Commit Graph
218 Commits
Author SHA1 Message Date
Willie bf1a12545f docs: update built-in skill references to v0.11.7
Catch up skill references with features added in v0.11.4–0.11.7:
- SKILL.md: bump version, add init-rules command, inline ui -g/-p hint
- init.md: add --skill/--no-skill flags, update non-interactive examples
- install.md: add --into and --skip-audit flags with examples
- audit.md: rewrite with --threshold, --json, --init-rules, path scanning,
  LOW/INFO severity, custom rules (three-layer merge), risk scoring
- targets.md: note 46+ built-in targets
- status.md: note upgrade --skill is opt-in
- TROUBLESHOOTING.md: add audit rules and nested skill tips
- Remove ui.md — AI only needs ui -g/-p from command table
v0.11.8
2026-02-13 14:21:37 +08:00
Willie d8699762ad fix: use deep skill count in init and prevent null files in git status API
- init: replace shallow os.ReadDir count with DiscoverSourceSkills()
  to correctly count nested skills by SKILL.md presence
- handler_git: guard against nil slice from GetDirtyFiles() overwriting
  the initialized empty slice, which serialized as JSON null
- GitSyncPage: add optional chaining on status.files for defense
2026-02-13 14:21:36 +08:00
Willie dde62dd733 docs: update target count to 45+, add project/global paths to table
- Update target counts across README, website docs, and homepage
- Rebuild ASCII box diagram with new targets (COMATE, Cortex, Xcode Claude, Xcode Codex)
- Replace single-column paths table with global + project path columns
- Fix stale paths (droid, copilot, etc.) to match actual targets.yaml
v0.11.7
2026-02-13 14:21:36 +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 ac58c5e71e docs: reorganize sidebar, add project migration, fix metadata format
- Guides: split 10 flat items into 3 sub-categories (Skills, Sharing, Advanced)
- Workflows: move Troubleshooting Workflow into Troubleshooting category
- Migration: add project mode sections (committed skills, global→project, team options)
- Configuration: add audit section, project config format, custom audit rules
- Navbar: add Guides and Targets quick links
- Fix .skillshare.yaml → .skillshare-meta.json across all docs (wrong filename/format)
- Bump font sizes site-wide for readability (base 16→17px, components proportional)
2026-02-13 14:21:36 +08:00
Willie 11e18dce00 fix: use git reset for clean history on init --remote, skip project auto-detect for global flags
- tryPullAfterRemoteSetup: replace git pull/merge with git reset --hard
  to avoid merge commits and ff-only/conflict issues when pulling from
  remote into a freshly initialized repo
- Add hasGlobalOnlyInitFlags() so init --remote works correctly even
  when cwd has .skillshare/config.yaml (project mode auto-detection)
- Update cross-machine-sync doc to reflect reset behavior
v0.11.6
2026-02-13 14:21:36 +08:00
Willie f4be50bdd7 fix: shorten target multi-select labels for readability
Move path display to detection phase output. Multi-select options
now show only name + status instead of name + full path + status,
preventing an unreadable long line when all targets are selected.
2026-02-13 14:21:36 +08:00
Willie 3830543309 feat: auto-commit and auto-pull on init, improve git UX
Init now creates an initial commit (including .gitignore) so that
push/pull work immediately after setup. When a remote is configured,
init fetches and auto-pulls existing skills from the remote.

- Always create initial commit in doGitInit (fixes stale untracked
  .gitignore blocking pull)
- Add ensureGitIdentity: set repo-local fallback when git user.name
  is not configured, with hint to set global config
- Add tryPullAfterRemoteSetup: fetch remote after adding origin,
  auto-pull if remote has content and local is empty
- Add hintGitRemoteError: context-aware hints for SSH, URL, and
  network errors in push/pull
- Show Pro tip only when built-in skill is installed
- Sandbox: add --bare mode (skip auto-init), --volumes for down
  (full reset), and sandbox-reset / sandbox:reset targets
- Docs: update init flow diagram, cross-machine-sync guide,
  push/pull prerequisites, getting-started, troubleshooting
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)
v0.11.5
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 af43a57ae2 feat: add JavaScript/TypeScript syntax highlighting in file viewer
Install @codemirror/lang-javascript and support .js, .ts, .jsx, .tsx,
.mjs, .mts, .cjs, .cts with proper language modes (including JSX and
TypeScript flags).
2026-02-13 14:21:36 +08:00
Willie e0c9499c14 fix: parse YAML block scalars in frontmatter and use CodeMirror for all file types
Two related UI fixes for the skill detail page:

