Commit Graph
54 Commits
Author SHA1 Message Date
Willie 4152282753 refactor(config): remove Skills field from Config and ProjectConfig structs
Migration now uses raw YAML parsing (temporary struct) to extract
skills[] from old config files, independent of the main struct.
2026-02-25 07:02:54 +08:00
Willie 74e232c254 refactor(config): reconcile writes to Registry instead of Config 2026-02-25 07:02:54 +08:00
Willie b7bb8afa26 feat(config): add silent auto-migration from config.yaml skills[] to registry.yaml 2026-02-25 07:02:54 +08:00
Willie e779ed8109 feat(config): add Registry struct with Load/Save for registry.yaml
Introduce a separate Registry type to hold skill entries (installed/tracked
skills) independently from config.yaml. This keeps config.yaml focused on
user-managed settings while registry.yaml tracks skill metadata.

Registry reuses the existing SkillEntry struct and follows the same
patterns as Config (schema comment, yaml.Marshal, validation on load).
2026-02-25 07:02:54 +08:00
Willie 173803e8cb chore(targets): remove deprecated openclaude target
OpenClaude has been superseded by OpenClaw. Upstream (vercel-labs/skills)
already removed it. Remove from targets.yaml and supported-targets docs.
2026-02-25 07:02:54 +08:00
Willie a05d3448f2 fix(sync): match targets by shared path and track local dirs in prune
MatchesTargetName now falls back to path comparison when name-based
matching fails, so targets sharing the same project_path (e.g. codex
and universal both using .agents/skills) correctly match in
FilterSkillsByTarget.

PruneOrphanLinks records user-created directories in LocalDirs instead
of emitting misleading "unknown directory" warnings, and syncMergeMode
counts them toward the local skill total.
2026-02-25 07:02:54 +08:00
Willie 06c14b6a9d feat(init): add --mode flag and per-target compatibility hints
Closes #42

Some AI CLIs (Cursor, Antigravity, Copilot, OpenCode) skip symlinks
when scanning skill directories, causing symlinked skills to be
silently ignored during auto-discovery.

Changes:
- `init --mode <merge|copy|symlink>` / `-m`: set default sync mode at
  init time (global and project); interactive prompt when TTY detected
- `init --discover --mode`: applies mode only to newly added targets,
  leaving existing targets unchanged
- Per-target mode hint after `sync` and `doctor`: suggests `copy` for
  known compatibility-sensitive targets (cursor → antigravity →
  copilot → opencode); suppressed when only claude/codex configured
- Neutral decision matrix in sync-modes.md for constraint-based choice
- By-target override examples in target.md, sync.md, first-sync.md
- Integration tests for mode flag, discover+mode, hint presence/absence
2026-02-24 01:47:38 +08:00
Willie 3b721ee3e2 feat(sync): add copy mode for AI CLIs that can't follow symlinks
Add a third sync mode (`copy`) that copies skills as real files instead
of symlinks, with a `.skillshare-manifest.json` tracking managed skills
and SHA256 checksums for incremental updates.

- Manifest-based tracking: skip unchanged, update modified, --force all
- Pruning: remove managed copies no longer in source
- Mode conversion: bidirectional merge↔copy and symlink↔copy
- Full command support: sync, status, doctor, diff, target, collect
- Server API + Web UI: targets list, drift detection, filter editing
- include/exclude filters work in both merge and copy modes
- 12 integration tests covering all acceptance criteria
- Documentation updated across 13 pages

Closes #31
2026-02-21 06:07:35 +08:00
Willie be9ac8945c refactor(targets): rename agents→universal, fix kimi/replit paths
- Rename "agents" target to "universal" with backward-compat alias
- Fix kimi global_path: ~/.kimi/skills → ~/.config/agents/skills
  (matches official docs recommended path)
- Add replit global_name and global_path (~/.config/agents/skills)
- Prefer "universal" as canonical name in GroupedProjectTargets
- Update tests for new naming and kimi as universal group member
2026-02-20 13:59:34 +08:00
Willie 072b077971 feat: add JSON Schema for config YAML files
Enable IDE autocompletion, validation, and hover docs for config.yaml
by adding JSON Schema support via yaml-language-server directive.

