Commit Graph
305 Commits
Author SHA1 Message Date
Willie 0ead6cee9e chore: update CHANGELOG 2026-02-19 00:09:10 +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
v0.14.1
2026-02-18 23:58:45 +08:00
Willie 47dc9495fe fix: enforce install flag validation and project uninstall preflight v0.14.0 2026-02-18 22:23:50 +08:00
Willie d1379cbc36 test: split audit tests by concern 2026-02-18 22:23:50 +08:00
Willie b1ede8d918 fix: handle errors from ReconcileGlobalSkills, filepath.Walk, and remove redundant applyExclude
Address PR #29 review feedback:
- Log warnings on ReconcileGlobalSkills/ReconcileProjectSkills failures
  instead of silently discarding errors
- Propagate filepath.Walk callback errors in uninstall group/nested resolution
- Remove redundant applyExclude call in selectSkills (callers already filter)
2026-02-18 22:23:50 +08:00
Willie 5c487c6874 docs: update README for v0.14.0 — add release entry, bump target count, document group uninstall 2026-02-18 22:23:50 +08:00
Willie 080377ff85 feat(ui): show license field in SkillDetailPage manifest box
Parse and display the license frontmatter from SKILL.md in the
manifest section, matching the existing name/description pattern.
2026-02-18 22:23:50 +08:00
Willie 95e7ee24a6 feat: auto-detect group in uninstall and update v0.14.0 docs
- Show "Uninstalling group (N skills)" with sub-skill listing when
  uninstalling a directory that contains sub-skills
- Update CHANGELOG, website uninstall docs with group detection example
- Update built-in skill references for v0.14.0: version bump,
  .skillignore, --exclude, license display, multi-skill uninstall,
  audit detection patterns table, Firebender target
2026-02-18 22:23:50 +08:00
Willie f99a29ac06 fix: show license in SkillBox for subdir single-skill install
handleGitSubdirInstall was missing the ui.SkillBox display that
handleGitDiscovery already had, so license frontmatter was silently
skipped when installing via a subdir URL with exactly one skill.
2026-02-18 22:23:50 +08:00
Willie 86d6134c58 feat: support multi-skill and group uninstall
Allow `skillshare uninstall` to accept multiple skill names and a
repeatable `--group`/`-G` flag for batch removal. Groups use prefix
matching so `--group frontend` removes `frontend/*` recursively.
Problematic skills are skipped with warnings (skip & continue).
Names and groups can be mixed; duplicates are deduplicated by path.
Single-skill invocation preserves backward-compatible output.
2026-02-18 22:23:50 +08:00
Willie bd4c9700be feat: support group matching in .skillignore via path-based comparison
Change matchSkillIgnore to compare against skill path instead of name,
enabling patterns like "feature-radar" to exclude all skills under
that group directory. Precise paths like "feature-radar/helper" still
target individual skills. Backward compatible — flat skills have
path == name so existing patterns work unchanged.
2026-02-18 22:23:50 +08:00
Willie bbe71471de docs: expand --init-rules workflow and list directory grouping
Add step-by-step false positive fix workflow with scaffold file
preview to audit docs. Add directory grouping section to list docs
explaining auto-grouping mechanism and linking to organizing guide.
2026-02-18 22:23:50 +08:00
Willie 82a101972f test: split install integration tests by concern 2026-02-18 22:23:50 +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 8143e29ea7 docs: add runkids/my-skills as real-world .skillignore demo with screenshot 2026-02-18 22:23:50 +08:00
Willie 001fff0c77 feat: add .skillignore, --exclude flag, and license display for install
Implement three install features with full documentation:

- .skillignore: repo-level file to hide skills from discovery (exact
  match + trailing wildcard). Applied during git repo discovery before
  any selection prompt.
- --exclude: CLI flag to skip specific skills during multi-skill install.
  Filters before the interactive prompt so excluded skills never appear.
  Warns when used with direct local-path installs (not applicable).
- License display: shows SKILL.md license frontmatter in selection
  prompts and single-skill confirmation screen.