1. YAML block scalar parsing: description fields using >-, >, |, |-
   syntax showed the raw indicator instead of the parsed value. Fix
   both frontend (parseScalarValue) and backend (ParseFrontmatterField)
   to recognize block indicators and read indented continuation lines.

2. File viewer: non-markdown files (.py, .sh, etc.) rendered as plain
   <pre> without line numbers or highlighting. Now all non-markdown
   files use CodeMirror, with Python syntax highlighting via
   @codemirror/lang-python.
2026-02-13 14:21:36 +08:00
Willie 3a132ab72e fix: update nested skills by full relative path in Web UI
The Update button on SkillDetailPage passed only the skill basename
(e.g. "ascii-box-check") instead of the full relative path
("utils/ascii-box-check"), causing "not found as tracked repo or
updatable skill" errors for nested skills.

- Frontend: use skill.relPath instead of skill.name for non-repo skills
- Backend: rewrite getServerUpdatableSkills with filepath.WalkDir so
  Update All also discovers nested skills
2026-02-13 14:21:36 +08:00
Willie a1a3bafe9e docs: document --into flag and add nested skills to playground
Update 5 website docs to cover the new --into install flag:
- commands/install.md: options table, quick examples, common scenarios
- guides/organizing-skills.md: new "Install Directly into Folders" section
- guides/project-setup.md: --into example in Step 3
- reference/file-structure.md: nested skill in source directory tree
- concepts/project-skills.md: --into in project directory structure

Reorganize playground demo skills into nested subdirectories
(security/, devops/, demos/, guides/) so users see the feature
out of the box.
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 3873960d84 feat: support nested skills in uninstall command
Previously `skillshare uninstall vue-best-practices` failed when the
skill lived under an organizational folder (e.g. frontend/vue/).
Now both global and project mode fall back to a basename search across
nested directories, matching the behavior already in check/update.

- Add resolveNestedSkillDir() with ambiguity detection
- Use as fallback in resolveUninstallTarget (global) and
  cmdUninstallProject (project)
- Also matches _name variant for nested tracked repos
- Add integration tests for basename and full-path uninstall
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 de6a4b49b5 docs: mention folder organization in README
Add bullet point in "Why skillshare" and a tip in "How It Works"
linking to the organizing guide and runkids/my-skills example.
2026-02-13 14:21:36 +08:00
Willie f50847eb6c feat: support nested skills in check/update and add organizing guide
GetTrackedRepos() and GetUpdatableSkills() now walk subdirectories
recursively so skills organized in folders (e.g. frontend/vue/) are
detected by check and update commands. Previously only direct children
of the source directory were scanned.

Also adds:
- Short name resolution for `update` (e.g. `update vue-best-practices`
  resolves to `frontend/vue/vue-best-practices`)
- Fix ReadMeta nil check in updateSkillOrRepo to ensure fallback fires
- Remove logo from `check`, replace with mode-aware header
- New docs guide: Organizing Skills with Folders
- Rename screenshot to organizing-skills-comparison.png
2026-02-13 14:21:36 +08:00
Willie d536de4311 docs: fix ASCII box alignment in audit, init, and project-setup
- audit.md: fix path line (62→63) and Warning/Failed lines (39→40)
- init.md: fix all │ lines in init -p flow diagram (68→67)
- project-setup.md: same flow diagram fix as init.md
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 b7d14fb622 docs: link builtin audit rules source in command reference 2026-02-11 10:37:28 +08:00
Willie 7fe3bf09e0 docs: fix incorrect CLI command in changelog
audit-rules is not a standalone command; the correct flag is
skillshare audit --init-rules
2026-02-11 10:29:23 +08:00
Willie 06bc3588f7 docs: add changelog for v0.11.4 v0.11.4 2026-02-11 10:17:58 +08:00
Willie 2c982848c5 feat: classify HIGH audit findings as warnings and refresh docs/playground 2026-02-11 10:10:09 +08:00
Willie bf6f60467f docs: update website for audit rules UI, built-in skill opt-in, and missing pages
- init.md: add step 5 (built-in skill prompt) to What Happens diagram
- first-sync.md: add tip about built-in skill prompt during init
- audit.md: add Custom Rules Editor section for /audit/rules page
- ui.md: add Audit, Audit Rules, Trash, Log to Dashboard Pages table
  and audit/log REST API endpoints