- Add schemas/config.schema.json (global) and project-config.schema.json
- Prepend schema comment in Config.Save() and ProjectConfig.Save()
- Add unit and integration tests for schema comment roundtrip
- Document IDE setup in configuration.md
2026-02-18 23:58:45 +08:00
Willie 1ff2fe6881 feat: add group field to SkillEntry for organized skill placement
The --into flag information was previously encoded only in the name
field (e.g. name: frontend/pdf), causing config-based install to fail
because validate.SkillName() rejects slashes. Add an explicit group
field to separate placement from identity, with automatic migration
of legacy slash-in-name entries.

- Add Group field, FullName(), and EffectiveParts() to SkillEntry
- Update reconcilers to write new format and migrate legacy entries
- Fix installFromGlobalConfig/installFromProjectConfig to use
  EffectiveParts() for validation and FullName() for path construction
- Fix uninstall config cleanup to match via FullName()
- Add unit tests for SkillEntry helpers and reconciler group behavior
- Add 5 integration tests for group field end-to-end flows
- Document group field in declarative-manifest.md
2026-02-18 22:23:50 +08:00
Willie 57099849da feat: add Firebender as a supported target
Firebender is a coding agent for JetBrains IDEs with native skills support.
Paths: ~/.firebender/skills
(global), .firebender/skills (project). Update target count to 49+.
2026-02-18 22:23:50 +08:00
Willie 15586425c8 fix: sync agent target paths with upstream and document push/pull vs config
- antigravity: global_skills → skills
- augment: rules → skills
- goose project: .agents/skills → .goose/skills (upstream main)
- Update supported-targets.md to match
- Add "Alternative: Install from Config" section to cross-machine-sync
  with comparison table (push/pull vs install from config)
- Add cross-reference tip in install.md
- Bump CHANGELOG version to 0.13.3
2026-02-18 22:23:50 +08:00
Willie 7abe17cc2c feat: add declarative skill manifest for global mode
Port the project-mode skill manifest pattern to global mode so
`config.yaml` supports a `skills:` section and `skillshare install`
(no args) installs all listed remote skills.

- Rename ProjectSkill → SkillEntry (shared by both modes)
- Add Skills []SkillEntry to global Config with validation
- Add ReconcileGlobalSkills() to auto-sync manifest after install
- Wire no-arg install, auto-reconcile on all install paths
  (including search → install), and uninstall cleanup
- Update server handlers for global reconciliation
- Update docs, tests, and CHANGELOG
2026-02-18 22:23:50 +08:00
Willie d99653025c refactor: unify CacheDir into config package and document all platform paths
Move GetCacheDir() from version package to config.CacheDir(), consistent
with BaseDir()/DataDir()/StateDir() pattern including Windows fallback.
Add XDG_CACHE_HOME and cache paths to website docs.
2026-02-16 12:58:28 +08:00
Willie eed0bdaa24 fix: report migration outcomes and rewrite source after windows move 2026-02-16 11:20:31 +08:00
Willie 0bf84493cc feat: split XDG data/state dirs and add Windows legacy migration
Separate backups/trash into XDG_DATA_HOME and logs into XDG_STATE_HOME
instead of keeping everything under XDG_CONFIG_HOME. Add automatic
migration at startup to move existing data to the new locations.

Fix Windows path resolution: DataDir() and StateDir() now fall back to
%AppData% on Windows (matching BaseDir()), preventing incorrect use of
~/.local/share and ~/.local/state paths.

Add MigrateWindowsLegacyDir() to move pre-v0.13.0 data from
~\.config\skillshare\ to %AppData%\skillshare\ on Windows.