Add 7 integration tests, 2 new doc pages (declarative-manifest,
url-formats), and cross-reference updates across 6 existing doc pages.
2026-02-18 22:23:50 +08:00
Willie 1d0633aa35 feat: expand audit rules with 6 new security patterns
Add detection for real-world attack vectors that were missing from the
audit engine: dynamic code evaluation (eval/exec/Function), Python shell
execution (os.system/subprocess), environment variable leaking
(process.env), prompt injection hidden in HTML comments, and escape
sequence obfuscation (hex/unicode). Each rule includes false-positive
guards (e.g. evaluate() excluded from eval rule, NODE_ENV excluded from
env-access). Also backfills insecure-http and shell-chain rules that
were missing from the website docs table.
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 f16a28d678 docs: restructure website documentation with scenario-driven navigation
- Add version command page and fix commands index (missing check, trash, hub)
- Document target aliases and XDG base directory layout
- Rewrite all 9 section index pages with "What do you want to do?" tables
- Standardize all 24 command docs with "When to Use" and "See Also" sections
- Enhance intro with role-based paths (individual / team / migration)
- Add "What Just Happened?" explainer to first-sync getting-started page
- Add practical context callouts (:::tip) to all concept pages
- Add See Also cross-references to all guide and workflow pages

59 files changed, 547 insertions(+), 163 deletions(-)
2026-02-16 17:01:06 +08:00
Willie 692d87c4cc fix: use .md extension in relative doc links to prevent 404s
Relative links like `./sync` resolve differently depending on
whether the page URL has a trailing slash. Adding `.md` lets
Docusaurus resolve them at build time, fixing broken links when
navigating via the navbar.
2026-02-16 16:16:18 +08:00
Willie 0d9acb2594 fix: use official formula name in brew upgrade command
Drop the explicit `runkids/tap/` prefix so `brew upgrade` resolves
the formula the same way `brew install skillshare` does, avoiding
the spurious "Failed to load cask" error from a stale Casks entry.
v0.13.2
2026-02-16 15:48:04 +08:00
Willie 1d6f21ed1d docs: add orphan external symlink fix to CHANGELOG (#28) 2026-02-16 15:24:53 +08:00
Willie 76e1f6e3a9 fix: prune broken external symlinks after data migration (#28)
After data migration (e.g. XDG path change), target symlinks still
point to old source path. PruneOrphanLinks treated these as "external"
and always preserved them, even with --force.

- Auto-remove broken external symlinks (target no longer exists)
- Pass force flag to PruneOrphanLinks; force removes valid external symlinks
- Use utils.PathHasPrefix for Windows case-insensitive path comparison
v0.13.1
2026-02-16 15:23:03 +08:00
Willie 4bd5f821a6 fix: avoid GitHub API rate limit in PowerShell install script
Use redirect-based version detection (same as install.sh) instead of
calling api.github.com directly, which is rate-limited to 60 req/hr
for unauthenticated requests on shared IPs.
2026-02-16 15:14:55 +08:00
Willie bda787362f docs: add upgrade tip to install sections and clarify Homebrew upgrade 2026-02-16 14:54:38 +08:00
Willie c2c52c8152 fix: enable TLS 1.2 in PowerShell install script
PowerShell 5.1 defaults to TLS 1.0/1.1 which GitHub API rejects,
causing "Failed to get latest version" on Windows. Also surface the
actual error message for easier debugging.
2026-02-16 14:51:59 +08:00
Willie 684cd5b59d fix: compare skill version instead of file existence in upgrade
upgradeSkillshareSkill() previously only checked whether SKILL.md
existed, always reporting "Already up to date" regardless of actual
version. Now reads the frontmatter version field and compares against
the remote version, auto-updating when outdated.
2026-02-16 14:51:13 +08:00
Willie 53b31dfa70 Merge pull request #27 from runkids/v0.13.0
v0.13.0
v0.13.0
2026-02-16 14:01:27 +08:00
Willie ba103c4a18 docs: update UI install notes for runtime download and add XDG cleanup paths
All install methods now include the web dashboard via runtime download.
Remove outdated Homebrew-only limitation notes. Add XDG data/state/cache
directories to uninstall instructions.
2026-02-16 13:04:07 +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 cb9db75dfb fix: improve dev mode placeholder with actionable instructions
Show exact commands (cd ui && pnpm run dev, make ui-dev) instead of
a vague mention of Vite, so developers know how to start the frontend.
2026-02-16 12:29:53 +08:00
Willie 9c51630b85 fix: bind port before opening browser to avoid connecting to stale server
Split ListenAndServe into Listen + Serve so port conflicts are detected
before the browser is opened.  Previously, openBrowser ran first and
could connect to an old skillshare ui process on the same port.
2026-02-16 12:28:03 +08:00
Willie 0b832f1d8c refactor: deduplicate skill target validation and project list display
- Extract findUnknownSkillTargets() into target_helpers.go, shared by
  check and doctor commands
- Reuse buildSkillEntries() + displaySkillsCompact() in project list,
  removing duplicate projectSkillEntry type and display functions
- Silence MigrationSkippedDestinationExists warning that fired on every
  run after a successful migration
2026-02-16 12:16:15 +08:00
Willie e3f501d16f fix: redirect XDG vars into sandbox to prevent CI test leakage
Ubuntu CI runners set XDG_CONFIG_HOME system-wide, causing
config.BaseDir() in subprocesses to resolve outside the sandbox.
Redirect XDG_CONFIG_HOME/DATA_HOME/STATE_HOME to sandbox paths
so every test exercises the XDG codepath with proper isolation.
2026-02-16 12:08:05 +08:00
Willie 2d78be860e docs: add v0.13.0 changelog, release note, and fix remaining doc gaps
- Add CHANGELOG.md entry for v0.13.0 (Added/Changed/Fixed/Breaking)
- Add RELEASE_NOTE_v0.13.0.md for GitHub release
- README: update Recent Updates table, fix Windows paths to %AppData%
- upgrade.md: document UI asset pre-download
- install.md: document fuzzy subdirectory resolution for monorepos
- check.md: document targets field validation warnings
- intro.md, configuration.md, windows.md: fix remaining Windows paths
2026-02-16 11:49:18 +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 41e822d979 feat: remove go:embed, serve UI exclusively via runtime download
Replace the embedded SPA (go:embed + build tags) with runtime download
from GitHub Releases. The binary no longer bundles UI assets — they are
downloaded on first `skillshare ui` launch and cached at
~/.cache/skillshare/ui/<version>/.

- Delete embed.go / embed_dev.go; add spa_disk.go with placeholder handler
- Simplify ensureUIAvailable(): cache check before dev-mode fallback
- Pre-download UI assets in `skillshare upgrade` (best-effort)
- Remove Node stages from production and CI Dockerfiles
- Keep Node stage in sandbox for playground UI cache pre-population
- Remove ui-embed-check CI job and -tags dev build flag
- Update Makefile, mise.toml, GoReleaser, release workflow
2026-02-16 02:58:22 +08:00
Willie b068116d95 docs: update built-in skill for v0.13.0 features
Bump version 0.11.7 → 0.13.0 and document new features:
- Target-level skill filtering (--add-include/--add-exclude)
- Skill-level targets frontmatter field
- Unified project target names (with alias backward compat)
- XDG Base Directory support ($XDG_CONFIG_HOME)
- Fuzzy subdirectory resolution for monorepo installs
- Improved list UX (grouped display, --verbose/-v)
- diff project mode support
- check targets field validation
- Target count 46+ → 48+
2026-02-16 01:35:22 +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 da50912307 feat: fuzzy resolve subdirectory when exact path not found in repo
When installing from a monorepo where skills live in a nested directory
(e.g. skills/vue-best-practices/), specifying just the skill name as
subdir (owner/repo/vue-best-practices) would fail because the exact
path doesn't exist at the repo root. Now resolveSubdir scans all
SKILL.md files and matches by basename, falling back gracefully with
an ambiguity error when multiple candidates share the same name.
2026-02-16 00:54:10 +08:00
Willie 2dfe57a213 chore: improve list skills UX 2026-02-16 00:41:24 +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 d30d90af76 feat: update Homebrew install to homebrew-core and detect missing UI
- Update Homebrew command from tap (runkids/tap/skillshare) to
  homebrew-core (brew install skillshare) in README, website homepage,
  and getting-started docs
- Add note that Homebrew build is CLI-only (no web dashboard)
- Add IsUIBuilt() detection in embed.go/embed_dev.go to check for
  placeholder UI at startup
- Show CLI warning with install instructions when skillshare ui is
  run on a build without the frontend
- Add Homebrew Note section to commands/ui.md with migration steps
2026-02-15 16:18:26 +08:00
Willie d64e3b18f5 feat: add project mode and filter display to diff command
Support -p/--project flag with auto-detection, matching other
dual-mode commands. Show include/exclude filters in diff output
so users understand why certain skills are absent from results.
v0.12.9
2026-02-14 21:59:40 +08:00
Willie db760b5f17 fix: suppress irrelevant doctor warnings in project mode
Skip git-not-initialized warning in project mode since the project
itself has version control and backups aren't used. Skip tracked repo
directories (_prefix) in SKILL.md validity check since they are
container directories for nested skills by design.
2026-02-14 21:46:31 +08:00
Willie 5b437c343a docs: add project config examples to collision detection sections
Each collision detection section now shows both global and project
config filter syntax, with a cross-reference link to the full
target filters documentation.
v0.12.8
2026-02-14 18:59:04 +08:00