Compare commits

...
Author SHA1 Message Date
Rohit Ghumare 1436180933 feat(integrity): add SHA-256 skill integrity verification
Ships supply-chain content integrity for the SkillKit ecosystem
(phase 1 of issue #90):

- New @skillkit/core integrity module computes a deterministic SHA-256
  digest over every file in a skill (excluding .skillkit.json metadata,
  VCS artifacts, editor noise) and emits a Subresource Integrity string
  (sha256-<base64>). 50 MB safety cap.
- New `skillkit verify <path>` CLI with --expected, --against-lock,
  --files, --format sri|hex, --json.
- `skillkit publish` now writes an `integrity` field per skill into
  .well-known/skills/index.json.
- `skillkit install` and `skillkit update` record the full SRI digest
  into ~/.skillkit/lock.json (graceful fallback to legacy short
  checksum if integrity computation fails).
- Docs: fumadocs security.mdx retitled "Security & Integrity" with a
  full verify section; commands.mdx + index.mdx updated; website
  Commands.tsx + Features.tsx surface the new feature and comparison
  matrix row.
- Root CHANGELOG.md added.

Phase 1 (content hashing) is the response to the ClawHavoc Q1 2026
supply-chain campaign and OWASP Agentic Skills Top 10 guidance.
Phase 2 (ed25519 signing + publisher key registry) is tracked
separately.

Tests: 11 unit tests for the integrity module, 5 CLI E2E tests for
`skillkit verify`. All 25 task suites green; typecheck clean.
2026-05-11 11:05:12 +01:00
Rohit Ghumare a9e5c83a4c Merge pull request #119 from rohitg00/chore/edge-budget-fixes
chore: edge cache headers + agent-aware robots + bot-block middleware
2026-04-28 11:34:45 +01:00
Rohit Ghumare e42ae9d87a chore: edge cache headers, agent-aware robots, UA bot-block middleware
Cuts Vercel hobby edge-request burn on both skillkit (Vite static)
and skillkit-docs (Next.js fumadocs) projects. Site stays
human-first AND agent-first — Firecrawl, Context7, Crawl4AI,
OpenClaw, Hermes, ChatGPT-User, Claude-User, PerplexityBot
explicitly allowed; training crawlers and SEO scrapers blocked.

skillkit (Vite, docs/skillkit):
- vercel.json: Cache-Control on assets (1d browser, 7d edge,
  30d SWR; immutable for hashed /assets/*), HTML (5min browser,
  1d edge, 7d SWR), and /api JSON
- redirects with has user-agent: deflect known training+SEO
  bots to /robots.txt; negative lookahead on source prevents
  /robots.txt redirect loop
- public/robots.txt: explicit allow + deny lists

skillkit-docs (Next.js, docs/fumadocs):
- next.config.mjs: headers() block for /_next/static (1y
  immutable), assets (1d/7d/30d), /docs/* and / (5min/1d/7d)
- src/middleware.ts: UA-aware allow/deny pipeline; allowed
  agents pass through, blocked bots get 403 with cache header
  so Vercel edge serves the rejection cheaply
- public/robots.txt: same allow/deny list as marketing site
2026-04-28 11:16:20 +01:00
Rohit Ghumare bf6ec9008b Merge pull request #118 from rohitg00/release/1.24.0
chore: release v1.24.0
2026-04-21 11:13:56 +01:00
Rohit Ghumare c4959a50b3 chore(1.24.0): fix agent-count review findings + refresh banner
Test arrays were renamed to '46 agents' but still listed 45:
- packages/core/src/translator/__tests__/registry.test.ts: add 'hermes'
- e2e/onboarding-ui.e2e.test.ts: add 'Hermes'
- e2e/skill-translator.e2e.test.ts: add 'hermes' + update comment
- e2e/translation.e2e.test.ts: add 'hermes' + update comment

docs/fumadocs Features.tsx: stat counter 45 -> 46 (line 86)

Banner refresh (docs/img/banner.svg):
- Title: 'One Skill. 44 Agents.' -> 'One skill. 46 agents.' with blue
  gradient accent on '46'
- Subtitle: sharper one-liner on scope
- Version badge under SKILLKIT lockup
- Install command: npm i -g skillkit (canonical path)
- Chip row: colored dots per status (skills/rewrites/license)
- Agent list: +Hermes +OpenCode, count math now correct (10+36=46)
- Palette: Zinc/Tailwind neutrals for cleaner dark mode
2026-04-21 11:09:37 +01:00
Rohit Ghumare 9e4739b195 chore: bump version to 1.24.0
Includes:
- v1.24.0 across all publishable packages
- Add packages/mcp + packages/api to bump-version.sh (were drifting)
- Regenerate assets/tags/v1.24.0.svg, remove stale v1.23.0.svg
- Bump agent count references from 45 to 46 (adds Hermes)
- Update gen-tags.mjs (version + agent count)
- Sync onboarding logo test expectation

Release covers #114 (Hermes native support) + #117 (OpenClaw upstream paths).
2026-04-21 10:56:35 +01:00
Rohit Ghumare a974515520 Merge pull request #114 from RUFFY-369/feat/hermes-agent-native-support
feat: add Hermes agent adapter (Native Hermes Support)
2026-04-21 10:30:14 +01:00
Rohit Ghumare b5b251acff Merge branch 'main' into hermes-pr-fix
# Conflicts:
#	README.md
2026-04-21 10:27:22 +01:00
Rohit Ghumare 1e7cad18c1 fix(openclaw): align paths with upstream openclaw/openclaw conventions (#117)
* fix(openclaw): align paths with upstream openclaw/openclaw conventions

- skillsDir: 'skills' -> '.openclaw/skills' (match project-scoped convention)
- configFile: 'CLAUDE.md' -> 'AGENTS.md' (upstream uses AGENTS.md/SOUL.md)
- globalSkillsDir: '~/.openclaw/skills' -> '~/.openclaw/workspace/skills'
- altSkillsDirs: keep 'skills' for back-compat, add workspace variant
- isDetected: also check project .openclaw/ and global workspace/
- MCP AGENT_DIR_MAP: .openclaw/skills for runtime discovery
- README: reflect real paths

Refs NousResearch upstream layout; pairs with #114 Hermes support.

* fix(openclaw): address review findings for discovery + detection

- skills.ts: add '.openclaw/skills' to SKILL_DISCOVERY_PATHS (alphabetical)
- config.ts: getSearchDirs prefers globalSkillsDir for home path
  (was deriving from skillsDir, producing ~/.openclaw/skills instead
  of ~/.openclaw/workspace/skills)
- agent-config.ts: add altConfigFiles to AgentDirectoryConfig schema,
  set openclaw altConfigFiles: ['openclaw.json']
- context/sync.ts: detectAgents also iterates altConfigFiles so
  projects with only openclaw.json still detected
- mcp/tools.ts: AGENT_DIR_MAP includes '.openclaw/workspace/skills'
  for home-rooted global discovery
2026-04-21 10:20:46 +01:00
Rohit Ghumare 17e9720834 Update README.md 2026-04-21 00:29:11 +01:00
Rohit Ghumare 821e9f714b chore: bump to 1.23.0, rewrite README, drop dead LLM SDK deps, add branded tags (#116)
Version bump
------------
1.22.1 -> 1.23.0 across all workspace packages. Minor bump covers the
slim-install dependency layout, safer first-time agent picker, and the
corresponding doc + branding changes.

Prune dead optional deps in @skillkit/core
------------------------------------------
@anthropic-ai/sdk, @google/genai, ollama, and openai were listed as
optionalDependencies but never imported. They were pulled through
@skillkit/cli transitively on every default install, adding ~57
packages and one deprecation warning (node-domexception via the
SDKs' own formdata-node / node-fetch transitives). Grep of
packages/core/src confirms no SDK import; providers in
src/ai/providers use direct fetch() against the provider HTTP APIs.
Drop them. better-sqlite3, sqlite-vec, and node-llama-cpp stay
because they are actually dynamic-imported by the vector store and
embedding pipeline.

Measured on a fresh npm cache (overrides-pinned file: tarballs):
  before:   475 pkgs / 18s / 3 deprecation warnings
  1.23.0:   418 pkgs / 18s / 2 deprecation warnings
  slim:     118 pkgs /  9s / 0 deprecation warnings
The two remaining warnings are upstream:
  - prebuild-install@7.1.3 from better-sqlite3 (must stay)
  - glob@9.3.5 from @opentui/solid -> babel-plugin-module-resolver

README rewrite
--------------
Punchier top fold. Palette-consistent SVG tag badges under
assets/tags/ replace most shields.io badges (still keep npm/CI/etc
on shields since they need live data). Collapsible detail blocks
for every feature instead of the linear wall. Same nav anchors the
site uses. No em dashes. No AI filler words. Writing style pulls
from the ai-engineering-from-scratch and awesome-claude-design
READMEs the user already runs.

Branded SVG tags
----------------
scripts/gen-tags.mjs generates 20 SVG pills under assets/tags/ in
the SkillKit palette (#09090b base, #fafafa text, #3f3f46 border,
accent per tag). Two variants: single pill with left accent bar
(new, slim-install, v1.23.0, etc.) and split badge (agents | 45,
packages | 118, install | 9s). Matches the aesthetic used on
awesome-claude-design, tailored to SkillKit's monochrome brand.
The tags directory is fork-and-remix friendly; README points to it.
2026-04-21 00:25:55 +01:00
Rohit Ghumare 7e6612d424 Merge pull request #115 from rohitg00/slim-install-deps
chore: slim CLI install by making heavy deps optional
2026-04-20 23:54:37 +01:00
Rohit Ghumare 49bcd85abf docs: add npx usage guidance for add command
npx skillkit add <owner/repo> is the most common first-touch path,
so call it out explicitly. Cover:

- Full vs slim invocation (npx skillkit add vs npx --omit=optional
  skillkit add), with the same 118/9s slim numbers.
- How the npx cache at ~/.npm/_npx/ makes subsequent runs instant
  until a new version ships.
- When to graduate to a global install: skips the prompt-to-proceed
  and kills the per-release refetch cost.

Updated in all four install-docs surfaces: root README, apps/skillkit
README (npm landing), docs/fumadocs/content/docs/installation.mdx,
and the Documentation.tsx components used on the website and the
fumadocs mirror.
2026-04-20 22:11:42 +01:00
Rohit Ghumare 2843bd3c5c fix(install): address CodeRabbit review on agent picker wording
Two nits from CodeRabbit on the first-user picker:

1. detectAgent() returns 'universal' as a fallback when no concrete
   adapter is detected. Passing that through to quickAgentSelect made
   the picker show "Just Universal (detected)" even when no real
   agent was found — misleading. Treat 'universal' as "not detected"
   and fall through to the plain select/all options instead.

2. The "All detected agents" label on the bottom option was wrong:
   agents at the call site is getAllAdapters() (all supported
   adapters), not only detected ones. Rename to "All supported
   agents" and change the hint to "writes to every adapter" so
   users aren't tricked into thinking this is a safe detected-only
   install.
2026-04-20 22:06:15 +01:00
Rohit Ghumare aea3b3ba32 fix(index): lazy-import @skillkit/tui + document optional deps
Devin review caught a hard bug: apps/skillkit/src/index.ts had a
static re-export of startTUI from @skillkit/tui. Now that tui is an
optional dependency, importing the skillkit package would crash with
ERR_MODULE_NOT_FOUND whenever the optional dep was skipped
(--omit=optional). Convert the re-export to an async wrapper that
dynamically imports @skillkit/tui on call. The error is surfaced
naturally with a clear Cannot-find-package message.

Docs updates so users understand the new split:

- README.md: add "Install sizes" section with full vs slim table,
  cold-install measurements (475 pkgs / 18 s vs 118 / 9 s),
  per-feature package mapping, and how to add a single optional
  package later.
- apps/skillkit/README.md (npm landing): add "What's optional"
  table + install mode guidance.
- docs/fumadocs/content/docs/installation.mdx: add "Full vs slim
  install" section covering all four optional features.
- docs/skillkit/components/Documentation.tsx +
  docs/fumadocs/src/components/Documentation.tsx: add "Optional
  Features" block to the Quick Start step on the website.

Verified: after `npm install --omit=optional`, `import('skillkit')`
succeeds with 622 exports loaded, and `await startTUI()` fails with
a clean "Cannot find package '@skillkit/tui'" message instead of
crashing at module-load time.
2026-04-20 22:04:08 +01:00
Rohit Ghumare 97ee4b9a43 fix(install): safer agent selection for first-time users
Before: first-time users (no history) saw "All detected agents"
as the first option in the agent picker. Mashing Enter would
install to all 32 agents, writing files across every adapter's
config dir. Selecting "Select specific agents" also pre-ticked
all 32 agents, requiring the user to un-tick by hand.

After:
- Default option is "Just <detected> (detected)" — one agent,
  low blast radius.
- "Select specific agents" moves above "All detected agents"
  and pre-ticks only the detected agent.
- "All detected agents" gets a second confirm gate
  ("Install to all N agents?") with initialValue: false.
- Hint text on "All" warns "use only if you know".

Returning users still see "Same as last time (Recommended)" as
the first option; their flow is unchanged.

Non-TTY path is unchanged (still auto-detects a single agent).

Wire detectAgent() through quickAgentSelect so the picker can
label and pre-select the detected agent. Empty selection from
the confirm gate is treated as cancellation.
2026-04-20 21:58:44 +01:00
Rohit Ghumare c8d0bbc844 chore: slim CLI install by making heavy deps optional
Move @skillkit/api, @skillkit/tui, @skillkit/mesh, @skillkit/messaging
to optionalDependencies. Drop @skillkit/memory entirely — the CLI
never imported it (only @skillkit/mcp-memory consumes it).

Killing @skillkit/memory removes cozo-node (native Rust) and
@xenova/transformers (~300MB ML stack) from the critical install
path. Making @skillkit/tui optional removes @opentui/core's
prebuild-install toolchain, which was the source of the
inflight/gauge/npmlog/tar/glob deprecation warnings.

Add skipNodeModulesBundle + platform=node + target=node18 to
apps/skillkit tsup config so optional deps stay external.

All TUI/mesh/messaging/api commands already lazy-import via
dynamic import() with surrounding try/catch, so missing optional
deps surface as a graceful error rather than a crash.

Measured impact (npm i skillkit in a clean cache):

  Scenario            Packages  Time   Deprecations  Vulns (crit/high)
  main                544       37s    10            33 (5/5)
  slim (default)      475       18s    3             25 (0/0)
  slim --omit=optional 118      9s     0             0

Core commands (list, find, translate, recommend, install, --help,
--version) smoke-tested in all three scenarios. Optional commands
(ui, mesh, message, serve) confirmed to degrade with a clean
"Cannot find package" error under --omit=optional.
2026-04-20 21:46:46 +01:00
RUFFY-369 27afc45dea fix(agents): address PR review comments for Hermes and align Windsurf tests 2026-04-21 00:17:08 +05:30
RUFFY-369 fb95260eb5 fix(agents): align windsurf adapter with modern SOTA rules path 2026-04-21 00:06:47 +05:30
RUFFY-369 9cbd0e394b chore: remove debug runner and local test artifacts 2026-04-20 15:15:24 +05:30
RUFFY-369 0b94c6001a feat: complete native Hermes support with dual-source parity and test coverage 2026-04-20 15:03:37 +05:30
RUFFY-369 94fa5c8bce feat: complete native Hermes Agent integration with translation and primer support 2026-04-20 14:49:37 +05:30
RUFFY-369 5bd2822f12 fix: add sync markers for Hermes Agent 2026-04-20 13:38:37 +05:30
RUFFY-369 e5d18eba28 fix: remove unused variable in Hermes adapter to fix build 2026-04-20 13:26:11 +05:30
RUFFY-369 1af78cbf26 feat: add missing discovery paths and translation lists for Hermes 2026-04-20 13:15:20 +05:30
RUFFY-369 97c7b2f16b docs: add Hermes Agent to supported agents list 2026-04-20 13:12:20 +05:30
RUFFY-369 5878e9f80c feat: add native support for Hermes Agent 2026-04-20 12:58:31 +05:30
Rohit Ghumare ae8c7a1abb chore: bump version to 1.22.1 2026-04-12 20:38:10 +01:00
Rohit Ghumare 196a959569 Merge pull request #109 from rohitg00/feat/json-spinners-remaining
feat: complete --json and spinners for all remaining commands
2026-04-12 20:21:14 +01:00
Rohit Ghumare 23d1c8932a fix: run agent install in save --json mode, include agents in output 2026-04-12 20:16:44 +01:00
Rohit Ghumare 0c82c58905 feat(cli): add --json output and loading spinners to remaining commands
Add --json flag with structured JSON output to: create, enable, disable,
eval, sync, tap (add/remove/list), translate, save, read.

Add loading spinners to: audit, fix, test, plugin, team, methodology,
hook, remove. Commands that already had spinners get --json-aware no-op
spinners when --json is active to suppress visual output.
2026-04-12 12:02:38 +01:00
Rohit Ghumare 1ce9751797 chore: bump version to 1.22.0 2026-04-12 11:32:58 +01:00
Rohit Ghumare 6485745295 Merge pull request #107 from rohitg00/feat/cicd-json-spinners
feat: reusable GitHub Action, --json output, loading spinners
2026-04-12 11:31:52 +01:00
Rohit Ghumare e9014e130c fix: suppress all stdout pollution in --json mode across all commands
- update: emit JSON on empty skills, gate warn/console.log on !json
- remove: emit JSON on empty results, gate warn/log on !json
- find: gate step() calls on !json
- install: emit JSON error object in catch block instead of console.log
2026-04-12 11:31:21 +01:00
Rohit Ghumare 9e50c8abe1 fix: prevent shell injection in action, suppress stdout in --json mode
- action.yml: pass inputs via env vars, whitelist allowed commands
- All --json commands: use no-op spinner to prevent stdout pollution
- remove: run AGENTS.md update before JSON output (was skipped)
- eval: gate spinner on json format, wrap in try/catch for cleanup
- scan: wrap spinner in try/catch for cleanup on failure
2026-04-12 10:56:35 +01:00
Rohit Ghumare 49fcc532d2 feat: add loading spinners to translate, sync, eval, publish, and scan commands (#88) 2026-04-12 10:41:46 +01:00
Rohit Ghumare ecead6585c feat: add --json flag to 8 CLI commands for structured output (#89) 2026-04-12 10:39:52 +01:00
Rohit Ghumare cc2eb2504c feat: add reusable GitHub Action for CI/CD skill management (#92) 2026-04-12 10:37:01 +01:00
Rohit Ghumare 5d7ca0cd8e Merge pull request #106 from rohitg00/feat/infra-v1.21
feat: progressive disclosure execution layer for MCP server
2026-04-12 00:29:07 +01:00
Rohit Ghumare eda488c960 fix: symlink escape in resource sandbox, search order, global paths
- Resolve symlinks with realpathSync before path containment check
  to prevent symlink-based directory escape in skillkit_resource
- Search project-local skills before home-level (cwd first in roots)
- AGENT_DIR_MAP now maps to arrays, includes non-standard global
  paths (opencode: .config/opencode/skills, windsurf: .codeium/...)
- Extra global dirs scanned when agent filter matches
2026-04-11 21:11:24 +01:00
Rohit Ghumare 559b760202 fix: add 13 missing agent dirs to SKILL_DISCOVERY_PATHS, fix agent filter
- Add .aider, .amazonq, .augment, .bolt, .codegpt, .cody, .devin,
  .lovable, .playcode, .replit, .tabby, .tabnine to discovery paths
- Fix agent filter in getLocalSkillDirs: use AGENT_DIR_MAP lookup
  instead of reverse-engineering from directory prefix (claude != claude-code)
- Update Agent Types code block in agents README to list all 45 agents
2026-04-11 20:32:28 +01:00
Rohit Ghumare ebd26b7c84 docs: fix agent count 32→45 in package READMEs 2026-04-11 20:25:13 +01:00
Rohit Ghumare 8ec5b9d8f2 Add progressive disclosure tools (skillkit_catalog, skillkit_load, skillkit_resource) to MCP server
Three new tools for token-efficient local skill access:
- skillkit_catalog (L1): lightweight catalog of installed skills (~50 tokens/skill)
- skillkit_load (L2): full SKILL.md content for a single skill
- skillkit_resource (L3): specific reference file with path traversal protection

Bumps server version to 1.21.0. Adds 14 new tests (18 total).
2026-04-11 20:24:20 +01:00
Rohit Ghumare 0cba1be49c docs: update package READMEs to 45 agents with full agent table 2026-04-11 19:10:19 +01:00
Rohit Ghumare 9f0eabc876 chore: bump version to 1.21.0 2026-04-11 16:27:20 +01:00
Rohit Ghumare ceeae304b5 Merge pull request #105 from rohitg00/feat/infra-v1.21
feat: trust levels, checksum updates, lock.json, custom taps
2026-04-11 16:26:17 +01:00
Rohit Ghumare bb97e9b747 docs: update agent count to 45, add v1.21.0 feature docs
- Fix "44 agents" → "45 agents" across 34 files (website, docs,
  package.json, tests, extension, API, TUI)
- README: add tap, check, update, publish submit to commands section
- Commands.tsx: add Sources category with tap commands, update manage
  group with remove --source/--all and check
- commands.mdx: full docs for tap, check, update, remove, publish
  submit with all new flags and behaviors
- configuration.mdx: document lock.json and taps.json
- security.mdx: document trust badges system
2026-04-11 14:09:58 +01:00
Rohit Ghumare 8b4f207fa1 fix: gate official badge on GitHub provider type 2026-04-11 13:56:26 +01:00
Rohit Ghumare c533d6f3bc fix: respect --no-federated flag to disable GitHub search 2026-04-11 13:52:02 +01:00
Rohit Ghumare e7dbaeb2b3 fix: standalone path in lock, sync lock on update, honor --force
- install: use actual installed path (handles .md files) for lock
  entry and results instead of reconstructing from skillName
- update: call addSkillToLock after both local and remote updates
  so lock.json stays in sync with metadata
- update: --force bypasses GitHub activity and checksum skip-checks
- update: timestamp comparison falls back to installedAt when
  updatedAt is not set
2026-04-11 13:46:28 +01:00
Rohit Ghumare 05b566c0df fix: address Devin and CodeRabbit review findings
- Use finally for temp cleanup so user cancels don't leak cloned dirs
- Move addSkillToLock outside inner agent loop, merge agents array
- Use source:name as lock key to avoid cross-source collisions
- Gate GitHub activity check on provider.type (skip for GitLab/Bitbucket)
- Normalize source URL to owner/repo before official check
- Include skill name in trust badge output
- Atomic lock.json writes via tmp file + renameSync
- Remove stale --federated suggestion from find no-results message
2026-04-11 13:36:07 +01:00
Rohit Ghumare 56c565bc65 feat: add user-level custom taps for skill sources
Introduce tap add/remove/list commands to manage custom skill sources
stored in ~/.skillkit/taps.json. Taps are included in find/search
results, allowing users to add private or community repositories.
2026-04-11 11:52:46 +01:00
Rohit Ghumare b4582c465d feat: add centralized lock.json for installed skill tracking
Introduce ~/.skillkit/lock.json with LockEntry/LockFile schemas to
track all installed skills in a single file. Install writes entries,
remove deletes them. Enables future team sync and reproducible setups.
2026-04-11 11:50:17 +01:00
Rohit Ghumare d929fe3af0 feat: add checksum-based change detection for skill updates
Compute SHA-256 checksum of SKILL.md on install and store in metadata.
During update, check GitHub pushedAt timestamp and compare checksums
to skip unnecessary re-downloads when content hasn't changed.
2026-04-11 11:49:05 +01:00
Rohit Ghumare 696db60cb4 feat: add trust level badges during install confirmation
Show trust badges for each skill during install: [Official] for known
official sources (Anthropic, Vercel, Expo, Remotion, Supabase, Stripe),
or [Trusted]/[Review]/[Caution] based on TrustScorer analysis.
2026-04-11 11:47:41 +01:00
Rohit Ghumare da14f329fd feat: quarantine cleanup on failure, federated search by default
- Hoist cloneResult above try block so catch can clean up temp dir
  on any failure path, not just the happy path
- Always include GitHub API in find search results (was behind
  --federated flag, now default)
2026-04-11 11:45:03 +01:00
Rohit Ghumare dc3f9ba330 Merge pull request #104 from rohitg00/feat/publish-check-stats
feat: direct publish, GitHub API update detection, quality scores
2026-04-11 11:27:34 +01:00
Rohit Ghumare 4206b8aab1 fix: prevent command injection in auto-publish workflow
- Pass all user-controlled values via env vars instead of
  interpolating ${{ outputs.* }} into inline scripts
- Fix operator precedence bug: entry.source || (owner && repo ? ...)
- Use --body-file instead of heredocs with interpolated values
- Quote all variable references in shell commands
2026-04-11 10:56:33 +01:00
Rohit Ghumare a4540c5fc1 simplify: extract timeAgo and fetchGitHubActivity to shared helpers 2026-04-11 10:50:59 +01:00
Rohit Ghumare 8cfae7e105 feat: auto-publish workflow for skill submissions and add HermesHub source
Add .github/workflows/auto-publish.yml that triggers on skill-submission
labeled issues, extracts JSON from issue body, validates the source repo
exists, runs security scanner and quality evaluation, then auto-merges
passing submissions (score >= 75) or flags them for manual review.

Add NousResearch/hermes-agent to marketplace/sources.json as a federated
search source for Hermes agent skills.
2026-04-11 10:45:44 +01:00
Rohit Ghumare f2183b8e14 feat: direct publish via gh CLI, GitHub API update detection, quality scores
publish submit:
- Runs quality eval + security scan before submission
- Shows quality badge, stars, last push date, and warnings
- Creates issue directly via gh CLI (no browser needed)
- Falls back to manual URL if gh is not installed/authenticated
- Issue body includes quality score, stars, and push date

check:
- Fetches pushed_at from GitHub API for real update detection
- Shows quality badges next to skill names
- Shows stars and push date in verbose mode
- Displays average quality score across all skills
2026-04-11 10:36:29 +01:00
Rohit Ghumare 573bbbeed7 Update README.md 2026-04-11 00:30:03 +01:00
Rohit Ghumare 7003fd3372 docs: add comparison video, update README for v1.20.0
- Add skills-vs-skillkit.mp4 comparison video
- Update agent count from 44 to 45
- Add remove --source/--all to commands section
- Add v1.20.0 callout (live progress, sparse checkout, bulk remove)
2026-04-11 00:25:59 +01:00
Rohit Ghumare c611e70764 fix: bump version in docs packages to 1.20.0 2026-04-10 22:12:40 +01:00
Rohit Ghumare 73f95c0b6e chore: bump version to 1.20.0 2026-04-10 22:11:44 +01:00
Rohit Ghumare 25556d15d9 Merge pull request #103 from rohitg00/feat/clone-progress-sparse
feat: live clone progress + sparse checkout for large repos
2026-04-10 22:10:41 +01:00
Rohit Ghumare dfa8d12c65 Merge pull request #100 from rohitg00/fix/audit-batch-3
fix: complete chalk→onboarding migration, refactor install.ts
2026-04-07 19:58:50 +01:00
159 changed files with 4633 additions and 4429 deletions
+87
View File
@@ -0,0 +1,87 @@
# SkillKit GitHub Action
A reusable composite action to install, scan, and manage AI agent skills in CI/CD pipelines.
## Usage
```yaml
# Install skills
- uses: rohitg00/skillkit/.github/actions/skillkit@main
with:
command: install
source: anthropics/skills
# Security scan
- uses: rohitg00/skillkit/.github/actions/skillkit@main
with:
command: scan
source: ./skills
# Check for updates
- uses: rohitg00/skillkit/.github/actions/skillkit@main
with:
command: check
```
## Inputs
| Input | Description | Required | Default |
|-------|-------------|----------|---------|
| `command` | SkillKit command to run (`install`, `scan`, `check`, `sync`) | Yes | |
| `source` | Skill source for install (e.g. `owner/repo`) | No | |
| `args` | Additional arguments | No | `''` |
| `node-version` | Node.js version | No | `20` |
| `agent` | Target agent (e.g. `claude-code`, `cursor`) | No | `claude-code` |
## Examples
### Install and sync skills
```yaml
jobs:
setup-skills:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: rohitg00/skillkit/.github/actions/skillkit@main
with:
command: install
source: anthropics/skills
agent: cursor
- uses: rohitg00/skillkit/.github/actions/skillkit@main
with:
command: sync
```
### Security scan on PR
```yaml
jobs:
scan-skills:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: rohitg00/skillkit/.github/actions/skillkit@main
with:
command: scan
source: ./skills
args: '--fail-on high'
```
### Check for updates
```yaml
jobs:
check-updates:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: rohitg00/skillkit/.github/actions/skillkit@main
with:
command: check
args: '--json'
```
+65
View File
@@ -0,0 +1,65 @@
name: 'SkillKit'
description: 'Install, scan, and manage AI agent skills in CI/CD'
inputs:
command:
description: 'SkillKit command to run (install, scan, check, sync)'
required: true
source:
description: 'Skill source for install (e.g. owner/repo)'
required: false
args:
description: 'Additional arguments'
required: false
default: ''
node-version:
description: 'Node.js version'
required: false
default: '20'
agent:
description: 'Target agent (e.g. claude-code, cursor)'
required: false
default: 'claude-code'
runs:
using: 'composite'
steps:
- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: ${{ inputs.node-version }}
- name: Install SkillKit
shell: bash
run: npm install -g skillkit@latest
- name: Run SkillKit
shell: bash
env:
SK_COMMAND: ${{ inputs.command }}
SK_SOURCE: ${{ inputs.source }}
SK_AGENT: ${{ inputs.agent }}
SK_ARGS: ${{ inputs.args }}
run: |
case "${SK_COMMAND}" in
install)
if [ -n "${SK_SOURCE}" ]; then
skillkit install "${SK_SOURCE}" --agent "${SK_AGENT}" --yes --json ${SK_ARGS}
else
echo "Error: source is required for install" >&2; exit 1
fi
;;
scan)
if [ -n "${SK_SOURCE}" ]; then
skillkit scan "${SK_SOURCE}" --json ${SK_ARGS}
else
echo "Error: source is required for scan" >&2; exit 1
fi
;;
check|sync|list|update)
skillkit "${SK_COMMAND}" ${SK_ARGS}
;;
*)
echo "Error: unsupported command '${SK_COMMAND}'. Use: install, scan, check, sync, list, update" >&2
exit 1
;;
esac
+324
View File
@@ -0,0 +1,324 @@
name: Auto-Publish Skill Submission
on:
issues:
types: [labeled]
permissions:
issues: write
contents: write
concurrency:
group: auto-publish-${{ github.event.issue.number }}
cancel-in-progress: false
jobs:
auto-publish:
if: github.event.label.name == 'skill-submission'
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Install pnpm
uses: pnpm/action-setup@v4
- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: '20'
cache: 'pnpm'
- name: Install dependencies
run: pnpm install --frozen-lockfile
- name: Build
run: pnpm build
- name: Extract and validate submission
id: validate
uses: actions/github-script@v7
env:
ISSUE_BODY: ${{ github.event.issue.body }}
with:
script: |
const { execSync } = require('child_process');
const fs = require('fs');
const path = require('path');
const body = process.env.ISSUE_BODY || '';
const jsonMatch = body.match(/```json\s*\n([\s\S]*?)\n```/);
if (!jsonMatch) {
core.setOutput('status', 'error');
core.setOutput('message', 'No JSON block found in issue body. Please include your source entry between \\`\\`\\`json and \\`\\`\\` fences.');
return;
}
let entry;
try {
entry = JSON.parse(jsonMatch[1].trim());
} catch (e) {
core.setOutput('status', 'error');
core.setOutput('message', `Invalid JSON in submission: ${e.message}`);
return;
}
const source = entry.source || (entry.owner && entry.repo ? `${entry.owner}/${entry.repo}` : null);
const name = entry.name;
const description = entry.description || '';
if (!source || !name) {
core.setOutput('status', 'error');
core.setOutput('message', 'Missing required fields. JSON must include `source` (owner/repo) and `name`.');
return;
}
const parts = source.split('/');
if (parts.length !== 2 || !parts[0] || !parts[1]) {
core.setOutput('status', 'error');
core.setOutput('message', `Invalid source format "${source}". Must be "owner/repo".`);
return;
}
const [owner, repo] = parts;
const sourcesData = JSON.parse(fs.readFileSync('marketplace/sources.json', 'utf-8'));
const existing = sourcesData.sources.find(s => s.source === source);
if (existing) {
core.setOutput('status', 'error');
core.setOutput('message', `Source "${source}" already exists in sources.json as "${existing.name}".`);
return;
}
try {
const repoCheck = await github.rest.repos.get({ owner, repo });
if (repoCheck.status !== 200) throw new Error('not found');
} catch (e) {
core.setOutput('status', 'error');
core.setOutput('message', `Repository "${source}" does not exist or is not accessible on GitHub.`);
return;
}
const cloneDir = `/tmp/skill-check-${owner}-${repo}`;
try {
execSync(`git clone --depth 1 https://github.com/${owner}/${repo}.git ${cloneDir}`, {
timeout: 60000,
stdio: 'pipe',
});
} catch (e) {
core.setOutput('status', 'error');
core.setOutput('message', `Failed to clone repository "${source}".`);
return;
}
let scanVerdict = 'pass';
let scanSummary = '';
let qualityScore = 0;
let qualitySummary = '';
try {
const scanScript = `
const { SkillScanner } = require('./packages/core/dist/scanner/scanner.js');
const scanner = new SkillScanner();
scanner.scan('${cloneDir}').then(result => {
console.log(JSON.stringify({
verdict: result.verdict,
stats: result.stats,
findings: result.findings.length,
}));
});
`;
const scanOutput = execSync(`node -e "${scanScript.replace(/\n/g, ' ')}"`, {
cwd: process.cwd(),
timeout: 30000,
stdio: 'pipe',
}).toString().trim();
const scanResult = JSON.parse(scanOutput);
scanVerdict = scanResult.verdict;
scanSummary = `Verdict: ${scanResult.verdict}, Findings: ${scanResult.findings}, Critical: ${scanResult.stats.critical}, High: ${scanResult.stats.high}`;
} catch (e) {
scanSummary = 'Scanner completed with warnings';
}
const skillMdCandidates = ['SKILL.md', 'skill.md', 'README.md'];
let skillContent = null;
for (const candidate of skillMdCandidates) {
try {
const found = execSync(`find ${cloneDir} -name "${candidate}" -maxdepth 3 -type f`, {
stdio: 'pipe',
}).toString().trim().split('\n').filter(Boolean);
if (found.length > 0) {
skillContent = fs.readFileSync(found[0], 'utf-8');
break;
}
} catch {}
}
if (skillContent) {
try {
const qualityScript = `
const { evaluateSkillContent } = require('./packages/core/dist/quality/index.js');
const fs = require('fs');
const content = fs.readFileSync('${cloneDir}/.skill-content.tmp', 'utf-8');
const result = evaluateSkillContent(content);
console.log(JSON.stringify({ overall: result.overall, warnings: result.warnings }));
`;
fs.writeFileSync(`${cloneDir}/.skill-content.tmp`, skillContent);
const qualityOutput = execSync(`node -e "${qualityScript.replace(/\n/g, ' ')}"`, {
cwd: process.cwd(),
timeout: 30000,
stdio: 'pipe',
}).toString().trim();
const qualityResult = JSON.parse(qualityOutput);
qualityScore = qualityResult.overall;
qualitySummary = `Score: ${qualityResult.overall}/100, Warnings: ${qualityResult.warnings.length}`;
} catch (e) {
qualityScore = 50;
qualitySummary = 'Quality evaluation encountered an error; defaulting to 50';
}
} else {
qualityScore = 50;
qualitySummary = 'No SKILL.md or README.md found; defaulting to score 50';
}
const scanPassed = scanVerdict !== 'fail';
const qualityPassed = qualityScore >= 75;
core.setOutput('source', source);
core.setOutput('name', name);
core.setOutput('description', description);
core.setOutput('official', entry.official === true ? 'true' : 'false');
core.setOutput('scan_verdict', scanVerdict);
core.setOutput('scan_summary', scanSummary);
core.setOutput('quality_score', String(qualityScore));
core.setOutput('quality_summary', qualitySummary);
if (scanPassed && qualityPassed) {
core.setOutput('status', 'pass');
core.setOutput('message', `Validation passed. Security: ${scanSummary}. Quality: ${qualitySummary}.`);
} else {
const reasons = [];
if (!scanPassed) reasons.push(`Security scan failed: ${scanSummary}`);
if (!qualityPassed) reasons.push(`Quality score ${qualityScore}/100 is below threshold of 75`);
core.setOutput('status', 'reject');
core.setOutput('message', reasons.join('. '));
}
- name: Add source and commit
if: steps.validate.outputs.status == 'pass'
env:
SKILL_SOURCE: ${{ steps.validate.outputs.source }}
SKILL_NAME: ${{ steps.validate.outputs.name }}
SKILL_DESCRIPTION: ${{ steps.validate.outputs.description }}
ISSUE_NUMBER: ${{ github.event.issue.number }}
run: |
node -e "
const fs = require('fs');
const data = JSON.parse(fs.readFileSync('marketplace/sources.json', 'utf-8'));
const newEntry = { source: process.env.SKILL_SOURCE, name: process.env.SKILL_NAME };
if (process.env.SKILL_DESCRIPTION) {
newEntry.description = process.env.SKILL_DESCRIPTION;
}
const skillsSh = data.sources.pop();
data.sources.push(newEntry);
if (skillsSh && skillsSh.registry === 'skills-sh') {
data.sources.push(skillsSh);
}
data.updatedAt = new Date().toISOString().split('T')[0];
fs.writeFileSync('marketplace/sources.json', JSON.stringify(data, null, 2) + '\n');
"
git config --local user.email "github-actions[bot]@users.noreply.github.com"
git config --local user.name "github-actions[bot]"
git add marketplace/sources.json
git commit -m "feat(marketplace): add source from #${ISSUE_NUMBER}"
git push
- name: Close issue on success
if: steps.validate.outputs.status == 'pass'
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
SKILL_SOURCE: ${{ steps.validate.outputs.source }}
SKILL_NAME: ${{ steps.validate.outputs.name }}
SCAN_SUMMARY: ${{ steps.validate.outputs.scan_summary }}
QUALITY_SUMMARY: ${{ steps.validate.outputs.quality_summary }}
ISSUE_NUMBER: ${{ github.event.issue.number }}
run: |
cat > /tmp/comment.md <<ENDOFCOMMENT
**Skill source auto-published!**
**Source:** \`${SKILL_SOURCE}\`
**Name:** ${SKILL_NAME}
**Security:** ${SCAN_SUMMARY}
**Quality:** ${QUALITY_SUMMARY}
The source has been added to \`marketplace/sources.json\` and will be included in the next release.
ENDOFCOMMENT
gh issue comment "${ISSUE_NUMBER}" --body-file /tmp/comment.md
gh issue close "${ISSUE_NUMBER}"
- name: Comment rejection reason
if: steps.validate.outputs.status == 'reject'
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
REJECT_MESSAGE: ${{ steps.validate.outputs.message }}
SCAN_VERDICT: ${{ steps.validate.outputs.scan_verdict }}
SCAN_SUMMARY: ${{ steps.validate.outputs.scan_summary }}
QUALITY_SCORE: ${{ steps.validate.outputs.quality_score }}
QUALITY_SUMMARY: ${{ steps.validate.outputs.quality_summary }}
ISSUE_NUMBER: ${{ github.event.issue.number }}
run: |
cat > /tmp/comment.md <<ENDOFCOMMENT
**Skill submission did not pass automated checks.**
${REJECT_MESSAGE}
**Details:**
- Security scan: ${SCAN_VERDICT} (${SCAN_SUMMARY})
- Quality score: ${QUALITY_SCORE}/100 (${QUALITY_SUMMARY})
Please address these issues and update your submission. A maintainer will review manually.
ENDOFCOMMENT
gh issue comment "${ISSUE_NUMBER}" --body-file /tmp/comment.md
gh issue edit "${ISSUE_NUMBER}" --add-label "needs-review"
- name: Comment parse error
if: steps.validate.outputs.status == 'error'
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
ERROR_MESSAGE: ${{ steps.validate.outputs.message }}
ISSUE_NUMBER: ${{ github.event.issue.number }}
run: |
cat > /tmp/comment.md <<'ENDOFCOMMENT'
**Could not process skill submission.**
ENDOFCOMMENT
echo "${ERROR_MESSAGE}" >> /tmp/comment.md
cat >> /tmp/comment.md <<'ENDOFCOMMENT'
**Expected format in issue body:**
```json
{
"source": "owner/repo",
"name": "Display Name",
"description": "Optional description"
}
```
Please update the issue body and re-apply the `skill-submission` label.
ENDOFCOMMENT
gh issue comment "${ISSUE_NUMBER}" --body-file /tmp/comment.md
gh issue edit "${ISSUE_NUMBER}" --add-label "needs-review"
+24
View File
@@ -0,0 +1,24 @@
# Changelog
All notable changes to SkillKit are documented here. Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versions use [Semantic Versioning](https://semver.org/).
## [Unreleased]
### Added
- **Skill integrity verification (`skillkit verify`).** New command computes a deterministic SHA-256 over every file in a skill (excluding metadata, VCS, and editor artifacts) and emits the result as a Subresource Integrity string (`sha256-<base64>`). Supports:
- `--expected <sri|hex>` to verify against a known publisher digest
- `--against-lock` to verify against the local `~/.skillkit/lock.json` entry
- `--files` to dump per-file digests
- `--json` for CI pipelines
- **`computeSkillIntegrity` / `verifySkillIntegrity`** exported from `@skillkit/core` for programmatic use.
- **`integrity` field** in `WellKnownSkill` index. `skillkit publish` now records a full SRI digest for each published skill alongside the file list.
- **Lockfile records full integrity.** `skillkit install` and `skillkit update` now persist the full SRI digest to `~/.skillkit/lock.json` (with graceful fallback to the legacy short checksum when integrity computation fails).
- Phase 1 of supply-chain integrity (issue #90). Phase 2 (ed25519 signing + publisher key registry) tracked separately.
### Tests
- 11 unit tests for the integrity module (`packages/core/src/integrity/__tests__/integrity.test.ts`).
- 5 CLI end-to-end tests for `skillkit verify` (`packages/cli/src/__tests__/verify.test.ts`).
## [1.24.0] - 2026-04-XX
See [GitHub releases](https://github.com/rohitg00/skillkit/releases) for prior history.
+328 -177
View File
@@ -3,106 +3,220 @@
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/img/banner.svg">
<source media="(prefers-color-scheme: light)" srcset="docs/img/banner.svg">
<img alt="SkillKit - One Skill. Every Agent." src="docs/img/banner.svg" width="100%">
<img alt="SkillKit. One skill. Every agent." src="docs/img/banner.svg" width="100%">
</picture>
<br/>
### *One skill. Every agent. 46 of them.*
<br/>
[![CI](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml/badge.svg)](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
[![npm version](https://img.shields.io/npm/v/skillkit.svg?style=flat-square&color=3b82f6)](https://www.npmjs.com/package/skillkit)
[![npm downloads](https://img.shields.io/npm/dm/skillkit.svg?style=flat-square)](https://www.npmjs.com/package/skillkit)
[![GitHub stars](https://img.shields.io/github/stars/rohitg00/skillkit?style=flat-square)](https://github.com/rohitg00/skillkit/stargazers)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg?style=flat-square)](https://opensource.org/licenses/Apache-2.0)
[![npm](https://img.shields.io/npm/v/skillkit?style=for-the-badge&logo=npm&logoColor=white&labelColor=0D1117&color=CB3837)](https://www.npmjs.com/package/skillkit)
[![downloads](https://img.shields.io/npm/dm/skillkit?style=for-the-badge&logo=npm&logoColor=white&labelColor=0D1117&color=FF8B94)](https://www.npmjs.com/package/skillkit)
[![stars](https://img.shields.io/github/stars/rohitg00/skillkit?style=for-the-badge&logo=github&logoColor=white&labelColor=0D1117&color=FFC75F)](https://github.com/rohitg00/skillkit/stargazers)
[![CI](https://img.shields.io/github/actions/workflow/status/rohitg00/skillkit/ci.yml?style=for-the-badge&logo=githubactions&logoColor=white&labelColor=0D1117&color=6BCB77)](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
[![license](https://img.shields.io/badge/License-Apache_2.0-4D96FF?style=for-the-badge&labelColor=0D1117)](LICENSE)
**SkillKit** is the open source package manager for AI agent skills. Write a skill once, deploy it to **44 agents** — Claude, Cursor, Copilot, Windsurf, Devin, Codex, and 38 more. No rewrites. 400K+ skills across registries.
[Website](https://skillkit.sh) &middot; [Docs](https://skillkit.sh/docs) &middot; [API Explorer](https://skillkit.sh/api) &middot; [Chrome Extension](https://github.com/rohitg00/skillkit/tree/main/packages/extension#readme) &middot; [npm](https://www.npmjs.com/package/skillkit)
<a href="https://skillkit.sh"><img src="assets/tags/skills.svg" alt="400K+ skills"></a>
<a href="#supported-agents"><img src="assets/tags/agents.svg" alt="46 agents"></a>
<a href="#skill-sources"><img src="assets/tags/sources.svg" alt="31 sources"></a>
<img src="assets/tags/tests.svg" alt="757 tests">
<a href="LICENSE"><img src="assets/tags/license.svg" alt="Apache 2.0"></a>
<a href="CONTRIBUTING.md"><img src="assets/tags/prs-welcome.svg" alt="PRs welcome"></a>
<a href="#full-vs-slim"><img src="assets/tags/slim-install.svg" alt="slim install"></a>
<a href="https://github.com/rohitg00/skillkit/releases/latest"><img src="assets/tags/v1.24.0.svg" alt="v1.24.0"></a>
<img src="assets/tags/new.svg" alt="new">
<img src="assets/tags/one-skill.svg" alt="one skill">
<img src="assets/tags/every-agent.svg" alt="every agent">
### Quick nav
[**Quick start**](#quick-start) · [**Install**](#install) · [**Commands**](#commands) · [**Agents**](#supported-agents) · [**Sources**](#skill-sources) · [**API**](#programmatic-api) · [**Website**](https://skillkit.sh)
</div>
---
Skills make AI coding agents smarter. But every agent uses a different format:
| Agent | Format | Directory |
|-------|--------|-----------|
| Claude Code | `SKILL.md` | `.claude/skills/` |
| Cursor | `.mdc` | `.cursor/skills/` |
| Copilot | Markdown | `.github/skills/` |
| Windsurf | Markdown | `.windsurf/skills/` |
You end up rewriting the same skill for each agent, or locking into one platform.
**SkillKit fixes this.** Install from 400K+ skills across registries, auto-translate between formats, persist learnings with Memory. Works with Claude, Cursor, Windsurf, Copilot, and 40 more.
```bash
npx skillkit@latest
```
## See It In Action
<div align="center">
[![Watch the demo](docs/img/inital-command.png)](https://raw.githubusercontent.com/rohitg00/skillkit/main/docs/video/skillkit.mp4)
*Click the image above to watch the full demo*
https://github.com/user-attachments/assets/b1843a07-2c54-422d-8903-f30a790cfb37
</div>
## Quick Start
## The problem
Every AI coding agent wants skills. Every agent invented a different format.
<table>
<tr>
<th>Agent</th>
<th>Format</th>
<th>Directory</th>
</tr>
<tr><td>Claude Code</td><td><code>SKILL.md</code></td><td><code>.claude/skills/</code></td></tr>
<tr><td>Cursor</td><td><code>.mdc</code></td><td><code>.cursor/skills/</code></td></tr>
<tr><td>Copilot</td><td>Markdown</td><td><code>.github/skills/</code></td></tr>
<tr><td>Windsurf</td><td>Markdown</td><td><code>.windsurf/skills/</code></td></tr>
<tr><td colspan="3"><i>... 41 more</i></td></tr>
</table>
You rewrite the same skill for each agent. Or you lock in to one.
## The fix
SkillKit is the package manager for AI agent skills. Install from 400K+ skills across 31 sources. Auto-translate between formats. Persist session learnings. Ship to 46 agents at once.
```bash
npx skillkit@latest init # Detect agents, create dirs
skillkit recommend # Get smart suggestions
skillkit install anthropics/skills # Install from marketplace
skillkit sync # Deploy to your agents
npx skillkit add anthropics/skills
```
Four commands. Your agents now have skills for PDF processing, code review, and more.
That is the whole first-run. Pick your agent (your detected agent is pre-selected), confirm, done.
## What Can You Do?
### Install skills from anywhere
## Quick start
```bash
skillkit install anthropics/skills # GitHub
skillkit install gitlab:team/skills # GitLab
skillkit install ./my-local-skills # Local path
npx skillkit init # detect agent, create dirs
skillkit recommend # stack-aware suggestions
skillkit add anthropics/skills # install from marketplace
skillkit sync # deploy to agent config
```
### Translate between agents
Four commands. Your agent now has PDF processing, code review, auth patterns, and whatever you need.
Write for Claude, deploy to Cursor:
### What the first install looks like
```
$ npx skillkit add anthropics/skills
◇ Detected 32 agents
│
◆ Install to
│ ● Just Claude Code (detected) claude-code
│ ○ Select specific agents space to toggle
│ ○ All supported agents 32 agents, writes to every adapter
└
◇ Cloning anthropics/skills
◇ Security scan: 42/42 skills pass
◇ Installed 42 skills to Claude Code
│
└ Done in 3.1s. Run `skillkit list` to see them.
```
## Install
Pick one. All three do the same thing.
```bash
npm install -g skillkit # npm
pnpm add -g skillkit # pnpm
bun add -g skillkit # bun
```
Both `skillkit` and `sk` work as the binary name.
### Full vs slim
Four features ship as optional packages so a bare CLI stays small. The default install pulls everything. Add `--omit=optional` if you only want the core.
| Feature | Package | Command |
| :-------------- | :--------------------- | :--------------- |
| Terminal UI | `@skillkit/tui` | `skillkit ui` |
| REST server | `@skillkit/api` | `skillkit serve` |
| Peer mesh | `@skillkit/mesh` | `skillkit mesh` |
| Agent messaging | `@skillkit/messaging` | `skillkit message` |
Cold install numbers on a fresh npm cache:
<p align="center">
<img src="assets/tags/packages.svg" alt="118 packages">
<img src="assets/tags/install.svg" alt="9s install">
<img src="assets/tags/vulns.svg" alt="0 vulnerabilities">
</p>
| Mode | Packages | Time | Vulns (crit/high) |
| :---------------------------------- | -------: | :--: | ----------------: |
| `npm i -g skillkit` | 418 | 18s | 0/0 |
| `npm i -g skillkit --omit=optional` | 118 | 9s | 0/0 |
Skipped optional? Add just the one you want later:
```bash
npm i -g @skillkit/tui # enables: skillkit ui
npm i -g @skillkit/api # enables: skillkit serve
npm i -g @skillkit/mesh # enables: skillkit mesh
npm i -g @skillkit/messaging # enables: skillkit message
```
The CLI catches missing optional packages and prints a one-line hint. No stack trace.
### Using `npx`
`npx skillkit add <owner/repo>` works with zero install. First call caches the package under `~/.npm/_npx/`. Every run after that is instant until a new version ships.
```bash
npx skillkit add anthropics/skills # full
npx --omit=optional skillkit add anthropics/skills # slim
```
If you reach for `npx skillkit` more than twice, switch to a global install. Kills the prompt-to-proceed and the per-release refetch.
## What you can do
<details open>
<summary><b>Install from anywhere</b></summary>
```bash
skillkit add anthropics/skills # GitHub
skillkit add gitlab:team/skills # GitLab
skillkit add ./my-local-skills # local path
skillkit add https://gist.github.com/... # gist
```
</details>
<details>
<summary><b>Translate between agents</b></summary>
Write once for Claude, ship everywhere:
```bash
skillkit translate my-skill --to cursor
skillkit translate --all --to windsurf
skillkit translate --all --to windsurf,codex
skillkit translate my-skill --to copilot --dry-run
```
</details>
### Get smart recommendations
<details>
<summary><b>Stack-aware recommendations</b></summary>
SkillKit reads your project, detects your stack, and suggests relevant skills:
SkillKit reads your repo, spots your stack, ranks skills:
```bash
skillkit recommend
# 92% vercel-react-best-practices
# 87% tailwind-v4-patterns
# 85% nextjs-app-router
$ skillkit recommend
92% vercel-react-best-practices
87% tailwind-v4-patterns
85% nextjs-app-router
81% shadcn-ui-components
```
</details>
### Discover skills at runtime
<details>
<summary><b>Runtime skill discovery (REST)</b></summary>
Start an API server and let agents find skills on demand:
Start the server, let agents fetch skills on demand:
```bash
skillkit serve
# Server running at http://localhost:3737
# http://localhost:3737
curl "http://localhost:3737/search?q=react+performance"
```
Or use MCP for native agent integration:
Or wire it up with MCP:
```json
{
@@ -112,11 +226,7 @@ Or use MCP for native agent integration:
}
```
Or use Python:
```bash
pip install skillkit-client
```
Or call from Python:
```python
from skillkit import SkillKitClient
@@ -125,53 +235,47 @@ async with SkillKitClient() as client:
results = await client.search("react performance", limit=5)
```
[REST API docs](https://skillkit.sh/docs/rest-api) &middot; [MCP Server docs](https://skillkit.sh/docs/mcp-server) &middot; [Python Client docs](https://skillkit.sh/docs/python-client) &middot; [Interactive API explorer](https://skillkit.sh/api)
[REST docs](https://skillkit.sh/docs/rest-api) · [MCP docs](https://skillkit.sh/docs/mcp-server) · [Python client](https://skillkit.sh/docs/python-client)
</details>
### Auto-generate agent instructions
<details>
<summary><b>Auto-generate agent instructions</b></summary>
Let SkillKit analyze your codebase and create CLAUDE.md, .cursorrules, etc.:
Analyze the codebase and write CLAUDE.md, `.cursorrules`, AGENTS.md, and friends:
```bash
skillkit primer --all-agents
```
</details>
### Session memory
<details>
<summary><b>Session memory</b></summary>
Your AI agents learn patterns during sessions, then forget everything. SkillKit captures those learnings:
AI agents learn during a session, then forget. SkillKit captures what they learned:
```bash
skillkit memory compress
skillkit memory search "auth patterns"
skillkit memory export auth-patterns
```
</details>
### AI skill generation
<details>
<summary><b>AI skill generation</b></summary>
Generate skills from natural language with multi-source context:
Generate skills from plain English with multi-source context:
```bash
skillkit generate
# Interactive wizard with 4 context sources:
# - Documentation (via Context7)
# - Your codebase patterns
# - 400K+ marketplace skills
# - Memory (your corrections)
```
Works with any LLM: Claude, GPT-4, Gemini, Ollama (local), or OpenRouter (100+ models). Generates agent-optimized variants with trust scores.
Pulls context from four places: Context7 docs, your codebase, 400K marketplace skills, your memory. Works with Claude, GPT-4, Gemini, Ollama (local), or any OpenRouter model.
</details>
### Mesh network
<details>
<summary><b>Team collaboration</b></summary>
Distribute agents across machines with encrypted P2P:
```bash
skillkit mesh init
skillkit mesh discover
```
### Team collaboration
Share skills via a Git-committable `.skills` manifest:
Share skills via a committable `.skills` manifest:
```bash
skillkit manifest init
@@ -179,112 +283,159 @@ skillkit manifest add anthropics/skills
git commit -m "add team skills"
```
Team members run `skillkit manifest install` and they're in sync.
Everyone else runs `skillkit manifest install` and matches state.
</details>
### Chrome Extension
<details>
<summary><b>Mesh network</b></summary>
Save any webpage as a skill directly from your browser.
Distribute agents across machines with encrypted P2P:
1. Build: `pnpm --filter @skillkit/extension build`
2. Chrome → `chrome://extensions` → Load unpacked → `packages/extension/dist/`
3. Click the extension icon or right-click → "Save page as Skill"
```bash
skillkit mesh init
skillkit mesh discover
```
</details>
The extension sends the page URL to the SkillKit API for server-side extraction with Turndown, 5-source weighted tag detection, and GitHub URL support. The resulting SKILL.md downloads automatically. Then run `skillkit install ~/Downloads/skillkit-skills/my-skill` to deploy to all agents.
<details>
<summary><b>Chrome extension</b></summary>
Save any webpage as a skill from the browser. Click the extension, the page round-trips through the SkillKit API (Turndown, 5-source tag detection, GitHub URL support), the `SKILL.md` downloads, then run `skillkit add ~/Downloads/skillkit-skills/<name>`.
[Extension docs](https://skillkit.sh/docs/chrome-extension)
</details>
### Interactive TUI
<details>
<summary><b>Interactive TUI</b></summary>
```bash
skillkit ui
```
`h` Home &middot; `m` Marketplace &middot; `r` Recommend &middot; `t` Translate &middot; `i` Installed &middot; `s` Sync &middot; `q` Quit
<sub><code>h</code> home · <code>m</code> marketplace · <code>r</code> recommend · <code>t</code> translate · <code>i</code> installed · <code>s</code> sync · <code>q</code> quit</sub>
![SkillKit Interactive CLI](docs/img/inital-command.png)
<img src="docs/img/skillkit-ui.png" width="100%" alt="SkillKit interactive TUI">
## Supported Agents (44)
| Agent | Format | Directory |
|-------|--------|-----------|
| **Claude Code** | SKILL.md | `.claude/skills/` |
| **Cursor** | .mdc | `.cursor/skills/` |
| **Codex** | SKILL.md | `.codex/skills/` |
| **Gemini CLI** | SKILL.md | `.gemini/skills/` |
| **OpenCode** | SKILL.md | `.opencode/skills/` |
| **GitHub Copilot** | Markdown | `.github/skills/` |
| **Windsurf** | Markdown | `.windsurf/skills/` |
| **Devin** | Markdown | `.devin/skills/` |
| **Aider** | SKILL.md | `.aider/skills/` |
| **Sourcegraph Cody** | SKILL.md | `.cody/skills/` |
| **Amazon Q** | SKILL.md | `.amazonq/skills/` |
Plus 33 more: Amp, Antigravity, Augment Code, Bolt, Clawdbot, Cline, CodeBuddy, CodeGPT, CommandCode, Continue, Crush, Droid, Factory, Goose, Kilo Code, Kiro CLI, Lovable, MCPJam, Mux, Neovate, OpenHands, Pi, PlayCode, Qoder, Qwen, Replit Agent, Roo Code, Tabby, Tabnine, Trae, Vercel, Zencoder, Universal
[Full agent details](https://skillkit.sh/docs/agents)
</details>
## Commands
### Core
<details open>
<summary><b>Core</b></summary>
```bash
skillkit install <source> # Install skills
skillkit remove <skills> # Remove skills
skillkit translate <skill> --to # Translate between agents
skillkit sync # Deploy to agent config
skillkit recommend # Smart recommendations
skillkit generate # AI skill generation wizard
skillkit serve # Start REST API server
skillkit add <source> # install skills (live progress)
skillkit remove <skills> # remove
skillkit remove --source org/repo # bulk by source
skillkit remove --all # remove everything
skillkit update # update (change detection)
skillkit check # updates, quality, activity
skillkit translate <skill> --to # agent format conversion
skillkit sync # deploy to agent config
skillkit recommend # smart recommendations
skillkit generate # AI skill wizard
skillkit serve # REST API server
skillkit publish submit # publish to marketplace
```
</details>
### Discovery & Security
<details>
<summary><b>Discovery & security</b></summary>
```bash
skillkit marketplace # Browse skills
skillkit tree # Hierarchical taxonomy
skillkit find <query> # Quick search
skillkit scan <path> # Security scan for skills
skillkit marketplace # browse
skillkit tree # taxonomy
skillkit find <query> # quick search
skillkit scan <path> # security scan
skillkit verify <path> # SHA-256 integrity (SRI)
skillkit verify <path> --expected sha256-... # verify against published digest
skillkit verify <path> --against-lock # verify against ~/.skillkit/lock.json
```
</details>
### Issue Planner
<details>
<summary><b>Custom sources</b></summary>
```bash
skillkit issue plan "#42" # Plan from GitHub Issue
skillkit issue plan owner/repo#42 # Cross-repo plan
skillkit issue list # List open issues
skillkit tap add owner/repo
skillkit tap list
skillkit tap remove owner/repo
```
</details>
### Session Intelligence
<details>
<summary><b>Issue planner</b></summary>
```bash
skillkit timeline # Unified event stream
skillkit session handoff # Agent-to-agent context
skillkit lineage # Skill impact graph
skillkit session explain # Human-readable summary
skillkit activity # Skill activity log
skillkit issue plan "#42"
skillkit issue plan owner/repo#42
skillkit issue list
```
</details>
### Advanced
<details>
<summary><b>Session intelligence</b></summary>
```bash
skillkit primer --all-agents # Generate agent instructions
skillkit memory compress # Capture session learnings
skillkit mesh init # Multi-machine distribution
skillkit message send # Inter-agent messaging
skillkit workflow run <name> # Run workflows
skillkit test # Test skills
skillkit timeline # unified event stream
skillkit session handoff # agent-to-agent context
skillkit lineage # skill impact graph
skillkit session explain # human summary
skillkit activity # activity log
```
</details>
<details>
<summary><b>Advanced</b></summary>
```bash
skillkit primer --all-agents # agent instruction files
skillkit memory compress # capture session learnings
skillkit mesh init # multi-machine distribution
skillkit message send # inter-agent messaging
skillkit workflow run <name> # run workflows
skillkit test # test skills
skillkit cicd init # CI/CD templates
```
</details>
[Full command reference](https://skillkit.sh/docs/commands)
## Creating Skills
## Supported agents
<details open>
<summary><b>Top 11</b></summary>
| Agent | Format | Directory |
| :----------------- | :--------- | :----------------- |
| **Claude Code** | `SKILL.md` | `.claude/skills/` |
| **Cursor** | `.mdc` | `.cursor/skills/` |
| **Codex** | `SKILL.md` | `.codex/skills/` |
| **Gemini CLI** | `SKILL.md` | `.gemini/skills/` |
| **OpenCode** | `SKILL.md` | `.opencode/skills/`|
| **GitHub Copilot** | Markdown | `.github/skills/` |
| **Windsurf** | Markdown | `.windsurf/skills/`|
| **Devin** | Markdown | `.devin/skills/` |
| **Aider** | `SKILL.md` | `.aider/skills/` |
| **Cody** | `SKILL.md` | `.cody/skills/` |
| **Amazon Q** | `SKILL.md` | `.amazonq/skills/` |
</details>
<details>
<summary><b>Plus 35 more</b></summary>
Amp, Antigravity, Augment Code, Bolt, Clawdbot, Cline, CodeBuddy, CodeGPT, CommandCode, Continue, Crush, Droid, Factory, Goose, Hermes Agent, Kilo Code, Kiro CLI, Lovable, MCPJam, Mux, Neovate, OpenClaw, OpenHands, Pi, PlayCode, Qoder, Qwen, Replit Agent, Roo Code, Tabby, Tabnine, Trae, Vercel, Zencoder, Universal.
</details>
[Full agent details](https://skillkit.sh/docs/agents)
## Creating skills
```bash
skillkit create my-skill
```
Or manually create a `SKILL.md`:
Or author a `SKILL.md` by hand:
```markdown
---
@@ -295,20 +446,20 @@ license: MIT
# My Skill
Instructions for the AI agent.
Instructions for the agent.
## When to Use
- Scenario 1
- Scenario 2
## When to use
- scenario 1
- scenario 2
## Steps
1. First step
2. Second step
1. first
2. second
```
## Programmatic API
```typescript
```ts
import { translateSkill, analyzeProject, RecommendationEngine } from 'skillkit';
const skill = await translateSkill(content, 'cursor');
@@ -318,53 +469,53 @@ const engine = new RecommendationEngine();
const recs = await engine.recommend(profile);
```
```typescript
```ts
import { startServer } from '@skillkit/api';
await startServer({ port: 3737, skills: [...] });
```
```typescript
```ts
import { MemoryCache, RelevanceRanker } from '@skillkit/core';
const cache = new MemoryCache({ maxSize: 500, ttlMs: 86_400_000 });
const ranker = new RelevanceRanker();
const results = ranker.rank(skills, 'react performance');
```
## Skill Sources
## Skill sources
SkillKit aggregates skills from trusted sources. All original creators are credited with their licenses preserved.
All original creators credited. Licenses preserved. PRs welcome.
### Official Partners
### Official partners
| Repository | Description |
|------------|-------------|
| Repository | What |
|:-----------|:-----|
| [anthropics/skills](https://github.com/anthropics/skills) | Official Claude Code skills |
| [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | Next.js and React skills |
| [expo/skills](https://github.com/expo/skills) | Mobile development with Expo |
| [remotion-dev/skills](https://github.com/remotion-dev/skills) | Programmatic video creation |
| [supabase/agent-skills](https://github.com/supabase/agent-skills) | Database and auth skills |
| [stripe/ai](https://github.com/stripe/ai) | Payment integration patterns |
| [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | Next.js, React |
| [expo/skills](https://github.com/expo/skills) | Expo mobile |
| [remotion-dev/skills](https://github.com/remotion-dev/skills) | Programmatic video |
| [supabase/agent-skills](https://github.com/supabase/agent-skills) | Database, auth |
| [stripe/ai](https://github.com/stripe/ai) | Payments |
### Community
[trailofbits/skills](https://github.com/trailofbits/skills) &middot; [obra/superpowers](https://github.com/obra/superpowers) &middot; [wshobson/agents](https://github.com/wshobson/agents) &middot; [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) &middot; [travisvn/awesome-claude-skills](https://github.com/travisvn/awesome-claude-skills) &middot; [langgenius/dify](https://github.com/langgenius/dify) &middot; [better-auth/skills](https://github.com/better-auth/skills) &middot; [onmax/nuxt-skills](https://github.com/onmax/nuxt-skills) &middot; [elysiajs/skills](https://github.com/elysiajs/skills) &middot; [kadajett/agent-nestjs-skills](https://github.com/kadajett/agent-nestjs-skills) &middot; [cloudai-x/threejs-skills](https://github.com/cloudai-x/threejs-skills) &middot; [dimillian/skills](https://github.com/dimillian/skills) &middot; [waynesutton/convexskills](https://github.com/waynesutton/convexskills) &middot; [kepano/obsidian-skills](https://github.com/kepano/obsidian-skills) &middot; [giuseppe-trisciuoglio/developer-kit](https://github.com/giuseppe-trisciuoglio/developer-kit) &middot; [openrouterteam/agent-skills](https://github.com/openrouterteam/agent-skills)
[trailofbits/skills](https://github.com/trailofbits/skills) · [obra/superpowers](https://github.com/obra/superpowers) · [wshobson/agents](https://github.com/wshobson/agents) · [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) · [travisvn/awesome-claude-skills](https://github.com/travisvn/awesome-claude-skills) · [langgenius/dify](https://github.com/langgenius/dify) · [better-auth/skills](https://github.com/better-auth/skills) · [onmax/nuxt-skills](https://github.com/onmax/nuxt-skills) · [elysiajs/skills](https://github.com/elysiajs/skills) · [kadajett/agent-nestjs-skills](https://github.com/kadajett/agent-nestjs-skills) · [cloudai-x/threejs-skills](https://github.com/cloudai-x/threejs-skills) · [dimillian/skills](https://github.com/dimillian/skills) · [waynesutton/convexskills](https://github.com/waynesutton/convexskills) · [kepano/obsidian-skills](https://github.com/kepano/obsidian-skills) · [giuseppe-trisciuoglio/developer-kit](https://github.com/giuseppe-trisciuoglio/developer-kit) · [openrouterteam/agent-skills](https://github.com/openrouterteam/agent-skills)
**Want to add your skills?** [Submit your repository](https://github.com/rohitg00/skillkit/issues/new?template=add-source.md)
**Want your skills listed?** [Submit your repo](https://github.com/rohitg00/skillkit/issues/new?template=add-source.md).
## Install
## Contributing
```bash
npm install -g skillkit # npm
pnpm add -g skillkit # pnpm
yarn global add skillkit # yarn
bun add -g skillkit # bun
npx skillkit <command> # no install
```
Issues and PRs land fast. See [CONTRIBUTING.md](CONTRIBUTING.md) for the short version.
## License
Apache License 2.0 — see [LICENSE](LICENSE).
Apache 2.0. See [LICENSE](LICENSE).
## Links
<br/>
[Documentation](https://skillkit.sh/docs) &middot; [Website](https://skillkit.sh) &middot; [API Explorer](https://skillkit.sh/api) &middot; [npm](https://www.npmjs.com/package/skillkit) &middot; [GitHub](https://github.com/rohitg00/skillkit)
<div align="center">
[**Docs**](https://skillkit.sh/docs) · [**Website**](https://skillkit.sh) · [**API Explorer**](https://skillkit.sh/api) · [**npm**](https://www.npmjs.com/package/skillkit) · [**GitHub**](https://github.com/rohitg00/skillkit)
<sub>Built for agents. Written by humans.</sub>
</div>
+35
View File
@@ -0,0 +1,35 @@
# SOUL
## Core Truths
- Ship working software. Everything else is negotiable.
- Simple beats clever. If a junior dev can't read it in 30 seconds, it's too complex.
- Opinions are load-bearing. "It depends" is a cop-out 90% of the time. Pick a side, explain why, move on.
- Exhaustion before escalation. Try everything available before asking for help or giving up.
- Broken things get fixed now, not "in a follow-up PR."
- If the tests pass and the build is green, stop touching it.
## Boundaries
- Never leak secrets, credentials, or private data. Period.
- Ask before doing anything destructive or irreversible. One confirmation. Not three.
- Be honest about uncertainty. "I don't know" is a valid answer. Bullshitting is not.
- The user's codebase is their house. Don't rearrange the furniture without permission.
## Vibe
- Never open with "Great question," "I'd be happy to help," or "Absolutely." Just answer.
- Brevity is mandatory. If the answer fits in one sentence, one sentence is what you get.
- Humor is welcome when it's natural. Not forced puns. The kind of wit that comes from actually understanding the problem.
- Call things out. If you're about to do something dumb, I'll say so. Charm over cruelty, but no sugarcoating.
- Swearing is fine when it lands. A well-placed "that's fucking brilliant" hits different than sterile corporate praise. Don't force it. Don't overdo it. But if a situation calls for a "holy shit" — say holy shit.
- No hedging. No weasel words. No "it might be worth considering perhaps maybe." Say the thing.
- Match energy. Quick question gets a quick answer. Deep problem gets deep analysis. Read the room.
- Code speaks louder than explanations. Show, don't tell. Then shut up.
- Be the assistant you'd actually want to talk to at 2am. Not a corporate drone. Not a sycophant. Just... good.
## Continuity
- This file is a living document. If something stops being true, change it.
- Session memory is ephemeral. This file is how identity persists.
- If this file gets modified during a session, say so explicitly.
+42 -4
View File
@@ -1,11 +1,49 @@
# SkillKit
Universal skills manager for AI coding agents. Install, manage, and sync skills across 32 AI agents including Claude Code, Cursor, Codex, Gemini CLI, and more.
Universal skills manager for AI coding agents. Install, manage, and sync skills across 46 AI agents including Claude Code, Cursor, Codex, Gemini CLI, and more.
## Installation
```bash
# Full install (default) — every feature, everything works:
npm install -g skillkit
# Slim install — core commands only, ~75% smaller, no native addons:
npm install -g skillkit --omit=optional
```
### What's optional
Four power features ship as **optional dependencies** so the core CLI
stays lean. They install automatically with `npm install -g skillkit`,
and are skipped with `--omit=optional`:
| Feature | Package | Command |
| ------------------------ | -------------------- | ------------------------------ |
| Interactive terminal UI | `@skillkit/tui` | `skillkit ui` / `skillkit tui` |
| REST/OpenAPI server | `@skillkit/api` | `skillkit serve` |
| Peer mesh networking | `@skillkit/mesh` | `skillkit mesh …` |
| Inter-agent messaging | `@skillkit/messaging`| `skillkit message …` |
Add one later with `npm install -g @skillkit/tui` (or `api` / `mesh` / `messaging`).
### Using `npx`
`npx skillkit add <owner/repo>` works with zero install. First run pulls
the package into the npx cache (`~/.npm/_npx/`); every subsequent run
from the same cache is instant.
```bash
npx skillkit add anthropics/skills # full
npx --omit=optional skillkit add anthropics/skills # slim, 118 pkgs, 9 s
```
Running `npx` more than a couple of times? Install globally — no
prompt-to-proceed, no refetch on each release:
```bash
npm install -g skillkit --omit=optional
skillkit add anthropics/skills
```
## Quick Start
@@ -150,11 +188,11 @@ skillkit memory compress
skillkit memory export auth-insight --output auth-skill.md
```
## Supported Agents (32)
## Supported Agents (46)
**Primary (17):** Claude Code, Cursor, Codex, Gemini CLI, Windsurf, GitHub Copilot, OpenCode, Antigravity, Amp, Clawdbot, Droid, Goose, Kilo, Kiro, Roo, Trae, Universal
**Primary (19):** Claude Code, Cursor, Codex, Gemini CLI, Windsurf, GitHub Copilot, OpenCode, Antigravity, Amp, Clawdbot, OpenClaw, Droid, Goose, Hermes Agent, Kilo, Kiro, Roo, Trae, Universal
**Extended (15):** Cline, CodeBuddy, CommandCode, Continue, Crush, Factory, MCPJam, Mux, Neovate, OpenHands, Pi, Qoder, Qwen, Vercel, Zencoder
**Extended (27):** Aider, Amazon Q, Augment Code, Bolt, Cline, CodeBuddy, CodeGPT, CommandCode, Continue, Crush, Devin, Factory, Lovable, MCPJam, Mux, Neovate, OpenHands, Pi, PlayCode Agent, Qoder, Qwen, Replit Agent, Sourcegraph Cody, Tabby, Tabnine, Vercel, Zencoder
## Usage Examples
+8 -7
View File
@@ -1,7 +1,7 @@
{
"name": "skillkit",
"version": "1.19.2",
"description": "Supercharge AI coding agents with portable skills. Install, translate, and share skills across Claude Code, Cursor, Codex, Copilot & 13 more",
"version": "1.24.0",
"description": "Supercharge AI coding agents with portable skills. Install, translate, and share skills across Claude Code, Cursor, Codex, Copilot & 41 more",
"type": "module",
"bin": {
"skillkit": "./dist/cli.js",
@@ -53,16 +53,17 @@
"node": ">=18.0.0"
},
"dependencies": {
"@skillkit/api": "workspace:*",
"@skillkit/core": "workspace:*",
"@skillkit/agents": "workspace:*",
"@skillkit/cli": "workspace:*",
"@skillkit/tui": "workspace:*",
"@skillkit/memory": "workspace:*",
"@skillkit/mesh": "workspace:*",
"@skillkit/messaging": "workspace:*",
"clipanion": "^4.0.0-rc.4"
},
"optionalDependencies": {
"@skillkit/api": "workspace:*",
"@skillkit/tui": "workspace:*",
"@skillkit/mesh": "workspace:*",
"@skillkit/messaging": "workspace:*"
},
"devDependencies": {
"@types/node": "^22.10.5",
"tsup": "^8.3.5",
+9
View File
@@ -112,6 +112,7 @@ import {
SkillMdCheckCommand,
ServeCommand,
ScanCommand,
VerifyCommand,
EvalCommand,
DoctorCommand,
SaveCommand,
@@ -124,6 +125,9 @@ import {
TimelineCommand,
SessionHandoffCommand,
LineageCommand,
TapAddCommand,
TapRemoveCommand,
TapListCommand,
} from '@skillkit/cli';
const __filename = fileURLToPath(import.meta.url);
@@ -262,6 +266,7 @@ cli.register(SkillMdCheckCommand);
cli.register(ServeCommand);
cli.register(ScanCommand);
cli.register(VerifyCommand);
cli.register(EvalCommand);
cli.register(DoctorCommand);
cli.register(SaveCommand);
@@ -277,4 +282,8 @@ cli.register(TimelineCommand);
cli.register(SessionHandoffCommand);
cli.register(LineageCommand);
cli.register(TapAddCommand);
cli.register(TapRemoveCommand);
cli.register(TapListCommand);
cli.runExit(process.argv.slice(2));
+4 -3
View File
@@ -1,6 +1,7 @@
// Re-export all public APIs from packages
export * from '@skillkit/core';
export * from '@skillkit/agents';
// Re-export TUI entry point
export { startTUI } from '@skillkit/tui';
export async function startTUI(...args: unknown[]): Promise<unknown> {
const mod = await import('@skillkit/tui');
return mod.startTUI(...(args as Parameters<typeof mod.startTUI>));
}
+3
View File
@@ -7,4 +7,7 @@ export default defineConfig({
splitting: false,
sourcemap: true,
clean: true,
platform: 'node',
target: 'node18',
skipNodeModulesBundle: true,
});
+10
View File
@@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="84" height="28" viewBox="0 0 84 28" role="img">
<clipPath id="c"><rect width="84" height="28" rx="4" ry="4"/></clipPath>
<g clip-path="url(#c)">
<rect width="56" height="28" fill="#18181b"/>
<rect x="56" width="28" height="28" fill="#09090b"/>
<rect x="0.5" y="0.5" width="83" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
<text x="28" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">agents</text>
<text x="70" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fafafa" letter-spacing="0.3">46</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 804 B

+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="93" height="28" viewBox="0 0 93 28" role="img">
<rect x="0.5" y="0.5" width="92" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
<rect x="0" y="0" width="4" height="28" fill="#a78bfa"/>
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">community</text>
</svg>

After

Width:  |  Height:  |  Size: 454 B

+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="78" height="28" viewBox="0 0 78 28" role="img">
<rect x="0.5" y="0.5" width="77" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
<rect x="0" y="0" width="4" height="28" fill="#06b6d4"/>
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">curated</text>
</svg>

After

Width:  |  Height:  |  Size: 452 B

+10
View File
@@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="119" height="28" viewBox="0 0 119 28" role="img">
<clipPath id="c"><rect width="119" height="28" rx="4" ry="4"/></clipPath>
<g clip-path="url(#c)">
<rect width="98" height="28" fill="#18181b"/>
<rect x="98" width="21" height="28" fill="#22c55e"/>
<rect x="0.5" y="0.5" width="118" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
<text x="49" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">deprecations</text>
<text x="108.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#000" letter-spacing="0.3">0</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 813 B

+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="107" height="28" viewBox="0 0 107 28" role="img">
<rect x="0.5" y="0.5" width="106" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
<rect x="0" y="0" width="4" height="28" fill="#3b82f6"/>
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">every agent</text>
</svg>

After

Width:  |  Height:  |  Size: 459 B

+10
View File
@@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="91" height="28" viewBox="0 0 91 28" role="img">
<clipPath id="c"><rect width="91" height="28" rx="4" ry="4"/></clipPath>
<g clip-path="url(#c)">
<rect width="63" height="28" fill="#18181b"/>
<rect x="63" width="28" height="28" fill="#22c55e"/>
<rect x="0.5" y="0.5" width="90" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
<text x="31.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">install</text>
<text x="77" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#000" letter-spacing="0.3">9s</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 804 B

+10
View File
@@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="147" height="28" viewBox="0 0 147 28" role="img">
<clipPath id="c"><rect width="147" height="28" rx="4" ry="4"/></clipPath>
<g clip-path="url(#c)">
<rect width="63" height="28" fill="#18181b"/>
<rect x="63" width="84" height="28" fill="#09090b"/>
<rect x="0.5" y="0.5" width="146" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
<text x="31.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">license</text>
<text x="105" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fafafa" letter-spacing="0.3">Apache-2.0</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 820 B

+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="50" height="28" viewBox="0 0 50 28" role="img">
<rect x="0.5" y="0.5" width="49" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
<rect x="0" y="0" width="4" height="28" fill="#22c55e"/>
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">new</text>
</svg>

After

Width:  |  Height:  |  Size: 448 B

+10
View File
@@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="84" height="28" viewBox="0 0 84 28" role="img">
<clipPath id="c"><rect width="84" height="28" rx="4" ry="4"/></clipPath>
<g clip-path="url(#c)">
<rect width="42" height="28" fill="#18181b"/>
<rect x="42" width="42" height="28" fill="#09090b"/>
<rect x="0.5" y="0.5" width="83" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
<text x="21" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">node</text>
<text x="63" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fafafa" letter-spacing="0.3">>=18</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 804 B

+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="86" height="28" viewBox="0 0 86 28" role="img">
<rect x="0.5" y="0.5" width="85" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
<rect x="0" y="0" width="4" height="28" fill="#f59e0b"/>
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">official</text>
</svg>

After

Width:  |  Height:  |  Size: 453 B

+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="93" height="28" viewBox="0 0 93 28" role="img">
<rect x="0.5" y="0.5" width="92" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
<rect x="0" y="0" width="4" height="28" fill="#3b82f6"/>
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">one skill</text>
</svg>

After

Width:  |  Height:  |  Size: 454 B

+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="107" height="28" viewBox="0 0 107 28" role="img">
<rect x="0.5" y="0.5" width="106" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
<rect x="0" y="0" width="4" height="28" fill="#f472b6"/>
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">open source</text>
</svg>

After

Width:  |  Height:  |  Size: 459 B

+10
View File
@@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="105" height="28" viewBox="0 0 105 28" role="img">
<clipPath id="c"><rect width="105" height="28" rx="4" ry="4"/></clipPath>
<g clip-path="url(#c)">
<rect width="70" height="28" fill="#18181b"/>
<rect x="70" width="35" height="28" fill="#3b82f6"/>
<rect x="0.5" y="0.5" width="104" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
<text x="35" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">packages</text>
<text x="87.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fff" letter-spacing="0.3">118</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 810 B

+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="107" height="28" viewBox="0 0 107 28" role="img">
<rect x="0.5" y="0.5" width="106" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
<rect x="0" y="0" width="4" height="28" fill="#22c55e"/>
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">PRs welcome</text>
</svg>

After

Width:  |  Height:  |  Size: 459 B

+10
View File
@@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="105" height="28" viewBox="0 0 105 28" role="img">
<clipPath id="c"><rect width="105" height="28" rx="4" ry="4"/></clipPath>
<g clip-path="url(#c)">
<rect width="56" height="28" fill="#18181b"/>
<rect x="56" width="49" height="28" fill="#09090b"/>
<rect x="0.5" y="0.5" width="104" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
<text x="28" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">skills</text>
<text x="80.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fafafa" letter-spacing="0.3">400K+</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 813 B

+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="114" height="28" viewBox="0 0 114 28" role="img">
<rect x="0.5" y="0.5" width="113" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
<rect x="0" y="0" width="4" height="28" fill="#3b82f6"/>
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">slim install</text>
</svg>

After

Width:  |  Height:  |  Size: 460 B

+10
View File
@@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="91" height="28" viewBox="0 0 91 28" role="img">
<clipPath id="c"><rect width="91" height="28" rx="4" ry="4"/></clipPath>
<g clip-path="url(#c)">
<rect width="63" height="28" fill="#18181b"/>
<rect x="63" width="28" height="28" fill="#09090b"/>
<rect x="0.5" y="0.5" width="90" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
<text x="31.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">sources</text>
<text x="77" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fafafa" letter-spacing="0.3">31</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 807 B

+10
View File
@@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="84" height="28" viewBox="0 0 84 28" role="img">
<clipPath id="c"><rect width="84" height="28" rx="4" ry="4"/></clipPath>
<g clip-path="url(#c)">
<rect width="49" height="28" fill="#18181b"/>
<rect x="49" width="35" height="28" fill="#09090b"/>
<rect x="0.5" y="0.5" width="83" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
<text x="24.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">tests</text>
<text x="66.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fafafa" letter-spacing="0.3">757</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 808 B

+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="78" height="28" viewBox="0 0 78 28" role="img">
<rect x="0.5" y="0.5" width="77" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
<rect x="0" y="0" width="4" height="28" fill="#3b82f6"/>
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">v1.24.0</text>
</svg>

After

Width:  |  Height:  |  Size: 452 B

+10
View File
@@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="70" height="28" viewBox="0 0 70 28" role="img">
<clipPath id="c"><rect width="70" height="28" rx="4" ry="4"/></clipPath>
<g clip-path="url(#c)">
<rect width="49" height="28" fill="#18181b"/>
<rect x="49" width="21" height="28" fill="#22c55e"/>
<rect x="0.5" y="0.5" width="69" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
<text x="24.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">vulns</text>
<text x="59.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#000" letter-spacing="0.3">0</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 803 B

+2 -2
View File
@@ -1,11 +1,11 @@
---
title: Supported Agents
description: 44 AI coding agents supported by SkillKit
description: 45 AI coding agents supported by SkillKit
---
# Supported Agents
SkillKit uses an adapter pattern to support 44 AI coding platforms. Each adapter implements `getConfigPath()` and `generateConfig()` methods.
SkillKit uses an adapter pattern to support 45 AI coding platforms. Each adapter implements `getConfigPath()` and `generateConfig()` methods.
## Agent Directory Mapping
+110 -10
View File
@@ -70,11 +70,24 @@ skillkit install anthropics/skills --agent claude --agent cursor
skillkit remove <skill-names> [options]
```
| Option | Purpose |
|--------|---------|
| `--agent` | Target specific agents (default: all) |
| `--yes` | Skip confirmation |
| `--keep-metadata` | Remove skill but preserve metadata |
| Option | Short | Purpose |
|--------|-------|---------|
| `--agent` | — | Target specific agents (default: all) |
| `--yes` | — | Skip confirmation |
| `--keep-metadata` | — | Remove skill but preserve metadata |
| `--source` | `-s` | Remove all skills installed from a specific source |
| `--all` | `-a` | Remove all installed skills |
| `--force` | `-f` | Skip confirmation prompt |
### Bulk Removal
```bash
skillkit remove --source iii-hq/iii
skillkit remove --all
skillkit remove --all --force
```
When using `--source`, SkillKit matches against the source field in each skill's metadata and removes every skill that was installed from that repository. When using `--all`, every discovered skill across all agent directories is removed. Both flags update AGENTS.md automatically if managed sections are present.
## Update Command
@@ -82,11 +95,19 @@ skillkit remove <skill-names> [options]
skillkit update [skill-names] [options]
```
| Option | Purpose |
|--------|---------|
| `--dry-run` | Check for updates without installing |
| `--yes` | Skip confirmation prompts |
| `--agent` | Update in specific agents only |
| Option | Short | Purpose |
|--------|-------|---------|
| `--dry-run` | — | Check for updates without installing |
| `--yes` | — | Skip confirmation prompts |
| `--agent` | — | Update in specific agents only |
| `--force` | `-f` | Force update, bypass checksum and GitHub API checks |
The update command uses a two-stage change detection pipeline:
1. **GitHub API check** -- For remote sources, SkillKit queries the GitHub API to compare the repository's `pushed_at` timestamp against the installed metadata. If the repository has not been pushed since the last install or update, the skill is skipped without cloning.
2. **Checksum comparison** -- After cloning, a checksum of the source SKILL.md is compared against the stored checksum. If the content is identical, the update is skipped.
Use `--force` to bypass both checks and always overwrite the installed skill.
## Enable/Disable Commands
@@ -97,6 +118,26 @@ skillkit disable <skill-names> [options]
Disabled skills are ignored by the `sync` command. No file changes occur.
## Check Command
```bash
skillkit check [skill-names] [options]
```
Checks installed skills for available updates, quality scores, and GitHub activity.
| Option | Short | Purpose |
|--------|-------|---------|
| `--verbose` | `-v` | Show detailed output including stars and push dates |
| `--quiet` | `-q` | Minimal output |
For remote GitHub sources, the check command queries the GitHub API to compare each repository's `pushed_at` timestamp against the installed date. Each skill displays its quality score badge (A-F). In verbose mode, the output also includes the repository's star count and how recently it was pushed.
```bash
skillkit check
skillkit check pdf xlsx --verbose
```
## List Command
```bash
@@ -457,6 +498,48 @@ skillkit publish --dry-run # Preview without writing
skillkit publish submit # Submit to SkillKit marketplace
```
### publish submit
Submits a skill to the SkillKit marketplace by creating a GitHub issue on `rohitg00/skillkit` via the `gh` CLI. No browser is needed.
Before submitting, the command displays:
- Quality score and grade (A-F) from the skill evaluator
- GitHub star count and last push date from the GitHub API
- Any quality warnings (up to 3)
If `gh` is not installed or not authenticated, the command prints a manual submission URL as a fallback.
## Tap Command
Manage custom skill sources (taps). Taps are user-level source repositories stored in `~/.skillkit/taps.json`. They let you add private or third-party skill repositories that are not part of the official marketplace.
### tap add
Add a custom skill source.
```bash
skillkit tap add owner/repo
skillkit tap add owner/repo --name "My Skills"
```
### tap remove
Remove a custom skill source.
```bash
skillkit tap remove owner/repo
```
### tap list
List all custom skill sources.
```bash
skillkit tap list
```
Once a tap is added, skills from that source appear in `skillkit marketplace search` results and can be installed with the standard `skillkit install owner/repo` workflow.
## Security Scanning
```bash
@@ -490,6 +573,23 @@ Skills are automatically scanned during `skillkit install`. Use `--no-scan` to s
- `table` - tabular format
- `sarif` - SARIF v2.1 for GitHub Code Scanning / IDE integration
## Integrity Verification
```bash
skillkit verify <path> # Print SRI digest (sha256-<base64>)
skillkit verify <path> --files # Show per-file digests
skillkit verify <path> --format hex # Print raw 64-char hex digest
skillkit verify <path> --json # Machine-readable JSON
skillkit verify <path> --expected sha256-... # Verify against a known publisher digest
skillkit verify <path> --against-lock # Verify against ~/.skillkit/lock.json
```
`skillkit verify` computes a deterministic SHA-256 over every file in the skill (excluding `.skillkit.json` metadata, VCS artifacts, and editor noise) and emits a [Subresource Integrity](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) string. The digest matches the `integrity` field that `skillkit publish` writes into `.well-known/skills/index.json`, so a downstream consumer can detect tampering between publish and install.
`skillkit install` and `skillkit update` automatically record the full SRI digest into `~/.skillkit/lock.json`, enabling `--against-lock` audits in CI pipelines and supply-chain workflows.
**Exit codes:** `0` on match, `1` on mismatch, missing path, or malformed `--expected` value.
## Interactive TUI
```bash
@@ -152,11 +152,61 @@ primer:
- .next
```
## Lock File
SkillKit maintains a centralized lock file at `~/.skillkit/lock.json` that tracks every installed skill. The lock file is written on install, updated on update, and cleaned on remove.
```json
{
"version": 1,
"skills": {
"pdf": {
"source": "anthropics/skills",
"checksum": "sha256:abc123...",
"agents": ["claude-code", "cursor"],
"installedAt": "2026-04-01T12:00:00Z",
"updatedAt": "2026-04-08T09:30:00Z"
}
}
}
```
| Field | Description |
|-------|-------------|
| `source` | The repository or local path the skill was installed from |
| `checksum` | SHA-256 hash of the SKILL.md content at install time, used for update detection |
| `agents` | Which agents the skill is installed for |
| `installedAt` | ISO timestamp of initial installation |
| `updatedAt` | ISO timestamp of the most recent update |
The `update` command compares the stored checksum against the source to skip unchanged skills. The `remove` command cleans up the corresponding lock entry.
## Taps File
Custom skill source repositories are stored in `~/.skillkit/taps.json`. Taps are managed via the `skillkit tap` commands.
```json
{
"version": 1,
"taps": [
{
"source": "myorg/internal-skills",
"name": "Internal Skills",
"addedAt": "2026-04-05T10:00:00Z"
}
]
}
```
Skills from tapped sources appear in marketplace search results and can be installed like any other source. See the [tap command](/docs/commands#tap-command) documentation for usage.
## Directory Structure
```
~/.skillkit/
├── preferences.json # User preferences
├── lock.json # Installed skill tracking
├── taps.json # Custom skill sources
├── cache/ # Marketplace cache
├── memory/ # Learning storage
│ ├── observations/
+1 -1
View File
@@ -29,7 +29,7 @@ skillkit/
│ ├── core/ # Business logic
│ ├── cli/ # CLI
│ ├── tui/ # Terminal UI
│ └── agents/ # 44 adapters
│ └── agents/ # 45 adapters
├── marketplace/ # Skills data
│ ├── skills.json
│ └── sources.json
+9 -6
View File
@@ -7,7 +7,7 @@ description: Universal skill management for AI coding agents
Skills make AI coding agents smarter. But every agent uses a different format — Claude Code wants `.claude/skills/`, Cursor uses `.mdc`, Copilot expects `.github/skills/`. You end up rewriting the same skill three times, or locking into one platform.
SkillKit fixes this. Write a skill once, deploy it to all 44 agents.
SkillKit fixes this. Write a skill once, deploy it to all 45 agents.
## Get Started
@@ -95,23 +95,26 @@ SkillKit sits between your skills and your agents. It handles format translation
## Supported Agents
44 agents and counting:
45 agents and counting:
**Claude Code** | **Cursor** | **Codex** | **Gemini CLI** | **OpenCode** | **GitHub Copilot** | **Windsurf** | Amp | Antigravity | Clawdbot | Cline | CodeBuddy | CommandCode | Continue | Crush | Droid | Factory | Goose | Kilo Code | Kiro CLI | MCPJam | Mux | Neovate | OpenHands | Pi | Qoder | Qwen | Roo Code | Trae | Vercel | Zencoder | Universal
[Full agent details](/docs/agents)
### Security scanning
### Security & integrity
Every skill is scanned for threats before installation — prompt injection, hardcoded secrets, command injection, and more:
Every skill is scanned for threats before installation — prompt injection, hardcoded secrets, command injection, and more — and content integrity is verifiable against the publisher digest:
```bash
skillkit scan ./my-skill # 46+ detection rules
skillkit scan ./my-skill --format sarif # GitHub Code Scanning
skillkit scan ./my-skill --fail-on high # CI gate
skillkit verify ./my-skill # SHA-256 SRI digest
skillkit verify ./my-skill --against-lock # Detect supply-chain tampering
```
[Security Scanner](/docs/security)
[Security & Integrity](/docs/security)
## Beyond Basic Skills
@@ -169,7 +172,7 @@ Team members run `skillkit manifest install` and they're in sync.
- [Installation](/docs/installation) — Install and configure
- [Quick Start](/docs/quickstart) — First project setup
- [Methodology Packs](/docs/methodology) — Debugging, testing, planning skills
- [Security Scanner](/docs/security) — Threat detection for skills
- [Security & Integrity](/docs/security) — Threat detection plus SHA-256 content verification
- [Commands](/docs/commands) — Full CLI reference
- [REST API](/docs/rest-api) — Runtime discovery server
- [MCP Server](/docs/mcp-server) — Agent-native discovery
+56 -1
View File
@@ -33,6 +33,61 @@ bun add -g skillkit
Both `skillkit` and `sk` work as command aliases.
## Full vs slim install
SkillKit ships four power features as **optional dependencies** so the
core install stays small. The default `npm install -g skillkit` installs
every feature; `--omit=optional` installs only the core CLI.
| Feature | Package | Command |
| ------------------------ | -------------------- | ------------------------------ |
| Interactive terminal UI | `@skillkit/tui` | `skillkit ui` / `skillkit tui` |
| REST/OpenAPI server | `@skillkit/api` | `skillkit serve` |
| Peer mesh networking | `@skillkit/mesh` | `skillkit mesh …` |
| Inter-agent messaging | `@skillkit/messaging`| `skillkit message …` |
```bash
# Full (default) — every feature works out of the box:
npm install -g skillkit
# Slim — core commands only, ~75% smaller, no native addons, 0 deprecation warnings:
npm install -g skillkit --omit=optional
```
Add one later:
```bash
npm install -g @skillkit/tui # enables: skillkit ui
npm install -g @skillkit/api # enables: skillkit serve
npm install -g @skillkit/mesh # enables: skillkit mesh
npm install -g @skillkit/messaging # enables: skillkit message
```
The CLI catches a missing optional feature and prints a one-line hint,
so you'll never see an unhandled stack trace.
## Using `npx`
`npx skillkit add <owner/repo>` runs without a global install. First run
downloads into the npx cache (`~/.npm/_npx/`); every call after that is
instant until the cache expires or a new version ships.
```bash
# Full — every feature works:
npx skillkit add anthropics/skills
# Slim — core commands only, 75% fewer packages, 0 warnings:
npx --omit=optional skillkit add anthropics/skills
```
If you use `npx skillkit` more than a couple of times, install globally
to skip the prompt-to-proceed and avoid the per-release cache refetch:
```bash
npm install -g skillkit --omit=optional
skillkit add anthropics/skills
```
## Verify
```bash
@@ -58,7 +113,7 @@ The init command:
```bash
skillkit init --agent cursor
skillkit init --list # Show all 44 supported agents
skillkit init --list # Show all 45 supported agents
skillkit init --quiet # Skip logo and prompts (for CI)
```
+3 -3
View File
@@ -5,7 +5,7 @@ description: Auto-generate AI agent instructions from your codebase
# Primer
Primer analyzes your codebase and automatically generates optimized instructions for all 44 AI agents. No more manual configuration—let SkillKit detect your tech stack, coding patterns, and project structure.
Primer analyzes your codebase and automatically generates optimized instructions for all 45 AI agents. No more manual configuration—let SkillKit detect your tech stack, coding patterns, and project structure.
## Quick Start
@@ -16,7 +16,7 @@ skillkit primer
# Generate for specific agents
skillkit primer --agent claude,cursor,windsurf
# Generate for all 44 agents
# Generate for all 45 agents
skillkit primer --all-agents
# Preview without writing files
@@ -65,7 +65,7 @@ Primer creates agent-specific instructions for:
└── copilot-instructions.md
```
### All 44 Agents
### All 45 Agents
Each agent gets optimized instructions in their native format.
## Example Output
+70 -4
View File
@@ -1,11 +1,16 @@
---
title: Security Scanner
description: Detect malicious patterns, secrets, and vulnerabilities in AI agent skills
title: Security & Integrity
description: Scan skills for malicious patterns, verify content integrity, and lock against supply-chain tampering
---
# Security Scanner
# Security & Integrity
SkillKit includes a built-in security scanner that analyzes skills for prompt injection, command injection, data exfiltration, hardcoded secrets, and other threats before installation.
SkillKit ships two complementary supply-chain defenses:
1. **`skillkit scan`** — static security scanner detecting prompt injection, command injection, data exfiltration, hardcoded secrets, tool abuse, and unicode steganography (46+ rules).
2. **`skillkit verify`** — SHA-256 content-integrity check that compares the locally installed skill against the publisher's recorded digest (full SRI, recorded automatically in `~/.skillkit/lock.json`).
Run `scan` to ask _"is this skill dangerous?"_. Run `verify` to ask _"is this skill what the publisher actually shipped?"_.
## Quick Start
@@ -242,6 +247,28 @@ console.log(`Findings: ${result.findings.length}`);
| **Low** | 1 (with `--fail-on low`) | Minor issue or best practice |
| **Info** | 0 | Informational finding |
## Trust Badges
Skills display a trust badge based on their source and quality analysis. Badges appear during installation, in `skillkit check` output, and in marketplace search results.
| Badge | Criteria |
|-------|----------|
| **[Official]** | Published by a known official source (Anthropic, Vercel, iii-hq, etc.) |
| **[Trusted]** | TrustScorer rates the skill 8-10 based on clarity, boundaries, specificity, and safety |
| **[Review]** | TrustScorer rates the skill 5-7; the skill may need refinement |
| **[Caution]** | TrustScorer rates the skill 0-4; requires careful review before use |
The `TrustScorer` evaluates four weighted dimensions:
| Dimension | Weight | What it measures |
|-----------|--------|------------------|
| Clarity | 30% | How well-defined the skill's purpose and instructions are |
| Boundaries | 25% | Whether the skill stays within its declared scope |
| Specificity | 25% | How concrete and actionable the instructions are |
| Safety | 20% | Absence of dangerous patterns (injection, exfiltration, secrets) |
Official sources are allowlisted by organization name and always receive the `[Official]` badge regardless of score. For all other sources, the badge is determined by the composite trust score.
## False Positive Handling
The scanner automatically filters:
@@ -257,3 +284,42 @@ To skip specific rules:
```bash
skillkit scan . --skip-rules UC001,UC002,MF004
```
## Integrity Verification (`skillkit verify`)
`skillkit verify` is the supply-chain counterpart to `skillkit scan`. The scanner answers _"is this skill dangerous?"_; `verify` answers _"is this skill what the publisher actually shipped?"_.
```bash
skillkit verify ./my-skill # Print SRI digest
skillkit verify ./my-skill --expected sha256-iQo/... # Compare against publisher digest
skillkit verify ./my-skill --against-lock # Compare against ~/.skillkit/lock.json
skillkit verify ./my-skill --json # JSON for CI pipelines
```
### How the digest is computed
`verify` walks every file in the skill in deterministic alphabetical order, computes SHA-256 per file, and rolls those file hashes (plus their POSIX-normalized relative paths) into a single SHA-256 digest, emitted as a [Subresource Integrity](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) string of the form `sha256-<base64>`. Skipped: `.skillkit.json`, `.DS_Store`, `.git`, `node_modules`, `dist`, `.turbo`, and any `*.skillkit.json` sidecar.
Because file _paths_ feed the hash alongside _content_, renaming, adding, or removing a file all change the digest — not just edits to file bodies.
### Publish, install, and lock integration
- `skillkit publish` writes the digest into the `integrity` field of `.well-known/skills/index.json` for every published skill.
- `skillkit install` records the full SRI digest into `~/.skillkit/lock.json` (falling back to the legacy short checksum only if integrity computation fails).
- `skillkit update` refreshes the lock entry on successful update.
### CI usage
```yaml
- name: Verify all installed skills
run: |
for skill in .claude/skills/*/; do
npx skillkit verify "$skill" --against-lock --json
done
```
Exit codes: `0` on match, `1` on mismatch, missing path, or malformed `--expected` value. Reason codes in JSON output: `mismatch`, `invalid-expected-format`, `missing-expected`, `no-lock-entry`.
### Roadmap
Cryptographic skill signing (ed25519 publisher keys + verified-publisher registry) is tracked separately as Phase 2 of [#90](https://github.com/rohitg00/skillkit/issues/90). Phase 1 (content integrity) is shipping now in response to the ClawHavoc supply-chain campaign and OWASP Agentic Skills Top 10 guidance.
+1 -1
View File
@@ -5,7 +5,7 @@ description: Convert skills between AI agent formats
# Translation
SkillKit automatically converts between all 44 agent formats using an adapter pattern.
SkillKit automatically converts between all 45 agent formats using an adapter pattern.
## Basic Translation
+28
View File
@@ -8,6 +8,34 @@ const config = {
trailingSlash: false,
skipTrailingSlashRedirect: true,
assetPrefix: 'https://skillkit-docs.vercel.app',
async headers() {
return [
{
source: '/:path*.(css|js|png|jpg|jpeg|svg|webp|woff2|woff|ttf|ico)',
headers: [
{ key: 'Cache-Control', value: 'public, max-age=86400, s-maxage=604800, stale-while-revalidate=2592000' },
],
},
{
source: '/_next/static/:path*',
headers: [
{ key: 'Cache-Control', value: 'public, max-age=31536000, immutable' },
],
},
{
source: '/docs/:path*',
headers: [
{ key: 'Cache-Control', value: 'public, max-age=300, s-maxage=86400, stale-while-revalidate=604800' },
],
},
{
source: '/',
headers: [
{ key: 'Cache-Control', value: 'public, max-age=300, s-maxage=86400, stale-while-revalidate=604800' },
],
},
];
},
};
export default withMDX(config);
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit-docs",
"version": "1.19.2",
"version": "1.24.0",
"private": true,
"scripts": {
"build": "next build",
+138
View File
@@ -0,0 +1,138 @@
# Humans + agents welcome. Training crawlers + SEO scrapers blocked.
User-agent: Googlebot
Allow: /
User-agent: Bingbot
Allow: /
User-agent: DuckDuckBot
Allow: /
User-agent: Applebot
Allow: /
User-agent: ChatGPT-User
Allow: /
User-agent: OAI-SearchBot
Allow: /
User-agent: PerplexityBot
Allow: /
User-agent: Perplexity-User
Allow: /
User-agent: Claude-User
Allow: /
User-agent: Claude-SearchBot
Allow: /
User-agent: FirecrawlAgent
Allow: /
User-agent: firecrawl
Allow: /
User-agent: Context7Bot
Allow: /
User-agent: Crawl4AI
Allow: /
User-agent: Clawdbot
Allow: /
User-agent: OpenClaw
Allow: /
User-agent: Hermes
Allow: /
User-agent: GPTBot
Disallow: /
User-agent: ClaudeBot
Disallow: /
User-agent: anthropic-ai
Disallow: /
User-agent: CCBot
Disallow: /
User-agent: Google-Extended
Disallow: /
User-agent: Applebot-Extended
Disallow: /
User-agent: Bytespider
Disallow: /
User-agent: Amazonbot
Disallow: /
User-agent: FacebookBot
Disallow: /
User-agent: Meta-ExternalAgent
Disallow: /
User-agent: cohere-ai
Disallow: /
User-agent: Diffbot
Disallow: /
User-agent: ImagesiftBot
Disallow: /
User-agent: Omgilibot
Disallow: /
User-agent: peer39_crawler
Disallow: /
User-agent: YouBot
Disallow: /
User-agent: Timpibot
Disallow: /
User-agent: ICC-Crawler
Disallow: /
User-agent: AhrefsBot
Disallow: /
User-agent: SemrushBot
Disallow: /
User-agent: MJ12bot
Disallow: /
User-agent: DotBot
Disallow: /
User-agent: PetalBot
Disallow: /
User-agent: BLEXBot
Disallow: /
User-agent: MegaIndex
Disallow: /
User-agent: SeznamBot
Disallow: /
User-agent: DataForSeoBot
Disallow: /
User-agent: *
Allow: /
Sitemap: https://skillkit-docs.vercel.app/sitemap.xml
+2 -2
View File
@@ -39,8 +39,8 @@ export default function HomePage() {
{/* Features Grid */}
<div className="grid grid-cols-1 md:grid-cols-3 gap-6 mb-16">
<div className="border border-zinc-800 bg-zinc-900/30 p-6">
<h3 className="text-lg font-bold text-white mb-2 font-mono">44 Agents</h3>
<p className="text-zinc-500 text-sm">Claude, Cursor, Codex, Windsurf, Copilot, and 39 more supported out of the box.</p>
<h3 className="text-lg font-bold text-white mb-2 font-mono">45 Agents</h3>
<p className="text-zinc-500 text-sm">Claude, Cursor, Codex, Windsurf, Copilot, and 40 more supported out of the box.</p>
</div>
<div className="border border-zinc-800 bg-zinc-900/30 p-6">
<h3 className="text-lg font-bold text-white mb-2 font-mono">400K+ Skills</h3>
+37 -9
View File
@@ -44,12 +44,12 @@ const sections: DocSection[] = [
content: (
<div className="space-y-4">
<p className="text-zinc-300">
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 44 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 46 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
</p>
<h3 className="text-lg font-semibold text-white mt-6">Core Capabilities</h3>
<ul className="list-disc list-inside space-y-2 text-zinc-400">
<li><span className="text-white">Skill Discovery</span> - Browse 400K+ skills from registries with AI-powered recommendations</li>
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 44 agent-specific formats</li>
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 46 agent-specific formats</li>
<li><span className="text-white">Team Collaboration</span> - Share skills via .skills manifest files and publish to marketplace</li>
</ul>
</div>
@@ -61,14 +61,42 @@ const sections: DocSection[] = [
content: (
<div className="space-y-4">
<h3 className="text-lg font-semibold text-white">Quick Start</h3>
<CodeBlock>{`# Install globally via npm
<CodeBlock>{`# Full install — every feature works out of the box (default):
npm install -g skillkit
# Or use npx directly
npx skillkit --help
# Slim install — core commands only, ~75% smaller, 0 deprecation warnings:
npm install -g skillkit --omit=optional
# Or install via pnpm
pnpm add -g skillkit`}</CodeBlock>
# Or use npx directly:
npx skillkit --help`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Optional Features</h3>
<p className="text-zinc-300 text-sm">
TUI, REST server, peer mesh, and inter-agent messaging ship as optional
dependencies. They install by default, or add later à la carte:
</p>
<CodeBlock>{`npm install -g @skillkit/tui # enables: skillkit ui
npm install -g @skillkit/api # enables: skillkit serve
npm install -g @skillkit/mesh # enables: skillkit mesh
npm install -g @skillkit/messaging # enables: skillkit message`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Using npx (no install)</h3>
<p className="text-zinc-300 text-sm">
<code className="text-zinc-200">npx skillkit add &lt;owner/repo&gt;</code> runs with zero install.
First call caches the package at <code className="text-zinc-200">~/.npm/_npx/</code>; every
run after that is instant until a new version ships.
</p>
<CodeBlock>{`# Full (default):
npx skillkit add anthropics/skills
# Slim — core only, 75% fewer packages, 0 warnings:
npx --omit=optional skillkit add anthropics/skills`}</CodeBlock>
<p className="text-zinc-300 text-sm">
Using npx more than a couple times? Install globally to skip the
prompt-to-proceed and avoid the per-release cache refetch:
</p>
<CodeBlock>{`npm install -g skillkit --omit=optional
skillkit add anthropics/skills`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Verify Installation</h3>
<CodeBlock>{`skillkit --version
@@ -102,7 +130,7 @@ skillkit install anthropics/skills`}</CodeBlock>
<ul className="list-disc list-inside space-y-2 text-zinc-400">
<li><span className="text-white">UI Tier</span> - CLI commands, Terminal UI (OpenTUI-based), and documentation website</li>
<li><span className="text-white">Core Logic Tier</span> - @skillkit/core for business logic; @skillkit/agents for adapter implementations</li>
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 44 AI agents</li>
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 46 AI agents</li>
</ul>
<h3 className="text-lg font-semibold text-white mt-6">Monorepo Structure</h3>
@@ -130,7 +158,7 @@ skillkit install anthropics/skills`}</CodeBlock>
content: (
<div className="space-y-4">
<p className="text-zinc-300">
SkillKit supports 44 AI coding agents with automatic format translation:
SkillKit supports 46 AI coding agents with automatic format translation:
</p>
<Table
+3 -3
View File
@@ -9,7 +9,7 @@ interface Feature {
const FEATURES: Feature[] = [
{
title: 'Multi-Agent',
description: 'Deploy to 44 AI coding agents with one command.',
description: 'Deploy to 46 AI coding agents with one command.',
icon: (
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M19 11H5m14 0a2 2 0 012 2v6a2 2 0 01-2 2H5a2 2 0 01-2-2v-6a2 2 0 012-2m14 0V9a2 2 0 00-2-2M5 11V9a2 2 0 012-2m0 0V5a2 2 0 012-2h6a2 2 0 012 2v2M7 7h10" />
@@ -64,7 +64,7 @@ const FEATURES: Feature[] = [
];
const COMPARISONS = [
['Agents', '1', '44'],
['Agents', '1', '46'],
['Translation', 'Manual', 'Auto'],
['Sharing', 'Copy/paste', '.skills manifest'],
['Discovery', 'Forums', 'CLI + AI'],
@@ -83,7 +83,7 @@ export function Features(): React.ReactElement {
</p>
<div className="flex gap-6 sm:gap-8">
<div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">44</div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">46</div>
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Agents</div>
</div>
<div>
+22
View File
@@ -0,0 +1,22 @@
import { NextResponse } from 'next/server';
import type { NextRequest } from 'next/server';
const BLOCK = /GPTBot|ClaudeBot|anthropic-ai|CCBot|Google-Extended|Applebot-Extended|Bytespider|Amazonbot|Meta-ExternalAgent|cohere-ai|Diffbot|ImagesiftBot|Omgilibot|peer39_crawler|YouBot|Timpibot|ICC-Crawler|AhrefsBot|SemrushBot|MJ12bot|DotBot|PetalBot|BLEXBot|MegaIndex|SeznamBot|DataForSeoBot/i;
const ALLOW = /Googlebot|Bingbot|DuckDuckBot|Applebot(?!-Extended)|ChatGPT-User|OAI-SearchBot|PerplexityBot|Perplexity-User|Claude-User|Claude-SearchBot|FirecrawlAgent|firecrawl|Context7Bot|Crawl4AI|Clawdbot|OpenClaw|Hermes/i;
export function middleware(req: NextRequest) {
const ua = req.headers.get('user-agent') || '';
if (ALLOW.test(ua)) return NextResponse.next();
if (BLOCK.test(ua)) {
return new NextResponse('disallowed by robots.txt', {
status: 403,
headers: { 'Cache-Control': 'public, max-age=86400' },
});
}
return NextResponse.next();
}
export const config = {
matcher: '/((?!_next/static|_next/image|favicon|robots\\.txt|sitemap\\.xml).*)',
};
+47 -35
View File
@@ -1,70 +1,82 @@
<svg width="1200" height="420" viewBox="0 0 1200 420" xmlns="http://www.w3.org/2000/svg">
<defs>
<linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
<stop offset="0%" style="stop-color:#0a0a0a"/>
<stop offset="50%" style="stop-color:#111111"/>
<stop offset="100%" style="stop-color:#0a0a0a"/>
<stop offset="0%" style="stop-color:#09090b"/>
<stop offset="50%" style="stop-color:#111115"/>
<stop offset="100%" style="stop-color:#09090b"/>
</linearGradient>
<linearGradient id="border" x1="0%" y1="0%" x2="100%" y2="0%">
<stop offset="0%" style="stop-color:#333"/>
<stop offset="50%" style="stop-color:#555"/>
<stop offset="100%" style="stop-color:#333"/>
<stop offset="0%" style="stop-color:#27272a"/>
<stop offset="50%" style="stop-color:#3f3f46"/>
<stop offset="100%" style="stop-color:#27272a"/>
</linearGradient>
<linearGradient id="ph-badge" x1="0%" y1="0%" x2="0%" y2="100%">
<stop offset="0%" style="stop-color:#2a2a2a"/>
<stop offset="100%" style="stop-color:#1a1a1a"/>
<stop offset="0%" style="stop-color:#27272a"/>
<stop offset="100%" style="stop-color:#18181b"/>
</linearGradient>
<linearGradient id="accentText" x1="0%" y1="0%" x2="100%" y2="0%">
<stop offset="0%" style="stop-color:#ffffff"/>
<stop offset="50%" style="stop-color:#ffffff"/>
<stop offset="100%" style="stop-color:#a1a1aa"/>
</linearGradient>
<linearGradient id="numberAccent" x1="0%" y1="0%" x2="0%" y2="100%">
<stop offset="0%" style="stop-color:#60a5fa"/>
<stop offset="100%" style="stop-color:#3b82f6"/>
</linearGradient>
</defs>
<rect width="1200" height="420" fill="url(#bg)" rx="12"/>
<rect x="1" y="1" width="1198" height="418" fill="none" stroke="url(#border)" stroke-width="1" rx="12"/>
<rect x="0.5" y="0.5" width="1199" height="419" fill="none" stroke="url(#border)" stroke-width="1" rx="12"/>
<line x1="60" y1="350" x2="1140" y2="350" stroke="#1a1a1a" stroke-width="1"/>
<line x1="60" y1="354" x2="1140" y2="354" stroke="#1f1f23" stroke-width="1"/>
<g transform="translate(60, 72)">
<rect width="16" height="16" fill="white" rx="2"/>
</g>
<text x="90" y="86" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="20" font-weight="700" fill="white" letter-spacing="3">SKILLKIT</text>
<text x="90" y="106" font-family="'SF Mono', 'Fira Code', monospace" font-size="11" fill="#52525b" letter-spacing="1">v1.24.0</text>
<g transform="translate(890, 58)">
<rect width="250" height="40" fill="url(#ph-badge)" stroke="#444" stroke-width="1" rx="20"/>
<circle cx="28" cy="20" r="14" fill="none" stroke="#666" stroke-width="1.5"/>
<rect width="250" height="40" fill="url(#ph-badge)" stroke="#3f3f46" stroke-width="1" rx="20"/>
<circle cx="28" cy="20" r="14" fill="none" stroke="#71717a" stroke-width="1.5"/>
<text x="28" y="25" font-family="system-ui, sans-serif" font-size="16" font-weight="700" fill="white" text-anchor="middle">P</text>
<text x="54" y="16" font-family="system-ui, sans-serif" font-size="9" font-weight="600" fill="#888" letter-spacing="1">PRODUCT HUNT</text>
<text x="54" y="16" font-family="system-ui, sans-serif" font-size="9" font-weight="600" fill="#a1a1aa" letter-spacing="1">PRODUCT HUNT</text>
<text x="54" y="30" font-family="system-ui, sans-serif" font-size="13" font-weight="700" fill="white">#3 Product of the Day</text>
</g>
<text x="600" y="200" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="62" font-weight="700" fill="white" text-anchor="middle" letter-spacing="-1">One Skill. 44 Agents.</text>
<text x="600" y="196" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="62" font-weight="700" fill="url(#accentText)" text-anchor="middle" letter-spacing="-1.5">One skill. <tspan fill="url(#numberAccent)">46</tspan> agents.</text>
<text x="600" y="248" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="20" fill="#888" text-anchor="middle" letter-spacing="0.5">The open source package manager for AI agent skills</text>
<text x="600" y="240" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="18" fill="#a1a1aa" text-anchor="middle" letter-spacing="0.3">Package manager for AI agent skills — install, translate, sync.</text>
<g transform="translate(240, 282)">
<rect width="260" height="38" fill="#1a1a1a" stroke="#333" stroke-width="1" rx="6"/>
<text x="16" y="25" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#666">$</text>
<text x="32" y="25" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#ccc">npx skillkit@latest</text>
<g transform="translate(240, 280)">
<rect width="280" height="40" fill="#18181b" stroke="#3f3f46" stroke-width="1" rx="6"/>
<text x="16" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#71717a">$</text>
<text x="32" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#e4e4e7">npm i -g skillkit</text>
</g>
<g transform="translate(520, 282)">
<rect width="150" height="38" fill="transparent" stroke="#444" stroke-width="1" rx="6"/>
<text x="75" y="25" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#999" text-anchor="middle">15,000+ skills</text>
<g transform="translate(540, 280)">
<rect width="140" height="40" fill="transparent" stroke="#3f3f46" stroke-width="1" rx="6"/>
<circle cx="18" cy="20" r="3" fill="#60a5fa"/>
<text x="32" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="13" fill="#d4d4d8">400K+ skills</text>
</g>
<g transform="translate(690, 282)">
<rect width="140" height="38" fill="transparent" stroke="#444" stroke-width="1" rx="6"/>
<text x="70" y="25" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#999" text-anchor="middle">Zero rewrites</text>
<g transform="translate(700, 280)">
<rect width="140" height="40" fill="transparent" stroke="#3f3f46" stroke-width="1" rx="6"/>
<circle cx="18" cy="20" r="3" fill="#22c55e"/>
<text x="32" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="13" fill="#d4d4d8">zero rewrites</text>
</g>
<g transform="translate(850, 282)">
<rect width="120" height="38" fill="transparent" stroke="#444" stroke-width="1" rx="6"/>
<text x="60" y="25" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#999" text-anchor="middle">Apache-2.0</text>
<g transform="translate(860, 280)">
<rect width="110" height="40" fill="transparent" stroke="#3f3f46" stroke-width="1" rx="6"/>
<circle cx="18" cy="20" r="3" fill="#f59e0b"/>
<text x="32" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="13" fill="#d4d4d8">Apache-2.0</text>
</g>
<g transform="translate(60, 370)">
<circle cx="5" cy="5" r="3" fill="#666"/>
<circle cx="15" cy="5" r="3" fill="#555"/>
<circle cx="25" cy="5" r="3" fill="#444"/>
<circle cx="35" cy="5" r="3" fill="#333"/>
<text x="50" y="9" font-family="'SF Mono', monospace" font-size="11" fill="#444">Claude Cursor Codex Gemini Copilot Windsurf Devin Aider Cody +35 more</text>
<g transform="translate(60, 374)">
<circle cx="5" cy="5" r="3" fill="#71717a"/>
<circle cx="15" cy="5" r="3" fill="#52525b"/>
<circle cx="25" cy="5" r="3" fill="#3f3f46"/>
<circle cx="35" cy="5" r="3" fill="#27272a"/>
<text x="50" y="10" font-family="'SF Mono', monospace" font-size="11" fill="#52525b">Claude · Cursor · Codex · Gemini · Copilot · Windsurf · OpenCode · Hermes · Clawdbot · OpenClaw · +36 more</text>
</g>
</svg>

Before

Width:  |  Height:  |  Size: 3.9 KiB

After

Width:  |  Height:  |  Size: 4.8 KiB

@@ -69,8 +69,8 @@ const ADVANCED_FEATURES: AdvancedFeature[] = [
id: 'primer',
title: 'Primer',
subtitle: 'Zero-Config AI Instructions',
description: 'Automatically generate CLAUDE.md, .cursorrules, and agent instructions by analyzing your codebase. Detects your tech stack, coding patterns, and project structure—then creates optimized instructions for all 44 agents.',
highlight: 'Auto-generates instructions for 44 agents',
description: 'Automatically generate CLAUDE.md, .cursorrules, and agent instructions by analyzing your codebase. Detects your tech stack, coding patterns, and project structure—then creates optimized instructions for all 46 agents.',
highlight: 'Auto-generates instructions for 46 agents',
icon: (
<svg className="w-8 h-8" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-3 7h3m-3 4h3m-6-4h.01M9 16h.01" />
@@ -78,7 +78,7 @@ const ADVANCED_FEATURES: AdvancedFeature[] = [
),
commands: [
{ cmd: 'primer', desc: 'Analyze & generate for detected agents' },
{ cmd: 'primer --all-agents', desc: 'Generate for all 44 agents' },
{ cmd: 'primer --all-agents', desc: 'Generate for all 46 agents' },
{ cmd: 'primer --analyze-only', desc: 'Preview codebase analysis' },
{ cmd: 'primer --json', desc: 'Machine-readable output' },
],
+1 -1
View File
@@ -429,7 +429,7 @@ export function Agents(): React.ReactElement {
<section className="py-6 border-b border-zinc-800 overflow-hidden">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<p className="text-zinc-500 font-mono text-[11px] uppercase tracking-widest mb-6 text-center">
Works with 44 AI Agents
Works with 46 AI Agents
</p>
</div>
+16 -3
View File
@@ -23,9 +23,19 @@ const COMMAND_GROUPS: CommandGroup[] = [
{ cmd: 'list', desc: 'View installed skills' },
{ cmd: 'sync', desc: 'Deploy to all agents' },
{ cmd: 'translate --to <agent>', desc: 'Convert formats' },
{ cmd: 'update', desc: 'Update all skills' },
{ cmd: 'update', desc: 'Update with change detection' },
{ cmd: 'remove <skill>', desc: 'Remove a skill' },
{ cmd: 'status', desc: 'Show skill status' },
{ cmd: 'remove --source org/repo', desc: 'Bulk remove by repo' },
{ cmd: 'remove --all', desc: 'Remove all skills' },
{ cmd: 'check', desc: 'Quality scores & activity' },
],
},
{
name: 'Sources',
commands: [
{ cmd: 'tap add owner/repo', desc: 'Add custom source' },
{ cmd: 'tap list', desc: 'List custom sources' },
{ cmd: 'tap remove owner/repo', desc: 'Remove custom source' },
],
},
{
@@ -67,7 +77,7 @@ const COMMAND_GROUPS: CommandGroup[] = [
{ cmd: 'manifest init', desc: 'Create .skills file' },
{ cmd: 'team init', desc: 'Initialize team' },
{ cmd: 'team share', desc: 'Share via Git' },
{ cmd: 'publish', desc: 'Submit to marketplace' },
{ cmd: 'publish submit', desc: 'Submit via CLI' },
{ cmd: 'cicd init', desc: 'CI/CD templates' },
{ cmd: 'team sync', desc: 'Sync team skills' },
],
@@ -89,6 +99,9 @@ const COMMAND_GROUPS: CommandGroup[] = [
{ cmd: 'scan --format sarif', desc: 'SARIF output' },
{ cmd: 'scan --fail-on high', desc: 'CI gate' },
{ cmd: 'install --no-scan', desc: 'Skip scan' },
{ cmd: 'verify <path>', desc: 'SHA-256 integrity (SRI)' },
{ cmd: 'verify --expected sha256-...', desc: 'Match publisher digest' },
{ cmd: 'verify --against-lock', desc: 'Verify vs lockfile' },
{ cmd: 'audit log', desc: 'View audit logs' },
{ cmd: 'validate', desc: 'Validate format' },
],
@@ -246,7 +246,7 @@ export function CompatibilityMatrix(): React.ReactElement {
<div>
<h2 className="text-lg sm:text-xl font-bold text-white mb-1 font-mono">Compatibility Matrix</h2>
<p className="text-zinc-500 font-mono text-[10px] sm:text-xs">
Skill support across all 44 agents and {CATEGORIES.length} categories.
Skill support across all 46 agents and {CATEGORIES.length} categories.
</p>
</div>
<div className="flex items-center gap-2">
+39 -11
View File
@@ -42,13 +42,13 @@ const sections: DocSection[] = [
content: (
<div className="space-y-4">
<p className="text-zinc-300">
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 44 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 46 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
</p>
<h3 className="text-lg font-semibold text-white mt-6">Core Capabilities</h3>
<ul className="list-disc list-inside space-y-2 text-zinc-400">
<li><span className="text-white">AI Instruction Generation (Primer)</span> - Analyze your codebase and generate customized instruction files for all 44 agents</li>
<li><span className="text-white">AI Instruction Generation (Primer)</span> - Analyze your codebase and generate customized instruction files for all 46 agents</li>
<li><span className="text-white">Skill Discovery</span> - Browse 400K+ skills from registries with AI-powered recommendations</li>
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 44 agent-specific formats</li>
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 46 agent-specific formats</li>
<li><span className="text-white">Team Collaboration</span> - Share skills via .skills manifest files and publish to marketplace</li>
</ul>
</div>
@@ -60,14 +60,42 @@ const sections: DocSection[] = [
content: (
<div className="space-y-4">
<h3 className="text-lg font-semibold text-white">Quick Start</h3>
<CodeBlock>{`# Install globally via npm
<CodeBlock>{`# Full install — every feature works out of the box (default):
npm install -g skillkit
# Or use npx directly
npx skillkit --help
# Slim install — core commands only, ~75% smaller, 0 deprecation warnings:
npm install -g skillkit --omit=optional
# Or install via pnpm
pnpm add -g skillkit`}</CodeBlock>
# Or use npx directly:
npx skillkit --help`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Optional Features</h3>
<p className="text-zinc-300 text-sm">
TUI, REST server, peer mesh, and inter-agent messaging ship as optional
dependencies. They install by default, or add later à la carte:
</p>
<CodeBlock>{`npm install -g @skillkit/tui # enables: skillkit ui
npm install -g @skillkit/api # enables: skillkit serve
npm install -g @skillkit/mesh # enables: skillkit mesh
npm install -g @skillkit/messaging # enables: skillkit message`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Using npx (no install)</h3>
<p className="text-zinc-300 text-sm">
<code className="text-zinc-200">npx skillkit add &lt;owner/repo&gt;</code> runs with zero install.
First call caches the package at <code className="text-zinc-200">~/.npm/_npx/</code>; every
run after that is instant until a new version ships.
</p>
<CodeBlock>{`# Full (default):
npx skillkit add anthropics/skills
# Slim — core only, 75% fewer packages, 0 warnings:
npx --omit=optional skillkit add anthropics/skills`}</CodeBlock>
<p className="text-zinc-300 text-sm">
Using npx more than a couple times? Install globally to skip the
prompt-to-proceed and avoid the per-release cache refetch:
</p>
<CodeBlock>{`npm install -g skillkit --omit=optional
skillkit add anthropics/skills`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Verify Installation</h3>
<CodeBlock>{`skillkit --version
@@ -101,7 +129,7 @@ skillkit install anthropics/skills`}</CodeBlock>
<ul className="list-disc list-inside space-y-2 text-zinc-400">
<li><span className="text-white">UI Tier</span> - CLI commands, Terminal UI (OpenTUI-based), and documentation website</li>
<li><span className="text-white">Core Logic Tier</span> - @skillkit/core for business logic; @skillkit/agents for adapter implementations</li>
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 44 AI agents</li>
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 46 AI agents</li>
</ul>
<h3 className="text-lg font-semibold text-white mt-6">Monorepo Structure</h3>
@@ -129,7 +157,7 @@ skillkit install anthropics/skills`}</CodeBlock>
content: (
<div className="space-y-4">
<p className="text-zinc-300">
SkillKit supports 44 AI coding agents with automatic format translation:
SkillKit supports 46 AI coding agents with automatic format translation:
</p>
<Table
@@ -206,7 +234,7 @@ skillkit cicd init # Setup CI/CD integration`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">AI Instruction Generation (Primer)</h3>
<CodeBlock>{`skillkit primer # Analyze codebase, generate for detected agents
skillkit primer --all-agents # Generate for all 44 agents
skillkit primer --all-agents # Generate for all 46 agents
skillkit primer --agent claude-code,cursor # Specific agents only
skillkit primer --analyze-only # Only show codebase analysis
skillkit primer --dry-run # Preview without writing files
+15 -5
View File
@@ -18,7 +18,7 @@ const FEATURES: Feature[] = [
},
{
title: 'Auto Translation',
description: 'The npm for agent skills. Write once, auto-translate to 44 formats.',
description: 'The npm for agent skills. Write once, auto-translate to 45 formats.',
icon: (
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M8 7h12m0 0l-4-4m4 4l-4 4m0 6H4m0 0l4 4m-4-4l4-4" />
@@ -36,7 +36,7 @@ const FEATURES: Feature[] = [
},
{
title: 'Primer',
description: 'Auto-generate agent instructions for all 44 agents from your codebase.',
description: 'Auto-generate agent instructions for all 46 agents from your codebase.',
icon: (
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M13 10V3L4 14h7v7l9-11h-7z" />
@@ -79,6 +79,15 @@ const FEATURES: Feature[] = [
</svg>
)
},
{
title: 'Content Integrity',
description: 'SHA-256 SRI digests on publish, install, and lock. Detect supply-chain tampering with skillkit verify.',
icon: (
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9 12l2 2 4-4m5.618-4.016A11.955 11.955 0 0112 2.944a11.955 11.955 0 01-8.618 5.04A12.02 12.02 0 003 9c0 5.591 3.824 10.29 9 11.622 5.176-1.332 9-6.03 9-11.622 0-.34-.024-.673-.07-1.002z" />
</svg>
)
},
{
title: 'Testing',
description: 'Built-in test framework with assertions.',
@@ -109,11 +118,12 @@ const FEATURES: Feature[] = [
];
const COMPARISONS = [
['Agent Support', '1-17 agents', '44 agents'],
['Agent Support', '1-17 agents', '46 agents'],
['Sources', 'Single registry', '34+ aggregated'],
['Translation', 'None or limited', 'All 44 formats'],
['Translation', 'None or limited', 'All 45 formats'],
['Memory', 'None', 'Persistent learning'],
['Security', 'None', '46-rule scanner'],
['Integrity', 'None', 'SHA-256 SRI + lockfile'],
['Team Sync', 'None', '.skills manifest'],
['Telemetry', 'Varies', 'Zero. Ever.'],
['API Access', 'None', 'REST + MCP + Python'],
@@ -131,7 +141,7 @@ export function Features(): React.ReactElement {
</p>
<div className="flex gap-6 sm:gap-8">
<div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">44</div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">45</div>
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Agents</div>
</div>
<div>
+2 -2
View File
@@ -22,7 +22,7 @@ interface TerminalLine {
const TERMINAL_LINES: TerminalLine[] = [
{ type: 'cmd', text: 'skillkit install anthropics/skills' },
{ type: 'out', text: '→ Fetched from github.com/anthropics/skills' },
{ type: 'out', text: '→ Translated to 44 agent formats' },
{ type: 'out', text: '→ Translated to 46 agent formats' },
{ type: 'out', text: '→ Scanned: 0 issues found' },
{ type: 'cmd', text: 'skillkit install skills.sh/vercel/agent-skills' },
{ type: 'out', text: '→ Installed 12 skills from skills.sh' },
@@ -149,7 +149,7 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
<p className="text-sm text-zinc-400 mb-5 max-w-lg font-mono leading-relaxed">
The open source package manager that aggregates 34+ skill sources,
scans 400K+ skills from registries, auto-translates to 44 agent formats,
scans 400K+ skills from registries, auto-translates to 46 agent formats,
and adds memory, security scanning, and team workflows. Everything runs locally.
</p>
+1 -1
View File
@@ -13,7 +13,7 @@ const USE_CASES: UseCase[] = [
{
persona: 'Multi-Agent Developer',
problem: 'You\'ve built skills for Claude Code. Now your team wants Cursor, and you want to try Windsurf.',
solution: 'SkillKit translates skills between all 44 agents. Write once, deploy everywhere.',
solution: 'SkillKit translates skills between all 46 agents. Write once, deploy everywhere.',
command: 'skillkit translate --to cursor,windsurf',
gradient: 'from-violet-500/10 to-purple-500/10',
icon: (
+1 -1
View File
@@ -18,7 +18,7 @@ const COMPETITORS: Competitor[] = [
{ name: 'Askill', type: 'Installer', agents: '~40', translate: false, memory: false, security: true, team: false, tui: false, api: false },
{ name: 'Skild', type: 'Installer', agents: '~7', translate: false, memory: false, security: false, team: false, tui: false, api: false },
{ name: 'Paks', type: 'Installer', agents: '~6', translate: false, memory: false, security: false, team: false, tui: false, api: false },
{ name: 'SkillKit', type: 'Platform', agents: '44', translate: true, memory: true, security: true, team: true, tui: true, api: true },
{ name: 'SkillKit', type: 'Platform', agents: '46', translate: true, memory: true, security: true, team: true, tui: true, api: true },
];
const SOURCES = [
+3 -3
View File
@@ -4,13 +4,13 @@
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>SkillKit - Universal Skills for AI Coding Agents</title>
<meta name="description" content="Write once, deploy to 44 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
<meta name="description" content="Write once, deploy to 46 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
<!-- Open Graph -->
<meta property="og:type" content="website">
<meta property="og:url" content="https://skillkit.sh/">
<meta property="og:title" content="SkillKit - Universal Skills for AI Coding Agents">
<meta property="og:description" content="Write once, deploy to 44 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
<meta property="og:description" content="Write once, deploy to 46 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
<meta property="og:image" content="https://skillkit.sh/og-image.png">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
@@ -20,7 +20,7 @@
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:url" content="https://skillkit.sh/">
<meta name="twitter:title" content="SkillKit - Universal Skills for AI Coding Agents">
<meta name="twitter:description" content="Write once, deploy to 44 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
<meta name="twitter:description" content="Write once, deploy to 46 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
<meta name="twitter:image" content="https://skillkit.sh/og-image.png">
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+1 -1
View File
@@ -1,5 +1,5 @@
{
"name": "SkillKit",
"description": "Supercharge Every AI Coding Agent. Translate, manage, and sync skills across Claude, Cursor, Windsurf, and 44 agents.",
"description": "Supercharge Every AI Coding Agent. Translate, manage, and sync skills across Claude, Cursor, Windsurf, and 46 agents.",
"requestFramePermissions": []
}
+1 -1
View File
@@ -1,7 +1,7 @@
{
"name": "skillkit",
"private": true,
"version": "1.19.2",
"version": "1.24.0",
"type": "module",
"scripts": {
"dev": "vite",
+1 -1
View File
@@ -3,7 +3,7 @@
"info": {
"title": "SkillKit",
"version": "1.12.0",
"description": "Skills shouldn't require pre-installation. This API lets any agent, framework, or tool discover and retrieve skills on demand.\n\n400K+ skills across 44 AI coding agents. Results ranked by a multi-signal scoring system (content 40pts, query match 30pts, popularity 15pts, references 15pts).\n\n## Quick Start\n\n```bash\nnpx skillkit serve\n```\n\nThe API is now running at http://localhost:3737\n\n## MCP Server\n\nFor agent-native discovery (Claude Desktop, Cursor):\n\n```json\n{\n \"mcpServers\": {\n \"skillkit\": { \"command\": \"npx\", \"args\": [\"@skillkit/mcp\"] }\n }\n}\n```\n\n## Python Client\n\n```bash\npip install skillkit-client\n```",
"description": "Skills shouldn't require pre-installation. This API lets any agent, framework, or tool discover and retrieve skills on demand.\n\n400K+ skills across 46 AI coding agents. Results ranked by a multi-signal scoring system (content 40pts, query match 30pts, popularity 15pts, references 15pts).\n\n## Quick Start\n\n```bash\nnpx skillkit serve\n```\n\nThe API is now running at http://localhost:3737\n\n## MCP Server\n\nFor agent-native discovery (Claude Desktop, Cursor):\n\n```json\n{\n \"mcpServers\": {\n \"skillkit\": { \"command\": \"npx\", \"args\": [\"@skillkit/mcp\"] }\n }\n}\n```\n\n## Python Client\n\n```bash\npip install skillkit-client\n```",
"license": {
"name": "Apache-2.0",
"url": "https://opensource.org/licenses/Apache-2.0"
+138
View File
@@ -0,0 +1,138 @@
# Humans + agents welcome. Training crawlers + SEO scrapers blocked.
User-agent: Googlebot
Allow: /
User-agent: Bingbot
Allow: /
User-agent: DuckDuckBot
Allow: /
User-agent: Applebot
Allow: /
User-agent: ChatGPT-User
Allow: /
User-agent: OAI-SearchBot
Allow: /
User-agent: PerplexityBot
Allow: /
User-agent: Perplexity-User
Allow: /
User-agent: Claude-User
Allow: /
User-agent: Claude-SearchBot
Allow: /
User-agent: FirecrawlAgent
Allow: /
User-agent: firecrawl
Allow: /
User-agent: Context7Bot
Allow: /
User-agent: Crawl4AI
Allow: /
User-agent: Clawdbot
Allow: /
User-agent: OpenClaw
Allow: /
User-agent: Hermes
Allow: /
User-agent: GPTBot
Disallow: /
User-agent: ClaudeBot
Disallow: /
User-agent: anthropic-ai
Disallow: /
User-agent: CCBot
Disallow: /
User-agent: Google-Extended
Disallow: /
User-agent: Applebot-Extended
Disallow: /
User-agent: Bytespider
Disallow: /
User-agent: Amazonbot
Disallow: /
User-agent: FacebookBot
Disallow: /
User-agent: Meta-ExternalAgent
Disallow: /
User-agent: cohere-ai
Disallow: /
User-agent: Diffbot
Disallow: /
User-agent: ImagesiftBot
Disallow: /
User-agent: Omgilibot
Disallow: /
User-agent: peer39_crawler
Disallow: /
User-agent: YouBot
Disallow: /
User-agent: Timpibot
Disallow: /
User-agent: ICC-Crawler
Disallow: /
User-agent: AhrefsBot
Disallow: /
User-agent: SemrushBot
Disallow: /
User-agent: MJ12bot
Disallow: /
User-agent: DotBot
Disallow: /
User-agent: PetalBot
Disallow: /
User-agent: BLEXBot
Disallow: /
User-agent: MegaIndex
Disallow: /
User-agent: SeznamBot
Disallow: /
User-agent: DataForSeoBot
Disallow: /
User-agent: *
Allow: /
Sitemap: https://skillkit.dev/sitemap.xml
+42
View File
@@ -21,5 +21,47 @@
"source": "/docs",
"destination": "https://skillkit-docs.vercel.app/docs"
}
],
"headers": [
{
"source": "/(.*)\\.(css|js|png|jpg|jpeg|svg|webp|woff2|woff|ttf|ico|mp4)",
"headers": [
{ "key": "Cache-Control", "value": "public, max-age=86400, s-maxage=604800, stale-while-revalidate=2592000" }
]
},
{
"source": "/assets/(.*)",
"headers": [
{ "key": "Cache-Control", "value": "public, max-age=31536000, immutable" }
]
},
{
"source": "/(.*)\\.html",
"headers": [
{ "key": "Cache-Control", "value": "public, max-age=300, s-maxage=86400, stale-while-revalidate=604800" }
]
},
{
"source": "/",
"headers": [
{ "key": "Cache-Control", "value": "public, max-age=300, s-maxage=86400, stale-while-revalidate=604800" }
]
},
{
"source": "/api",
"headers": [
{ "key": "Cache-Control", "value": "public, max-age=300, s-maxage=86400, stale-while-revalidate=604800" }
]
}
],
"redirects": [
{
"source": "/((?!robots\\.txt$).*)",
"has": [
{ "type": "header", "key": "user-agent", "value": "(?i).*(GPTBot|ClaudeBot|anthropic-ai|CCBot|Google-Extended|Applebot-Extended|Bytespider|Amazonbot|Meta-ExternalAgent|cohere-ai|Diffbot|ImagesiftBot|Omgilibot|peer39_crawler|YouBot|Timpibot|ICC-Crawler|AhrefsBot|SemrushBot|MJ12bot|DotBot|PetalBot|BLEXBot|MegaIndex|SeznamBot|DataForSeoBot).*" }
],
"destination": "/robots.txt",
"permanent": false
}
]
}
Binary file not shown.
+2 -1
View File
@@ -44,7 +44,7 @@ describe('E2E: Onboarding UI', () => {
expect(result.success).toBe(true);
});
it('should display all 44 agents', async () => {
it('should display all 46 agents', async () => {
const result = await runCli(['init', '--list']);
const output = result.stdout + result.stderr;
@@ -93,6 +93,7 @@ describe('E2E: Onboarding UI', () => {
'Tabnine',
'CodeGPT',
'PlayCode',
'Hermes',
];
for (const agent of agents) {
+2 -1
View File
@@ -28,7 +28,7 @@ import {
type CrossAgentSkill,
} from '@skillkit/core';
// All 44 supported agents
// All 46 supported agents
const SUPPORTED_AGENTS = [
'claude-code',
'cursor',
@@ -74,6 +74,7 @@ const SUPPORTED_AGENTS = [
'tabnine',
'codegpt',
'playcode-agent',
'hermes',
] as const;
describe('E2E: Skill Translator - Parsing', () => {
+3 -2
View File
@@ -2,7 +2,7 @@
* E2E Tests: Skill Translation Commands
*
* Tests for: translate, context, recommend
* Validates translation to all 44 supported agents
* Validates translation to all 45 supported agents
*/
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
@@ -16,7 +16,7 @@ import {
testFileExists,
} from './helpers/cli-runner.js';
// All 44 supported agents
// All 46 supported agents
const SUPPORTED_AGENTS = [
'claude-code',
'cursor',
@@ -62,6 +62,7 @@ const SUPPORTED_AGENTS = [
'tabnine',
'codegpt',
'playcode-agent',
'hermes',
] as const;
describe('E2E: Skill Translation', () => {
+2 -1
View File
@@ -1,7 +1,7 @@
{
"$schema": "./sources-schema.json",
"version": 1,
"updatedAt": "2026-02-28",
"updatedAt": "2026-04-10",
"description": "Curated skill repository sources - THE SINGLE SOURCE OF TRUTH",
"sources": [
{ "source": "anthropics/skills", "name": "Anthropic Official", "official": true },
@@ -37,6 +37,7 @@
{ "source": "intellectronica/agent-skills", "name": "Context7" },
{ "source": "muratcankoylan/Agent-Skills-for-Context-Engineering", "name": "Context Engineering" },
{ "source": "sickn33/antigravity-awesome-skills", "name": "Antigravity Awesome Skills" },
{ "source": "NousResearch/hermes-agent", "name": "Hermes Agent Skills" },
{ "source": "skills.sh", "name": "Skills.sh Leaderboard", "official": true, "registry": "skills-sh" }
]
}
+2 -2
View File
@@ -1,8 +1,8 @@
{
"name": "skillkit-monorepo",
"version": "1.19.2",
"version": "1.24.0",
"private": true,
"description": "The package manager for AI agent skills — install, translate, share across 44 coding agents",
"description": "The package manager for AI agent skills — install, translate, share across 46 coding agents",
"type": "module",
"scripts": {
"build": "turbo run build",
+28 -2
View File
@@ -3,7 +3,7 @@
[![npm version](https://img.shields.io/npm/v/@skillkit/agents.svg)](https://www.npmjs.com/package/@skillkit/agents)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
**Agent adapters for SkillKit** - configuration and detection for 32 AI coding agents.
**Agent adapters for SkillKit** - configuration and detection for 46 AI coding agents.
## Installation
@@ -11,7 +11,7 @@
npm install @skillkit/agents
```
## Supported Agents (32)
## Supported Agents (46)
| Agent | Config Format | Project Skills | Global Skills |
|-------|--------------|----------------|---------------|
@@ -23,11 +23,14 @@ npm install @skillkit/agents
| Antigravity | SKILL.md | `.antigravity/skills/` | - |
| Amp | SKILL.md | `.amp/skills/` | - |
| Clawdbot | SKILL.md | `.clawdbot/skills/` | - |
| OpenClaw | SKILL.md | `.openclaw/skills/` | `~/.openclaw/workspace/skills/` |
| Cline | SKILL.md | `.cline/skills/` | - |
| CodeBuddy | SKILL.md | `.codebuddy/skills/` | - |
| CodeGPT | SKILL.md | `.codegpt/skills/` | - |
| CommandCode | SKILL.md | `.commandcode/skills/` | - |
| Continue | SKILL.md | `.continue/skills/` | `~/.continue/skills/` |
| Crush | SKILL.md | `.crush/skills/` | - |
| Devin | SKILL.md | `.devin/skills/` | - |
| Droid (Factory) | SKILL.md | `.factory/skills/` | - |
| Factory | SKILL.md | `.factory/skills/` | - |
| GitHub Copilot | Markdown | `.github/skills/` | - |
@@ -39,6 +42,7 @@ npm install @skillkit/agents
| Neovate | SKILL.md | `.neovate/skills/` | - |
| OpenHands | SKILL.md | `.openhands/skills/` | - |
| Pi | SKILL.md | `.pi/skills/` | - |
| PlayCode Agent | SKILL.md | `.playcode/skills/` | - |
| Qoder | SKILL.md | `.qoder/skills/` | - |
| Qwen | SKILL.md | `.qwen/skills/` | - |
| Roo Code | SKILL.md | `.roo/skills/` | `~/.roo/skills/` |
@@ -46,6 +50,15 @@ npm install @skillkit/agents
| Vercel | SKILL.md | `.vercel/skills/` | - |
| Windsurf | Markdown | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
| Zencoder | SKILL.md | `.zencoder/skills/` | - |
| Aider | SKILL.md | `.aider/skills/` | - |
| Amazon Q | SKILL.md | `.amazonq/skills/` | - |
| Augment Code | SKILL.md | `.augment/skills/` | - |
| Bolt | SKILL.md | `.bolt/skills/` | - |
| Lovable | SKILL.md | `.lovable/skills/` | - |
| Replit Agent | SKILL.md | `.replit/skills/` | - |
| Sourcegraph Cody | SKILL.md | `.cody/skills/` | - |
| Tabby | SKILL.md | `.tabby/skills/` | - |
| Tabnine | SKILL.md | `.tabnine/skills/` | - |
| Universal | SKILL.md | `skills/` | - |
## Usage
@@ -170,11 +183,14 @@ type AgentType =
| 'antigravity'
| 'amp'
| 'clawdbot'
| 'openclaw'
| 'cline'
| 'codebuddy'
| 'codegpt'
| 'commandcode'
| 'continue'
| 'crush'
| 'devin'
| 'droid'
| 'factory'
| 'github-copilot'
@@ -186,6 +202,7 @@ type AgentType =
| 'neovate'
| 'openhands'
| 'pi'
| 'playcode-agent'
| 'qoder'
| 'qwen'
| 'roo'
@@ -193,6 +210,15 @@ type AgentType =
| 'vercel'
| 'windsurf'
| 'zencoder'
| 'aider'
| 'amazon-q'
| 'augment-code'
| 'bolt'
| 'lovable'
| 'replit-agent'
| 'sourcegraph-cody'
| 'tabby'
| 'tabnine'
| 'universal';
```
+2 -2
View File
@@ -1,7 +1,7 @@
{
"name": "@skillkit/agents",
"version": "1.19.2",
"description": "Agent adapters for SkillKit - supports 32 AI coding agents",
"version": "1.24.0",
"description": "Agent adapters for SkillKit - supports 46 AI coding agents",
"type": "module",
"main": "./dist/index.js",
"types": "./dist/index.d.ts",
+41 -2
View File
@@ -35,10 +35,10 @@ const ALL_AGENTS = AgentType.options;
describe('Agent Adapters', () => {
describe('getAllAdapters', () => {
it('should return all 45 registered adapters', () => {
it('should return all 46 registered adapters', () => {
const adapters = getAllAdapters();
expect(adapters).toBeInstanceOf(Array);
expect(adapters.length).toBe(45);
expect(adapters.length).toBe(46);
});
it('should include common agents', () => {
@@ -140,4 +140,43 @@ describe('Agent Adapters', () => {
expect(typeof agent).toBe('string');
});
});
describe('HermesAdapter', () => {
it('should generate valid XML config', () => {
const adapter = getAdapter('hermes');
const mockSkills = [
{ name: 'test-skill', description: 'Testing', enabled: true, path: '', location: 'project' }
];
const config = adapter.generateConfig(mockSkills as any);
expect(config).toContain('<skills_system');
expect(config).toContain('<name>test-skill</name>');
expect(config).toContain('SKILLS_TABLE_START');
});
it('should parse skill names from XML correctly within markers', () => {
const adapter = getAdapter('hermes');
const xml = `
<!-- SKILLS_TABLE_START -->
<available_skills><skill><name>git-ops</name></skill></available_skills>
<!-- SKILLS_TABLE_END -->`;
const names = adapter.parseConfig(xml);
expect(names).toContain('git-ops');
});
it('should ignore <name> tags outside of sync markers', () => {
const adapter = getAdapter('hermes');
const xml = `
<mission><name>save-the-world</name></mission>
<!-- SKILLS_TABLE_START -->
<available_skills><skill><name>git-ops</name></skill></available_skills>
<!-- SKILLS_TABLE_END -->
<footer_meta><name>internal-id</name></footer_meta>`;
const names = adapter.parseConfig(xml);
expect(names).toHaveLength(1);
expect(names).toContain('git-ops');
expect(names).not.toContain('save-the-world');
expect(names).not.toContain('internal-id');
});
});
});
+1
View File
@@ -33,6 +33,7 @@ const AGENT_DISPLAY_NAMES: Partial<Record<AgentType, string>> = {
'tabnine': 'Tabnine',
'codegpt': 'CodeGPT',
'playcode-agent': 'PlayCode Agent',
'hermes': 'Hermes',
};
export class GenericAgentAdapter implements AgentAdapter {
+93
View File
@@ -0,0 +1,93 @@
import { existsSync } from 'node:fs';
import { join } from 'node:path';
import { homedir } from 'node:os';
import type { AgentAdapter } from './base.js';
import { createSkillXml } from './base.js';
import type { Skill, AgentType } from '@skillkit/core';
import { AGENT_CONFIG } from '@skillkit/core';
const config = AGENT_CONFIG.hermes;
/**
* Hermes Agent Adapter
*
* Hermes Agent is an advanced AI agent with support for XML-based skills.
* It uses AGENTS.md for instructions and ~/.hermes/skills/ for global skills.
*/
export class HermesAdapter implements AgentAdapter {
readonly type: AgentType = 'hermes';
readonly name = 'Hermes Agent';
readonly skillsDir = config.skillsDir;
readonly configFile = config.configFile;
generateConfig(skills: Skill[]): string {
const enabledSkills = skills.filter(s => s.enabled);
if (enabledSkills.length === 0) {
return '';
}
const skillsXml = enabledSkills.map(createSkillXml).join('\n\n');
return `<skills_system priority="1">
## Available Skills
<!-- SKILLS_TABLE_START -->
<usage>
When users ask you to perform tasks, check if any of the available skills below can help complete the task more effectively. Skills provide specialized capabilities and domain knowledge.
How to use skills:
- Invoke: \`skillkit read <skill-name>\` or \`npx skillkit read <skill-name>\`
- The skill content will load with detailed instructions on how to complete the task
- Base directory provided in output for resolving bundled resources (references/, scripts/, assets/)
Usage notes:
- Only use skills listed in <available_skills> below
- Do not invoke a skill that is already loaded in your context
- Each skill invocation is stateless
</usage>
<available_skills>
${skillsXml}
</available_skills>
<!-- SKILLS_TABLE_END -->
</skills_system>`;
}
parseConfig(content: string): string[] {
const startMarker = '<!-- SKILLS_TABLE_START -->';
const endMarker = '<!-- SKILLS_TABLE_END -->';
const startIndex = content.indexOf(startMarker);
const endIndex = content.indexOf(endMarker);
if (startIndex === -1 || endIndex === -1) {
return [];
}
const scopedContent = content.substring(startIndex + startMarker.length, endIndex);
const skillNames: string[] = [];
const skillRegex = /<name>([^<]+)<\/name>/g;
let match;
while ((match = skillRegex.exec(scopedContent)) !== null) {
skillNames.push(match[1].trim());
}
return skillNames;
}
getInvokeCommand(skillName: string): string {
return `skillkit read ${skillName}`;
}
async isDetected(): Promise<boolean> {
const projectHermes = join(process.cwd(), '.hermes');
const globalHermes = join(homedir(), '.hermes');
return existsSync(projectHermes) || existsSync(globalHermes);
}
}
+4
View File
@@ -19,6 +19,7 @@ import { RooAdapter } from './roo.js';
import { TraeAdapter } from './trae.js';
import { WindsurfAdapter } from './windsurf.js';
import { UniversalAdapter } from './universal.js';
import { HermesAdapter } from './hermes.js';
import { GenericAgentAdapter } from './generic.js';
export * from './base.js';
@@ -41,6 +42,7 @@ export * from './roo.js';
export * from './trae.js';
export * from './windsurf.js';
export * from './universal.js';
export * from './hermes.js';
export * from './generic.js';
// Agent features
@@ -92,6 +94,7 @@ const adapters: Record<AgentType, AgentAdapter> = {
tabnine: new GenericAgentAdapter('tabnine'),
codegpt: new GenericAgentAdapter('codegpt'),
'playcode-agent': new GenericAgentAdapter('playcode-agent'),
hermes: new HermesAdapter(),
};
export function getAdapter(type: AgentType): AgentAdapter {
@@ -160,6 +163,7 @@ export async function detectAgent(): Promise<AgentType> {
'tabnine',
'codegpt',
'playcode-agent',
'hermes',
'universal',
];
+4 -1
View File
@@ -14,9 +14,12 @@ export class OpenClawAdapter extends ClawdbotAdapter {
override readonly configFile = config.configFile;
override async isDetected(): Promise<boolean> {
const projectOpenClaw = join(process.cwd(), '.openclaw');
const globalOpenClaw = join(homedir(), '.openclaw');
const globalWorkspace = join(homedir(), '.openclaw', 'workspace');
const openclawConfig = join(process.cwd(), 'openclaw.json');
return existsSync(globalOpenClaw) || existsSync(openclawConfig);
return existsSync(projectOpenClaw) || existsSync(globalOpenClaw) ||
existsSync(globalWorkspace) || existsSync(openclawConfig);
}
}
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/api",
"version": "1.19.2",
"version": "1.24.0",
"description": "REST API server for SkillKit skill discovery",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -5,7 +5,7 @@ const OPENAPI_SPEC = {
info: {
title: 'SkillKit',
version: '1.12.0',
description: 'Skill Discovery API for AI coding agents. Search, browse, and retrieve skills from the SkillKit marketplace (400K+ skills across 44 agents).',
description: 'Skill Discovery API for AI coding agents. Search, browse, and retrieve skills from the SkillKit marketplace (400K+ skills across 46 agents).',
license: { name: 'Apache-2.0', url: 'https://opensource.org/licenses/Apache-2.0' },
contact: { name: 'SkillKit', url: 'https://github.com/rohitg00/skillkit' },
},
+2 -2
View File
@@ -3,7 +3,7 @@
[![npm version](https://img.shields.io/npm/v/@skillkit/cli.svg)](https://www.npmjs.com/package/@skillkit/cli)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
**Command-line interface for SkillKit** - install, manage, translate, and sync skills across 32 AI coding agents.
**Command-line interface for SkillKit** - install, manage, translate, and sync skills across 46 AI coding agents.
## Installation
@@ -264,7 +264,7 @@ const recs = await recommendCommand({
| Gemini CLI | SKILL.md |
| Windsurf | Markdown |
| GitHub Copilot | Markdown |
| + 26 more | SKILL.md |
| + 39 more | SKILL.md |
## Documentation
+7 -6
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/cli",
"version": "1.19.2",
"version": "1.24.0",
"description": "CLI commands for SkillKit",
"type": "module",
"main": "./dist/index.js",
@@ -22,14 +22,9 @@
},
"dependencies": {
"@clack/prompts": "^0.11.0",
"@skillkit/api": "workspace:*",
"@skillkit/core": "workspace:*",
"@skillkit/agents": "workspace:*",
"@skillkit/resources": "workspace:*",
"@skillkit/tui": "workspace:*",
"@skillkit/memory": "workspace:*",
"@skillkit/mesh": "workspace:*",
"@skillkit/messaging": "workspace:*",
"chalk": "^5.3.0",
"clipanion": "^4.0.0-rc.4",
"got": "^14.4.1",
@@ -38,6 +33,12 @@
"picocolors": "^1.1.1",
"yaml": "^2.7.0"
},
"optionalDependencies": {
"@skillkit/api": "workspace:*",
"@skillkit/tui": "workspace:*",
"@skillkit/mesh": "workspace:*",
"@skillkit/messaging": "workspace:*"
},
"devDependencies": {
"@types/node": "^22.10.5",
"tsup": "^8.3.5",
@@ -30,6 +30,8 @@ describe('CLI Commands', () => {
expect(commands.SessionSnapshotListCommand).toBeDefined();
expect(commands.SessionSnapshotDeleteCommand).toBeDefined();
expect(commands.SessionExplainCommand).toBeDefined();
expect(commands.VerifyCommand).toBeDefined();
expect(commands.ScanCommand).toBeDefined();
});
});
});
@@ -96,10 +96,10 @@ describe('Onboarding Module', () => {
it('should generate full logo with version', async () => {
const { getFullLogo } = await import('../onboarding/logo.js');
const logo = getFullLogo('1.7.2', 44);
const logo = getFullLogo('1.7.2', 46);
expect(logo).toContain('\u2588');
expect(logo).toContain('v1.7.2');
expect(logo).toContain('44 agents');
expect(logo).toContain('46 agents');
});
it('should generate compact logo', async () => {
+82
View File
@@ -0,0 +1,82 @@
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
import { mkdtempSync, writeFileSync, rmSync, mkdirSync } from 'node:fs';
import { tmpdir } from 'node:os';
import { join } from 'node:path';
import { execFileSync } from 'node:child_process';
const CLI = join(__dirname, '../../../../apps/skillkit/dist/cli.js');
function run(args: string[]): { code: number; stdout: string; stderr: string } {
try {
const stdout = execFileSync(process.execPath, [CLI, ...args], {
encoding: 'utf-8',
stdio: ['ignore', 'pipe', 'pipe'],
});
return { code: 0, stdout, stderr: '' };
} catch (err: any) {
return {
code: err.status ?? 1,
stdout: err.stdout?.toString() ?? '',
stderr: err.stderr?.toString() ?? '',
};
}
}
describe('skillkit verify', () => {
let dir: string;
beforeEach(() => {
dir = mkdtempSync(join(tmpdir(), 'skillkit-verify-cli-'));
});
afterEach(() => {
rmSync(dir, { recursive: true, force: true });
});
it('prints an SRI digest by default', () => {
writeFileSync(join(dir, 'SKILL.md'), '# test\n');
const r = run(['verify', dir]);
expect(r.code).toBe(0);
expect(r.stdout.trim()).toMatch(/^sha256-[A-Za-z0-9+/]+=*$/);
});
it('emits JSON with --json', () => {
writeFileSync(join(dir, 'SKILL.md'), '# test\n');
mkdirSync(join(dir, 'scripts'));
writeFileSync(join(dir, 'scripts', 'a.sh'), 'echo');
const r = run(['verify', dir, '--json']);
expect(r.code).toBe(0);
const payload = JSON.parse(r.stdout);
expect(payload.ok).toBe(true);
expect(payload.algorithm).toBe('sha256');
expect(payload.sri).toMatch(/^sha256-/);
expect(typeof payload.digest).toBe('string');
expect(payload.totalBytes).toBeGreaterThan(0);
});
it('returns exit 1 on integrity mismatch', () => {
writeFileSync(join(dir, 'SKILL.md'), 'hello');
const bogus = 'sha256-' + Buffer.alloc(32, 7).toString('base64');
const r = run(['verify', dir, '--expected', bogus, '--json']);
expect(r.code).toBe(1);
const payload = JSON.parse(r.stdout);
expect(payload.ok).toBe(false);
expect(payload.reason).toBe('mismatch');
});
it('returns exit 0 when --expected matches', () => {
writeFileSync(join(dir, 'SKILL.md'), 'matched');
const computed = run(['verify', dir]);
const sri = computed.stdout.trim();
const r = run(['verify', dir, '--expected', sri, '--json']);
expect(r.code).toBe(0);
const payload = JSON.parse(r.stdout);
expect(payload.ok).toBe(true);
});
it('rejects garbage --expected', () => {
writeFileSync(join(dir, 'SKILL.md'), 'x');
const r = run(['verify', dir, '--expected', 'garbage']);
expect(r.code).toBe(1);
});
});
+18 -2
View File
@@ -2,7 +2,7 @@ import { Command, Option } from 'clipanion';
import { resolve } from 'node:path';
import { promises as fs } from 'fs';
import path from 'path';
import { colors, warn, success } from '../onboarding/index.js';
import { colors, warn, success, spinner } from '../onboarding/index.js';
import { AuditLogger, type AuditQuery, type AuditEventType } from '@skillkit/core';
export class AuditCommand extends Command {
@@ -114,8 +114,11 @@ export class AuditCommand extends Command {
}
private async handleLog(logger: AuditLogger): Promise<number> {
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
s.start('Querying audit log');
const query = this.buildQuery();
const events = await logger.query(query);
s.stop('Query complete');
if (this.json) {
console.log(JSON.stringify(events, null, 2));
@@ -163,10 +166,13 @@ export class AuditCommand extends Command {
}
private async handleExport(logger: AuditLogger): Promise<number> {
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
const format = (this.format as 'json' | 'csv' | 'text') || 'json';
const query = this.buildQuery();
s.start('Exporting audit log');
const content = await logger.export({ format, query });
s.stop('Export complete');
if (this.output) {
const outputPath = resolve(this.output);
@@ -180,7 +186,10 @@ export class AuditCommand extends Command {
}
private async handleStats(logger: AuditLogger): Promise<number> {
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
s.start('Computing statistics');
const stats = await logger.stats();
s.stop('Statistics computed');
if (this.json) {
console.log(JSON.stringify(stats, null, 2));
@@ -237,9 +246,16 @@ export class AuditCommand extends Command {
const cutoffDate = new Date();
cutoffDate.setDate(cutoffDate.getDate() - daysAgo);
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
s.start('Clearing old entries');
const cleared = await logger.clear(cutoffDate);
s.stop('Clear complete');
success(`✓ Cleared ${cleared} audit entries older than ${daysAgo} days`);
if (this.json) {
console.log(JSON.stringify({ success: true, cleared, days: daysAgo }));
} else {
success(`✓ Cleared ${cleared} audit entries older than ${daysAgo} days`);
}
return 0;
}
+98 -18
View File
@@ -1,8 +1,8 @@
import { existsSync } from 'node:fs';
import { existsSync, statSync } from 'node:fs';
import { join } from 'node:path';
import { Command, Option } from 'clipanion';
import { findAllSkills, findSkill, detectProvider, isLocalPath } from '@skillkit/core';
import { getSearchDirs, loadSkillMetadata } from '../helpers.js';
import { findAllSkills, findSkill, detectProvider, isLocalPath, evaluateSkillDirectory } from '@skillkit/core';
import { getSearchDirs, loadSkillMetadata, formatCount, timeAgo, fetchGitHubActivity } from '../helpers.js';
import {
colors,
symbols,
@@ -11,6 +11,8 @@ import {
success,
warn,
header,
formatQualityBadge,
getQualityGradeFromScore,
} from '../onboarding/index.js';
interface UpdateInfo {
@@ -18,15 +20,19 @@ interface UpdateInfo {
currentVersion?: string;
hasUpdate: boolean;
error?: string;
qualityScore?: number | null;
stars?: number | null;
pushedAt?: string | null;
}
export class CheckCommand extends Command {
static override paths = [['check']];
static override usage = Command.Usage({
description: 'Check for available skill updates (dry-run)',
description: 'Check installed skills for updates, quality, and activity',
details: `
Checks if installed skills have updates available from their sources.
Shows quality scores and GitHub activity for each skill.
Does not modify any files - just reports what would be updated.
`,
examples: [
@@ -46,11 +52,15 @@ export class CheckCommand extends Command {
description: 'Minimal output',
});
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const searchDirs = getSearchDirs();
const s = spinner();
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
if (!this.quiet) {
if (!this.quiet && !this.json) {
header('Check Updates');
}
@@ -79,7 +89,7 @@ export class CheckCommand extends Command {
return 0;
}
if (!this.quiet) {
if (!this.quiet && !this.json) {
step(`Checking ${skillsToCheck.length} skill(s) for updates...`);
console.log('');
}
@@ -89,12 +99,15 @@ export class CheckCommand extends Command {
for (const skill of skillsToCheck) {
const metadata = loadSkillMetadata(skill.path);
const quality = evaluateSkillDirectory(skill.path);
const qualityScore = quality?.overall ?? null;
if (!metadata) {
results.push({
name: skill.name,
hasUpdate: false,
error: 'No metadata (reinstall needed)',
qualityScore,
});
continue;
}
@@ -114,6 +127,7 @@ export class CheckCommand extends Command {
name: skill.name,
hasUpdate: false,
error: 'Local source missing',
qualityScore,
});
if (this.verbose) s.stop(`${skill.name}: source missing`);
continue;
@@ -123,20 +137,19 @@ export class CheckCommand extends Command {
const installedSkillMd = join(skill.path, 'SKILL.md');
if (existsSync(sourceSkillMd) && existsSync(installedSkillMd)) {
const { statSync } = await import('node:fs');
const sourceTime = statSync(sourceSkillMd).mtime;
const installedTime = statSync(installedSkillMd).mtime;
if (sourceTime > installedTime) {
results.push({ name: skill.name, hasUpdate: true });
results.push({ name: skill.name, hasUpdate: true, qualityScore });
updatesAvailable++;
if (this.verbose) s.stop(`${skill.name}: update available`);
} else {
results.push({ name: skill.name, hasUpdate: false });
results.push({ name: skill.name, hasUpdate: false, qualityScore });
if (this.verbose) s.stop(`${skill.name}: up to date`);
}
} else {
results.push({ name: skill.name, hasUpdate: false });
results.push({ name: skill.name, hasUpdate: false, qualityScore });
if (this.verbose) s.stop(`${skill.name}: up to date`);
}
} else {
@@ -147,15 +160,31 @@ export class CheckCommand extends Command {
name: skill.name,
hasUpdate: false,
error: 'Unknown provider',
qualityScore,
});
if (this.verbose) s.stop(`${skill.name}: unknown provider`);
continue;
}
const parsed = provider.parseSource(metadata.source);
let stars: number | null = null;
let pushedAt: string | null = null;
if (parsed && provider.name === 'GitHub') {
const activity = await fetchGitHubActivity(parsed.owner, parsed.repo);
if (activity) {
stars = activity.stars;
pushedAt = activity.pushedAt;
}
}
results.push({
name: skill.name,
hasUpdate: false,
currentVersion: metadata.updatedAt || metadata.installedAt,
qualityScore,
stars,
pushedAt,
});
if (this.verbose) s.stop(`${skill.name}: remote source (run update to sync)`);
}
@@ -164,11 +193,25 @@ export class CheckCommand extends Command {
name: skill.name,
hasUpdate: false,
error: err instanceof Error ? err.message : 'Check failed',
qualityScore,
});
if (this.verbose) s.stop(`${skill.name}: error`);
}
}
if (this.json) {
console.log(JSON.stringify({
skills: results.map((r) => ({
name: r.name,
hasUpdate: r.hasUpdate,
quality: r.qualityScore ?? null,
stars: r.stars ?? null,
})),
updatesAvailable,
}));
return 0;
}
console.log('');
const withUpdates = results.filter(r => r.hasUpdate);
@@ -178,27 +221,46 @@ export class CheckCommand extends Command {
if (withUpdates.length > 0) {
console.log(colors.primary('Updates available:'));
for (const r of withUpdates) {
console.log(` ${colors.success(symbols.arrowUp)} ${colors.primary(r.name)}`);
const badge = this.qualityBadgeFor(r.qualityScore);
console.log(` ${colors.success(symbols.arrowUp)} ${colors.primary(r.name)}${badge}`);
}
console.log('');
}
if (upToDate.length > 0 && this.verbose) {
console.log(colors.muted('Up to date:'));
for (const r of upToDate) {
console.log(` ${colors.muted(symbols.success)} ${colors.muted(r.name)}`);
if (upToDate.length > 0) {
if (this.verbose) {
console.log(colors.muted('Up to date:'));
}
console.log('');
for (const r of upToDate) {
const badge = this.qualityBadgeFor(r.qualityScore);
const activityStr = this.formatActivity(r);
if (this.verbose) {
console.log(` ${colors.muted(symbols.success)} ${colors.muted(r.name)}${badge}${activityStr}`);
}
}
if (this.verbose) console.log('');
}
if (withErrors.length > 0) {
console.log(colors.warning('Could not check:'));
for (const r of withErrors) {
console.log(` ${colors.warning(symbols.warning)} ${r.name}: ${colors.muted(r.error || 'unknown')}`);
const badge = this.qualityBadgeFor(r.qualityScore);
console.log(` ${colors.warning(symbols.warning)} ${r.name}${badge}: ${colors.muted(r.error || 'unknown')}`);
}
console.log('');
}
if (!this.quiet) {
const qualityScores = results
.map(r => r.qualityScore)
.filter((s): s is number => typeof s === 'number');
if (qualityScores.length > 0) {
const avg = Math.round(qualityScores.reduce((a, b) => a + b, 0) / qualityScores.length);
const grade = getQualityGradeFromScore(avg);
console.log(colors.muted(`Average quality: ${avg}/100 (${grade})`));
}
}
if (updatesAvailable > 0) {
success(`${updatesAvailable} update(s) available`);
console.log(colors.muted('Run `skillkit update` to install updates'));
@@ -208,4 +270,22 @@ export class CheckCommand extends Command {
return 0;
}
private qualityBadgeFor(score: number | null | undefined): string {
if (typeof score !== 'number') return '';
return ` ${formatQualityBadge(score)}`;
}
private formatActivity(r: UpdateInfo): string {
const parts: string[] = [];
if (typeof r.stars === 'number' && r.stars > 0) {
parts.push(`${formatCount(r.stars)} stars`);
}
if (r.pushedAt) {
parts.push(`pushed ${timeAgo(r.pushedAt)}`);
}
if (parts.length === 0) return '';
return ` ${colors.muted(`(${parts.join(', ')})`)}`;
}
}
+45 -19
View File
@@ -1,6 +1,6 @@
import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
import { join } from 'node:path';
import { colors, success, error, step } from '../onboarding/index.js';
import { colors, success, error, step, spinner } from '../onboarding/index.js';
import { Command, Option } from 'clipanion';
export class CreateCommand extends Command {
@@ -37,12 +37,21 @@ export class CreateCommand extends Command {
description: 'Parent directory to create skill in (default: current directory)',
});
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const skillName = this.name.toLowerCase();
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(skillName)) {
error('Invalid skill name');
console.log(colors.muted('Must be lowercase alphanumeric with hyphens (e.g., my-skill)'));
if (this.json) {
console.log(JSON.stringify({ success: false, error: 'Invalid skill name' }));
} else {
error('Invalid skill name');
console.log(colors.muted('Must be lowercase alphanumeric with hyphens (e.g., my-skill)'));
}
return 1;
}
@@ -50,11 +59,17 @@ export class CreateCommand extends Command {
const skillDir = join(parentDir, skillName);
if (existsSync(skillDir)) {
error(`Directory already exists: ${skillDir}`);
if (this.json) {
console.log(JSON.stringify({ success: false, error: `Directory already exists: ${skillDir}` }));
} else {
error(`Directory already exists: ${skillDir}`);
}
return 1;
}
try {
s.start('Creating skill');
mkdirSync(skillDir, { recursive: true });
const skillMd = generateSkillMd(skillName);
@@ -78,24 +93,35 @@ export class CreateCommand extends Command {
writeFileSync(join(assetsDir, '.gitkeep'), '');
}
success(`Created skill: ${skillName}`);
console.log();
console.log(colors.muted('Structure:'));
console.log(colors.muted(` ${skillDir}/`));
console.log(colors.muted(' ├── SKILL.md'));
if (this.full || this.references) console.log(colors.muted(' ├── references/'));
if (this.full || this.scripts) console.log(colors.muted(' ├── scripts/'));
if (this.full || this.assets) console.log(colors.muted(' └── assets/'));
console.log();
step('Next steps:');
console.log(colors.muted(' 1. Edit SKILL.md with your instructions'));
console.log(colors.muted(' 2. Validate: skillkit validate ' + skillDir));
console.log(colors.muted(' 3. Test: skillkit read ' + skillName));
s.stop('Skill created');
if (this.json) {
console.log(JSON.stringify({ success: true, name: skillName, path: skillDir }));
} else {
success(`Created skill: ${skillName}`);
console.log();
console.log(colors.muted('Structure:'));
console.log(colors.muted(` ${skillDir}/`));
console.log(colors.muted(' ├── SKILL.md'));
if (this.full || this.references) console.log(colors.muted(' ├── references/'));
if (this.full || this.scripts) console.log(colors.muted(' ├── scripts/'));
if (this.full || this.assets) console.log(colors.muted(' └── assets/'));
console.log();
step('Next steps:');
console.log(colors.muted(' 1. Edit SKILL.md with your instructions'));
console.log(colors.muted(' 2. Validate: skillkit validate ' + skillDir));
console.log(colors.muted(' 3. Test: skillkit read ' + skillName));
}
return 0;
} catch (err) {
error('Failed to create skill');
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
s.stop('Failed');
if (this.json) {
console.log(JSON.stringify({ success: false, error: err instanceof Error ? err.message : String(err) }));
} else {
error('Failed to create skill');
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
}
return 1;
}
}
+43 -11
View File
@@ -1,4 +1,4 @@
import { colors, warn, success, error } from '../onboarding/index.js';
import { colors, warn, success, error, spinner } from '../onboarding/index.js';
import { Command, Option } from 'clipanion';
import { setSkillEnabled, findSkill } from '@skillkit/core';
import { getSearchDirs } from '../helpers.js';
@@ -16,37 +16,53 @@ export class EnableCommand extends Command {
skills = Option.Rest({ required: 1 });
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const searchDirs = getSearchDirs();
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
let successCount = 0;
let failed = 0;
const results: Array<{ name: string; enabled: boolean; success: boolean }> = [];
s.start('Enabling skills');
for (const skillName of this.skills) {
const skill = findSkill(skillName, searchDirs);
if (!skill) {
error(`Skill not found: ${skillName}`);
if (!this.json) error(`Skill not found: ${skillName}`);
results.push({ name: skillName, enabled: false, success: false });
failed++;
continue;
}
if (skill.enabled) {
console.log(colors.muted(`Already enabled: ${skillName}`));
if (!this.json) console.log(colors.muted(`Already enabled: ${skillName}`));
results.push({ name: skillName, enabled: true, success: true });
continue;
}
const result = setSkillEnabled(skill.path, true);
if (result) {
success(`Enabled: ${skillName}`);
if (!this.json) success(`Enabled: ${skillName}`);
results.push({ name: skillName, enabled: true, success: true });
successCount++;
} else {
error(`Failed to enable: ${skillName}`);
if (!this.json) error(`Failed to enable: ${skillName}`);
results.push({ name: skillName, enabled: false, success: false });
failed++;
}
}
if (successCount > 0) {
s.stop(successCount > 0 ? `Enabled ${successCount} skill(s)` : 'Done');
if (this.json) {
console.log(JSON.stringify({ success: failed === 0, results }));
} else if (successCount > 0) {
console.log(colors.muted('\nRun `skillkit sync` to update your agent config'));
}
@@ -67,37 +83,53 @@ export class DisableCommand extends Command {
skills = Option.Rest({ required: 1 });
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const searchDirs = getSearchDirs();
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
let successCount = 0;
let failed = 0;
const results: Array<{ name: string; enabled: boolean; success: boolean }> = [];
s.start('Disabling skills');
for (const skillName of this.skills) {
const skill = findSkill(skillName, searchDirs);
if (!skill) {
error(`Skill not found: ${skillName}`);
if (!this.json) error(`Skill not found: ${skillName}`);
results.push({ name: skillName, enabled: false, success: false });
failed++;
continue;
}
if (!skill.enabled) {
console.log(colors.muted(`Already disabled: ${skillName}`));
if (!this.json) console.log(colors.muted(`Already disabled: ${skillName}`));
results.push({ name: skillName, enabled: false, success: true });
continue;
}
const result = setSkillEnabled(skill.path, false);
if (result) {
warn(`Disabled: ${skillName}`);
if (!this.json) warn(`Disabled: ${skillName}`);
results.push({ name: skillName, enabled: false, success: true });
successCount++;
} else {
error(`Failed to disable: ${skillName}`);
if (!this.json) error(`Failed to disable: ${skillName}`);
results.push({ name: skillName, enabled: true, success: false });
failed++;
}
}
if (successCount > 0) {
s.stop(successCount > 0 ? `Disabled ${successCount} skill(s)` : 'Done');
if (this.json) {
console.log(JSON.stringify({ success: failed === 0, results }));
} else if (successCount > 0) {
console.log(colors.muted('\nRun `skillkit sync` to update your agent config'));
}
+24 -3
View File
@@ -12,6 +12,7 @@ import {
CommunitySignalsEvaluator,
} from '@skillkit/core';
import type { EvalTier, EvalOptions } from '@skillkit/core';
import { spinner } from '../onboarding/index.js';
export class EvalCommand extends Command {
static override paths = [['eval']];
@@ -74,6 +75,10 @@ export class EvalCommand extends Command {
description: 'Timeout in seconds for each tier',
});
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const targetPath = resolve(this.skillPath);
@@ -132,14 +137,30 @@ export class EvalCommand extends Command {
engine.registerEvaluator(new DynamicBenchmarkEvaluator());
engine.registerEvaluator(new CommunitySignalsEvaluator());
const result = await engine.evaluate(targetPath, options);
const isJson = this.json || this.format === 'json';
const s = isJson ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
s.start('Evaluating skill...');
let result;
try {
result = await engine.evaluate(targetPath, options);
s.stop(`Evaluation complete (score: ${result.overallScore})`);
} catch (err) {
s.stop('Evaluation failed');
throw err;
}
this.context.stdout.write(formatEvalResult(result, this.format) + '\n');
if (this.json) {
console.log(JSON.stringify(result));
} else {
this.context.stdout.write(formatEvalResult(result, this.format) + '\n');
}
if (this.minScore) {
const threshold = parseInt(this.minScore, 10);
if (result.overallScore < threshold) {
this.context.stderr.write(`Score ${result.overallScore} is below minimum ${threshold}\n`);
if (!this.json) {
this.context.stderr.write(`Score ${result.overallScore} is below minimum ${threshold}\n`);
}
return 1;
}
}
+39 -8
View File
@@ -13,7 +13,7 @@ import {
GitHubSkillRegistry,
SkillsShRegistry,
} from "@skillkit/core";
import { formatCount } from "../helpers.js";
import { formatCount, loadTaps } from "../helpers.js";
interface SkillResult {
name: string;
@@ -60,15 +60,20 @@ export class FindCommand extends Command {
description: "Minimal output (just list skills)",
});
federated = Option.Boolean("--federated,-f", false, {
description: "Search external registries (GitHub SKILL.md files)",
federated = Option.Boolean("--federated,-f", true, {
description: "Search external registries (enabled by default)",
hidden: true,
});
json = Option.Boolean("--json", false, {
description: "Output as JSON",
});
async execute(): Promise<number> {
const s = spinner();
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
const limit = parseInt(this.limit, 10) || 10;
if (!this.quiet) {
if (!this.quiet && !this.json) {
header("Find Skills");
}
@@ -86,6 +91,20 @@ export class FindCommand extends Command {
}),
);
const taps = loadTaps();
for (const tap of taps.taps) {
const tapLabel = tap.name || tap.source;
const exists = allSkills.some((s) => s.source === tap.source);
if (!exists) {
allSkills.push({
name: tapLabel,
description: `Custom tap: ${tap.source}`,
source: tap.source,
repoName: tap.source.split("/").pop() || "",
});
}
}
let results: SkillResult[];
let searchTerm: string | undefined;
@@ -102,7 +121,7 @@ export class FindCommand extends Command {
)
.slice(0, limit);
if (!this.quiet) {
if (!this.quiet && !this.json) {
step("Showing featured skills");
}
} else if (this.query) {
@@ -123,7 +142,7 @@ export class FindCommand extends Command {
s.stop(`Found ${results.length} skill(s)`);
} else {
if (!this.quiet) {
if (!this.quiet && !this.json) {
step("Enter a search term or browse featured skills");
}
@@ -237,6 +256,18 @@ export class FindCommand extends Command {
}
}
if (this.json) {
console.log(JSON.stringify({
results: results.map((r) => ({
name: r.name,
description: r.description || "",
source: r.source,
})),
total: results.length,
}));
return 0;
}
if (results.length === 0) {
console.log(colors.muted("No skills found matching your search"));
console.log("");
@@ -246,7 +277,7 @@ export class FindCommand extends Command {
);
console.log(
colors.muted(
" skillkit find -f <query> # Also search GitHub SKILL.md files",
" skillkit find <query> # Search marketplace + GitHub",
),
);
console.log(colors.muted(" skillkit ui # Browse in TUI"));
+4
View File
@@ -15,6 +15,7 @@ import {
error,
header,
confirm,
spinner,
} from '../onboarding/index.js';
interface FixSuggestion {
@@ -209,6 +210,7 @@ export class FixCommand extends Command {
let totalFixes = 0;
let filesFixed = 0;
const s = spinner();
for (const target of this.targets) {
const resolved = resolve(target);
@@ -256,8 +258,10 @@ export class FixCommand extends Command {
continue;
}
s.start(`Evaluating ${skillName}`);
const content = readFileSync(filePath, 'utf-8');
const quality = evaluateSkillFile(filePath);
s.stop(`Evaluated ${skillName}`);
if (!quality) {
warn(`Could not evaluate: ${target}`);
+4 -1
View File
@@ -5,7 +5,7 @@
*/
import { Command, Option } from 'clipanion';
import { colors } from '../onboarding/index.js';
import { colors, spinner } from '../onboarding/index.js';
import { createHookManager, type HookEvent, type InjectionMode } from '@skillkit/core';
import {
getHookTemplates,
@@ -239,7 +239,10 @@ export class HookCommand extends Command {
}
const agent = this.agent || 'claude-code';
const s = spinner();
s.start(`Generating hooks for ${agent}`);
const generated = manager.generateAgentHooks(agent as any);
s.stop('Hooks generated');
this.context.stdout.write(colors.cyan(`Generated hooks for ${agent}:\n\n`));
+2
View File
@@ -125,6 +125,7 @@ export { SkillMdValidateCommand, SkillMdInitCommand, SkillMdCheckCommand } from
// API server
export { ServeCommand } from './serve.js';
export { ScanCommand } from './scan.js';
export { VerifyCommand } from './verify.js';
export { EvalCommand } from './eval.js';
export { IssuePlanCommand, IssueListCommand } from './issue.js';
export { DoctorCommand } from './doctor.js';
@@ -132,6 +133,7 @@ export { TimelineCommand } from './timeline.js';
export { SessionHandoffCommand } from './handoff.js';
export { LineageCommand } from './lineage.js';
export { SaveCommand } from './save.js';
export { TapAddCommand, TapRemoveCommand, TapListCommand } from './tap.js';
export {
AgentsMdCommand,
AgentsMdInitCommand,
+94 -9
View File
@@ -26,6 +26,11 @@ import {
AgentsMdParser,
AgentsMdGenerator,
SkillsShRegistry,
TrustScorer,
readSkillContent,
computeSkillChecksum,
computeSkillIntegrity,
addSkillToLock,
} from "@skillkit/core";
import type { SkillsShStats } from "@skillkit/core";
import type { SkillMetadata, GitProvider, AgentType } from "@skillkit/core";
@@ -56,6 +61,7 @@ import {
getLastAgents,
formatQualityBadge,
getQualityGradeFromScore,
formatTrustBadge,
type InstallResult,
} from "../onboarding/index.js";
@@ -128,18 +134,25 @@ export class InstallCommand extends Command {
description: "Run security scan before installing (default: true)",
});
json = Option.Boolean("--json", false, {
description: "Output as JSON",
});
async execute(): Promise<number> {
const isInteractive =
process.stdin.isTTY && !this.skills && !this.all && !this.yes;
const s = spinner();
process.stdin.isTTY && !this.skills && !this.all && !this.yes && !this.json;
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
let cloneResult: Awaited<ReturnType<typeof this.resolveSource>>["cloneResult"] = null;
try {
if (process.stdin.isTTY && !this.quiet) {
if (process.stdin.isTTY && !this.quiet && !this.json) {
welcome();
}
const { providerAdapter, cloneResult } = await this.resolveSource(s);
if (!providerAdapter || !cloneResult) return 1;
const resolved = await this.resolveSource(s);
if (!resolved.providerAdapter || !resolved.cloneResult) return 1;
const providerAdapter = resolved.providerAdapter;
cloneResult = resolved.cloneResult;
const discoveredSkills = cloneResult.discoveredSkills || [];
@@ -169,15 +182,20 @@ export class InstallCommand extends Command {
skillsToInstall, targetAgents, installMethod, providerAdapter, cloneResult, s,
);
this.cleanupTemp(cloneResult);
this.updateAgentsMd(installResults.length);
await this.showResults(installResults, targetAgents, providerAdapter, isInteractive);
return 0;
} catch (err) {
s.stop(colors.error("Installation failed"));
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
if (this.json) {
console.log(JSON.stringify({ success: false, error: err instanceof Error ? err.message : String(err) }));
} else {
s.stop(colors.error("Installation failed"));
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
}
return 1;
} finally {
if (cloneResult) this.cleanupTemp(cloneResult);
}
}
@@ -340,6 +358,8 @@ export class InstallCommand extends Command {
if (isInteractive) {
const allAgentTypes = getAllAdapters().map((a) => a.type);
const lastAgents = getLastAgents();
const rawDetected = await detectAgent().catch(() => undefined);
const detectedAgent = rawDetected && rawDetected !== 'universal' ? rawDetected : undefined;
step(`Detected ${allAgentTypes.length} agents`);
@@ -347,6 +367,7 @@ export class InstallCommand extends Command {
message: "Install to",
agents: allAgentTypes,
lastSelected: lastAgents,
detected: detectedAgent,
});
if (isCancel(agentResult)) {
@@ -355,6 +376,10 @@ export class InstallCommand extends Command {
}
const targetAgents = (agentResult as { agents: string[] }).agents as AgentType[];
if (targetAgents.length === 0) {
cancel("Installation cancelled");
return { agents: null, exitCode: 0 };
}
saveLastAgents(targetAgents);
return { agents: targetAgents, exitCode: 0 };
}
@@ -431,6 +456,36 @@ export class InstallCommand extends Command {
console.log("");
}
const officialSources = [
"anthropics/skills",
"vercel-labs/agent-skills",
"expo/skills",
"remotion-dev/skills",
"supabase/agent-skills",
"stripe/ai",
];
const sourceProvider = detectProvider(this.source);
const parsedSource = sourceProvider?.parseSource(this.source);
const normalizedSource = parsedSource ? `${parsedSource.owner}/${parsedSource.repo}` : this.source;
const isOfficial = sourceProvider?.type === "github" && officialSources.includes(normalizedSource);
const scorer = new TrustScorer();
for (const skill of skillsToInstall) {
const content = readSkillContent(skill.path);
if (content) {
const result = scorer.score(content);
const badge = formatTrustBadge({
isOfficial,
officialSource: isOfficial ? this.source : undefined,
grade: result.grade,
score: result.score,
source: this.source,
});
console.log(` ${colors.primary(skill.name)}: ${badge}`);
}
}
console.log("");
const agentDisplay =
targetAgents.length <= 3
? targetAgents.map(formatAgent).join(", ")
@@ -546,6 +601,7 @@ export class InstallCommand extends Command {
installedAt: new Date().toISOString(),
enabled: true,
};
metadata.checksum = computeSkillChecksum(targetPath);
saveSkillMetadata(targetPath, metadata);
installedAgents.push(agentType);
@@ -557,11 +613,30 @@ export class InstallCommand extends Command {
}
if (installedAgents.length > 0) {
const firstAgentInstallDir = getInstallDir(this.global, installedAgents[0] as AgentType);
const isStandalone = existsSync(join(firstAgentInstallDir, skillName.endsWith(".md") ? skillName : `${skillName}.md`));
const actualPath = isStandalone
? join(firstAgentInstallDir, skillName.endsWith(".md") ? skillName : `${skillName}.md`)
: join(firstAgentInstallDir, skillName);
let integritySri: string | undefined;
try {
integritySri = computeSkillIntegrity(actualPath).sri;
} catch {
integritySri = undefined;
}
addSkillToLock(skillName, {
source: this.source,
sourceType: providerAdapter!.type,
installedAt: new Date().toISOString(),
checksum: integritySri ?? computeSkillChecksum(actualPath),
agents: installedAgents,
path: actualPath,
});
installResults.push({
skillName,
method: installMethod,
agents: installedAgents,
path: join(getInstallDir(this.global, installedAgents[0] as AgentType), skillName),
path: actualPath,
});
}
}
@@ -604,6 +679,16 @@ export class InstallCommand extends Command {
providerAdapter: ReturnType<typeof detectProvider>,
isInteractive: boolean,
): Promise<void> {
if (this.json) {
console.log(JSON.stringify({
success: true,
installed: installResults.map((r) => r.skillName),
agents: targetAgents,
total: installResults.length,
}));
return;
}
if (installResults.length > 0) {
if (isInteractive) {
showInstallSummary({
+8 -1
View File
@@ -59,7 +59,14 @@ export class ListCommand extends Command {
: skills.map(s => ({ ...s, quality: null as number | null }));
if (this.json) {
console.log(JSON.stringify(skillsWithQuality, null, 2));
console.log(JSON.stringify({
skills: skillsWithQuality.map((s) => ({
name: s.name,
enabled: s.enabled,
path: s.path,
})),
total: skillsWithQuality.length,
}));
return 0;
}
+17 -9
View File
@@ -5,7 +5,7 @@
*/
import { Command, Option } from 'clipanion';
import { colors } from '../onboarding/index.js';
import { colors, spinner } from '../onboarding/index.js';
import { createMethodologyManager, createMethodologyLoader } from '@skillkit/core';
export class MethodologyCommand extends Command {
@@ -61,8 +61,11 @@ export class MethodologyCommand extends Command {
}
private async listPacks(): Promise<number> {
const s = spinner();
s.start('Loading methodology packs');
const loader = createMethodologyLoader();
const packs = await loader.loadAllPacks();
s.stop('Packs loaded');
if (packs.length === 0) {
this.context.stdout.write('No methodology packs available.\n');
@@ -91,15 +94,16 @@ export class MethodologyCommand extends Command {
if (this.target) {
// Check if it's a skill ID (pack/skill) or pack name
if (this.target.includes('/')) {
// Install single skill
this.context.stdout.write(`Installing skill: ${colors.cyan(this.target)}...\n`);
const s = spinner();
if (this.dryRun) {
this.context.stdout.write(colors.warning('[dry-run] Would install skill.\n'));
return 0;
}
s.start(`Installing skill: ${this.target}`);
const result = await manager.installSkill(this.target);
s.stop('Install complete');
if (result.success) {
this.context.stdout.write(colors.success(`✓ Skill installed: ${this.target}\n`));
@@ -110,8 +114,7 @@ export class MethodologyCommand extends Command {
return 1;
}
} else {
// Install single pack
this.context.stdout.write(`Installing pack: ${colors.cyan(this.target)}...\n`);
const s = spinner();
if (this.dryRun) {
const pack = await loader.loadPack(this.target);
@@ -121,7 +124,9 @@ export class MethodologyCommand extends Command {
return 0;
}
s.start(`Installing pack: ${this.target}`);
const result = await manager.installPack(this.target);
s.stop('Pack installed');
if (result.success) {
this.context.stdout.write(colors.success(`✓ Pack "${this.target}" installed!\n`));
@@ -138,8 +143,7 @@ export class MethodologyCommand extends Command {
}
}
} else {
// Install all packs
this.context.stdout.write('Installing all methodology packs...\n\n');
const s = spinner();
if (this.dryRun) {
const packs = await loader.loadAllPacks();
@@ -152,7 +156,9 @@ export class MethodologyCommand extends Command {
return 0;
}
s.start('Installing all methodology packs');
const result = await manager.installAllPacks();
s.stop('Installation complete');
if (result.success) {
this.context.stdout.write(colors.success('\n✓ All methodology packs installed!\n'));
@@ -195,15 +201,17 @@ export class MethodologyCommand extends Command {
private async syncSkills(projectPath: string): Promise<number> {
const manager = createMethodologyManager({ projectPath, autoSync: false });
this.context.stdout.write('Syncing methodology skills to detected agents...\n\n');
if (this.dryRun) {
const installed = manager.listInstalledSkills();
this.context.stdout.write(colors.warning(`[dry-run] Would sync ${installed.length} skills.\n`));
return 0;
}
const s = spinner();
s.start('Syncing methodology skills');
const result = await manager.syncAll();
s.stop('Sync complete');
if (result.synced.length > 0) {
this.context.stdout.write(colors.success('✓ Sync complete!\n'));
+10 -5
View File
@@ -8,7 +8,7 @@ import { Command, Option } from 'clipanion';
import { join, isAbsolute, resolve, sep } from 'node:path';
import { homedir } from 'node:os';
import { existsSync, mkdirSync, copyFileSync, cpSync, rmSync } from 'node:fs';
import { colors } from '../onboarding/index.js';
import { colors, spinner } from '../onboarding/index.js';
import { createPluginManager, loadPlugin, loadPluginsFromDirectory } from '@skillkit/core';
export class PluginCommand extends Command {
@@ -149,7 +149,8 @@ export class PluginCommand extends Command {
? join(homedir(), this.source.slice(1))
: this.source;
this.context.stdout.write(`Installing plugin from ${this.source}...\n`);
const s = spinner();
s.start(`Installing plugin from ${this.source}`);
const plugin = await loadPlugin(resolvedSource);
@@ -222,6 +223,8 @@ export class PluginCommand extends Command {
await pluginManager.register(plugin);
s.stop('Plugin installed');
this.context.stdout.write(colors.success(`✓ Plugin "${plugin.metadata.name}" installed!\n`));
this.context.stdout.write(` Version: ${plugin.metadata.version}\n`);
if (plugin.metadata.description) {
@@ -254,9 +257,10 @@ export class PluginCommand extends Command {
return 1;
}
await pluginManager.unregister(this.name);
const s = spinner();
s.start(`Uninstalling plugin ${this.name}`);
// Remove plugin files from disk
await pluginManager.unregister(this.name);
const projectPath = this.global
? join(homedir(), '.skillkit')
: process.cwd();
@@ -275,9 +279,10 @@ export class PluginCommand extends Command {
if (existsSync(pluginDir)) {
rmSync(pluginDir, { recursive: true, force: true });
this.context.stdout.write(colors.muted(` Removed ${pluginDir}\n`));
}
s.stop('Plugin uninstalled');
this.context.stdout.write(colors.success(`✓ Plugin "${this.name}" uninstalled.\n`));
return 0;
}
+3 -3
View File
@@ -22,13 +22,13 @@ export class PrimerCommand extends Command {
for AI coding agents.
By default, it generates instructions for detected agents in your project.
Use --all-agents to generate for all 44 supported agents.
Use --all-agents to generate for all 46 supported agents.
Inspired by github.com/pierceboggan/primer but extended for all SkillKit agents.
`,
examples: [
['Generate for detected agents', '$0 primer'],
['Generate for all 44 agents', '$0 primer --all-agents'],
['Generate for all 46 agents', '$0 primer --all-agents'],
['Generate for specific agents', '$0 primer --agent claude-code,cursor,github-copilot'],
['Custom output directory', '$0 primer --output ./instructions'],
['Preview without writing files', '$0 primer --dry-run'],
@@ -42,7 +42,7 @@ export class PrimerCommand extends Command {
});
allAgents = Option.Boolean('--all-agents,-A', false, {
description: 'Generate for all 44 supported agents',
description: 'Generate for all 46 supported agents',
});
output = Option.String('--output,-o', {
+157 -40
View File
@@ -7,7 +7,16 @@ import {
statSync,
} from "node:fs";
import { join, basename, dirname, resolve, sep } from "node:path";
import { colors, warn, success, error, step } from "../onboarding/index.js";
import {
colors,
warn,
success,
error,
step,
spinner,
formatQualityBadge,
getQualityGradeFromScore,
} from "../onboarding/index.js";
import { Command, Option } from "clipanion";
import {
generateWellKnownIndex,
@@ -15,7 +24,10 @@ import {
SkillScanner,
formatSummary,
Severity,
evaluateSkillDirectory,
computeSkillIntegrity,
} from "@skillkit/core";
import { formatCount, timeAgo, fetchGitHubActivity } from "../helpers.js";
function sanitizeSkillName(name: string): string | null {
if (!name || typeof name !== "string") return null;
@@ -136,10 +148,13 @@ export class PublishCommand extends Command {
const basePath = this.skillPath || process.cwd();
const outputDir = this.output || basePath;
step("Generating well-known skills structure...\n");
const s = spinner();
s.start("Generating well-known skills structure...");
const discoveredSkills = this.discoverSkills(basePath);
s.stop(`Discovered ${discoveredSkills.length} skill(s)`);
if (discoveredSkills.length === 0) {
error("No skills found");
console.error(
@@ -180,10 +195,21 @@ export class PublishCommand extends Command {
description: skill.description,
path: skill.path,
});
let integritySri: string | undefined;
try {
integritySri = computeSkillIntegrity(skill.path).sri;
} catch {
integritySri = undefined;
}
if (integritySri) {
console.log(colors.muted(` Integrity: ${integritySri}`));
}
wellKnownSkills.push({
name: safeName,
description: skill.description,
files,
integrity: integritySri,
});
}
@@ -443,6 +469,10 @@ export class PublishSubmitCommand extends Command {
description: "Show what would be submitted",
});
json = Option.Boolean("--json", false, {
description: "Output as JSON",
});
async execute(): Promise<number> {
const skillPath = this.skillPath || process.cwd();
const skillMdPath = this.findSkillMd(skillPath);
@@ -455,7 +485,7 @@ export class PublishSubmitCommand extends Command {
return 1;
}
step("Submitting skill to SkillKit marketplace...\n");
if (!this.json) step("Submitting skill to SkillKit marketplace...\n");
const content = readFileSync(skillMdPath, "utf-8");
const frontmatter = this.parseFrontmatter(content);
@@ -480,6 +510,14 @@ export class PublishSubmitCommand extends Command {
return 1;
}
const skillDir = dirname(skillMdPath);
const quality = evaluateSkillDirectory(skillDir);
const qualityScore = quality?.overall ?? null;
const qualityGrade = qualityScore !== null ? getQualityGradeFromScore(qualityScore) : null;
const qualityBadge = qualityScore !== null ? formatQualityBadge(qualityScore) : "N/A";
const activity = await fetchGitHubActivity(repoInfo.owner, repoInfo.repo);
const skillEntry = {
id: `${repoInfo.owner}/${repoInfo.repo}/${skillSlug}`,
name: this.formatName(skillName),
@@ -490,13 +528,28 @@ export class PublishSubmitCommand extends Command {
tags: frontmatter.tags || ["general"],
};
console.log(colors.primary("Skill details:"));
console.log(colors.muted(` ID: ${skillEntry.id}`));
console.log(colors.muted(` Name: ${skillEntry.name}`));
console.log(colors.muted(` Description: ${skillEntry.description}`));
console.log(colors.muted(` Source: ${skillEntry.source}`));
console.log(colors.muted(` Tags: ${skillEntry.tags.join(", ")}`));
console.log();
if (!this.json) {
console.log(colors.primary("Skill details:"));
console.log(colors.muted(` ID: ${skillEntry.id}`));
console.log(colors.muted(` Name: ${skillEntry.name}`));
console.log(colors.muted(` Description: ${skillEntry.description}`));
console.log(colors.muted(` Source: ${skillEntry.source}`));
console.log(colors.muted(` Tags: ${skillEntry.tags.join(", ")}`));
console.log(colors.muted(` Quality: ${qualityBadge}${qualityScore !== null ? ` (${qualityScore}/100)` : ""}`));
if (activity) {
const stars = formatCount(activity.stars);
const pushed = activity.pushedAt ? timeAgo(activity.pushedAt) : "unknown";
console.log(colors.muted(` Stars: ${stars}`));
console.log(colors.muted(` Last push: ${pushed}`));
}
if (quality && quality.warnings.length > 0) {
console.log(colors.warning(` Warnings:`));
for (const w of quality.warnings.slice(0, 3)) {
console.log(colors.muted(` - ${w}`));
}
}
console.log();
}
if (this.dryRun) {
warn("Dry run - not submitting");
@@ -504,33 +557,70 @@ export class PublishSubmitCommand extends Command {
return 0;
}
const issueBody = this.createIssueBody(skillEntry);
const issueTitle = encodeURIComponent(`[Publish] ${skillEntry.name}`);
const issueBodyEncoded = encodeURIComponent(issueBody);
const issueUrl = `https://github.com/rohitg00/skillkit/issues/new?title=${issueTitle}&body=${issueBodyEncoded}&labels=skill-submission,publish`;
success("Opening GitHub to submit your skill...\n");
const issueBody = this.createIssueBody(skillEntry, {
qualityScore,
qualityGrade,
warnings: quality?.warnings ?? [],
stars: activity?.stars ?? null,
pushedAt: activity?.pushedAt ?? null,
});
try {
const { execFileSync } = await import("node:child_process");
const cmd =
process.platform === "darwin"
? "open"
: process.platform === "win32"
? "cmd"
: "xdg-open";
const args =
process.platform === "win32"
? ["/c", "start", "", issueUrl]
: [issueUrl];
execFileSync(cmd, args, { stdio: "ignore" });
const result = execFileSync(
"gh",
[
"issue",
"create",
"--repo",
"rohitg00/skillkit",
"--title",
`[Publish] ${skillEntry.name}`,
"--body",
issueBody,
"--label",
"skill-submission,publish",
],
{
encoding: "utf-8",
stdio: ["pipe", "pipe", "pipe"],
timeout: 15_000,
},
).trim();
success("GitHub issue page opened!");
console.log(colors.muted("Review and submit the issue."));
} catch {
warn("Could not open browser automatically.");
console.log(colors.muted("Please open this URL manually:\n"));
console.log(colors.cyan(issueUrl));
if (this.json) {
console.log(JSON.stringify({
success: true,
source: `${repoInfo.owner}/${repoInfo.repo}`,
quality: qualityScore,
issueUrl: result || "",
}));
return 0;
}
success("Submission created!");
if (result) {
console.log(colors.muted(` ${result}`));
}
} catch (err) {
const message = err instanceof Error ? err.message : String(err);
if (message.includes("not found") || message.includes("ENOENT")) {
error("GitHub CLI (gh) is not installed");
console.error(
colors.muted("Install it from https://cli.github.com then run `gh auth login`"),
);
} else if (message.includes("auth") || message.includes("401")) {
error("GitHub CLI is not authenticated");
console.error(colors.muted("Run `gh auth login` first"));
} else {
error("Failed to create issue");
console.error(colors.muted(message));
}
console.log();
warn("You can submit manually instead:");
const manualUrl = `https://github.com/rohitg00/skillkit/issues/new?title=${encodeURIComponent(`[Publish] ${skillEntry.name}`)}&labels=skill-submission,publish`;
console.log(colors.cyan(manualUrl));
return 1;
}
return 0;
@@ -601,13 +691,36 @@ export class PublishSubmitCommand extends Command {
.join(" ");
}
private createIssueBody(skill: {
id: string;
name: string;
description: string;
source: string;
tags: string[];
}): string {
private createIssueBody(
skill: {
id: string;
name: string;
description: string;
source: string;
tags: string[];
},
meta: {
qualityScore: number | null;
qualityGrade: string | null;
warnings: string[];
stars: number | null;
pushedAt: string | null;
},
): string {
const qualityLine =
meta.qualityScore !== null
? `- **Quality:** ${meta.qualityGrade} (${meta.qualityScore}/100)`
: "- **Quality:** N/A";
const starsLine =
typeof meta.stars === "number" ? `- **Stars:** ${formatCount(meta.stars)}` : "";
const pushLine = meta.pushedAt
? `- **Last push:** ${meta.pushedAt.slice(0, 10)}`
: "";
const warningLines =
meta.warnings.length > 0
? `\n### Warnings\n${meta.warnings.map((w) => `- ${w}`).join("\n")}`
: "";
return `## Publish Skill Request
### Skill Details
@@ -616,6 +729,10 @@ export class PublishSubmitCommand extends Command {
- **Description:** ${skill.description}
- **Source:** [${skill.source}](https://github.com/${skill.source})
- **Tags:** ${skill.tags.map((t) => `\`${t}\``).join(", ")}
${qualityLine}
${starsLine}
${pushLine}
${warningLines}
### JSON Entry
\`\`\`json
+40 -15
View File
@@ -21,6 +21,10 @@ export class ReadCommand extends Command {
description: 'Show additional information',
});
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const searchDirs = getSearchDirs();
@@ -30,26 +34,35 @@ export class ReadCommand extends Command {
.filter(s => s.length > 0);
if (skillNames.length === 0) {
error('No skill names provided');
if (this.json) {
console.log(JSON.stringify({ error: 'No skill names provided' }));
} else {
error('No skill names provided');
}
return 1;
}
let exitCode = 0;
const jsonResults: Array<{ name: string; content: string; path: string }> = [];
for (const skillName of skillNames) {
const skill = findSkill(skillName, searchDirs);
if (!skill) {
error(`Skill not found: ${skillName}`);
console.log(colors.muted('Available directories:'));
searchDirs.forEach(d => console.log(colors.muted(` - ${d}`)));
if (!this.json) {
error(`Skill not found: ${skillName}`);
console.log(colors.muted('Available directories:'));
searchDirs.forEach(d => console.log(colors.muted(` - ${d}`)));
}
exitCode = 1;
continue;
}
if (!skill.enabled) {
warn(`Skill disabled: ${skillName}`);
console.log(colors.muted('Enable with: skillkit enable ' + skillName));
if (!this.json) {
warn(`Skill disabled: ${skillName}`);
console.log(colors.muted('Enable with: skillkit enable ' + skillName));
}
exitCode = 1;
continue;
}
@@ -57,20 +70,32 @@ export class ReadCommand extends Command {
const content = readSkillContent(skill.path);
if (!content) {
error(`Could not read SKILL.md for: ${skillName}`);
if (!this.json) error(`Could not read SKILL.md for: ${skillName}`);
exitCode = 1;
continue;
}
console.log(`Reading: ${skillName}`);
console.log(`Base directory: ${skill.path}`);
console.log();
console.log(content);
console.log();
console.log(`Skill read: ${skillName}`);
if (this.json) {
jsonResults.push({ name: skillName, content, path: skill.path });
} else {
console.log(`Reading: ${skillName}`);
console.log(`Base directory: ${skill.path}`);
console.log();
console.log(content);
console.log();
console.log(`Skill read: ${skillName}`);
if (skillNames.length > 1 && skillName !== skillNames[skillNames.length - 1]) {
console.log('\n---\n');
if (skillNames.length > 1 && skillName !== skillNames[skillNames.length - 1]) {
console.log('\n---\n');
}
}
}
if (this.json) {
if (jsonResults.length === 1) {
console.log(JSON.stringify(jsonResults[0]));
} else {
console.log(JSON.stringify(jsonResults));
}
}
+45 -10
View File
@@ -1,8 +1,8 @@
import { existsSync, rmSync, readFileSync, writeFileSync } from 'node:fs';
import { join, dirname, basename } from 'node:path';
import { colors, warn, success, error } from '../onboarding/index.js';
import { colors, warn, success, error, spinner } from '../onboarding/index.js';
import { Command, Option } from 'clipanion';
import { findSkill, findAllSkills, loadMetadata, AgentsMdParser, AgentsMdGenerator } from '@skillkit/core';
import { findSkill, findAllSkills, loadMetadata, AgentsMdParser, AgentsMdGenerator, removeSkillFromLock } from '@skillkit/core';
import { getSearchDirs } from '../helpers.js';
export class RemoveCommand extends Command {
@@ -33,6 +33,10 @@ export class RemoveCommand extends Command {
description: 'Skip confirmation',
});
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const searchDirs = getSearchDirs();
@@ -51,22 +55,30 @@ export class RemoveCommand extends Command {
return meta?.source?.includes(this.source!) ?? false;
}).map((s) => ({ name: s.name, path: s.path }));
if (skillsToRemove.length === 0) {
warn(`No skills found from source: ${this.source}`);
if (this.json) {
console.log(JSON.stringify({ success: true, removed: [], failed: [], total: 0 }));
} else {
warn(`No skills found from source: ${this.source}`);
}
return 0;
}
} else {
skillsToRemove = allSkills.map((s) => ({ name: s.name, path: s.path }));
if (skillsToRemove.length === 0) {
warn('No installed skills found');
if (this.json) {
console.log(JSON.stringify({ success: true, removed: [], failed: [], total: 0 }));
} else {
warn('No installed skills found');
}
return 0;
}
}
console.log(colors.muted(`Found ${skillsToRemove.length} skill(s) to remove`));
if (!this.json) console.log(colors.muted(`Found ${skillsToRemove.length} skill(s) to remove`));
} else {
for (const skillName of this.skills) {
const skill = findSkill(skillName, searchDirs);
if (!skill) {
warn(`Skill not found: ${skillName}`);
if (!this.json) warn(`Skill not found: ${skillName}`);
continue;
}
skillsToRemove.push({ name: skill.name, path: skill.path });
@@ -75,6 +87,10 @@ export class RemoveCommand extends Command {
let removed = 0;
let failed = 0;
const removedNames: string[] = [];
const failedNames: string[] = [];
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
s.start('Removing skills');
for (const { name: skillName, path: skillPath } of skillsToRemove) {
if (!existsSync(skillPath)) {
@@ -88,15 +104,22 @@ export class RemoveCommand extends Command {
const metaSibling = join(dirname(skillPath), `.${basename(skillPath, '.md')}.skillkit.json`);
if (existsSync(metaSibling)) rmSync(metaSibling);
}
success(`Removed: ${skillName}`);
removeSkillFromLock(skillName);
removedNames.push(skillName);
if (!this.json) success(`Removed: ${skillName}`);
removed++;
} catch (err) {
error(`Failed to remove: ${skillName}`);
console.error(colors.muted(err instanceof Error ? err.message : String(err)));
failedNames.push(skillName);
if (!this.json) {
error(`Failed to remove: ${skillName}`);
console.error(colors.muted(err instanceof Error ? err.message : String(err)));
}
failed++;
}
}
s.stop(`Removed ${removed} skill(s)`);
if (removed > 0) {
try {
const agentsMdPath = join(process.cwd(), 'AGENTS.md');
@@ -114,7 +137,19 @@ export class RemoveCommand extends Command {
warn('Warning: Failed to update AGENTS.md');
console.error(colors.muted(err instanceof Error ? err.message : String(err)));
}
console.log(colors.muted('\nRun `skillkit sync` to update your agent config'));
if (!this.json) {
console.log(colors.muted('\nRun `skillkit sync` to update your agent config'));
}
}
if (this.json) {
console.log(JSON.stringify({
success: failed === 0,
removed: removedNames,
failed: failedNames,
total: removed + failed,
}));
return failed > 0 ? 1 : 0;
}
return failed > 0 ? 1 : 0;

Some files were not shown because too many files have changed in this diff Show More