Update doctor, oplog, backup, trash, and all tests/docs accordingly.
2026-02-16 10:41:14 +08:00
Willie 80c2d52fef feat: respect XDG Base Directory Specification (#26)
Add config.BaseDir() as single source of truth for base directory
resolution. Replace all hardcoded ~/.config/skillshare paths.

Path resolution priority:
  1. SKILLSHARE_CONFIG env var (unchanged)
  2. $XDG_CONFIG_HOME/skillshare (any platform)
  3. %AppData%/skillshare (Windows only)
  4. ~/.config/skillshare (Linux, macOS fallback)

- Add config.BaseDir() with XDG_CONFIG_HOME + Windows %AppData% support
- Update BackupDir(), TrashDir(), init default source to use BaseDir()
- Show resolved base directory in doctor output
- Add unit tests and integration tests for XDG override
- Document XDG_CONFIG_HOME and update Windows paths in docs
2026-02-16 01:23:36 +08:00
Willie 403aafb254 feat: unify project target names with global names, add aliases for backward compat
Project targets now use the same short names as global targets (e.g.,
"claude" instead of "claude-code"). Old project_name values are preserved
as aliases so existing configs continue to work.

- Add Aliases field to targetSpec (deprecated, remove once safe)
- Update 11 targets in targets.yaml: project_name = global_name
- LookupProjectTarget falls back to alias lookup
- Fix 3 callers that bypassed LookupProjectTarget
- Extend MatchesTargetName and KnownTargetNames with alias support
- Add TestLookupProjectTarget_Alias
- Update all integration tests, docs, CLI help, and FAQ
2026-02-16 00:08:59 +08:00
Willie a29e198725 feat: add target filter CLI, skill-level targets field, and Web UI support
- CLI: `target <name> --add-include/--add-exclude/--remove-include/--remove-exclude`
- SKILL.md `targets` frontmatter restricts sync to specified targets
- Cross-mode matching (e.g. "claude" matches "claude-code" project target)
- Web UI: inline filter editor on Targets page, target badges on Skills pages
- API: PATCH /api/targets/{name} for filter updates
- Fix drift detection in doctor/status/handler to account for skill-level targets
- `check` warns about unknown target names in skill-level targets field
- Docs: update skill-format, target command, configuration, creating-skills
2026-02-15 23:29:30 +08:00
Willie 137fb84abf fix: correct droid and copilot skill paths per official docs
- droid (Factory AI): ~/.agents/skills → ~/.factory/skills,
  .agents/skills → .factory/skills
  Ref: https://docs.factory.ai/cli/configuration/skills

- copilot (GitHub Copilot): .agents/skills → .github/skills
  Ref: https://docs.github.com/en/copilot/concepts/agents/about-agent-skills
2026-02-14 02:30:35 +08:00
Willie 61d6c213ef feat: add Deep Agents CLI as supported target
Global: ~/.deepagents/agent/skills/
Project: .deepagents/skills/

Ref: https://docs.langchain.com/oss/python/deepagents/cli/overview
2026-02-14 02:22:30 +08:00
Willie 7faae6122a fix: correct opencode project skill path to .opencode/skills
Per OpenCode docs (https://opencode.ai/docs/skills/), workspace skills
should be at .opencode/skills/, not .agents/skills/.
2026-02-14 02:19:37 +08:00
Willie f771feb939 fix: correct gemini-cli project skill path to .gemini/skills
Per Gemini CLI docs (https://geminicli.com/docs/cli/skills/), workspace
skills should be at .gemini/skills/, not .agents/skills/.
2026-02-14 02:18:20 +08:00
Willie bd75ef8939 feat: support target include/exclude filters across sync, UI, and docs 2026-02-14 00:21:48 +08:00
Willie 0bd79a438e feat: add hub persistence to config for CLI and Web UI
Hub sources are now saved in config.yaml (both global and project),
replacing the Web UI's localStorage-based approach. This allows CLI
and UI to share the same hub list.

- Add HubConfig/HubEntry types and helper methods (resolve, add, remove)
- Add CLI subcommands: hub add/list/remove/default
- Search --hub now resolves saved labels (e.g. --hub team)
- Add REST API endpoints for hub CRUD (GET/PUT/POST/DELETE /api/hub/saved)
- Migrate SearchPage from localStorage to server API calls
2026-02-13 14:21:37 +08:00
Willie 192ccc7955 feat: add Cortex Code (Snowflake) target
Project .cortex/skills, global ~/.snowflake/cortex/skills.
2026-02-13 14:21:36 +08:00
Willie 59b6067e6d feat: add Letta project-mode support (.skills/)
Letta previously only had global path. Add project_name and
project_path per docs.letta.com/letta-code/skills.
2026-02-13 14:21:36 +08:00
Willie bf37442952 feat: add Xcode Codex and Xcode Claude Agent targets
Add macOS-specific Xcode Coding Intelligence targets:
- xcode-codex: global ~/Library/Developer/Xcode/CodingAssistant/codex/skills
- xcode-claude: global ~/Library/Developer/Xcode/CodingAssistant/ClaudeAgentConfig/skills

Update tests: droid now shares .agents/skills group, cursor replaces
claude-code as the single-path test case since xcode-claude shares
.claude/skills.
2026-02-13 14:21:36 +08:00
Willie 5b964eda62 feat: add COMATE target, switch Droid to .agents/skills
- Add COMATE with ~/.comate/skills (global) and .comate/skills (project)
- Update Droid from .factory/skills to universal .agents/skills
2026-02-13 14:21:36 +08:00
Willie d9fd9cc573 docs: add v0.11.5 changelog, remove stale moltbot target, fix target count
- Add CHANGELOG v0.11.5 covering --into flag, nested skill support,
  IBM Bob target, JS/TS highlighting, and project init grouping
- Remove deprecated moltbot entry from targets.yaml (renamed to openclaw)
- Fix target name cmdcode → commandcode in supported-targets table
- Update target count from 44+ to 43+ across docs (42 global + replit)
2026-02-13 14:21:36 +08:00
Willie 9ee5324689 feat: enhance security audit thresholds, logging, and UI 2026-02-13 14:21:36 +08:00
Willie aa43f94892 feat: add --into flag for skill install command
Allow installing skills into subdirectories for organized folder
structures. Works with all install modes (direct, discovery, tracked)
in both global and project mode.

- Add Into field to InstallOptions and IntoPath() validation
- Update 4 dest-path construction points in CLI with destWithInto()
- Update InstallTrackedRepo for --into prefix in dest and gitignore
- Rewrite ReconcileProjectSkills to use filepath.WalkDir (recursive)
- Add --into to Web UI install handler, API client, and form
- Add 5 integration tests covering local, multi-level, validation,
  project mode, and no-source rejection
2026-02-13 14:21:36 +08:00
Willie 57e7b68131 feat: group shared-path agents in project init UI
Multiple agents (Amp, Codex, Copilot, Gemini, Goose, Kimi, OpenCode,
Replit) all map to .agents/skills in project mode. Previously init -p
showed each as a separate selectable entry pointing to the same directory,
which was redundant and confusing.

Now targets sharing a project path are collapsed into a single group entry
(e.g. "agents") with member names shown in parentheses. Discover uses
path-based dedup so an existing "amp" entry correctly prevents the
"agents" group from appearing as new. --select accepts both canonical
and member names for backward compatibility.

- Add project_name/project_path to agents meta-target in targets.yaml
- Add GroupedProjectTargets() in config package with unit tests
- Rewrite detect/list/prompt/discover in init_project.go
- Add agents target to playground demo project
2026-02-13 14:21:36 +08:00
Willie 8d17b75e95 feat: add IBM Bob target and update Goose to universal project path
- Add IBM Bob agent (global: ~/.bob/skills, project: .bob/skills)
- Change Goose project_path from .goose/skills to .agents/skills
  to align with universal agent directory convention
- Update supported target count from 43+ to 44+ across docs
2026-02-13 14:21:34 +08:00
Willie 46c1f8ebcb feat: add tracked field to ProjectSkill config, fix reconcile for tracked repos
ProjectSkill gains `tracked: true` (omitempty) so `install -p` can
correctly dispatch tracked repos via InstallTrackedRepo instead of
regular Install. ReconcileProjectSkills now detects .git/ dirs and
reads git remote origin URL for tracked repos that lack meta files,
fixing the bug where tracked repos were silently skipped during
reconcile. SkillName validation is moved after the tracked branch
so _ prefixed repo names no longer fail.

Docs updated to position config.yaml as a portable skill manifest
usable by teams, open source contributors, and community templates.
2026-02-10 04:43:39 +08:00
Willie 14bd568b9a feat: add project mode support to web dashboard (skillshare ui -p)
The web dashboard now fully supports project-level skills. When launched
with `-p` or when `.skillshare/config.yaml` is auto-detected, the UI
adapts: Git Sync and Backup pages are hidden, Config edits the project
config, Install reconciles ProjectConfig.Skills[], and targets resolve
from project-level definitions.

Server: add NewProject constructor, IsProjectMode/configPath/saveConfig/
reloadConfig helpers, branch all handlers for project mode.

Frontend: AppContext propagates isProjectMode, Layout filters nav items,
Git/Backup pages show unavailable message, Config/Dashboard adapt.

Extract ReconcileProjectSkills to internal/config for reuse by both CLI
and server. Add unit tests and integration tests for project UI.

Update docs, README, and Docker playground with project mode demo project
and skillshare-ui-p alias.
2026-02-08 17:15:59 +08:00
Willie 0162bddfde feat: add per-target sync mode support for project mode
Allow project targets to set mode individually (merge or symlink),
mirroring global behavior. Default remains merge.

- Add Mode field to ProjectTargetEntry with YAML marshal/unmarshal
- Add mode branching in project sync (reuses syncMergeMode/syncSymlinkMode)
- Support --mode flag in target info for project targets
- Mode-aware unlink in target remove
- Unify project sync UI with global sync output format
- Update docs to reflect per-target mode support
2026-02-05 13:20:12 +08:00
Willie b83300ac05 feat: project level skills 2026-02-05 11:20:53 +08:00
Willie Hung 83bd7d45ef feat(targets): add 6 new agents to supported targets
Add AdaL, Augment, iFlow, OpenClaude, Trae CN, and Mistral Vibe.
Total supported agents: 43.
2026-01-31 16:34:36 +08:00
Willie Hung e764b0a206 feat(targets): add openclaw support (moltbot renamed)
Moltbot rebranded to OpenClaw with new skills directory
(~/.openclaw/skills). Keep moltbot as legacy alias.
2026-01-30 15:38:27 +08:00
Willie Hung 115a554d3c feat: add Kimi CLI support
Add ~/.kimi/skills/ as a sync target for Kimi Code CLI.
2026-01-28 23:20:42 +08:00
Willie Hung 4a65a981f3 feat: expand supported agents from 17 to 35
Add 18 new agents: cline, codebuddy, commandcode, continue, junie,
kiro, kode, mcpjam, moltbot, mux, neovate, openhands, pi, pochi,
qoder, qwen, trae, zencoder

- Rename clawdbot to moltbot
- Fix antigravity path to global_skills
- Update docs with new agent table
2026-01-28 17:16:02 +08:00
Willie Hung 8bcf5b6a13 feat: add 5 new agents to DefaultTargets
- clawdbot, droid, kilocode, roo, windsurf
- Fix amp path to ~/.config/agents/skills
- Update docs/targets.md with new agents list
2026-01-21 00:41:57 +08:00
Willie Hung 5e15e6bc8a fix: update opencode target path from skill to skills
Opencode unified their path structure to use "skills" (plural).
See: https://opencode.ai/docs/skills/
2026-01-19 21:06:22 +08:00
Willie Hung 3c28b254dd feat: add Amp, Gemini CLI, Letta as supported targets
- Add amp target (~/.amp/skills)
- Add gemini target (~/.gemini/skills)
- Add letta target (~/.letta/skills)
2026-01-15 17:17:50 +08:00
Willie Hung 2a83d170eb feat: add Goose and global agents as supported targets
- Add goose target (~/.config/goose/skills)
- Add agents target (~/.config/agents/skills) for portable cross-agent skills
- Alphabetize target list for consistency
2026-01-15 17:12:15 +08:00
Willie Hung 6f181f18bf feat: add Crush as supported target
- Add crush target with path ~/.config/crush/skills
- Update README supported tools list
2026-01-15 17:08:54 +08:00
Willie Hung 4d96a0de56 refactor: rename gemini target to antigravity
- Rename target from 'gemini' to 'antigravity' to match product name
- Update README to use Antigravity instead of Gemini CLI
2026-01-15 03:53:32 +08:00
Willie Hung 881c78b08e feat: add GitHub Copilot as supported target
- Add copilot target (~/.copilot/skills) to default targets
- Update README to list GitHub Copilot in supported tools
2026-01-15 03:52:30 +08:00