Commit Graph
567 Commits
Author SHA1 Message Date
Willie 22e7028747 docs: update target/filtering docs for agent filters and metadata.targets
- Add --agent-mode, --add-agent-include/exclude flags to target command docs
- Update filtering reference with agent filter examples and storage paths
- Prefer metadata.targets over top-level targets in all examples
- Note agent filter limitations (merge/copy only, requires agents path)
- Update skill-format docs with metadata.targets precedence note
- Update built-in skill references/targets.md with agent filter examples
2026-04-09 03:14:58 +08:00
Willie 081348d39b refactor(collect): unify skills/agents flow with collectPlan + generics
Replace duplicated runCollectSkills/runCollectAgents (~110 lines of 95%
identical code) with a single runCollectPlan function driven by a
collectPlan struct + toCollectResources[T] generic converter.

Key changes:

- Add collectPlan/collectResources types and runCollectPlan unified flow
- Add toCollectResources[T] generic to bridge typed slices into the
  shared pipeline (scan → display → dry-run → confirm → pull → render)
- Replace fragile err.Error() == "already exists in source" string
  matching with ErrAlreadyExists sentinel error + errors.Is()
- Move os.MkdirAll from per-agent PullAgent to PullAgents (call once)
- Add FindLocalAgents/PullAgent/PullAgents to match FindLocalSkills API
- Add target selection, --force/--dry-run/--json support for agent collect
- Add integration tests for agent collect (target filter, dry-run, force,
  JSON, oplog, project mode)
- Update collect.md, agents.md, ui.md docs for agent collect support
2026-04-09 00:36:39 +08:00
Willie 36ee2fe15f fix: tone down doctor target colors — only status word is colored
Split status word from detail in displayTargetStatus. Only the status
word (merged/drift/linked) gets color, detail text uses dim. Reduces
the "wall of green" effect in doctor output.
2026-04-08 22:26:18 +08:00
Willie baea54d938 docs: update status, doctor, diff docs for unified agent layout
status.md:
  - Fix synced→merged for agents, add [merge] mode prefix
  - Remove synced from status table
  - Update project mode example

doctor.md:
  - Update example outputs with sub-item format (target name header + skills/agents indented)
  - Add agents source to environment checks table
  - Update targets section description
  - Single-line extras format
  - Remove leading spaces from output examples
2026-04-08 22:25:00 +08:00
Willie 8d909494ee docs: update status.md for unified layout with agents in targets
- Update example output to show new layout (agents as sub-items)
- Remove outdated agents/--all flags from options table
- Fix --json note: now supported in both global and project mode
- Add agents section to JSON output example
- Rewrite project mode example with new format
- Remove fictional "Remote Skills" section
2026-04-08 22:10:10 +08:00
Willie 4a84796160 docs: document agents_source config field
The agents_source field was already implemented but had no
documentation, unlike extras_source which was fully documented.

- Add agents_source to Full Example in configuration.md
- Add dedicated agents_source field reference section
- Add Custom Source Directory section to understand/agents.md
- Note agents_source in Skills vs Agents comparison table
2026-04-08 22:04:15 +08:00
Willie 9025fb35bf docs: update website docs for centralized .metadata.json format 2026-04-08 15:14:22 +08:00
Willie d759a7e8ee docs: add agent support to all command reference and getting-started pages
Command pages updated (7 files):
- list: 'skillshare list agents', [A] badge
- install: --kind agent, -a flag, auto-detection
- sync: agent sync with all three modes, supported targets
- check: 'skillshare check agents' drift detection
- audit: 'skillshare audit agents'
- enable: --kind agent routes to .agentignore
- uninstall: --kind agent flag

Getting started updated:
- first-sync: link to agents concepts in What's Next
- quick-reference: agent management command table + agents source path

Commands index: added agents row to What do you want to do table.
2026-04-07 18:05:40 +08:00
Willie 9896aa7cd6 docs: add Agents concepts page to website documentation
Create website/docs/understand/agents.md covering:
- Skills vs Agents comparison table
- Directory structure (global + project)
- Agent file format and naming conventions
- Supported targets (claude, cursor, opencode, augment)
- Sync modes (merge/symlink/copy)
- .agentignore usage
- Install from repos with auto-detection
- CLI commands reference
- Data flow diagram

Update sidebar ordering to include agents between skill-format and
project-skills.
2026-04-07 18:05:40 +08:00
Willie 7d4e6cad42 docs: add v0.18.9 changelog and document relative symlinks in project mode 2026-04-07 17:26:37 +08:00
Willie e82d18cfa4 fix: sync must not prune registry entries for installed skills
Sync's registry prune logic removed entries for installed skills whose
files were missing from disk. This was wrong: the registry is the
authoritative record of installations managed by install/uninstall.

