Commit Graph
68 Commits
Author SHA1 Message Date
Willie 035c9fe3f7 feat(config): add ExtraConfig struct for extras sync
Add ExtraTargetConfig and ExtraConfig structs to support a new
`extras:` section in config.yaml for syncing non-skill resources
(rules, commands, etc.) to target directories.

- ExtraConfig: name + list of ExtraTargetConfig (path + mode)
- Extras field added to Config struct (after Targets, before Ignore)
- Load() expands ~ in extras paths, matching existing target behavior
- Tests cover parsing, tilde expansion, mode field, and empty extras
2026-03-04 12:16:32 +08:00
Willie f6c5e1d2c8 feat(tui): add persistent TUI toggle via skillshare tui [on|off]
Allow users to globally disable interactive TUI without adding --no-tui
to every command. The setting is stored in config.yaml as `tui: false`.

Priority: --no-tui flag > config tui field > default (true).

- Add Config.TUI *bool field + IsTUIEnabled() helper
- Add centralized shouldLaunchTUI() replacing 9 scattered TTY checks
- Add `skillshare tui` command (show/on/off)
- Update JSON schema with tui boolean property
- Clean up unused golang.org/x/term imports (4 files)
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 07f70abf02 fix(audit): let profile presets set threshold when config has no explicit block_threshold
config.Load() normalized empty block_threshold to "CRITICAL", preventing
ResolvePolicy from applying profile-based thresholds (e.g. strict → HIGH).

Change: normalizeAuditBlockThreshold("") now returns "" instead of "CRITICAL".
All downstream callers (install, update, server) already use
audit.NormalizeThreshold() which handles empty → CRITICAL independently.

Also adds 4 integration tests for --profile, --dedupe, and config-based
profile resolution. Includes gofmt formatting fixes.
2026-03-03 16:08:11 +08:00
Willie 3465100382 feat(config): add profile and dedupe_mode to AuditConfig and schemas
New optional fields for audit policy. Both omitempty so existing
configs without them continue to work unchanged. JSON schemas
updated for both global and project configurations.
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 38f8f1c796 fix(symlink): resolve symlinked source/target dirs across all Walk callsites
filepath.Walk/WalkDir silently skip symlinked root directories because
os.Lstat sees the root as a non-directory symlink and never enters it.
This affected update, uninstall, reconcile, and server handlers when
the source directory was a symlink (common with dotfiles managers).

Extract ResolveSymlink() from sync.go into internal/utils/path.go and
apply it at every filepath.Walk/WalkDir callsite on source/target dirs.

Also add containment guards to resolveGroupSkills (uninstall) and
resolveGroupUpdatable (update) to reject group directories that are
symlinks pointing outside the source tree.
2026-03-02 10:05:57 +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 4c70b7d0af perf(gitignore): batch read/write for install reconcile and uninstall
UpdateGitIgnore/RemoveFromGitIgnore were called per-skill inside loops,
re-reading the entire .gitignore each time. With large files (100K+ lines
in project mode), this caused O(N×M) complexity and process hangs.

- Add UpdateGitIgnoreBatch and RemoveFromGitIgnoreBatch (single read/write)
- ReconcileProjectSkills: collect entries during walk, batch-update once
- uninstall (global + project): batch-remove after loop, not per-iteration
- Fix spinner WithRemoveWhenDone in StartSpinnerWithSteps
- Add E2E runbook for gitignore batch performance validation
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 c0b3f878da fix(sync,log): canonicalize group key to prevent race; honor max_entries: 0
P1: sync_parallel grouped targets by raw path string, so the same
physical directory with different representations (trailing slash,
relative segments, symlink aliases) could be placed in separate groups
and written concurrently. Resolve paths via filepath.Clean → Abs →
EvalSymlinks (walking up to the nearest existing ancestor when the
leaf doesn't exist yet) before using them as group keys.

P2: LogConfig.MaxEntries was int, making 0 (explicit unlimited)
indistinguishable from "not set". Changed to *int so nil = default
(1000), 0 = unlimited, >0 = user value, <0 = fall back to default.
2026-02-26 22:27:23 +08:00
Willie 5f1521c3fd feat(log): comprehensive log improvements — partial status, instrumentation, retention, stats
- Report "partial" status for sync/install/update/uninstall when some
  items succeed and others fail
- Instrument 6 new commands: check, diff, trash, init, upgrade, and
  all mutating commands now log to operations.log
- Auto-truncation via WriteWithLimit with configurable log.max_entries
  (default 1000) and 20% hysteresis to avoid truncating every write
- Stats engine: computeLogStats with per-command breakdown
- CLI --stats flag with colored output and ✓ok/total ratios
- TUI stats panel (toggle with 's'): bar charts, status distribution,
  last operation timestamp
- TUI stats footer: compact always-visible summary line
- TUI detail panel: j/k scrolling for long entries, proportional
  list/detail layout (40%/60%)
- Web API: GET /api/log/stats endpoint
- Updated website docs for log command
2026-02-26 22:27:23 +08:00
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