- file-structure.md: add audit-rules.yaml to overview tree
2026-02-11 04:43:58 +08:00
Willie 927bad707e feat: add audit rules Web UI page with create/edit support
Add REST API (GET/PUT/POST /api/audit/rules) for managing custom
audit-rules.yaml through the web dashboard. Extract template and
validation logic from CLI into reusable audit package functions
(ValidateRulesYAML, InitRulesFile, DefaultRulesTemplate). Frontend
provides CodeMirror YAML editor with dirty tracking, file creation
flow, and mode-aware path display. Sidebar nav gains overflow scroll.
2026-02-11 04:36:58 +08:00
Willie fbcec80788 feat: externalize audit rules to YAML with user customization
Move 17 hardcoded audit rules from Go structs to embedded rules.yaml,
enabling community PRs on rule definitions without recompilation.

Add user-customizable audit rules at two levels:
- Global: ~/.config/skillshare/audit-rules.yaml
- Project: .skillshare/audit-rules.yaml

Merge semantics: built-in → global → project. Users can append new
rules, override existing ones by id, or disable them (enabled: false).

Replace hardcoded localhostURL check with generic exclude regex field
on rules. Add --init-rules flag to scaffold a starter rules file.

Public API (ScanSkill, ScanContent, Finding, Result) unchanged —
callers require zero modifications.
2026-02-11 03:40:54 +08:00
Willie 98db20a9a0 test: add !online build tag to offline integration tests
Prevent test-docker and test-docker-online from running the same 36
offline integration tests. Each offline test file now has
`//go:build !online` so the two sets are mutually exclusive:
- default (no tag): 36 offline tests only
- -tags online: online tests only
2026-02-11 03:40:54 +08:00
Willie 18a4177973 test: add online integration tests for install, update, and search
Cover real GitHub operations that were previously untested:
- install clone (subdir skill)
- install --track (full repo)
- update tracked repo (freshly cloned → up to date)
- search with conditional GITHUB_TOKEN skip

Also pass GITHUB_TOKEN into sandbox-online container and remove
the -run filter so all online-tagged tests run automatically.
2026-02-11 03:40:54 +08:00
Willie 348102d5a9 feat: make built-in skill opt-in for init and upgrade
Built-in skillshare skill was auto-installed during `init` and
unconditionally refreshed by `upgrade --skill`. This caused
unintended pushes and surprised new users who didn't need it.