Remove PruneStaleSkills calls from sync (CLI global, CLI project, and
web UI handler). Reconcile (called during install) still uses prune
with full metadata context, which is correct.

Fixes: running 'sync' after 'install' would clear registry.yaml when
the installed skill's source files were not yet on disk.
2026-04-06 17:28:10 +08:00
Willie 9ddff32f42 docs(blog): update legacy target config format to current style
Migrate flat targets format (targets.claude.path) to nested skills
sub-key format (targets.claude.skills.path) for consistency across
all blog posts.
2026-04-05 20:51:04 +08:00
Willie 17da67aaff fix(blog): correct image path and remove outdated posts
Fix Docusaurus build error: /static/img/ → /img/ for markdown images.
Remove e2e-testing-for-ai-agents and e2e-tests-now-powered-by-mdproof
blog posts.
2026-04-05 20:31:46 +08:00
Willie 9a02d82554 docs(blog): add multi-account Claude Code setup guide
Covers setting up multiple Claude Code accounts via CLAUDE_CONFIG_DIR
aliases, syncing skills across accounts with skillshare targets, and
syncing rules/hooks/agents with the extras feature. Includes web UI
section and full config example.
2026-04-05 20:26:47 +08:00
Willie 343e29cfe5 fix(ui,server): harden target management, toggle, and tracked-repo UX
- Enable frontmatter parsing in DiscoverSourceSkillsAll so /api/skills
  returns saved targets (fixes target display reverting to All)
- Skip tracked-repo skills in batch/single target handlers to prevent
  dirty git state; reject with 400 for single-skill endpoint
- Add RefreshMetaHashes to recompute audit hashes after SKILL.md edits;
  batch handler refreshes outside the write lock
- Show 'Uninstall Repo' with confirm dialog for tracked-repo members
  instead of the always-failing individual uninstall action
- Return 409 Conflict when enabling a skill disabled by glob pattern
  in .skillignore/.skillignore.local instead of false success
- Preserve IsInRepo flag for root-skillignore-disabled skills so they
  remain visible in the Tracked tab after disable
