Willie
9b849172ff
docs: add sync extras documentation across website, skill, and README
...
Document the new `sync extras` subcommand and `--all` flag:
- sync.md: add Sync Extras section with config, modes, flowchart, example
- configuration.md: add `extras` field reference with schema table
- file-structure.md: show extras source directories alongside skills
- quick-reference.md: add sync extras and sync --all entries
- SKILL.md + references/sync.md: add extras recipes for AI callers
- README.md: add v0.16.10 to Recent Updates
2026-03-04 12:16:32 +08:00
Willie
6caf73faf0
docs(audit): split monolith audit.md into focused pages
...
The 1294-line audit.md mixed command reference, conceptual teaching,
rule management, and CI/CD recipes. Split into:
- understand/audit-engine.md — threat model, detection rules, risk
scoring, command tiering, cross-skill analysis
- reference/commands/audit-rules.md — rule management, custom rules,
built-in rule IDs table (adds 4 cross-skill finding IDs)
- how-to/recipes/ci-cd-skill-validation.md — absorb output format
docs (SARIF, Markdown, JSON+jq, exit codes)
- reference/commands/audit.md — slim to ~370 lines, link to new pages
Also fixes:
- Replace ghost rule `system-writes-0` with `insecure-http-0` in all
docs (the old ID no longer exists in rules.yaml)
- Update 3 cross-page links in security.md
- Update 1 rule ID in configuration.md
- Add sidebar entries for both new pages
2026-03-04 12:16:32 +08:00
Willie
d1e7f6558a
feat(audit): wire --analyzer CLI flag, config field, and update docs
...
- Add EnabledAnalyzers []string to AuditConfig struct
- Add enabled_analyzers to both JSON schemas (config + project)
- Parse --analyzer repeatable flag in audit command
- Wire config → PolicyInputs → Registry for all scan paths
(ParallelScan, single skill, single path, filtered)
- Add PolicyAnalyzers to JSON summary output
- Server handler also reads config enabled_analyzers
- Update audit.md: Policy & Profiles section, Finding Schema table,
--profile/--dedupe/--analyzer in Options table and examples
- Update configuration.md: expanded audit section with all new fields,
profile table, analyzer IDs, precedence rules
2026-03-03 16:08:11 +08:00
Willie
3bc9ad7574
feat(targets): add AstrBot, update Cline to universal .agents/skills
...
- Add AstrBot target (data/skills / ~/.astrbot/data/skills)
- Update Cline paths from ~/.cline/skills to ~/.agents/skills (global)
and .cline/skills to .agents/skills (project)
- Update website docs: add AstrBot badge/row, update Cline paths,
add Cline to universal agents info box
2026-03-02 23:01:30 +08:00
Willie
85b6329836
feat(targets): add Lingma as built-in target
...
Alibaba Cloud AI coding assistant. Global: ~/.lingma/skills,
project: .lingma/skills.
2026-02-28 21:38:55 +08:00
Willie
dce960ea9a
feat(targets): add oh-my-pi (omp) as built-in target
...
Add omp target with global path ~/.omp/agent/skills and project path
.omp/skills. Alias: oh-my-pi. Ref: #57
2026-02-28 21:10:36 +08:00
Willie
5d9a77372d
feat(init): label universal as shared agent directory and add coexistence docs
...
- Change universal description from "(recommended)" to "(shared agent directory)"
in detect, checklist, and discover flows
- Add FAQ section on using universal alongside npx skills: merge vs copy mode
differences, name collision caveats, lock file visibility
- Add universal info admonition to supported-targets page
- Add E2E runbook for universal target path verification
- Update CHANGELOG and release notes for v0.16.4
2026-02-28 03:44:02 +08:00
Willie
8997196593
fix(init): correct universal target path and auto-include in init
...
The universal target pointed to ~/.config/agents/skills (wrong) instead
of ~/.agents/skills, causing `npx skills list` to miss synced skills.
Also auto-recommend universal as a target whenever any CLI is detected
during `init` and `init --discover`, since ~/.agents/ won't exist on
disk until skillshare creates it.
Closes #54
2026-02-28 03:44:02 +08:00
Willie
00cb3ba80e
feat(targets): add Verdent AI coding agent
...
Add Verdent (verdent.ai) as a built-in target with standard skill paths.
Update target count from 49+ to 50+ across README, homepage, and docs.
Sync changelog and release notes with the new target entry.
2026-02-27 05:39:49 +08:00
Willie
1327586f30
docs: fix 17 factual errors across website documentation
...
Full content audit identified inaccuracies verified against source code:
Critical fixes:
- declarative-manifest: skills: migrated from config.yaml to registry.yaml
- private-enterprise-skills: fix token list, add --track, fix dir separator
- supported-targets: fix universal canonical name, kimi/replit paths, aliases
- with-multiple-tools: fix target list output format, opencode path
Moderate fixes:
- tracked-repositories, project-skills: update config examples for registry.yaml
- skill-format: name rule "underscore" -> "number" (per validSkillNameRegex)
- understand/index: fix opencode path in diagram, add copy mode
- comparison: ~/.cursor/rules -> ~/.cursor/skills
- configuration: fix backups path, add registry migration note
- with-devcontainer: add non-interactive flags for postCreateCommand
- migration: .source -> .skillshare-meta.json
- docker-sandbox: make --cmd -> ./scripts/test_docker.sh --cmd
- security: audit rule count 31 -> 32
- ci-cd-skill-validation: production -> CI docker image
- cross-machine-sync-recipe: replace unimplemented ignore with include/exclude
- environment-variables: add GH_TOKEN entry
2026-02-26 22:27:23 +08:00
Willie
caa525b8aa
feat(website): complete website revamp — Diátaxis IA, blog, recipes, quickstarts
...
Restructure the entire documentation site following the Diátaxis framework
(Learn / How-to / Understand / Reference) with new content across 110 files.
## Information Architecture (M1)
- Move all docs to Diátaxis directory structure (learn/, how-to/, understand/, reference/)
- Add client-redirects plugin for old URL compatibility
- Rewrite sidebar, navbar, and footer to match new IA
- Update all internal cross-references
## Homepage + Quickstarts (M2)
- Add scenario entry cards to homepage with hand-drawn design
- 5 quickstart pages: Claude Code, GitHub Copilot (with copy mode recommendation),
Codex, Multiple Tools, Dev Containers, Playground
## Blog + Changelog (M3)
- Enable Docusaurus blog plugin with authors.yml
- 5 blog posts: 5-min tutorial, managing 50+ skills, skillshare vs vercel/skills
comparison, team sharing patterns, write your first skill
- Static /changelog page from CHANGELOG.md
## Recipes + Philosophy (M4)
- 5 recipe pages: CI/CD validation, enterprise skills, project setup,
cross-machine sync, team onboarding
- 3 philosophy pages: why-local-first, security-first, sync-modes-explained
## Content Polish
- Cross-validate all content against CLI source (19 inaccuracies fixed)
- Lowercase "skillshare" throughout (avoid brand conflict with Skillshare Inc.)
- Add registry.yaml to file structure and Key Paths docs
- Highlight multi-platform git support (GitHub, GitLab, Bitbucket, Gitea,
Azure DevOps, AtomGit, Codeberg)
- Standardize brew install command
- Add AsciinemaPlayer component (cast recordings pending)
2026-02-26 22:27:23 +08:00