Changes:
- init: add --skill/--no-skill flags, prompt [y/N] (default N)
- upgrade: decouple --skill from --force, prompt when not installed
- Add 4 new integration tests for the opt-in behavior
- Update existing tests to use --no-skill or --force as needed
- Document all non-interactive init flags in website docs
2026-02-11 03:40:54 +08:00
Willie 84ba16802d feat: add log filtering, improve log UX, and custom dropdown
- Add --cmd, --status, --since, --json flags to CLI log command
- Auto-skip irrelevant log section when --cmd narrows to one file
- Add blank line separator between log entries for readability
- API returns totalAll and commands for smarter frontend filtering
- Custom HandSelect dropdown matching hand-drawn design system
- Empty state distinguishes "no matching entries" from "no entries"
- Update website docs and built-in skill reference with new flags
2026-02-11 03:40:54 +08:00
Willie e8a3c57cb4 Merge pull request #19 from runkids/fix/filepath-issue-on-windows
fix: normalize backslash path separators for Windows
v0.11.3
2026-02-11 03:38:27 +08:00
Willie 0b280d0864 fix: normalize backslash path separators for Windows (fixes #18)
On Windows, filepath.Join produces backslash separators that were
written directly into .gitignore and JSON metadata files. Git does
not match backslash patterns, and metadata subdirs with backslashes
corrupt source URLs during updates.

Use strings.ReplaceAll(s, "\\", "/") at write boundaries — matching
the existing pattern in sync.go — to ensure config/metadata files
always contain forward slashes regardless of OS.
2026-02-11 03:30:14 +08:00
Willie 7287b68921 feat: make -v output mise-parseable for registry support
`skillshare version` keeps the ASCII logo, while `-v`/`--version`
now outputs `skillshare v<version>` — the plain-text format that
mise's registry test expects (`skillshare v{{version}}`).

Add registry/skillshare.toml for the upcoming jdx/mise PR.
v0.11.2
2026-02-11 03:03:46 +08:00
Willie acca11fa5f refactor: slim built-in skill to reduce context window cost
Reduce SKILL.md description (959→506 chars) and body (117→66 lines)
by removing content already covered in references/ (Quick Start,
verbose examples, Finding Skills section). Zero information loss.
v0.11.1
2026-02-10 11:57:28 +08:00
Willie f49b3999bc feat: enrich install and audit logs with mode/path and installed skills 2026-02-10 11:51:09 +08:00
Willie 4c48556094 fix: remove audit false positives from built-in skill and trim description
The built-in skillshare skill's references/audit.md contained real threat
strings (curl to evil URL, base64 decode pipe, prompt injection text) in
example output snippets, causing `skillshare audit` to flag itself. Remove
the offending `> ...` snippet lines while keeping the finding messages.

Also trim SKILL.md description from 1039 to 959 chars (under Codex 1024
limit) by removing redundant trigger phrases already covered by other entries.

Add integration test that copies the real built-in skill into a sandbox and
verifies `skillshare audit skillshare` produces zero findings.
2026-02-10 11:46:39 +08:00
Willie 591e874c3a docs: refine neutral comparison language and project mode guidance 2026-02-10 05:14:54 +08:00
Willie 4d620f25fd feat: improve log view and project log ignore defaults v0.11.0 2026-02-10 04:52:52 +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 e5813cc7e0 feat: add oplog instrumentation to all API handlers, improve audit/log/sync CLI
- Add oplog write helpers to server (oplog_helper.go) and instrument
  all handler_*.go endpoints with ops/audit logging
- Improve audit CLI with structured auditRunSummary and severity counts
- Enhance log CLI with richer filtering and detail display
- Improve sync CLI with drift detection summaries in oplog
- Reorder web UI sidebar nav by user workflow (core → acquire → distribute → maintain → monitor)
- Enhance LogPage with better formatting and filtering
- Add server oplog unit tests (logging_test.go, log_test.go)
- Update docs for log command and quick-reference
2026-02-10 03:50:03 +08:00
Willie f152245f27 docs(skill): update built-in skill to v0.11.0 with audit, trash, log, and drift detection
Add new reference docs for security audit, trash (soft-delete), and
operation log commands. Update existing references with sync drift
detection, install audit blocking, SSH subpath syntax, and new Web UI
pages/API endpoints.
2026-02-10 03:32:36 +08:00
Willie 14bb54d6bd fix(log): show target count in sync log details
CLI formatLogDetail and Web UI formatDetail now display the "targets"
arg as "N target(s)" so sync entries are no longer blank in Details.
2026-02-10 03:16:04 +08:00
Willie f2017a35aa feat: fix tracked repo discovery, improve naming, and unify project list
Sync discovery (DiscoverSourceSkills) was skipping all hidden directories
via utils.IsHidden(), causing skills inside .curated/ and .system/ (like
openai/skills) to be invisible after install. Now only .git is skipped,
matching the install-time discovery that was already fixed in 8ec5306.

Tracked repo naming now uses owner-repo format (e.g., _openai-skills
instead of _skills) via new Source.TrackName() method, preventing
collisions between repos that share the same basename.

Project-mode `list` command now uses recursive DiscoverSourceSkills()
instead of shallow os.ReadDir(), aligning with global list and web UI
behavior so tracked repo skills are visible everywhere.

Also includes CHANGELOG for v0.11.0, README updates, docs improvements,
and minor UI nav reorder.
2026-02-10 03:13:21 +08:00
Willie 2feff60e65 docs: add log command reference and update README/sidebar/file-structure
- New: website/docs/commands/log.md with usage, format, options, web UI
- commands/index.md: add log to Utilities table and quick reference
- sidebars.ts: add commands/log to Security & Utilities category
- file-structure.md: add logs/ directory to tree and platform tables
- README.md: add skillshare log to Daily Commands, update v0.11.0 summary
2026-02-10 03:00:28 +08:00
Willie 5a65993304 feat: add operation log — JSONL-based persistent audit trail for CLI, API, and web UI
Add oplog package (internal/oplog) that records every mutating command
(install, uninstall, sync, push, pull, collect, backup, restore, update,
audit) as a JSONL entry with timestamp, status, duration, and args.

- CLI: `skillshare log` with --audit, --tail, --clear, --project flags
- API: GET/DELETE /api/log endpoints with type and limit params
- Web UI: LogPage with ops/audit tabs, table view, clear and refresh
- Instrumentation across 12 command handlers (CLI + server)
2026-02-10 02:56:59 +08:00