- Update changelog and website changelog for v0.18.7
2026-04-04 17:05:22 +08:00
Willie ce76f58393 fix(doctor): read metadata.version + harden frontmatter delimiter parsing
- doctor: replace inline frontmatter parser with version.ReadLocalSkillVersion
  which correctly reads nested metadata.version (fixes #119)
- frontmatter_write: use TrimRight instead of TrimSpace for --- delimiter
  so indented --- inside YAML block scalars is not mistaken for end marker
- Update changelog and website changelog for v0.18.7
2026-04-04 17:05:22 +08:00
Willie 1057b1449c docs: add v0.18.7 changelog, release notes, bump skill version
Folder-level target display, bulk editing, right-click context menu,
table view redesign, optimistic updates, and config panel fix.
2026-04-04 17:05:22 +08:00
Willie 96a084a4f4 docs: add v0.18.7 changelog, release notes, bump skill version 2026-04-04 17:05:22 +08:00
Willie a570670a92 fix: registry cleanup after uninstall and sync, UI polish
- Fix UI batch uninstall not removing nested skill registry entries:
  handler used flat names (__) but registry stores path names (/),
  now tracks exact RelPath from discovered skills for matching

- Add stale entry pruning to ReconcileGlobalSkills and
  ReconcileProjectSkills using a live set built during disk walk,
  so skills deleted from source are removed from registry

- Trigger registry reconcile after sync in both UI handler (via defer
  for early-return safety) and CLI (global + project mode), writing
  warnings to stderr to avoid corrupting --json output

- UI: fix BatchUninstallPage search treating plain text as exact-match
  glob (now substring search when no * or ? present), display nested
  skill paths with / instead of __ in confirm and result dialogs

- UI: hide redundant 'X repo(s) and Y skill(s) already up to date'
  line on UpdatePage when everything is already current

- Fix test isolation: set XDG_CONFIG_HOME in server test helpers to
  prevent host agents dir leaking into test results, skip chmod-based
  oplog test when running as root

- Add README badge for Awesome Codex CLI
2026-04-01 22:30:39 +08:00
Willie 115a7dd086 docs: add v0.18.5 changelog and bump skill version 2026-04-01 14:22:05 +08:00
Willie c574d30ceb docs: ensure --branch examples cover both regular and tracked installs
quick-reference.md and SKILL.md now show both regular (--branch --all)
and tracked (--track --branch) usage patterns.
2026-04-01 00:32:49 +08:00
Willie 074b139855 docs: update check JSON example, quick reference, and built-in skill for --branch
- check.md: JSON output now includes branch field for tracked repos
- quick-reference.md: added --branch example in team sharing section
- SKILL.md: added -b flag to install recipes
2026-04-01 00:32:49 +08:00
Willie b38f719cdb docs: update v0.18.4 changelog with branch support, sync accuracy, and bug fixes
Adds --branch feature, sync count fix, CLI warning summary,
target dropdown optimistic update, and cached branch lookups
to existing v0.18.4 changelog entry. Syncs website changelog
and release notes.
2026-04-01 00:32:49 +08:00
Willie 67893a402a docs: document --branch flag for install and tracked repositories
Adds --branch to options table, usage examples for branch installs,
and Branch Tracking section in tracked-repositories guide.

Closes #90
2026-04-01 00:32:49 +08:00
Willie ccdafd3293 feat(sync): add target_naming config option (flat/standard)
Add per-target target_naming setting that controls how skill directories
are named in sync targets. 'flat' (default) preserves the existing
flattened __ separator behavior. 'standard' uses the SKILL.md name field
directly, following the Agent Skills specification.

Standard mode:
- Validates SKILL.md names match directory basenames
- Detects and skips name collisions with warnings
- Auto-migrates managed entries when switching from flat to standard
- Preserves legacy entries when bare name is already occupied

Also includes:
- Per-target toggle via CLI (--target-naming), TUI (N key), and Web UI
- Collision output redesigned as deduplicated compact summary
- Config inheritance: global target_naming → per-target override
- JSON schema + UI validation for the new field

Closes #110
2026-04-01 00:32:49 +08:00
Willie ab64d3d1c3 docs: add v0.18.4 changelog and release notes
Folder tree view, agent target paths, setup-skillshare action.
2026-04-01 00:32:49 +08:00
Willie 50df8b0526 docs: update CI/CD recipes to use setup-skillshare action
- ci-cd-skill-validation: setup-skillshare@v1 as primary method,
  manual curl install as fallback option
- security: simplified CI audit example using the action
- Link to GitHub Marketplace listing
2026-03-30 18:30:26 +08:00
Willie 1016a155db fix(diff): filter out skills with SKILL.md targets mismatch
diff (CLI, TUI, Web UI) now applies FilterSkillsByTarget before
computing differences, matching the behavior of sync/status/doctor.
Previously, skills with unsupported targets values (e.g. targets: ["*"])
appeared as false 'source only' pending items that sync could never resolve.
2026-03-29 04:59:23 +08:00
Willie 58a78ab131 docs: add v0.18.3 changelog, enable/disable docs, and release notes
- New enable/disable command reference page with examples and Mermaid diagrams
- Update command index, list, upgrade, and filtering docs for new features
- Add enable page to sidebar under Skill Management
- Update SKILL.md with enable/disable recipes and version bump to v0.18.3
- Sync changelog to website, update README latest note
- Document upgrade auto-sudo, TUI E key toggle, and [disabled] label
2026-03-29 04:59:23 +08:00
Willie 41967309af docs: add v0.18.2 changelog, release notes, bump skill version 2026-03-28 02:54:53 +08:00
Willie 3ee5d0bb83 docs: add v0.18.1 changelog, release notes, bump skill version
- CHANGELOG.md: v0.18.1 entry (filter, registry move, init fix)
- website/src/pages/changelog.md: synced
- skills/skillshare/SKILL.md: version → v0.18.1
- specs/RELEASE_NOTES_0.18.1.md: maintainer release notes
2026-03-27 02:24:19 +08:00
Willie b6b7ae8caa docs: add --filter to analyze quick-reference entry 2026-03-27 02:20:21 +08:00
Willie dbce8ffa20 fix: update registry.yaml path and clean up formatting
Update registry.yaml path references from ~/.config/skillshare/
to ~/.config/skillshare/skills/ in schema description, quick
reference docs, and migration guide. Fix whitespace alignment
in lint.go constants and remove blank line in skill.go imports.
2026-03-27 02:17:54 +08:00
Willie fb044d68a6 feat(analyze): add filtered token summary bar to Web UI
Shows always-loaded, on-demand, and total token sums for the current
search/filter result set using mini stat chips with icon + label + value.
Appears only when a filter is active. Search matches on path (relPath)
to support group filtering. Lint filter badge shows readable rule name.
2026-03-27 00:33:36 +08:00
Willie acedd77f20 docs: update registry.yaml path and init --remote behavior
- registry.yaml now lives in skills/ dir (synced via git)
- Updated file-structure, declarative-manifest, appendix, init docs
- Added migration note for v0.19+ users
2026-03-26 23:06:37 +08:00
Willie f7e04f1961 docs: add v0.18.0 changelog, release notes, and analyze docs
Add CHANGELOG and website changelog entries for v0.18.0 covering
the new analyze command, skill quality lint, TUI, Web UI Analyze
page, and Update page improvements.

Update analyze.md with lint rules table, quality section, and
updated JSON output example. Add analyze to built-in skill
description and Quick Lookup table. Bump skill version to v0.18.0.

Fix TUI list title to show skill count in stats line instead of
title, and truncate long skill names to keep token count visible.
2026-03-26 19:20:52 +08:00
Willie 78ba5c7282 refactor(analyze): polish TUI rendering and add docs
- Fix nil pointer panic when WindowSizeMsg arrives before data loaded
- Fix TestAnalyze_Verbose: create 12 skills to match analyzeTopN=10
- Unify left panel with shared renderPrefixRow (▌ prefix bar style)
- Right-align token counts in skill list rows
- Pre-compute colored dots to avoid per-render lipgloss allocations
- Add category tab bar at top for future analysis categories
- Improve target bar separator (│ → ·) and footer spacing
- Extract renderFooter to eliminate viewSplit/viewVertical duplication
- Add analyze command reference page and sidebar/index entries
2026-03-26 19:20:52 +08:00
Willie e030801a71 docs: update extras mode docs for multi-target flatten behavior 2026-03-25 21:14:16 +08:00
Willie f31e1b1520 docs: update changelog with TUI flatten toggle 2026-03-25 21:14:16 +08:00
Willie dcd452735d docs: add F flatten keybinding to extras TUI documentation 2026-03-25 21:14:16 +08:00
Willie 7c913086d0 fix(ui): show correct field docs for target names in config editor
- name: claude under targets was showing mode doc (targets.mode)
  instead of target name doc. Fixed by adding targets.name fieldDoc
  entry which scores higher in subsequence matching.
- Bare list values like "- agents" (short-form target name) were
  invisible: extractKey, parseYamlTree, and lookupFieldDoc now
  handle them.
2026-03-25 21:14:16 +08:00
Willie 2ce1544dd1 docs: add flatten documentation, changelog, and contributor
Extras command docs, config reference, built-in skill, website
changelog, release notes. Add mk-imagine to README contributors.

Ref: #97
2026-03-25 21:14:16 +08:00
Willie b93f437d8e feat(ui): add update notification dialog to Web UI
Show a compact dialog on first visit when a newer CLI or skill version
is available. Queries /api/version (shared cache with Dashboard), displays
version diff with copyable upgrade command. Dismissed once per browser
session via sessionStorage. Supports ?update-test param for local testing.
2026-03-24 23:17:06 +08:00
Willie 3a45d38305 docs: add filtering skills guide and reference
New users frequently ask for per-target skill management without
realizing three filtering layers already exist (#93). Add two new
doc pages to surface the full picture:

- How-to guide (6 scenarios + decision flowchart + verification table)
- Reference page (comparison table + evaluation order + full specs)

Also add cross-links from sync, target, file-structure, and
creating-skills pages, sidebar entries, and a README highlight.

Ref: #93
2026-03-20 18:29:05 +08:00
Willie 1c7bdcdd84 feat(ui): add Force toggle to Extras page and auto-reset after sync
- Add Force toggle button with tooltip in Extras PageHeader
- Pass force flag to syncExtras API for both Sync All and per-extra sync
- Show "enable Force to override" hint in toast when files are skipped
- Auto-reset Force to disabled after successful sync (Extras + Sync pages)
- Fix ExtrasSyncResult type to match server response (target field, errors array)
- Update v0.17.9 changelog entries
2026-03-20 18:29:05 +08:00
Willie 5198a74287 fix(ui): fix assistant panel scrolling, remove false target warnings, add virtual scroll
- Fix Config and Audit Rules assistant panels with fixed 500px content
  height to enable scrolling (matching CodeMirror editor height)
- Remove target name validation that produced false "Unknown target"
  warnings — target names are user-defined and freely configurable
- Enrich targets field docs example with all sub-fields
- Add react-virtuoso virtual scrolling to FilterStudioPage preview list
- Add v0.17.9 changelog and website changelog
2026-03-20 18:29:05 +08:00
Willie 5a0a8753d0 fix(test): update extras source-not-exist test for auto-create behavior
Sync now auto-creates missing extras source directories instead of
failing with "does not exist". Update the assertion to match.
2026-03-20 02:36:50 +08:00
Willie c4b493ca03 docs: add audit rules assistant panel to v0.17.8 changelog
Add YAML editor assistant panel with regex tester feature to
CHANGELOG.md and website changelog.
2026-03-20 02:36:50 +08:00
Willie 34aedc99b2 docs: update v0.17.8 changelog with assistant panel and bug fixes
Add config editor assistant panel feature and three bug fixes to
CHANGELOG.md and website changelog.
2026-03-20 02:36:50 +08:00
Willie 4b7f02ffde docs: extras source config documentation and v0.17.8 changelog
- extras command reference: --source flag, source_type, resolution priority
- configuration reference: extras_source and per-extra source fields
- CHANGELOG and website changelog: v0.17.8 entry
- mdproof lessons-learned: jq mixed stdout, ssenv+mdproof conflict
2026-03-20 02:36:50 +08:00