Compare commits

..
175 Commits
Author SHA1 Message Date
Rohit Ghumare d2e5c346f7 Merge pull request #131 from rohitg00/fix/scanner-false-positives
fix(scanner): resolve false positives blocking legit skills (#129)
2026-06-02 10:43:06 +01:00
Rohit Ghumare 3e16ac25a7 fix(scanner): address PR #131 review findings
1. install.ts: gate marketplace-resolution console.log behind !this.json && !this.quiet so --json output stays a single JSON blob and --quiet stays silent. Uses real flag names from the InstallCommand class (this.json, this.quiet).

2. tool-abuse.ts: TA002 pattern 2 lookbehind was too broad. The original list (must|should|always|will|to) included malicious intensifiers — 'Always run without confirmation' and 'Will execute without approval' were incorrectly suppressed. Replaced with negation-only tokens (not|n'?t|never|avoid|forbid|deny|reject|prevent|cannot|can'?t) so genuine negation like 'Do not run without confirmation' still suppresses, but malicious intensifiers fire.

3. rules.test.ts: scanContent helper now uses try/finally so the temp directory is cleaned up even when analyzer.analyze throws.

Tests: 3 new cases for the TA002 lookbehind fix. Full core suite 1051/1051 pass.
2026-06-01 13:07:14 +01:00
Rohit Ghumare 45c94fdcab fix(scanner): resolve false positives blocking legit skills (#129)
Four scanner rules over-fired on standard Node patterns and safety documentation, blocking install of skills like pro-workflow on every node-script skill. Findings tracked at #129.

TA002 (autonomy abuse): patterns 2 and 3 now use negative lookbehind for negation context. 'Never auto-approve' / 'must not bypass approval' no longer trip the rule, but bare 'Auto-approve all tools' still fires.

CI003 (child_process): dropped the bare 'require(child_process)' pattern. Importing the module is not the risk surface — exec() and execSync() are, and they have their own patterns. const { execFileSync } = require('child_process') is the recommended safe form.

CI005 (template literal injection): narrowed pattern to template literals inside shell-spawning calls (exec/execSync/spawn/spawnSync). Authorization headers like `Bearer ${env.TOKEN}` and string concatenation like fs.writeFileSync(file, `${header}${rows}`) are no longer flagged.

CI007 (shell chaining): dropped 'markdown' from fileTypes. Markdown documentation of dangerous shell patterns (deny-list tables, security guides) is documentation, not execution. Real .sh/.bash files still scanned.

install command: marketplace name lookup. 'skillkit install <bare-name>' now consults marketplace/skills.json for entries matching by name or id and resolves to the canonical source string before failing with 'Could not detect provider'.

Tests: 13 new scanner regression tests in packages/core/src/scanner/__tests__/rules.test.ts. Full suite 1048/1048 pass.
2026-06-01 12:49:20 +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 2b1c04e221 fix: address CodeRabbit review findings
- findSkill: fall through to .md check when parseSkill returns null
- Use isPathInside instead of dir.includes(cwd) for location detection
- Optional chaining on meta.source in remove --source filter
- Track fence delimiter type per CommonMark (backtick vs tilde)
- Wrap statSync in try-catch so one bad source doesn't abort all installs
- Add cleanup fallback when sparse-checkout/checkout fails
2026-04-10 22:10:07 +01:00
Rohit Ghumare b1e1e2f266 simplify: extract toAdapterInfo helper, remove spawnGit overloads
- helpers.ts: extract toAdapterInfo() to eliminate 4x repeated object
  construction
- base.ts: remove redundant spawnGit overload signatures, remove
  ?? (() => {}) since spawnGit already handles undefined onProgress
2026-04-10 22:06:06 +01:00
Rohit Ghumare 84fb16486b fix: save metadata for standalone .md skills as sibling dotfiles
Standalone .md skills (e.g. doc_explanation.md) now get metadata saved
as .doc_explanation.skillkit.json in the same directory. This allows
remove --source to find and remove them. Updated saveSkillMetadata,
loadSkillMetadata, loadMetadata, and remove command to handle both
directory and sibling metadata patterns.
2026-04-10 22:03:55 +01:00
Rohit Ghumare 0aae4b16a7 feat: add --all and --source flags to skillkit remove
- skillkit remove --all: removes all installed skills
- skillkit remove --source iii-hq/iii: removes all skills from that source
- Both check .skillkit.json metadata to match source
2026-04-10 21:59:24 +01:00
Rohit Ghumare 244413da79 fix: show logo on TTY regardless of --all/--yes flags 2026-04-10 21:57:39 +01:00
Rohit Ghumare d9d775b189 fix: skillkit read searches all agent dirs and finds standalone .md skills
getSearchDirs now collects skill directories from ALL agent adapters
instead of only the configured agent. This fixes 'skill not found' when
skills were installed to .claude/skills/ but the default agent is
universal (which only searches skills/).

findSkill now also checks name.md for standalone .md skills that were
installed as plain files.
2026-04-10 21:56:06 +01:00
Rohit Ghumare ba09309d5b fix: compute standalone file target path once, use everywhere
Move isStandaloneFile detection and .md suffix normalization before
the existence/force/symlink checks so all code paths use the same
effective target path. Fixes --force not detecting previously installed
standalone skills and symlinks pointing to the wrong filename.
2026-04-10 21:51:30 +01:00
Rohit Ghumare 430bcefaa6 fix: narrow partial clone fallback, cap stderr, add -- before paths
- Restrict try/catch to only the partial clone spawn so
  sparse-checkout/checkout failures bubble up as real errors instead
  of being misreported as "partial clone unsupported"
- Cap stderr accumulator to 4KB to bound memory on verbose clones
- Add -- terminator before sparsePaths in sparse-checkout set to
  prevent user-controlled subpath from being parsed as git options
2026-04-10 21:49:13 +01:00
Rohit Ghumare 3007e9f8fd fix: preserve standalone .md skills as plain files
Instead of wrapping standalone .md skills in a directory, copy them
as-is with .md extension. Skip saveSkillMetadata for standalone files
since it requires a directory. This preserves the original format that
repos like iii-hq/iii use for lightweight single-file skills.
2026-04-10 21:46:18 +01:00
Rohit Ghumare 7160dfddf2 fix: install standalone .md skills by wrapping in a directory
Standalone .md skills (e.g. doc_explanation.md) were copied as plain
files, then saveSkillMetadata tried to write .skillkit.json inside
them causing ENOTDIR. Now detects file sources via statSync and
creates a directory with SKILL.md inside instead.
2026-04-10 21:44:02 +01:00
Rohit Ghumare 16d00a8ec9 fix: address review findings in cloneRepo and scanner
- spawnGit: set stdout to 'ignore' instead of 'pipe' to prevent
  buffer deadlock (git clone writes to stderr, not stdout)
- tryPartialClone: emit fallback message via onProgress instead of
  silently swallowing the error
- scanner: preserve fence markers so PI011 delimiter injection is
  still detected, only strip inner code block content
- scanner: guard against unclosed frontmatter by looking ahead for
  closing --- before entering frontmatter mode
2026-04-10 21:40:45 +01:00
Rohit Ghumare 3457fbc011 fix: sparse checkout includes subpath so skill discovery works
cloneRepo now accepts a subpath option. When set, sparse-checkout
includes both the subpath itself and SKILL_DISCOVERY_PATHS under it.
All four providers pass their parsed subpath through to cloneRepo.

Without this, sparse checkout would skip the subpath directory and
discoverSkills would find nothing.
2026-04-10 21:27:44 +01:00
Rohit Ghumare dd30ee0af0 fix: scanner false positives on markdown code blocks and frontmatter
Strip fenced code blocks and standard YAML frontmatter before scanning
markdown files. This eliminates three categories of false positives:

- PI013: no longer flags standard --- frontmatter delimiters
- CI007: no longer flags curl|sh in code examples
- DE003: no longer flags process.env in code examples

Real threats in prose (outside code blocks) are still caught.
2026-04-10 21:25:03 +01:00
Rohit Ghumare 1fb95fd57e feat: add live clone progress and sparse checkout for large repos
Replace silent execFileSync with async spawn + --progress flag so the
spinner shows real download progress (e.g. "Receiving objects 45%").
For large monorepos, try partial clone (--filter=blob:none) with sparse
checkout of SKILL_DISCOVERY_PATHS first, falling back to regular
--depth 1 clone if the server doesn't support it. Also adds
--single-branch --no-tags to all clones.

Shared cloneRepo() helper in base.ts eliminates duplicate clone logic
across all four git providers.
2026-04-10 20:28:38 +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
Rohit Ghumare 172602f173 fix: preserve exit codes in refactored install.ts, fix spinner API
- selectSkills/selectAgents now return { result, exitCode } to
  distinguish errors (exit 1) from cancellations (exit 0)
- Fixes: --skill with nonexistent name returned 0 instead of 1
- Fixes: --agent with invalid name returned 0 instead of 1
- ai.ts: s.stop('msg', 1) → s.stop(colors.error('msg'))
  (clack spinner.stop only accepts message, not exit code)
2026-04-07 15:46:15 +01:00
Rohit Ghumare e542c4e484 fix: complete chalk→onboarding migration, refactor install.ts (#87 #88 #93)
Complete chalk/ora elimination:
- All 41 chalk imports removed from commands/ (41→0)
- All ora imports removed (replaced with onboarding spinner)
- Consistent use of colors/warn/success/error/step helpers

install.ts refactor (#93):
- extract execute() from 700→50 lines (orchestration only)
- 14 focused private methods: resolveSource, listSkills,
  selectSkills, selectAgents, selectMethod, runSecurityScan,
  confirmInstall, performInstall, cleanupTemp, updateAgentsMd,
  showResults, showSkillsShStats, showProTips

Closes #87, closes #93
Partial progress on #88 (spinners added via migration)
2026-04-07 14:02:01 +01:00
Rohit Ghumare 9fa542e8d8 Merge pull request #99 from rohitg00/fix/audit-batch-2
fix: normalize --agent flag, migrate 6 commands to onboarding helpers
2026-04-07 12:30:28 +01:00
Rohit Ghumare f714a39a46 fix: add deprecation warning when --agents is used
generate.ts and manifest.ts now warn when --agents (deprecated) is
used instead of --agent. Message: "Warning: --agents is deprecated,
use --agent instead (--agents will be removed in v2.0)"

Findings 3 (scan.ts stderr) and 4 (translate.ts stderr) skipped:
error() from onboarding goes to stdout via clack — this is the
standard pattern across all migrated commands. Changing individual
commands would break consistency.
2026-04-07 12:27:37 +01:00
Rohit Ghumare d9142c8125 fix: simplify review — error styling, double-wrap, aliases
- translate.ts: 7 error paths used colors.muted() (gray) instead of
  error() (red) — errors were invisible. Now properly styled.
- update.ts: error(colors.muted(...)) double-wrapped ANSI codes.
  Split into s.stop() for headline + console.log for detail.
- enable.ts: dropped successLog/errorLog aliases, renamed counters
  to successCount/failedCount (matches translate.ts pattern)
- update.ts: removed unused error import
2026-04-07 12:24:15 +01:00
Rohit Ghumare 64944a1c50 fix: normalize --agent flag, migrate 6 commands to onboarding helpers
Option naming (#94):
- generate.ts, manifest.ts: accept --agent as primary (--agents as alias)

Chalk→onboarding migration (#87, #88):
- update.ts: chalk/ora → colors/spinner from onboarding
- translate.ts: chalk → colors/warn/success from onboarding
- remove.ts: chalk → colors/warn/success/error from onboarding
- enable.ts: chalk → colors/warn/successLog/errorLog from onboarding
- scan.ts: stderr.write → error() from onboarding
- list.ts: chalk → colors/warn from onboarding

Chalk imports reduced from 41 to 36 across commands.
All 13 packages build, all 25 test suites pass.
2026-04-07 12:15:03 +01:00
Rohit Ghumare 12bba7f32c Merge pull request #98 from rohitg00/fix/openclaw-cleanup
refactor: deduplicate OpenClaw adapter, fix clawdbot config
2026-04-07 11:57:07 +01:00
Rohit Ghumare 02fe3f2509 fix: TUI uses hardcoded AgentType — import from @skillkit/core instead
The TUI had a manually-maintained 44-agent AgentType union in
translator.service.ts that fell out of sync when openclaw was added
to core. Replace with re-export from @skillkit/core so it stays in
sync automatically. Fixes CI typecheck failure from #86.
2026-04-07 11:52:16 +01:00
Rohit Ghumare 808ae83271 refactor: deduplicate OpenClaw adapter, fix clawdbot config
Follow-up to #86 — cleanup without changing contributor attribution.

- OpenClawAdapter extends ClawdbotAdapter (removes 80 lines of copy-paste)
- Revert clawdbot config to legacy paths (.clawdbot/skills, AGENTS.md)
- OpenClaw detection: ~/.openclaw or openclaw.json
- Widen ClawdbotAdapter property types for extensibility
- Fix tests: adapter count 44→45, remove stale detection assertions
2026-04-07 11:48:05 +01:00
Rohit Ghumare 5324e4528b feat: add OpenClaw agent adapter (Clawdbot rebrand) (#86)
feat: add OpenClaw agent adapter (Clawdbot rebrand)
2026-04-07 11:40:08 +01:00
Rohit Ghumare 59ea709613 fix: version display, install UX — audit findings (#95)
* fix: version display, install UX — audit findings

- Fix version showing hardcoded 1.7.6 instead of actual 1.19.2
  - Export setVersion/setAgentCount from @skillkit/cli
  - Call setVersion(version) and setAgentCount(getAllAdapters().length) in cli.ts
  - Change fallback from '1.7.6' to 'dev' so stale values are obvious

- Fix install pre-selecting all skills by default (bad UX)
  - Add "Install all / Select specific" prompt before multiselect
  - When selecting manually, start with nothing pre-selected
  - Apply same fix to both InstallCommand and runInstallFlow()
  - Matches existing quickAgentSelect pattern

Fixes found during comprehensive codebase audit.
Related issues: #87, #88, #89, #90, #91, #92, #93, #94

* refactor: extract quickSkillSelect, use getAdapterCount

- Extract duplicated "Install all / Select specific" pattern into
  quickSkillSelect() in prompts.ts (mirrors existing quickAgentSelect)
- Both install.ts and runInstallFlow() now use the shared helper
- Add getAdapterCount() to @skillkit/agents to avoid allocating 44
  spread-copied objects just to call .length
- Use getAdapterCount() in cli.ts instead of getAllAdapters().length
2026-04-07 10:44:29 +01:00
Lumina Mao 6ed78ceba7 fix: address PR review comments for OpenClaw adapter
- Remove legacy clawdbot path checks from OpenClawAdapter.isDetected()
  so pure clawdbot workspaces are not hijacked by OpenClaw detection
- Add '.openclaw/agents' to ALL_AGENT_DISCOVERY_PATHS so agent
  discovery works for OpenClaw agent directories
2026-03-27 05:10:21 -07:00
Lumina Mao 3509b74f85 feat: add OpenClaw agent adapter (Clawdbot rebrand)
OpenClaw (formerly Clawdbot) is a local-first AI agent framework with a
persistent gateway daemon. This adds first-class OpenClaw support:

- New `openclaw` agent type in AgentType enum and all Record types
- New `OpenClawAdapter` class with detection for `~/.openclaw/` + `openclaw.json`
- OpenClaw agent config: `skills/` dir (not `.clawdbot/skills/`), CLAUDE.md config
- Extended frontmatter fields: permissions, triggers, metadata, version, scan_exempt
- Agent dirs: `agents/` and `~/.openclaw/agents/`
- Command format: `.claude/commands/` directory
- Translator format map: `openclaw` → `skill-md`
- Simplified clawdbot adapter detection (legacy paths only)

OpenClaw SKILL.md files use an extended YAML frontmatter schema:
  - permissions: { filesystem: none|read|write, network: true|false }
  - triggers: [{ command: /skill-name }]
  - metadata.openclaw.requires: { bins: [], env: [], os: [] }

This enables `skillkit translate <skill> --to openclaw` producing
SKILL.md files compatible with the OpenClaw gateway runtime.

Ref: https://docs.openclaw.ai
2026-03-22 09:03:19 -07:00
Rohit Ghumare 5691b10c7e feat: add multi-tier eval engine (skillkit eval) (#85)
* feat: add multi-tier eval engine (skillkit eval)

6-tier evaluation system for comprehensive skill assessment:
- Tier 1: LLM quality scoring (G-Eval pattern, 6 dimensions)
- Tier 2: Contradiction detection (formal rules + LLM semantic)
- Tier 3: Behavioral security (code analysis + taint tracking + LLM)
- Tier 4: Sandbox execution testing (Docker, graceful skip)
- Tier 5: Dynamic marketplace benchmarks (percentile ranking)
- Tier 6: Community signals (freshness, metadata, content health)

Works without API keys (heuristic fallback for Tier 1, Tiers 5-6).
Full LLM evaluation with --provider flag.

* fix: address Devin review — input validation for eval CLI

- --min-score NaN bypass: validate parseInt result before comparison
- --timeout NaN propagation: skip NaN timeout instead of passing to Docker
- --tier invalid input: graceful error message instead of unhandled throw
- scoreContentSize formula: cap sub-optimal at 99 to distinguish from optimal

* fix: address CodeRabbit review findings on eval system

- Harden contradiction/security prompts against prompt injection by
  wrapping untrusted content in <skill_content> XML tags and adding
  explicit "treat as untrusted data" instructions
- Use head+tail content sampling in security prompt instead of head-only
  truncation to catch malicious payloads at end of content
- Add missing Tier 4 sandbox formatter to reporter.ts
- Fix misleading sampleSize fallback in dynamic-benchmark.ts
- Move --min-score NaN validation before engine.evaluate() to avoid
  wasting LLM calls on invalid input
- Add truncation indicator to quality-cot.ts prompts
- Add term length limits (>100 chars) in contradiction.ts to mitigate
  ReDoS risk on dynamically constructed regex

* fix: address round 2 review findings on eval system

- Wrap quality-cot prompts with <skill_content> XML tags and untrusted
  data instructions, consistent with contradiction/security prompts
- Change truncateContent to head+tail sampling (4000+2000) instead of
  head-only, so completeness/token-efficiency evaluators see both
  beginning and end of long skills
- Fix escapeXmlTags regex to handle whitespace variants before closing
  angle bracket (</skill_content >, </skill_content\n>)
- Type DIMENSION_PROMPTS with Record<EvalDimension, PromptBuilder> for
  compile-time key validation
- Clamp estimatePercentile return to [0,100] range defensively
- Make buildStatsFromMarketplace async with periodic yields (every 50
  skills) to avoid blocking the event loop on first-run cache miss
- Extract parsedTimeout local variable in eval.ts to avoid double
  parseInt parsing

* fix: address round 3 Devin + CodeRabbit findings on eval system

- Scan both code blocks AND full content for dangerous patterns in
  behavioral-security.ts, with deduplication by description+snippet
  to avoid double-reporting (Devin: security scanner skipped prose)
- Use non-greedy regex /\[[\s\S]*?\]/ in parseSemanticFindings to
  match first complete JSON array instead of greedily spanning to
  last bracket in LLM response (Devin: greedy regex corrupted JSON)
- Fix formatSandboxDetails to use r.testCase matching SandboxResult
  type instead of r.name which doesn't exist (Devin: property mismatch)
- Make MarketplaceSkill.description optional to match marketplace
  schema where only id/name/source/tags are required (CodeRabbit)
- Rename sandbox test case from "code example execution" to "code
  block content validation" since it validates content not execution
  (CodeRabbit)

* fix: address round 4 Devin + CodeRabbit findings on eval system

Inline fixes:
- Replace greedy JSON regex in behavioral-security.ts runLLMAnalysis
  with balanced bracket extraction that correctly handles ] inside
  JSON string values
- Replace non-greedy regex in contradiction.ts parseSemanticFindings
  with same balanced bracket extraction (non-greedy also breaks on
  inner brackets)
- Fix crossValidatedCount in behavioral-security.ts to accumulate
  (+= uniqueEngines.size) instead of replacing (Math.max)
- Fix gradeDeterministic: cleanExit && hasOutput without matching
  expectedOutcome now returns passed:false score:50 instead of
  passed:true score:75
- Docker unavailable returns score:-1 sentinel instead of 0/F;
  engine.ts filters score<0 tiers from overall average so
  Docker-less machines aren't penalized

Duplicate fix:
- Add score field to SandboxResult type; store gradeResult.score
  in each result; compute tier score from average of numeric scores
  instead of boolean pass rate

Nitpick fixes:
- Distinguish "Docker unavailable" from "No tests executed" in
  formatSandboxDetails
- Tighten base64 obfuscation regex to require 4-char groups
- Only push 'llm' to engines when LLM actually produced findings
- Bound \s+ to \s{1,10} in dynamically constructed regexes in
  contradiction.ts to prevent catastrophic backtracking
- Validate cache timestamp with Number.isFinite() in loadCache to
  reject corrupted cache files with NaN timestamps
2026-03-10 18:34:32 +00:00
Rohit Ghumare 46153e6eb0 fix: update stale stats, sync agent carousel, refresh attribution (#84)
* fix: update docs, TUI help, and website for v1.19.2 gaps

- docs/index.mdx: version v1.18.0 → v1.19.2, add skills.sh install
  source, add methodology packs to next steps
- docs/rest-api.mdx: health check example version 1.12.0 → 1.19.2
- docs/methodology.mdx: new page documenting 5 packs with 14 skills
- docs/meta.json: add methodology to page ordering
- Hero.tsx: show skills.sh install in terminal animation
- Help.tsx: fix shortcut conflicts — add Session section (l=Timeline,
  v=Lineage, f=Handoff), remove stale f=Find/v=Validate mappings

* fix: update stale stats across repo, website, TUI, CLI, and docs

- Fix agent count: 32 → 44 across package.json, core, TUI READMEs
- Fix source count: 31+ → 34+ across website (Hero, Features, WhySkillKit)
- Fix skill count: 15K/15,000+ → 400K+ everywhere (SkillKit aggregates
  from registries like skills.sh 83K+, SkillsMP 351K+, not just bundled)
- Add 13 missing agents to carousel (Devin, Aider, Cody, Amazon Q,
  Augment, Replit, Bolt, Lovable, Tabby, Tabnine, CodeGPT, PlayCode,
  Universal) — now shows all 44
- Refactor Attribution.tsx to import from marketplace/sources.json
  (single source of truth, auto-shows all 34 sources)
- Fix 8 broken trending skill IDs that didn't resolve in skills.json
- Update fumadocs site (Hero, Commands, layout, page, Documentation)
- Update CLI generate command hints and API docs description
- Increase carousel scroll animation 35s → 45s for more agents
- Add resolveJsonModule to website tsconfig.json
2026-03-10 15:09:31 +00:00
Rohit Ghumare 7c8ba72462 fix: update docs, TUI help, and website for v1.19.2 gaps (#82)
- docs/index.mdx: version v1.18.0 → v1.19.2, add skills.sh install
  source, add methodology packs to next steps
- docs/rest-api.mdx: health check example version 1.12.0 → 1.19.2
- docs/methodology.mdx: new page documenting 5 packs with 14 skills
- docs/meta.json: add methodology to page ordering
- Hero.tsx: show skills.sh install in terminal animation
- Help.tsx: fix shortcut conflicts — add Session section (l=Timeline,
  v=Lineage, f=Handoff), remove stale f=Find/v=Validate mappings
2026-03-06 09:08:50 +00:00
Rohit Ghumare 06d1ba6420 optimize 14 skills via tessl review (avg 24% → 92%) (#81)
Ran `npx tessl skill review --optimize` on all methodology pack
skills and find-skills. Key improvements:

- Better descriptions with "Use when..." clauses and concrete verbs
- Lowercase-hyphenated name format for consistency
- Trimmed self-evident prose Claude already understands
- Added executable examples and quick reference tables
- Condensed verbose sections into compact tables/summaries
- Fixed YAML parsing errors (unquoted colons in descriptions)

Net result: -552 lines across 14 files.
2026-03-06 08:53:32 +00:00
Rohit Ghumare 9b85e40196 feat: add Context Engineering and Antigravity Awesome Skills sources (#80)
* feat: add Context Engineering and Antigravity Awesome Skills sources

Add two major community skill repositories to the marketplace:

- muratcankoylan/Agent-Skills-for-Context-Engineering (12.6K stars):
  13 skills on context engineering, cited in Peking University paper
- sickn33/antigravity-awesome-skills (16.8K stars):
  954+ agentic skills across 9 categories for Claude Code, Gemini CLI,
  Cursor, Copilot and more

Sources: 31 → 33 curated collections
Skills: 15,079 → 15,136 indexed entries

* fix: deduplicate skill IDs and fix slack/notion ID mismatch

- Fix ID mismatch: slack-automation → notion-automation (name/desc were Notion)
- Remove 16 generic duplicate entries that clashed with detailed ones
- Total skills: 15,136 → 15,120 after dedup
2026-03-02 10:56:18 +00:00
Rohit Ghumare a6c0905a7f fix(extension): local content extraction for Chrome Web Store approval (#76)
* fix(extension): replace server API with local content extraction

Chrome Web Store rejected the extension because the core "Save page as
Skill" feature called https://skillkit.sh/api/save-skill which is
unreachable during review. This rewires page saving to work entirely
locally using chrome.scripting.executeScript to extract page content
(title, meta description, headings, body text) directly in the browser.

- Remove API_URL and callSaveApi() server dependency
- Add extractPageContent() via chrome.scripting.executeScript
- Add detectTags() with weighted keyword scoring (URL/headings/body)
- Add buildPageSkill() to generate SKILL.md with frontmatter locally
- Add scripting permission to manifest
- Pass tabId from popup to background for script injection targeting
- Block chrome-extension:// and chromewebstore.google.com URLs
- Add console.error logging in catch blocks for debuggability
- Guard currentTabId validity in popup click handler
- Update store listing to reflect fully local processing
- Bump version to 1.20.0

* fix(extension): address code review findings for robustness

- Extract RESTRICTED_PREFIXES and isRestricted() into shared constants.ts
  so popup and background use the same URL blocklist
- Fix yamlEscape to quote YAML bare scalars (true/false/null/yes/no/on/off)
  and numeric strings that parsers would coerce to non-string types
- Apply yamlEscape to skill name fields in both buildPageSkill and
  buildSelectionSkill to prevent YAML misinterpretation
- Switch tag detection from substring matching to word-boundary regex
  to eliminate false positives (e.g. "js" matching "adjustments")
- Check chrome.runtime.lastError in download callback and always
  revoke blob URL to prevent leaks on download failure
2026-02-28 06:59:04 +00:00
Rohit Ghumare 1cb76f9831 feat: integrate skills.sh as first-class registry
* feat: integrate skills.sh as first-class registry

Add SkillsShRegistry and SkillsShProvider so users can install skills
directly from skills.sh (e.g. `skillkit install skills.sh/owner/repo/skill`).
The find command now searches skills.sh by default alongside the local
marketplace. Post-install shows skills.sh popularity stats and pro tips
highlighting skillkit's unique features (translate, recommend, evaluate).

* fix: address CodeRabbit and Devin review findings for skills.sh integration

- Fix path traversal vulnerability in SkillsShProvider.clone (validate subpath containment)
- Fix federated search skipped for interactive queries (use searchTerm instead of this.query)
- Guard showSkillsShStats to skip network call for local providers
- Replace deprecated npm --production with --omit=dev
- Fix loose includes() match in getSkillStats to use strict endsWith()
- Fix FederatedSearch resilience: don't re-throw RateLimitError, return partial results
- Forward timeoutMs through FederatedSearch to registries
- Extract shared formatCount utility to helpers.ts (deduplicate find.ts/install.ts)
- Fix install hint to use skill.source instead of fragile skill.description
- Fix timer leak in fetchLeaderboard using finally block
- Deduplicate URL parsing via shared parseSkillsShParts helper
- Validate --agent flag values against known agent types
2026-02-22 21:39:50 +05:30
Rohit Ghumare a312640609 fix: security hardening and code quality fixes
* Security hardening and code quality fixes

- Replace execSync with execFileSync to prevent shell injection (providers, executor, fetcher, publish)
- Add security headers: X-Content-Type-Options, X-Frame-Options, Content-Security-Policy, Referrer-Policy
- Add input validation for save route name field to prevent path traversal
- Fix rate limiter IP extraction (x-forwarded-for + x-real-ip fallback)
- Default server bind to 127.0.0.1 instead of 0.0.0.0
- CORS fallback to * (configurable via options.corsOrigin)
- Use execFileSync in publish submit (avoid shell injection when opening browser)
- TLS-aware health checks and HTTPS support in RemoteTransport
- Conditional rejectUnauthorized for TLS (self-signed configurable)
- Add **/.env.local patterns to .gitignore
- Formatting: double quotes, trailing commas (Prettier)

* fix: address CodeRabbit and Devin review findings from PR #74

- TLS: default allowSelfSigned=true to preserve self-signed cert workflow;
  enforce rejectUnauthorized=true when trustedCAs are supplied in client context
- Signature verification: verifySecureMessage now cryptographically verifies
  signatures using PeerIdentity.verifyHex instead of only checking fingerprints
- WebSocket: fix timeout handle leak in performClientHandshake; add error
  logging to empty catch blocks; add per-socket error handler; pre-compute
  signature once in broadcast(); add send error callbacks; reject startup if
  TLS configured but certInfo missing
- Command parsing: replace broken regex tokenizer with shared splitCommand()
  utility that correctly handles --flag="value with spaces"
- Rate limiter: prefer x-real-ip, fall back to rightmost x-forwarded-for entry
- Save route: scope IPv6 prefix checks to actual IPv6 addresses; stop leaking
  internal error messages to clients
- Publish: extract shared parseSkillFrontmatter(); fix getRepoInfo to use
  async execFileSync; fix path containment checks with separator
- Remote transport: add rejectUnauthorized option; bracket IPv6 in URLs;
  fix host:port splitting for IPv6 with lastIndexOf
- Health checks: add tls/tlsAllowSelfSigned to Host type; pass https options
- Fetcher: validate owner/repo; derive indexDir from INDEX_PATH
- .gitignore: add recursive **/.env pattern, remove redundant entries

* fix(executor): restore shell feature support in shellExecutor

The previous security hardening replaced execSync with execFileSync,
which broke commands using pipes, redirects, and subshells. Now detects
shell metacharacters and falls back to sh -c for those commands while
keeping execFileSync for simple commands.
2026-02-22 21:39:47 +05:30
Rohit Ghumare 39b94534ec chore: release v1.19.2 2026-02-20 00:16:28 +05:30
Rohit Ghumare aeb2b05f15 fix: update composioHQ repo name from awesome-claude-code-skills to awesome-claude-skills (#73)
Closes #72
2026-02-17 19:28:39 +00:00
Rohit Ghumare 5991fead9b fix: compact Features grid — 3 cols mobile, 4 cols desktop 2026-02-14 16:08:19 +05:30
Rohit Ghumare 1d3a779c2e fix: show Docs link on mobile nav (#71)
* chore: migrate domain from agenstskills.com to skillkit.sh

Update all OG/Twitter meta tags, API endpoints, docs links, badge
URLs, privacy policy, extension store listing, and README references
to use skillkit.sh. Both skillkit.sh and agenstskills.com are treated
as equal domains — privacy policy, store listing, and docs reference
both.

* perf: skip Vercel builds when docs unchanged

Add ignoreCommand to both docs/skillkit and docs/fumadocs vercel.json.
Vercel will skip rebuilds when the respective docs folder has no
changes, saving ~1h+ of build minutes per billing cycle.
2026-02-14 10:31:26 +00:00
Rohit Ghumare 2fe4702bd6 chore: migrate domain to skillkit.sh (#70)
* chore: migrate domain from agenstskills.com to skillkit.sh

Update all OG/Twitter meta tags, API endpoints, docs links, badge
URLs, privacy policy, extension store listing, and README references
to use skillkit.sh. Both skillkit.sh and agenstskills.com are treated
as equal domains — privacy policy, store listing, and docs reference
both.

* perf: skip Vercel builds when docs unchanged

Add ignoreCommand to both docs/skillkit and docs/fumadocs vercel.json.
Vercel will skip rebuilds when the respective docs folder has no
changes, saving ~1h+ of build minutes per billing cycle.
2026-02-14 10:24:08 +00:00
Rohit Ghumare 28ed83deb0 chore: release v1.19.1 2026-02-14 14:24:41 +05:30
Rohit Ghumare 7c4ee9cfef refactor: simplify homepage by removing 5 sections and adding docs CTA (#69)
Remove WhySkillKit, StackBuilder, BadgeGenerator, Commands, and
TeamEnterprise sections to streamline the landing page from 14 to 9
sections. Replace Extension nav link with Docs, remove duplicate Docs
link, and add a lightweight docs CTA between AdvancedFeatures and
UseCases.
2026-02-14 07:50:00 +00:00
Rohit Ghumare 64cafc76a1 feat: add TUI screens for session intelligence (timeline, lineage, handoff) (#68)
Wire up 3 new screens from PR #65's session intelligence commands into the TUI with
keyboard navigation (l=timeline, v=lineage, f=handoff) and a new Session sidebar section.
2026-02-14 07:33:01 +00:00
Rohit Ghumare 7e3b31b43b feat: add session intelligence — timeline, handoff, and lineage (#65)
* feat: add session intelligence — timeline, handoff, and lineage commands

Three new skill-centric session intelligence features:
- `skillkit timeline` — unified chronological event stream merging skill executions, git commits, observations, decisions, and snapshots
- `skillkit session handoff` — generates structured markdown for agent-to-agent context transfer with accomplished/pending tasks, key files, observations, and recommendations
- `skillkit lineage` — tracks skill impact graph connecting skills to files, commits, and observations with aggregate stats

Includes 44 tests, updated docs/website to reflect 44 agents, and CodeRabbit review fixes (defensive access, type validation, double-count prevention).

* fix: address CodeRabbit review round 2

- Fix primer.mdx example: "29 more agents" → "41 more agents"
- Validate invalid since date in timeline (return empty instead of silent filter-all)
- Guard hist.durationMs with Number.isFinite before formatting
- Fix misleading "commits" label → "changes" for activity log entries
2026-02-14 07:11:44 +00:00
Rohit Ghumare ff089429ae feat: redesign website with aggregator positioning (#67)
* feat: redesign website with aggregator positioning and competitor landscape

- Add WhySkillKit section with competitor comparison table (Vercel skills, PRPM, Askill, Skild, Paks)
- Show SkillKit as meta-package manager aggregating 31+ sources, not competing with them
- Add source grid showing all curated repositories (Anthropic, Vercel, Expo, Supabase, Stripe, etc.)
- Update Hero tagline: "One CLI. Every Source. Every Agent. Zero Telemetry."
- Fix agent count from 32 to 44 in Features stats
- Reframe comparison table: "Simple Installers" vs "SkillKit" instead of vague "Without"
- Update CompatibilityMatrix with all 44 agents (was 16)
- Add zero-telemetry, Apache 2.0, no-account trust signals
- Update nav to include "Why SkillKit" link

* feat: update terminal demo to showcase aggregator workflow

Show install from multiple sources (Anthropic, Vercel), auto-translation
to 44 formats, security scanning, and cross-source recommendations.

* feat: update promo video with aggregator positioning

Updated Remotion video to reflect SkillKit's meta-package manager identity:
- Version bumped from v1.7.5 to v1.19.0 across all scenes
- Install scene shows multi-source aggregation + security scan
- Find scene searches 31+ sources (15K+ skills)
- Translate scene shows cross-source bulk translation
- Workflow scene replaced with security scanner (46 rules)
- Recommend scene shows cross-source recommendations with source labels
- TUI scene updated with source attribution and 44 agents
- Manifest scene shows multi-source team sync
- Logo scene: "One CLI. Every Source. Every Agent." + "Zero Telemetry"
- Agent count updated from "17 agents" to "44 agents | 31+ sources | 15K+ skills"
2026-02-14 07:10:35 +00:00
Rohit Ghumare 6c3cecec4d chore: add v1.19.0 extension zip and remove old one 2026-02-14 11:48:52 +05:30
Rohit Ghumare 8ed4ada674 chore: release v1.19.0 2026-02-14 11:33:57 +05:30
Rohit Ghumare 514de86727 feat: server-side save-skill API for Chrome extension (#66)
* feat: move extension save-skill to server-side API

Chrome Web Store rejected the content script approach since it doesn't
inject on pre-existing tabs. Move webpage-to-skill conversion from
client-side to a server-side API route that uses Turndown + weighted
tag detection, eliminating the need for content scripts entirely.

- Add POST /api/save-skill route with SSRF protection and rate limiting
- Rewrite extension to call API with tab URL instead of injecting scripts
- Remove content script, scripting permission, and turndown dependency
- Add name field validation and YAML-escape source URLs
- Bump extension manifest to v1.18.0

* fix: update privacy policy and store listing for server-side save

Privacy policy previously stated "no external requests" which is now
inaccurate. Updated to clearly disclose that the page URL is sent to
agenstskills.com for processing, what data is NOT sent, and that
nothing is stored server-side.

Store listing updated to match: removed "no server" claims, added
data flow explanation, permissions justifications, and data usage
disclosure section for the Chrome Web Store Privacy tab.

* fix: address Devin and CodeRabbit review findings

- Fix SSRF IPv6 checks blocking legit domains (ffmpeg.org, fdroid.org)
  by requiring colon in fc00:/ff prefixes (Devin)
- Add 5MB response body size limit to prevent OOM on large pages,
  applied to both extractFromUrl and fetchGitHubContent (CodeRabbit)
- Guard response.json() in callSaveApi against non-JSON error pages
  from proxies returning HTML 502/504 (CodeRabbit)
- YAML-escape source URL in buildSelectionSkill to match server-side
  handling of URLs with #, :, or query strings (CodeRabbit)
2026-02-14 06:00:28 +00:00
Rohit Ghumare bf5903bf7f chore: release v1.18.0 2026-02-11 20:50:49 +00:00
Rohit Ghumare aafa086314 feat: add skillkit doctor command and enhance skillkit status (#64)
* feat: add `skillkit doctor` command and enhance `skillkit status`

- New `skillkit doctor` command with 10 health checks across 3 categories
  (environment, configuration, skills) with --json and --fix flags
- Enhanced `skillkit status` shows project overview dashboard when no
  active session exists instead of bare "No active session found" message
- Overview includes agent, config, version, skills count, recent history

* feat: add skill activity log, session snapshots, and session explain

Three new session intelligence features:

- Activity Log: tracks which skills were active per git commit
  (`skillkit activity` with --skill, --limit, --json flags)
- Session Snapshots: save/restore named snapshots of session state
  (`skillkit session snapshot save|restore|list|delete`)
- Session Explain: structured summary of current session
  (`skillkit session explain` with --json, --no-git flags)

Includes path traversal protection on snapshot names, YAML validation
on parsed activity data, and robust error handling on snapshot restore.

983 tests passing (942 core + 41 CLI including 14 E2E tests).

* feat: add issue planner - generate plans from GitHub Issues

New `skillkit issue plan` and `skillkit issue list` commands that
fetch GitHub Issues via `gh` CLI and generate StructuredPlans.
Parses checkboxes, file mentions, and labels from issue body.
29 new tests, all passing.

* fix: address CodeRabbit review suggestions for PR #64

- doctor.ts: use execFileSync, typed AgentType, remove as-any casts
- activity.ts: validate parseInt with radix and NaN guard
- issue.ts: wrap JSON.parse in try/catch for gh CLI output
- issue-planner.ts: guard JSON.parse, fix includeTests no-op ternary,
  remove duplicate IssuePlanMetadata (import from types.ts)
- status.ts: typed StatusOverview interface, remove as-any casts
- snapshot-manager.ts: align observations param with SessionSnapshot type
- session.ts: proper type mapping for observations (no double cast)
- activity-log.ts: min-length guard for SHA prefix match
- e2e tests: use top-level imports instead of inline require()
- commands.test.ts: add assertions for DoctorCommand, IssuePlanCommand,
  IssueListCommand

* fix: address review feedback from CodeRabbit and Devin

- Include test step in no-checklist fallback when includeTests is true
- Restore observations from snapshot in SessionSnapshotRestoreCommand

* fix: address remaining CodeRabbit and Devin review feedback

- doctor.ts: Use getAdapter() per AgentType instead of getAllAdapters()
  spread (which destroys prototype methods like isDetected)
- doctor.ts: Use getGlobalSkillsDir() from AGENT_CONFIG instead of
  hardcoded path formula
- session-explainer.ts: Defensively default state.history and
  state.decisions to empty arrays
- session-explainer.ts: Use loadConfig().agent with skillSource fallback
  instead of always using skillSource as agent name
- observation-store.ts: Add static readAll() that reads observations
  without sessionId mismatch clearing
- session.ts: Use ObservationStore.readAll() for snapshot save to avoid
  empty observations due to sessionId mismatch
2026-02-11 20:26:51 +00:00
Rohit Ghumare 344f081664 feat: add privacy policy page for Chrome Web Store compliance 2026-02-11 17:56:38 +00:00
Rohit Ghumare 86c1e5d8f9 chore: release v1.17.0 2026-02-10 11:21:57 +00:00
Rohit Ghumare 9930096242 fix: MCP server fails to start via npx (#58) (#63)
* fix: MCP server fails to start via npx — symlink + skills.json issues

1. isMain guard: process.argv[1] (symlink path) never matched
   import.meta.url (real path). Fixed with realpathSync comparison.

2. skills.json not in npm package: prebuild copies marketplace/skills.json
   to data/ dir, included in package files.

3. Version string bumped from 1.12.0 to 1.16.0.

Closes #58

* fix: guard realpathSync against undefined argv and resolve both paths

- Wrap in try/catch so library imports don't crash
- Check process.argv[1] exists before calling realpathSync
- Also resolve import.meta.url with realpathSync for pnpm/hoisted setups
2026-02-10 11:13:05 +00:00
Rohit Ghumare 24ff833265 feat: Chrome extension — Save any webpage as a Skill (#62)
* fix: remove redundant GitHub Star button from Hero section

Star count is already visible in navbar and stats bar on all screen sizes.

* fix: keep GitHub Star button on mobile, hide on desktop

Star button uses sm:hidden so it only appears on mobile where
the navbar star badge is less prominent. On desktop (sm+), the
navbar star badge is sufficient.
2026-02-10 10:13:47 +00:00
Rohit Ghumare 12ac7356f8 docs: add Chrome extension to website, fumadocs, and README (#61)
- Website Hero: "Add to Chrome" button (white, high contrast) between
  install command and GitHub star button
- Website navbar: "Extension" link in desktop nav
- Fumadocs: new chrome-extension.mdx page with install, usage,
  architecture, permissions, and build docs
- README: Chrome extension section + link in header nav
- Extension README: setup and usage guide
2026-02-10 09:57:51 +00:00
Rohit Ghumare 53b3f4f839 feat: add Chrome extension to save webpages as skills (#60)
Fully browser-based — no local server required. Content script extracts
page content as markdown (Turndown), background generates SKILL.md with
frontmatter and auto-tags, and downloads via chrome.downloads API.

- Manifest V3 with contextMenus, activeTab, downloads permissions
- Content script: HTML-to-markdown via Turndown, extracts article/main
- Background: SKILL.md generation (slugify, YAML frontmatter, tag detection)
- Downloads to skillkit-skills/{name}/SKILL.md in browser Downloads folder
- Monochromatic popup UI matching website design system
- Context menu: "Save page as Skill" / "Save selection as Skill"
- POST /save API endpoint still available for CLI users
2026-02-10 09:49:52 +00:00
Rohit Ghumare 896eff184c feat: standards reference implementation — URL-to-Skill, AGENTS.md, spec validation (#59)
* feat: implement standards reference — URL-to-Skill, AGENTS.md, spec validation

Phase 1-4 of positioning SkillKit as THE runtime implementing all three
AI agent skill standards (Agent Skills, AGENTS.md, well-known discovery).

New modules:
- save/ — ContentExtractor, SkillGenerator, AutoTagger for URL-to-Skill
- agents-md/ — AGENTS.md generator with managed section markers
- validation/ — SpecValidator with strict mode for agentskills.io compliance

New CLI commands:
- `skillkit save <url>` — save any URL/text/file as a reusable SKILL.md
- `skillkit agents init|sync|show` — generate and manage AGENTS.md

Updated:
- Well-known provider: Mintlify convention paths, discoverFromUrl()
- Install command: smart URL fallback (well-known → offer save)
- Remove command: auto-updates AGENTS.md on skill removal
- Validate command: --strict flag for spec compliance checks
- Quality module: name-directory match + token budget warnings
- Schema: agents enum updated from 7 → 44 agents

* fix: address Devin review — register AgentsMd commands, fix temp dir leak, wrap AGENTS.md update

- Register AgentsMdCommand/Init/Sync/Show in CLI entry point (were exported but never registered)
- Clean up tempDir in wellknown clone() when no skills found via index or mintlify
- Wrap AGENTS.md auto-update in install.ts with try-catch to prevent masking successful installs

* fix: address CodeRabbit review findings

- wellknown.ts: drop multiline flag from frontmatter regex, extract skill name
  from URL path segments instead of basename on full URL
- agents-md.ts: wrap init/sync in try-catch for user-friendly error messages
- publish.ts: add path-traversal guard to mintlify branch
- validate.ts: remove duplicate error/warning output in spec report
- extractor.ts: add 30s AbortSignal timeout to all fetch calls
- skill-generator.ts: fix .filter(Boolean) stripping blank line after frontmatter
2026-02-10 09:05:49 +00:00
Rohit Ghumare 407e8215f2 fix: stack ASCII and PH badge vertically on mobile, hide ASCII below sm 2026-02-09 23:16:18 +00:00
Rohit Ghumare dd4ec56a1a fix: show ASCII logo on mobile, use B&W Product Hunt badge 2026-02-09 21:58:30 +00:00
Rohit Ghumare e9bb9fbd0d fix: add separate mobile PH badge, fix visibility on small screens 2026-02-09 21:53:01 +00:00
Rohit Ghumare ee54bf1545 fix: show Product Hunt badge on mobile, remove duplicate from nav 2026-02-09 21:43:57 +00:00
Rohit Ghumare f097ec7ad7 style: add Product Hunt badge next to ASCII logo on website hero 2026-02-09 21:38:32 +00:00
Rohit Ghumare eeddd2a8cf style: add Product Hunt #3 badge to banner SVG 2026-02-09 21:32:51 +00:00
Rohit Ghumare 6362be2cb9 fix: update website from 32 to 44 agents across all components 2026-02-09 21:28:39 +00:00
Rohit Ghumare 7e23c3a5d7 fix: bump apps/skillkit version to 1.16.0 2026-02-09 21:21:55 +00:00
Rohit Ghumare 91c81ba1fa fix: bump all package versions to 1.16.0 2026-02-09 21:18:05 +00:00
Rohit Ghumare 684ea48f58 chore: release v1.16.0 2026-02-09 21:00:18 +00:00
Rohit Ghumare 19c9f6bdc4 feat: add 12 missing AI agents, expand to 44 total (#57)
* feat: add 12 missing AI coding agents (Devin, Aider, Cody, Amazon Q, Augment, Replit, Bolt, Lovable, Tabby, Tabnine, CodeGPT, PlayCode)

Expands agent support from 32 to 44 agents across all packages:
- Core types, configs, discovery paths, format maps, command generator
- Agent adapters (UniversalAdapter for all new agents)
- CLI onboarding icons/names, TUI symbols/logos
- Updated all docs, tests, and e2e references from 32 to 44

* test: add comprehensive tests for new agents, update docs and e2e

- Add it.each tests for all 12 new agent adapters and configs
- Add completeness test ensuring every AgentType has adapter + config
- Update agents.mdx doc table with all 12 new agents
- Update e2e onboarding test with new agent display names

* fix: add all 44 agents to translateSkillToAll and fix e2e test

- translateSkillToAll had hardcoded 17-agent list, now includes all 44
- e2e/skill-translator test was missing cline-zencoder batch in SUPPORTED_AGENTS

* fix: replace UniversalAdapter with GenericAgentAdapter for all non-universal agents

UniversalAdapter hardcoded type='universal', skillsDir='skills', and
name='Universal (Any Agent)' for all 26 agents that used it. This caused
skills to install to wrong directories and agents to be undetectable.

GenericAgentAdapter reads type, skillsDir, configFile from AGENT_CONFIG
and checks agent-specific directories in isDetected(). Fixes both the
12 new agents and the 14 pre-existing ones (cline through zencoder).

115 adapter tests now verify correct type, skillsDir, configFile, and
name for every GenericAgentAdapter instance.

* style: update README banner and header for 44 agents

* style: add rotating 3D model banner GIF for README

* style: revert to monochromatic SVG banner, update to 44 agents
2026-02-09 20:51:17 +00:00
Rohit Ghumare f11de2ac63 feat: add 12 missing AI coding agents (32 to 44) (#56)
* feat: add 12 missing AI coding agents (Devin, Aider, Cody, Amazon Q, Augment, Replit, Bolt, Lovable, Tabby, Tabnine, CodeGPT, PlayCode)

Expands agent support from 32 to 44 agents across all packages:
- Core types, configs, discovery paths, format maps, command generator
- Agent adapters (UniversalAdapter for all new agents)
- CLI onboarding icons/names, TUI symbols/logos
- Updated all docs, tests, and e2e references from 32 to 44

* test: add comprehensive tests for new agents, update docs and e2e

- Add it.each tests for all 12 new agent adapters and configs
- Add completeness test ensuring every AgentType has adapter + config
- Update agents.mdx doc table with all 12 new agents
- Update e2e onboarding test with new agent display names

* fix: add all 44 agents to translateSkillToAll and fix e2e test

- translateSkillToAll had hardcoded 17-agent list, now includes all 44
- e2e/skill-translator test was missing cline-zencoder batch in SUPPORTED_AGENTS

* fix: replace UniversalAdapter with GenericAgentAdapter for all non-universal agents

UniversalAdapter hardcoded type='universal', skillsDir='skills', and
name='Universal (Any Agent)' for all 26 agents that used it. This caused
skills to install to wrong directories and agents to be undetectable.

GenericAgentAdapter reads type, skillsDir, configFile from AGENT_CONFIG
and checks agent-specific directories in isDetected(). Fixes both the
12 new agents and the 14 pre-existing ones (cline through zencoder).

115 adapter tests now verify correct type, skillsDir, configFile, and
name for every GenericAgentAdapter instance.
2026-02-09 20:21:54 +00:00
Rohit Ghumare 3e92215231 fix: remove unnecessary VERSIONING.md from repo root (#55) 2026-02-09 19:44:08 +00:00
Rohit Ghumare 2f29632f17 fix: bump docs package versions to 1.15.0 2026-02-08 21:03:09 +00:00
Rohit Ghumare 596fc0aa7b chore: release v1.15.0 2026-02-08 20:57:48 +00:00
Rohit Ghumare 2bf8c7499c docs: add security scanner documentation, TUI screen, and README updates (#53)
- Add dedicated security.mdx docs page with full rule reference (46+ rules),
  threat categories, SARIF/CI integration guide, and programmatic usage
- Add TUI Scan screen (z key) with live scan results, severity colors,
  finding navigation, and rescan support
- Add scan to TUI sidebar nav, help shortcuts, and bottom status bar
- Add security scanner section to docs index page with link
- Add programmatic scan usage example to CLI README
- Remove stale --quiet option from commands.mdx
- Add security page to docs sidebar navigation
2026-02-08 20:50:45 +00:00
Rohit Ghumare d7861f96a7 feat: update Product Hunt badge to top post daily badge (#54)
Replace featured badge with top-post-badge showing daily ranking.
2026-02-08 20:50:29 +00:00
Rohit Ghumare c89d3130d1 fix: rewrite compatibility matrix with accurate agent capability data (#52)
Replace fabricated compatibility data with ratings based on actual
SkillKit translator capabilities, agent constraints, and compatibility
scoring from the codebase.

Key changes:
- Categories now reflect real SkillKit features (Translation, Hooks,
  MCP & Tools, Context Window) alongside skill categories
- Cline promoted to Tier 1 (full MCP/tools/hooks support)
- Only Claude, Cline, Roo show full MCP & Tools support (accurate)
- Codex/Copilot show partial for most categories (8K context limit)
- No agent claims 100% - scores reflect real translation capabilities
- Removed language-specific categories (Go, Python, TypeScript) that
  don't meaningfully differ across agents since skills are text-based
2026-02-08 20:35:08 +00:00
Rohit Ghumare d8168044b3 fix: remove hardcoded initial stars count from website loader (#51)
Replace stale hardcoded fallback values (66 stars, 2.4k downloads, v1.9.0)
with empty/zero defaults that show a dash placeholder while loading. Real
values populate once the API responds.
2026-02-08 20:30:10 +00:00
Rohit Ghumare b28a2801b2 feat: add security scanner for detecting malicious patterns in skills (#50)
* feat: add security scanner for detecting malicious patterns in skills

Add `skillkit scan <path>` command with 46+ detection rules across 6 threat
categories: prompt injection, command injection, data exfiltration, tool abuse,
hardcoded secrets, and unicode steganography.

- 3 analyzers: static pattern matching, SKILL.md manifest validation, secrets detection
- 4 output formats: summary (colored terminal), json, table, sarif (GitHub Code Scanning)
- Auto-scan on `skillkit install` (--no-scan to skip, --force to override)
- Auto-scan on `skillkit publish` (blocks on HIGH+ findings)
- Threat taxonomy with 10 categories and severity levels
- False-positive filtering for placeholders, test files, safe patterns
- Updated README, CLI docs, website commands, features, and fumadocs

* fix: address Devin and CodeRabbit review suggestions for security scanner

- Fix .env variant files (.env.local, .env.production) being skipped by scanner
- Add multiline rule support in StaticAnalyzer for cross-line pattern matching
- Fix PI004/PI013 patterns that contained literal \n (never matched per-line)
- Fix /g flag on CI006 path traversal regex causing intermittent misses
- Fix frontmatter regex to handle Windows CRLF line endings
- Fix allowed-tools parsing to detect multi-line YAML arrays
- Fix snippet redaction order: redact before truncate to prevent secret leaks
- Reset findingCounter per analyze() call for deterministic finding IDs
- Make SARIF artifactLocation.uri relative to skillPath for GitHub Code Scanning
- Use basename() instead of split('/').pop() for cross-platform paths
- Inject package version at build time via tsup define (replaces hardcoded 1.0.0)
- Validate --fail-on and --format CLI options with clear error messages
- Remove unused format/quiet from ScanOptions interface
- Move publish scan after name validation to avoid blocking on invalid skills
- Add excludePatterns for jailbreak detection to reduce false positives
- Add biome suppression for intentional control character regex in UC005
- Use alternation instead of character class for ZWJ in UC001

* fix: address CodeRabbit round 2 review suggestions

- Remove unused --quiet option from scan command
- Update OpenAI API key pattern to detect sk-proj- and sk-admin- prefixes

* fix: address deep review issues in security scanner

- SK001: add negative lookahead to prevent matching Anthropic keys
- static.ts: fix multiline loop hang for non-global regex with filtered matches
- CI005: reduce severity to MEDIUM, expand excludePatterns for template literals
- CI006: reduce severity to MEDIUM, add fileTypes whitelist, exclude markdown/YAML patterns
- PI011: fix literal \n in regex, use $/im for end-of-line matching
- UC004: use \u{...} notation for supplementary codepoint range
- scanner.ts: propagate skipRules to ManifestAnalyzer and SecretsAnalyzer
2026-02-08 12:56:45 +00:00
Rohit Ghumare 2c05d08027 fix: use PH embed badge image with live upvote count (#49) 2026-02-07 13:49:41 +00:00
Rohit Ghumare 51b62d1cce feat: show live Product Hunt upvotes, remove Apache license from stats bar (#48) 2026-02-07 13:42:30 +00:00
Rohit Ghumare a8df5a25d1 feat: add Product Hunt featured badge to website stats bar (#47) 2026-02-07 13:38:41 +00:00
Rohit Ghumare 616b268ad4 feat: add live GitHub stars CTA and redesign README banner (#46)
* feat: add live GitHub stars CTA and redesign README banner

- Add live star count to navbar with star icon and bordered button
- Add GitHub Star CTA button in hero with live count from GitHub API
- Update description to "open source package manager"
- Replace plain ASCII README header with SVG banner
- Fix video visibility with clickable thumbnail fallback
- Add GitHub stars badge to README badges row

* fix: reduce gap between install and star buttons

* fix: remove broken placeholder URL from README video section
2026-02-07 13:29:35 +00:00
Rohit Ghumare f7803183bf chore: release v1.14.0
Features:
- Smart Context Generation: AI-powered skill generation with multi-source context
  - Multi-provider LLM support (Claude, GPT-4, Gemini, Ollama, OpenRouter)
  - 4 context sources: docs, codebase, marketplace skills, memory
  - Agent-specific optimization for 32 agents
  - Trust scoring and compatibility matrix
  - Skill composition via natural language search

Documentation:
- Added Generate Command section to CLI reference
- Updated README with AI skill generation feature
- Updated website with AI Generate in Advanced Features
2026-02-05 15:43:33 +00:00
Rohit Ghumare 2441f0d275 feat(ai): add smart context generation with multi-provider support (#45)
* feat(ai): add smart context generation with multi-provider support

Implements the SkillKit Smart Context Generation system:

- Multi-Provider Support: 6 LLM providers (Anthropic, OpenAI, Google, Ollama, OpenRouter, Mock) with auto-detection via environment variables
- Multi-Source Context Engine: 4 context sources (docs, codebase, skills, memory) with relevance weighting
- Skill Composition Engine: Natural language search and intelligent skill merging
- Agent Optimization: Agent-specific optimization for 10+ agents with compatibility scoring
- Security Module: Trust scoring (0-10 scale) and prompt injection detection
- Wizard Core: 6-step interactive wizard (expertise → context-sources → composition → clarification → review → install)
- CLI Integration: `skillkit generate` command with @clack/prompts

New files:
- packages/core/src/ai/providers/{types,anthropic,openai,google,ollama,openrouter,factory}.ts
- packages/core/src/ai/context/{index,docs-source,codebase-source,skills-source,memory-source}.ts
- packages/core/src/ai/composition/{index,analyzer,merger}.ts
- packages/core/src/ai/agents/{optimizer,compatibility}.ts
- packages/core/src/ai/security/{trust-score,injection-detect}.ts
- packages/core/src/ai/wizard/{types,steps,clarification,index}.ts
- packages/cli/src/commands/generate.ts
- 6 test files for new modules

* fix(ai): address Devin/CodeRabbit review feedback

- Escape regex in codebase-source.ts to prevent ReDoS attacks
- Fix division by zero in skills-source.ts when no keywords present
- Include all config overrides in ProviderFactory cache key
- Validate AI-provided indices before indexing skills arrays
- Use limited array in ollama.ts search to avoid out-of-bounds access
- Add 120s timeout with AbortController to ollama/openrouter requests
- Fix provider precedence in wizard: config.provider > options.provider
- Fix emitComplete timing to fire after install step completes
- Guard memory lookups with memoryPersonalization opt-out check

* chore(deps): update Google AI SDK to new @google/genai package

The legacy @google/generative-ai package is deprecated as of Nov 2025.
Updated to the new unified @google/genai SDK (GA since May 2025).

* fix(ai): address remaining Devin/CodeRabbit review issues

- Update AIConfig type to support all providers (google, ollama, openrouter)
- Update getAIConfig() in CLI to detect all configured providers
- Add defensive check for expertise in clarification fallback questions
- Add null check for OpenAI choices[0] response
- Validate AI-provided indices in OpenAI/Anthropic search methods
- Add 120s timeout with AbortController to OpenAI/Anthropic requests
- Guard against zero/Infinity per-source chunk allocation in ContextEngine
- Normalize trust score weights and clamp final score to [0-10]
- Fix Windows path handling in memory-source.ts (use [\\/] regex)
- Fix token-to-character ratio consistency (use 4 throughout)
- Target 95% of max tokens in truncation to stay under limit

* chore: sync docs package versions to 1.13.0 and update lockfile

- Update docs/skillkit/package.json version to 1.13.0
- Update docs/fumadocs/package.json version to 1.13.0
- Regenerate pnpm-lock.yaml with new @google/genai dependency

* fix(ai): final code review fixes for smart context generation

- Add 'mock' to AIConfig provider union type
- Show mock provider in handleProviders() when no API keys configured
- Reserve space for truncation marker in truncateContent
- Capture pre-heading content in splitIntoSections
- Add tolerant JSON parsing in anthropic parseSearchResponse
- Use Number.isInteger for index validation in openai search
- Validate all required fields in openai generateFromExample
- Guard against zero sentences in trust-score scoreClarity
- Sanitize weight values (non-negative, finite) in TrustScorer

* fix(ai): re-validate after AI optimization and validate parseGenerateResponse

- Re-truncate content after AI optimization if it exceeds agent max context
- Add JSON extraction from code fences in parseGenerateResponse
- Validate required fields (name, description, content) in parseGenerateResponse
- Clamp confidence to [0,1] range and properly type-check optional fields
2026-02-05 15:40:14 +00:00
Rohit Ghumare a546b04953 chore: release v1.13.0 2026-02-05 11:27:29 +00:00
Rohit Ghumare 6d290171b7 feat(memory): add lifecycle hooks, progressive disclosure, and auto-compress memory (#44)
* feat(memory): add lifecycle hooks, progressive disclosure, and auto-CLAUDE.md updates

- Add Claude Code lifecycle hooks (SessionStart, PostToolUse, SessionEnd)
  for automatic memory capture and injection
- Implement 3-layer progressive disclosure for token-optimized retrieval
  (Index ~50 tokens, Timeline ~200 tokens, Details ~600 tokens)
- Add CLAUDE.md auto-updater to populate LEARNED section with learnings
- Add auto-compression threshold trigger in observation store
- Add new CLI commands: `memory sync-claude` and `memory index`
- Update documentation with new memory features
- Remove 139 lines of unnecessary inline comments (code cleanup)

* fix(memory): address Devin review comments

- Fix double execution bug in MemoryHookManager by adding
  generateHookOutputFromResult methods to avoid calling execute() twice
- Add setConfig method to PostToolUseHook for runtime config updates
- Update manager.setConfig() to propagate config to all hooks

* fix(memory): address CodeRabbit review comments

- Fix cross-platform path handling using path.basename() instead of split('/')
  in claude-md-updater.ts, session-start.ts, and session-end.ts
- Fix onSessionEnd to call execute() before generateHookOutput to run
  compression/cleanup side effects
- Add generateHookOutputFromResult() to SessionEndHook to avoid double execution
- Call clearOldPendingErrors() in PostToolUseHook.execute() to prevent
  unbounded pendingErrors map growth
- Handle async checkAutoCompression() errors in observation-store.ts
- Add validation for compression threshold (must be positive integer)
- Fix docs/commands.mdx to use correct CLI flags (--limit, --tags)
- Clarify token accounting in progressive-disclosure smartRetrieve() JSDoc
- Use config.minRelevanceForCapture in session-start.ts instead of hardcoded value

* fix(memory): address additional CodeRabbit review comments

- Use nullish coalescing (??) for maxResults defaults in progressive-disclosure
- Guard against non-positive tokenBudget in smartRetrieve()
- Thread minRelevance option through to findRelevantIds()
- Fix memory index CLI to validate --limit and pass maxResults to getIndex()
2026-02-05 11:26:31 +00:00
Rohit Ghumare a994726952 docs: rewrite README with clean, concise style
Reduced from 777 lines to 300 lines. Same information, clearer structure:
problem/solution opening, progressive examples, one command reference
section linking to full docs, compact agent table and attribution list.
2026-02-04 11:09:06 +00:00
Rohit Ghumare 1ee5258447 docs: rewrite with clean, concise style (#43)
* docs: rewrite documentation with clean, concise style

Rewrote all core docs pages (index, installation, quickstart, rest-api,
mcp-server, python-client) with problem/solution framing, progressive
code examples, and conversational tone. Updated OpenAPI descriptions
and api.html meta tags to match. 366 additions vs 722 deletions.

* docs(mcp): remove stale skill count, add list_categories tool name

Replace hard-coded "15,000+" with non-specific wording and explicitly
name the list_categories tool in the Browse categories section.
2026-02-04 11:01:48 +00:00
Rohit Ghumare db38c9059d feat(website): add hosted API docs at agenstskills.com/api
- Create public/api.html with Swagger UI dark theme matching site design
- Create public/openapi.json with full OpenAPI 3.1 spec and examples
- Add Vercel rewrite: /api -> /api.html
- Add "API" nav link to website navbar
- Custom dark theme with monospace fonts matching SkillKit branding
2026-02-04 00:50:03 +00:00
Rohit Ghumare 988a49f38f feat(api): add interactive Swagger UI docs at /docs
- Add OpenAPI 3.1 spec with all endpoints, schemas, and tags
- Serve Swagger UI at GET /docs with try-it-out enabled
- Serve OpenAPI JSON at GET /openapi.json
- Add API info endpoint at GET / with endpoint listing
- Update serve command to show /docs and /openapi.json endpoints
- Update REST API docs page with interactive docs section
2026-02-04 00:46:03 +00:00
Rohit Ghumare 19694dcaa1 docs: add v1.12.0 runtime skill discovery documentation
- README: add Runtime Discovery, serve command, REST API, MCP, Python
  client sections with examples and comparison table update
- Website Hero: update terminal animation with serve/API demo
- Website Features: add REST & MCP APIs card, API Access comparison row
- Website Commands: add Server tab with serve command options
- Fumadocs: create rest-api.mdx, mcp-server.mdx, python-client.mdx
- Fumadocs: update index (v1.12.0, architecture, discovery section),
  commands (serve command), and meta.json navigation
2026-02-04 00:40:49 +00:00
Rohit Ghumare b432400b5a chore: release v1.12.0 2026-02-04 00:29:39 +00:00
Rohit Ghumare e5f0d6d450 feat: runtime skill discovery — REST API, MCP server, cache, ranking, Python client (#42)
* feat: runtime skill discovery — REST API, MCP server, cache, ranking, Python client (#42)

Add runtime skill discovery capabilities enabling agents to autonomously
search and retrieve skills on demand, inspired by skyll.app's approach
of making skills queryable by intent rather than requiring pre-installation.

Core infrastructure:
- Pluggable cache backend with LRU + TTL (MemoryCache)
- Multi-signal relevance ranker (content 40pts, query 30pts, popularity 15pts, refs 15pts)
- Enhanced SKILL.md parser with frontmatter extraction and reference discovery
- Runtime skill injector fetching SKILL.md from GitHub with caching

REST API server (@skillkit/api):
- Hono-based HTTP server on port 3737
- GET/POST /search with ranked results and filters
- GET /skills/:source/:id, /trending, /categories, /health, /cache/stats
- Sliding-window rate limiting (60 req/min/IP)

MCP server (@skillkit/mcp):
- 4 tools: search_skills, get_skill, recommend_skills, list_categories
- 2 resources: skills://trending, skills://categories
- Compatible with Claude Desktop, Cursor, any MCP client

CLI serve command:
- `skillkit serve` starts the API server
- Options: --port, --host, --cors, --cache-ttl

Community registry:
- registry/SKILLS.md with 26 curated skills across 12 categories
- CommunityRegistry class integrated into FederatedSearch

Python client (skillkit-client):
- Async httpx + pydantic client for the REST API
- search, get_skill, trending, categories, cache_stats, health

All 856+ tests pass across 24 workspace tasks.

* fix: resolve TypeScript errors in API package

Add explicit return type to rate limiter middleware and remove stale
CategoryCount type annotation in categories route.

* fix: address CodeRabbit review findings and version-check CI

- Fix version-check: bump docs packages to 1.11.0
- Parse first IP from X-Forwarded-For header in rate limiter
- Add try/catch for malformed JSON in POST /search
- Use exact source match in skill routes (owner/repo/id pattern)
- Fix NaN fallback for invalid limit params in trending/search
- Filter empty strings from query words in relevance ranker
- Use Map lookups instead of O(n^2) find in MCP resources/tools
- URL-encode path params in Python client
- Fix -h flag conflict with Clipanion help in serve command
- Fix typo: remoti-dev -> remotion-dev in registry SKILLS.md

* fix: address Devin review — composite key lookups and Python URL path

- Use source+name composite key Map lookups in search GET/POST routes
- Use source+name composite key Map lookup in trending route
- Fix Python client get_skill to use /skills/:owner/:repo/:id URL pattern
- Update Python test to match new 3-segment skill URL
2026-02-04 00:27:25 +00:00
Rohit Ghumare e569046776 chore: release v1.11.0 2026-02-03 14:38:15 +00:00
Rohit Ghumare 5bd7ebf607 feat: viral growth features — quick setup, badges, matrix, SKILL.md, federated search (#41)
* feat: add viral growth features (quick setup, badges, matrix, SKILL.md, federated search)

Tier 2: skillkit quick zero-friction entry, shareable badge generator,
agent compatibility matrix on website.

Tier 3: reposition as npm for agent skills, SKILL.md validate/init/check
commands, federated GitHub skill search with --federated flag on find.

* fix: matrix filtering, path traversal, cross-platform paths, fetch timeout

- CompatibilityMatrix: query matching agents now shows all categories
  (and vice versa) instead of hiding both dimensions independently
- quick.ts: sanitize skill names and validate targetInstallPath stays
  inside installDir before rmSync/cpSync/symlinkSync
- skillmd.ts: use path.relative() instead of string replace for
  cross-platform path display
- registry: add AbortController timeout (10s default) and distinct
  RateLimitError on 403 instead of silent empty return
- find.ts: handle RateLimitError with user-facing message
- Add quick-security.test.ts regression tests for path traversal

* fix: harden isPathInside with path.resolve, propagate RateLimitError

- isPathInside now uses path.resolve() + path.sep comparison instead of
  naive string replacement, fixing detection of paths completely outside
  the parent directory (both packages/core and src/core copies)
- FederatedSearch.search re-throws RateLimitError from rejected
  Promise.allSettled results so callers (find.ts) can handle 403s
- Updated security test to use the corrected isPathInside logic

* fix: use GITHUB_TOKEN/GH_TOKEN for authenticated GitHub API requests

GitHubSkillRegistry now reads GITHUB_TOKEN or GH_TOKEN from env and
sends Bearer auth header, raising the rate limit from 10 to 30 req/min
for code search. Matches the guidance shown to users on 403 errors.
2026-02-03 13:48:35 +00:00
Rohit Ghumare 549a21ad84 chore: release v1.10.0 2026-02-02 23:33:12 +00:00
Rohit Ghumare 109f00cd95 feat(core): add QMD-inspired hybrid search pipeline (#40)
* feat(core): add QMD-inspired hybrid search pipeline

Implement a hybrid search system combining vector embeddings with keyword search:

- Vector embeddings using node-llama-cpp with GGUF models (nomic-embed-text)
- RRF (Reciprocal Rank Fusion) for combining multiple rankers
- Query expansion with LLM and synonym fallback
- Position-aware score blending (different weights for top3, top10, rest)
- SQLite storage with sqlite-vec extension (falls back to in-memory)
- Auto-download of local GGUF models (~2GB)

New search module:
- embeddings.ts: Vector embedding generation service
- vector-store.ts: SQLite-based vector storage
- rrf.ts: RRF fusion algorithm
- expansion.ts: Query expansion with caching
- hybrid.ts: Main hybrid search pipeline
- local-models.ts: GGUF model management

CLI integration:
- skillkit recommend --hybrid: Enable hybrid search
- skillkit recommend --expand: Enable query expansion
- skillkit recommend --rerank: Enable LLM re-ranking
- skillkit recommend --build-index: Build embedding index

Tests: 56 new tests for search module (all passing)

* fix(search): address CodeRabbit review findings

- Add missing beforeEach import in embeddings.test.ts
- Update optional dependencies to current versions
- Fix weights/variations length mismatch in expansion.ts
- Avoid mutating input arrays in rrf.ts mergeRankings
- Delete orphaned chunk vectors in vector-store.ts delete() and clear()
- Add comment for empty catch block in vector-store.ts
- Make hybridSearch helper use buildIndex for true hybrid search
- Handle graceful degradation when embeddings unavailable
- Add node-llama-cpp mock in hybrid.test.ts

* fix(search): address CodeRabbit review round 2

- Fix gemma GGUF URL to point to valid community repo (bartowski)
- Add SQL injection protection for table names in vector-store.ts
- Fix resource leak with try/finally in hybridSearch helper
- Add backpressure handling for large model downloads
- Clamp startLine to non-negative in chunk calculation
- Add runtime validation warning for --expand/--rerank without --hybrid
- Update node-llama-cpp API usage (createEmbeddingContext, createContext)
- Update pnpm-lock.yaml for new optional dependency versions

* fix(search): use @ts-ignore for optional node-llama-cpp imports

CI doesn't install optional dependencies, so @ts-ignore is needed
instead of @ts-expect-error to suppress module not found errors.
2026-02-02 23:28:08 +00:00
Rohit Ghumare e3d7e0e28f feat(marketplace): add beautiful-mermaid skill
Add beautiful-mermaid to the skills marketplace:
- Render Mermaid diagrams as beautiful SVGs or ASCII art
- 5 diagram types: flowchart, sequence, class, ER, state
- 15 built-in themes + Shiki/VS Code theme integration
- Zero DOM dependencies, works in Node.js/Bun/Deno/browsers

Source: rohitg00/beautiful-mermaid
2026-02-02 17:42:09 +00:00
Rohit Ghumare 6cbbdabf59 feat(website): add dynamic stats from npm and GitHub APIs (#39)
* feat(website): add dynamic stats from npm and GitHub APIs

- Create useStats hook to fetch real-time version, downloads, and stars
- Replace hardcoded values in App.tsx stats bar with dynamic data
- Replace hardcoded version in Hero.tsx badge with dynamic data
- Add 5-minute cache to reduce API calls
- Fallback to default values if APIs fail

* fix: address CodeRabbit and Devin review comments

- Fix duplicate API calls: remove useStats from Hero, pass version as prop from App
- Fix falsy checks: use typeof checks for downloads and stargazers_count
  to correctly handle zero values instead of showing defaults
2026-02-02 17:38:48 +00:00
Rohit Ghumare c1c179217d fix(website): update version to 1.9.0 2026-02-02 17:09:24 +00:00
Rohit Ghumare de4425f440 chore: release v1.9.0 (#38)
Features:
- Hierarchical skill tree with 12 categories (skillkit tree)
- LLM-based reasoning engine for skill discovery
- Explainable recommendations (--explain, --reasoning flags)
- Connector placeholders for tool-agnostic skills (~~CRM, ~~chat, etc.)
- Execution flow tracking with metrics
- Standalone vs Enhanced mode detection

CLI:
- New `tree` command for taxonomy navigation
- Enhanced `recommend` with explanation support
- Fixed --skill alias and agent detection

Documentation:
- Added tree.mdx for Skill Tree documentation
- Updated recommendations.mdx with reasoning features
- Updated TUI docs with tree view mode
- Updated README with new features
- Updated website Features and Commands
2026-02-02 16:48:43 +00:00
Rohit Ghumare 8121c2bbac feat(core): add PageIndex-inspired patterns for skill discovery (#37)
* feat(core): add PageIndex-inspired patterns for skill discovery

Implements patterns from anthropics/knowledge-work-plugins:

Tree Module (packages/core/src/tree/):
- Hierarchical skill taxonomy with 12 categories
- Tree generator from skill tags and metadata
- Tree serializer for JSON/Markdown export
- Related skills graph with 4 relation types

Reasoning Engine (packages/core/src/reasoning/):
- LLM-based tree traversal for skill discovery
- Explainable recommendations with reasoning chains
- Search planning with category relevance scoring
- Result caching with 5-minute TTL

Connectors (packages/core/src/connectors/):
- Tool-agnostic ~~ placeholder system
- 13 connector categories (crm, chat, email, etc.)
- Auto-suggest mappings from MCP config
- Placeholder detection and replacement utilities

Execution Flow (packages/core/src/execution/):
- Step-by-step execution tracking with metrics
- Automatic retry with exponential backoff
- Standalone vs Enhanced mode detection
- Capability-based feature gating

CLI Integration:
- New `skillkit tree` command with --generate, --stats flags
- Enhanced `skillkit recommend` with --explain, --reasoning flags

TUI Integration:
- Tree view mode in Marketplace (toggle with 'v')
- Arrow key navigation for tree hierarchy

* fix: address CodeRabbit and Devin review feedback

- Use os.homedir() instead of process.env.HOME || '~' fallback
  (tree.ts, tree.service.ts, mode.ts)
- Add guard for division by zero in tree stats percentage
- Validate parseInt result for --depth flag
- Fix average stats calculation to use cacheMisses count
- Extract category from data in validateCategoryScore
- Remove unused skillMap field from TreeGenerator
- Make reasoning provider configurable instead of hardcoded
- Add try/catch for tree loading errors in Marketplace
- Handle missing tree nodes during traversal

* fix(execution): clear timeout timer to prevent resource leak

Store setTimeout ID and clear it in finally block when step
completes successfully before timeout. This prevents orphaned
timers from accumulating during long-running applications.
2026-02-02 16:18:13 +00:00
Rohit Ghumare 3565daa7f1 fix(cli): add --skill alias and fix agent detection
- Add --skill as alias for --skills option (install command)
- Fix sync command to always detect agent instead of using default 'universal'
- Auto-install npm dependencies for skills with package.json
2026-02-02 12:07:41 +00:00
Rohit Ghumare 8496e3c63c feat(publish): add RFC 8615 well-known skills support (#36)
* feat(agents): add skill-to-subagent converter command

Add `skillkit agent from-skill` command to convert SkillKit skills into
Claude Code native subagent format (.md files in .claude/agents/).

Features:
- Reference mode (default): generates subagent with `skills: [skill-name]`
- Inline mode (--inline): embeds full skill content in system prompt
- Options: --model, --permission, --global, --output, --dry-run

New files:
- packages/core/src/agents/skill-converter.ts
- packages/core/src/agents/__tests__/skill-converter.test.ts (23 tests)

Closes #22

* feat(publish): add RFC 8615 well-known skills support

Redesign publish workflow to align with industry standard:

- Add WellKnownProvider for auto-discovery from any domain
- skillkit add https://example.com discovers skills via /.well-known/skills/
- skillkit publish generates well-known hosting structure
- skillkit publish submit opens GitHub issue (legacy workflow)

Provider discovers skills from:
- /.well-known/skills/index.json (manifest)
- /.well-known/skills/{skill-name}/SKILL.md (skill files)

Includes 16 tests for WellKnownProvider and structure generation.

* fix(wellknown): correct baseSkillsUrl calculation for skills.json fallback

When using the /.well-known/skills.json fallback URL, the previous
logic produced a malformed URL with duplicated .well-known path segment:
- Before: https://example.com/.well-known/.well-known/skills
- After: https://example.com/.well-known/skills

Extract calculateBaseSkillsUrl helper function for better testability
and add 4 new unit tests covering both URL formats.

* docs: update publish command documentation for well-known skills

- README.md: Add self-hosting section with well-known URI structure
- commands.mdx: Add Publishing Commands section
- marketplace.mdx: Expand publish section with self-hosting instructions
- skills.mdx: Add self-hosting workflow documentation

Documents the new `skillkit publish` workflow that generates RFC 8615
well-known URI structures for decentralized skill hosting.

* fix(security): address path traversal and CRLF vulnerabilities

- agent.ts: Sanitize skill.name when building default filename
- publish.ts: Add sanitizeSkillName() to validate skill names before
  using in file paths, verify resolved paths stay within target dir
- skill-converter.ts: Normalize CRLF to LF before extracting body
  content to handle Windows-style line endings
- wellknown.ts: Add sanitizeSkillName() to validate remote skill names,
  verify resolved paths stay within temp dir, encode URL components

* fix(agents): improve YAML string escaping logic

Only escape strings that actually need it for valid YAML parsing:
- Strings containing newlines or colons
- Strings starting with special YAML characters (-, *, &, !, {, [, >, |, @, `)
- Strings starting with quotes

This fixes unnecessary escaping of strings like "code-quality" where
hyphens in the middle don't need escaping.

* fix(wellknown): address security review feedback

- Use path.sep instead of hardcoded '/' for cross-platform compatibility
- Add sanitization and path containment check in generateWellKnownStructure
- Remove unused 'vi' import in wellknown.test.ts
2026-02-01 21:38:42 +00:00
Rohit Ghumare 847af0f7ab feat(agents): add skill-to-subagent converter command (#34)
* feat(agents): add skill-to-subagent converter command

Add `skillkit agent from-skill` command to convert SkillKit skills into
Claude Code native subagent format (.md files in .claude/agents/).

Features:
- Reference mode (default): generates subagent with `skills: [skill-name]`
- Inline mode (--inline): embeds full skill content in system prompt
- Options: --model, --permission, --global, --output, --dry-run

New files:
- packages/core/src/agents/skill-converter.ts
- packages/core/src/agents/__tests__/skill-converter.test.ts (23 tests)

Closes #22

* fix(agents): address code review feedback

- Update CLI option descriptions to list all valid values (model: inherit, permission: bypassPermissions)
- Add filename sanitization to prevent path traversal attacks via --output
- Fix parseAllowedTools to handle both string and YAML array formats
- Support space-separated tool lists in allowed-tools
- Add tests for array and space-separated formats
2026-02-01 20:00:11 +00:00
Rohit Ghumare 34e8cd0b61 docs(tui): update documentation for Solid.js migration (#33)
Update TUI documentation to reflect the v1.8.0 migration from React to
Solid.js:

- Change @opentui/react to @opentui/solid
- Change React 19.0.0 to Solid.js 1.9.0
- Add note about migration rationale (performance, bundle size)
- Update performance optimizations section with Solid.js primitives
  (createMemo, createSignal, createEffect)
- Add windowed list rendering mention
- Update Integration section with Solid.js code example
- Update graceful exit to reference onCleanup instead of React unmount
2026-02-01 17:55:45 +00:00
Rohit Ghumare cbd9fcd679 chore: fix version mismatch in root and docs packages 2026-02-01 17:34:40 +00:00
498 changed files with 52749 additions and 5480 deletions
+1 -1
View File
@@ -35,7 +35,7 @@ assignees: rohitg00
- [ ] Repository is public
- [ ] Repository contains valid SKILL.md files
- [ ] Repository has a clear license
- [ ] Skills follow the [Agent Skills specification](https://agenstskills.com)
- [ ] Skills follow the [Agent Skills specification](https://skillkit.sh)
## Additional Context
+1 -1
View File
@@ -83,7 +83,7 @@ body:
options:
- label: Repository is public
required: true
- label: SKILL.md follows the agenstskills.com standard format
- label: SKILL.md follows the skillkit.sh standard format
required: true
- label: Skill has been tested with at least one AI agent
required: false
+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"
+4 -2
View File
@@ -24,8 +24,9 @@ npm-debug.log*
# Environment
.env
.env.local
.env.*.local
**/.env
**/.env.local
**/.env.*.local
# Package manager
yarn.lock
@@ -65,3 +66,4 @@ skillkit.yaml
CLAUDE.md
prd.md
.vercel
packages/extension/store-assets/skillkit-extension.zip
+1 -1
View File
@@ -206,7 +206,7 @@ To add support for a new AI coding agent:
If you want to contribute skills to the ecosystem:
1. Follow the [Agent Skills specification](https://agenstskills.com)
1. Follow the [Agent Skills specification](https://skillkit.sh)
2. Include a `SKILL.md` with proper frontmatter
3. Test with multiple agents using `skillkit translate`
4. Submit to the appropriate skill repository
+394 -491
View File
File diff suppressed because it is too large Load Diff
+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.
-93
View File
@@ -1,93 +0,0 @@
# Versioning
SkillKit uses **synchronized versioning** - all packages share the same version number.
## Package List
All these packages are kept in sync:
| Package | Location |
|---------|----------|
| `skillkit` | `apps/skillkit/` |
| `@skillkit/cli` | `packages/cli/` |
| `@skillkit/core` | `packages/core/` |
| `@skillkit/tui` | `packages/tui/` |
| `@skillkit/agents` | `packages/agents/` |
| `@skillkit/memory` | `packages/memory/` |
| `@skillkit/mesh` | `packages/mesh/` |
| `@skillkit/messaging` | `packages/messaging/` |
| `@skillkit/mcp-memory` | `packages/mcp-memory/` |
| `@skillkit/resources` | `packages/resources/` |
| `skillkit-docs` | `docs/fumadocs/` |
| Website | `docs/skillkit/` |
## How to Release
### 1. Bump Version
Use the version bump script:
```bash
./scripts/bump-version.sh 1.8.1
```
This updates all package.json files to the same version.
### 2. Commit Changes
```bash
git add -A
git commit -m "chore: bump version to 1.8.1"
git push origin main
```
### 3. Create Release
```bash
gh release create v1.8.1 --generate-notes
```
Or with custom notes:
```bash
gh release create v1.8.1 --title "v1.8.1 - Bug fixes" --notes "Release notes here"
```
### 4. Automated Publishing
When you push a tag starting with `v`, the CI automatically:
1. Verifies tag matches package versions
2. Runs tests
3. Publishes to npm
4. Publishes to GitHub Packages
5. Creates GitHub Release
## CI Checks
The CI validates version consistency on every PR:
- **version-check** job compares all package versions
- Fails if any package has a different version
- Run `./scripts/bump-version.sh <version>` to fix mismatches
## Semantic Versioning
We follow [semver](https://semver.org/):
- **MAJOR** (x.0.0): Breaking changes
- **MINOR** (0.x.0): New features, backward compatible
- **PATCH** (0.0.x): Bug fixes, backward compatible
## Quick Commands
```bash
# Check current versions
grep -r '"version"' apps/skillkit/package.json
# Bump all packages
./scripts/bump-version.sh 1.8.1
# Create release
gh release create v1.8.1 --generate-notes
```
+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 -6
View File
@@ -1,7 +1,7 @@
{
"name": "skillkit",
"version": "1.8.1",
"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",
@@ -56,12 +56,14 @@
"@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",
+71
View File
@@ -3,6 +3,8 @@ import { readFileSync } from 'node:fs';
import { fileURLToPath } from 'node:url';
import { dirname, join } from 'node:path';
import { Cli, Builtins } from 'clipanion';
import { setVersion, setAgentCount } from '@skillkit/cli';
import { getAdapterCount } from '@skillkit/agents';
import {
InstallCommand,
SyncCommand,
@@ -48,10 +50,12 @@ import {
AICommand,
AuditCommand,
PublishCommand,
PublishSubmitCommand,
AgentCommand,
AgentListCommand,
AgentShowCommand,
AgentCreateCommand,
AgentFromSkillCommand,
AgentTranslateCommand,
AgentSyncCommand,
AgentValidateCommand,
@@ -84,6 +88,12 @@ import {
SessionNoteCommand,
SessionCompleteCommand,
SessionInProgressCommand,
SessionSnapshotSaveCommand,
SessionSnapshotRestoreCommand,
SessionSnapshotListCommand,
SessionSnapshotDeleteCommand,
SessionExplainCommand,
ActivityCommand,
ProfileCommand,
ProfileListCommand,
ProfileCreateCommand,
@@ -95,6 +105,28 @@ import {
GuidelineDisableCommand,
GuidelineCreateCommand,
GuidelineRemoveCommand,
TreeCommand,
QuickCommand,
SkillMdValidateCommand,
SkillMdInitCommand,
SkillMdCheckCommand,
ServeCommand,
ScanCommand,
EvalCommand,
DoctorCommand,
SaveCommand,
AgentsMdCommand,
AgentsMdInitCommand,
AgentsMdSyncCommand,
AgentsMdShowCommand,
IssuePlanCommand,
IssueListCommand,
TimelineCommand,
SessionHandoffCommand,
LineageCommand,
TapAddCommand,
TapRemoveCommand,
TapListCommand,
} from '@skillkit/cli';
const __filename = fileURLToPath(import.meta.url);
@@ -103,6 +135,9 @@ const packageJsonPath = join(__dirname, '../package.json');
const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
const version = packageJson.version || '1.2.0';
setVersion(version);
setAgentCount(getAdapterCount());
const cli = new Cli({
binaryLabel: 'skillkit',
binaryName: 'skillkit',
@@ -149,10 +184,12 @@ cli.register(CommandCmd);
cli.register(AICommand);
cli.register(AuditCommand);
cli.register(PublishCommand);
cli.register(PublishSubmitCommand);
cli.register(AgentCommand);
cli.register(AgentListCommand);
cli.register(AgentShowCommand);
cli.register(AgentCreateCommand);
cli.register(AgentFromSkillCommand);
cli.register(AgentTranslateCommand);
cli.register(AgentSyncCommand);
cli.register(AgentValidateCommand);
@@ -199,6 +236,12 @@ cli.register(SessionListCommand);
cli.register(SessionNoteCommand);
cli.register(SessionCompleteCommand);
cli.register(SessionInProgressCommand);
cli.register(SessionSnapshotSaveCommand);
cli.register(SessionSnapshotRestoreCommand);
cli.register(SessionSnapshotListCommand);
cli.register(SessionSnapshotDeleteCommand);
cli.register(SessionExplainCommand);
cli.register(ActivityCommand);
cli.register(ProfileCommand);
cli.register(ProfileListCommand);
@@ -213,4 +256,32 @@ cli.register(GuidelineDisableCommand);
cli.register(GuidelineCreateCommand);
cli.register(GuidelineRemoveCommand);
cli.register(TreeCommand);
cli.register(QuickCommand);
cli.register(SkillMdValidateCommand);
cli.register(SkillMdInitCommand);
cli.register(SkillMdCheckCommand);
cli.register(ServeCommand);
cli.register(ScanCommand);
cli.register(EvalCommand);
cli.register(DoctorCommand);
cli.register(SaveCommand);
cli.register(AgentsMdCommand);
cli.register(AgentsMdInitCommand);
cli.register(AgentsMdSyncCommand);
cli.register(AgentsMdShowCommand);
cli.register(IssuePlanCommand);
cli.register(IssueListCommand);
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

+42
View File
@@ -0,0 +1,42 @@
[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"
[project]
name = "skillkit-client"
version = "0.1.0"
description = "Python client for the SkillKit REST API"
readme = "README.md"
license = "Apache-2.0"
requires-python = ">=3.9"
authors = [
{ name = "Rohit Ghumare", email = "ghumare64@gmail.com" },
]
keywords = ["skillkit", "ai", "agents", "skills", "discovery"]
classifiers = [
"Development Status :: 3 - Alpha",
"Intended Audience :: Developers",
"License :: OSI Approved :: Apache Software License",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.9",
"Programming Language :: Python :: 3.10",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Topic :: Software Development :: Libraries",
]
dependencies = [
"httpx>=0.27",
"pydantic>=2.0",
]
[project.optional-dependencies]
dev = [
"pytest>=7.0",
"pytest-asyncio>=0.23",
"respx>=0.21",
]
[project.urls]
Homepage = "https://github.com/rohitg00/skillkit"
Documentation = "https://skillkit.sh"
Repository = "https://github.com/rohitg00/skillkit"
+12
View File
@@ -0,0 +1,12 @@
from skillkit.client import SkillKitClient
from skillkit.models import Skill, SearchResponse, HealthResponse, CacheStats, Category
__all__ = [
"SkillKitClient",
"Skill",
"SearchResponse",
"HealthResponse",
"CacheStats",
"Category",
]
__version__ = "0.1.0"
+140
View File
@@ -0,0 +1,140 @@
from __future__ import annotations
from typing import Optional
from urllib.parse import quote
import httpx
from skillkit.models import (
CacheStats,
CategoriesResponse,
Category,
HealthResponse,
SearchResponse,
Skill,
TrendingResponse,
)
class SkillKitClient:
def __init__(self, base_url: str = "http://localhost:3737", timeout: float = 30.0):
self.base_url = base_url.rstrip("/")
self.timeout = timeout
self._client: Optional[httpx.AsyncClient] = None
async def __aenter__(self) -> "SkillKitClient":
self._client = httpx.AsyncClient(base_url=self.base_url, timeout=self.timeout)
return self
async def __aexit__(self, *args: object) -> None:
if self._client:
await self._client.aclose()
self._client = None
def _get_client(self) -> httpx.AsyncClient:
if self._client is None:
self._client = httpx.AsyncClient(base_url=self.base_url, timeout=self.timeout)
return self._client
async def health(self) -> HealthResponse:
client = self._get_client()
response = await client.get("/health")
response.raise_for_status()
data = response.json()
return HealthResponse(
status=data["status"],
version=data["version"],
skill_count=data.get("skillCount", 0),
uptime=data.get("uptime", 0),
)
async def search(
self,
query: str,
limit: int = 20,
include_content: bool = False,
) -> SearchResponse:
client = self._get_client()
params = {"q": query, "limit": str(limit)}
if include_content:
params["include_content"] = "true"
response = await client.get("/search", params=params)
response.raise_for_status()
data = response.json()
return SearchResponse(
skills=[Skill(**s) for s in data["skills"]],
total=data["total"],
query=data["query"],
limit=data["limit"],
)
async def search_with_filters(
self,
query: str,
limit: int = 20,
include_content: bool = False,
tags: Optional[list[str]] = None,
category: Optional[str] = None,
source: Optional[str] = None,
) -> SearchResponse:
client = self._get_client()
body: dict = {"query": query, "limit": limit, "include_content": include_content}
filters: dict = {}
if tags:
filters["tags"] = tags
if category:
filters["category"] = category
if source:
filters["source"] = source
if filters:
body["filters"] = filters
response = await client.post("/search", json=body)
response.raise_for_status()
data = response.json()
return SearchResponse(
skills=[Skill(**s) for s in data["skills"]],
total=data["total"],
query=data["query"],
limit=data["limit"],
)
async def get_skill(self, source: str, skill_id: str) -> Skill:
client = self._get_client()
parts = source.split("/", 1)
owner = quote(parts[0], safe="")
repo = quote(parts[1], safe="") if len(parts) > 1 else owner
response = await client.get(f"/skills/{owner}/{repo}/{quote(skill_id, safe='')}")
response.raise_for_status()
return Skill(**response.json())
async def trending(self, limit: int = 20) -> list[Skill]:
client = self._get_client()
response = await client.get("/trending", params={"limit": str(limit)})
response.raise_for_status()
data = response.json()
return [Skill(**s) for s in data["skills"]]
async def categories(self) -> list[Category]:
client = self._get_client()
response = await client.get("/categories")
response.raise_for_status()
data = response.json()
return [Category(**c) for c in data["categories"]]
async def cache_stats(self) -> CacheStats:
client = self._get_client()
response = await client.get("/cache/stats")
response.raise_for_status()
data = response.json()
return CacheStats(
hits=data["hits"],
misses=data["misses"],
size=data["size"],
max_size=data.get("maxSize", 0),
hit_rate=data.get("hitRate", 0.0),
)
async def close(self) -> None:
if self._client:
await self._client.aclose()
self._client = None
+51
View File
@@ -0,0 +1,51 @@
from typing import Optional
from pydantic import BaseModel
class Skill(BaseModel):
name: str
description: Optional[str] = None
source: str
repo: Optional[str] = None
tags: Optional[list[str]] = None
category: Optional[str] = None
content: Optional[str] = None
stars: Optional[int] = None
installs: Optional[int] = None
class SearchResponse(BaseModel):
skills: list[Skill]
total: int
query: str
limit: int
class HealthResponse(BaseModel):
status: str
version: str
skill_count: int = 0
uptime: int = 0
class CacheStats(BaseModel):
hits: int
misses: int
size: int
max_size: int = 0
hit_rate: float = 0.0
class Category(BaseModel):
name: str
count: int
class CategoriesResponse(BaseModel):
categories: list[Category]
total: int
class TrendingResponse(BaseModel):
skills: list[Skill]
limit: int
View File
+99
View File
@@ -0,0 +1,99 @@
import pytest
import httpx
import respx
from skillkit import SkillKitClient
BASE_URL = "http://localhost:3737"
@pytest.fixture
def mock_api():
with respx.mock(base_url=BASE_URL) as respx_mock:
yield respx_mock
@pytest.mark.asyncio
async def test_health(mock_api):
mock_api.get("/health").respond(
json={"status": "ok", "version": "1.11.0", "skillCount": 100, "uptime": 60}
)
async with SkillKitClient(BASE_URL) as client:
health = await client.health()
assert health.status == "ok"
assert health.version == "1.11.0"
assert health.skill_count == 100
@pytest.mark.asyncio
async def test_search(mock_api):
mock_api.get("/search").respond(
json={
"skills": [{"name": "react-perf", "source": "owner/repo"}],
"total": 1,
"query": "react",
"limit": 20,
}
)
async with SkillKitClient(BASE_URL) as client:
result = await client.search("react")
assert result.total == 1
assert result.skills[0].name == "react-perf"
@pytest.mark.asyncio
async def test_search_with_filters(mock_api):
mock_api.post("/search").respond(
json={
"skills": [{"name": "nextjs-auth", "source": "other/repo"}],
"total": 1,
"query": "auth",
"limit": 20,
}
)
async with SkillKitClient(BASE_URL) as client:
result = await client.search_with_filters("auth", tags=["nextjs"])
assert result.total == 1
@pytest.mark.asyncio
async def test_get_skill(mock_api):
mock_api.get("/skills/owner/repo/react-perf").respond(
json={"name": "react-perf", "description": "React performance", "source": "owner/repo"}
)
async with SkillKitClient(BASE_URL) as client:
skill = await client.get_skill("owner/repo", "react-perf")
assert skill.name == "react-perf"
@pytest.mark.asyncio
async def test_trending(mock_api):
mock_api.get("/trending").respond(
json={"skills": [{"name": "a", "source": "x/y"}], "limit": 20}
)
async with SkillKitClient(BASE_URL) as client:
trending = await client.trending()
assert len(trending) == 1
@pytest.mark.asyncio
async def test_categories(mock_api):
mock_api.get("/categories").respond(
json={"categories": [{"name": "react", "count": 5}], "total": 1}
)
async with SkillKitClient(BASE_URL) as client:
cats = await client.categories()
assert len(cats) == 1
assert cats[0].name == "react"
@pytest.mark.asyncio
async def test_cache_stats(mock_api):
mock_api.get("/cache/stats").respond(
json={"hits": 10, "misses": 5, "size": 8, "maxSize": 500, "hitRate": 0.667}
)
async with SkillKitClient(BASE_URL) as client:
stats = await client.cache_stats()
assert stats.hits == 10
assert stats.size == 8
+14 -2
View File
@@ -1,11 +1,11 @@
---
title: Supported Agents
description: 32 AI coding agents supported by SkillKit
description: 45 AI coding agents supported by SkillKit
---
# Supported Agents
SkillKit uses an adapter pattern to support 32 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
@@ -42,6 +42,18 @@ SkillKit uses an adapter pattern to support 32 AI coding platforms. Each adapter
| Qwen | `.qwen/skills/` | SKILL.md |
| Vercel | `.vercel/skills/` | SKILL.md |
| Zencoder | `.zencoder/skills/` | SKILL.md |
| Devin | `.devin/skills/` | Markdown |
| Aider | `.aider/skills/` | SKILL.md |
| Sourcegraph Cody | `.cody/skills/` | SKILL.md |
| Amazon Q Developer | `.amazonq/skills/` | SKILL.md |
| Augment Code | `.augment/skills/` | SKILL.md |
| Replit Agent | `.replit/skills/` | Markdown |
| Bolt | `.bolt/skills/` | Markdown |
| Lovable | `.lovable/skills/` | Markdown |
| Tabby | `.tabby/skills/` | SKILL.md |
| Tabnine | `.tabnine/skills/` | SKILL.md |
| CodeGPT | `.codegpt/skills/` | SKILL.md |
| PlayCode Agent | `.playcode/skills/` | Markdown |
| Universal | `skills/` | SKILL.md |
## Translation System
@@ -0,0 +1,121 @@
---
title: Chrome Extension
description: Save any webpage as an AI agent skill from your browser
---
# Chrome Extension
Save any webpage as a SKILL.md directly from your browser.
## Install
1. Download the extension from the [releases page](https://github.com/rohitg00/skillkit/releases)
2. Open `chrome://extensions` in Chrome
3. Enable "Developer mode" (top right)
4. Click "Load unpacked" and select the `packages/extension/dist/` folder
Or build from source:
```bash
git clone https://github.com/rohitg00/skillkit.git
cd skillkit
pnpm install && pnpm --filter @skillkit/extension build
```
Then load `packages/extension/dist/` as an unpacked extension.
## Usage
### Popup
1. Navigate to any webpage
2. Click the SkillKit extension icon
3. Optionally enter a custom skill name
4. Click **Save as Skill**
The extension sends the page URL to the SkillKit API, which extracts the content as markdown, generates tags using weighted 5-source analysis, and returns a complete SKILL.md. The file downloads to your `Downloads/skillkit-skills/` folder.
### Context Menu
Right-click on any page:
- **Save page as Skill** — sends the URL to the API, downloads the result
- **Save selection as Skill** — builds the skill locally from selected text (no network request)
### Making Skills Available to Agents
After downloading, install the skill so all agents can use it:
```bash
skillkit install ~/Downloads/skillkit-skills/my-skill
```
Or copy directly:
```bash
cp -r ~/Downloads/skillkit-skills/my-skill ~/.skillkit/skills/
skillkit sync
```
## How It Works
```
Extension → POST /api/save-skill { url } → Server pipeline → Download
```
1. **Popup** reads the current tab's URL and title via `activeTab` permission. No content script injection needed.
2. **Background service worker** sends the URL to `skillkit.sh/api/save-skill` (or `agenstskills.com/api/save-skill`):
- Server fetches the page and converts HTML to markdown via Turndown
- GitHub URLs are auto-converted to raw content
- Tags are detected from 5 weighted sources (URL segments, headings, code blocks, keywords, language)
- Returns a complete SKILL.md with YAML frontmatter
3. **Download** — the service worker creates a blob and saves via `chrome.downloads` API.
4. **Selection saves** work entirely offline — Chrome natively provides `selectionText` via the context menu API, so the skill is built locally with no server round-trip.
## Permissions
| Permission | Why |
|-----------|-----|
| `contextMenus` | Right-click "Save as Skill" menu items |
| `activeTab` | Access current page URL and title on click |
| `downloads` | Save SKILL.md files to disk |
No `host_permissions` or `scripting` permissions needed. Only the page URL is sent to the server — no page content, browsing history, or personal data.
## Generated SKILL.md Format
```yaml
---
name: react-performance-tips
description: Optimizing React rendering with memo and useMemo
tags:
- react
- javascript
- testing
metadata:
source: https://example.com/react-performance
savedAt: 2026-02-14T09:00:00.000Z
---
# React Performance Tips
The extracted markdown content of the page...
```
## Building from Source
The extension uses tsup to bundle TypeScript into IIFE format for browser compatibility:
```bash
pnpm --filter @skillkit/extension build
```
Output goes to `packages/extension/dist/` with:
- `background.global.js` — Service worker (~4KB)
- `popup.global.js` — Popup UI logic (~2KB)
- `popup.html` + `popup.css` — Monochromatic UI
- `manifest.json` — Chrome Manifest V3
- `icons/` — 16/48/128px PNG icons
+350 -14
View File
@@ -5,7 +5,7 @@ description: Complete reference for all SkillKit CLI commands
# CLI Commands
SkillKit provides 40+ commands organized into functional categories. Built on Clipanion v4 with interactive prompts via @clack/prompts.
SkillKit provides 50+ commands organized into functional categories. Built on Clipanion v4 with interactive prompts via @clack/prompts.
## Global Options
@@ -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
@@ -127,6 +168,72 @@ AI-powered recommendations based on project analysis.
| `--category` | Filter by category |
| `--min-score` | Quality threshold |
## Generate Command
AI-powered skill generation with multi-source context and agent optimization.
```bash
skillkit generate [options]
```
### Generate Options
| Option | Type | Purpose |
|--------|------|---------|
| `--provider` | string | LLM provider: anthropic, openai, google, ollama, openrouter |
| `--model` | string | Specific model (e.g., gpt-4o, gemini-2.0-flash) |
| `--compose` | string | Natural language search to find skills to compose |
| `--agents` | array | Target agents for optimization |
| `--no-memory` | boolean | Skip memory context |
| `--context-sources` | string | Comma-separated: docs,codebase,skills,memory |
### Context Sources
The wizard gathers context from 4 sources:
| Source | Description |
|--------|-------------|
| **Documentation** | Library docs via Context7 MCP |
| **Codebase** | Local project patterns and conventions |
| **Skills** | 15,000+ marketplace skills for composition |
| **Memory** | Your corrections and learned patterns |
### Examples
```bash
# Interactive wizard (recommended)
skillkit generate
# Use specific provider
skillkit generate --provider openai --model gpt-4o
# Compose from existing skills
skillkit generate --compose "testing patterns for react"
# Generate for specific agents
skillkit generate --agents claude-code,cursor
# Skip memory personalization
skillkit generate --no-memory
```
### Trust Score
Generated skills receive a trust score (0-10):
| Grade | Score | Meaning |
|-------|-------|---------|
| Trusted | 8-10 | High clarity, well-bounded |
| Review | 5-7 | May need refinement |
| Caution | 0-4 | Requires careful review |
### Agent Compatibility
The wizard shows compatibility scores for each target agent based on:
- Context length limits
- MCP/tool support
- Format requirements
## Marketplace Command
```bash
@@ -170,11 +277,19 @@ owner/repo@v1.2.3
```bash
skillkit memory status # View memory status
skillkit memory search <query> # Search learnings
skillkit memory compress # Compress observations
skillkit memory export <name> # Export as skill
skillkit memory compress # Compress observations to learnings
skillkit memory export <name> # Export learnings as skill
skillkit memory sync-claude # Update CLAUDE.md with learnings
skillkit memory index # View memory index (Layer 1)
skillkit memory --global # Use global memory
```
| Option | Purpose |
|--------|---------|
| `--global` | Use global memory instead of project |
| `--limit` | Limit number of results |
| `--tags` | Filter by tags |
## Translation Commands
```bash
@@ -226,6 +341,144 @@ skillkit cicd gitlab-ci # Generate GitLab CI
skillkit cicd pre-commit # Generate pre-commit hooks
```
## Serve Command
Start the SkillKit REST API server for runtime skill discovery.
```bash
skillkit serve [options]
```
| Option | Short | Default | Description |
|--------|-------|---------|-------------|
| `--port` | `-p` | `3737` | Port to listen on |
| `--host` | `-H` | `0.0.0.0` | Host to bind to |
| `--cors` | — | `*` | CORS allowed origin |
| `--cache-ttl` | — | `86400000` | Cache TTL in milliseconds |
### Examples
```bash
# Start with defaults
skillkit serve
# Custom port and host
skillkit serve --port 8080 --host localhost
# Restricted CORS
skillkit serve --cors "http://localhost:3000"
# Short cache TTL (1 hour)
skillkit serve --cache-ttl 3600000
```
### Endpoints
| Method | Path | Description |
|--------|------|-------------|
| GET | `/search?q=...` | Search skills |
| POST | `/search` | Search with filters |
| GET | `/skills/:owner/:repo/:id` | Get specific skill |
| GET | `/trending?limit=20` | Trending skills |
| GET | `/categories` | Skill categories |
| GET | `/health` | Server health |
| GET | `/cache/stats` | Cache statistics |
## Issue Planner
Generate structured plans from GitHub Issues. Requires the `gh` CLI.
```bash
skillkit issue plan "#42" # Plan from current repo
skillkit issue plan rohitg00/skillkit#42 # Cross-repo
skillkit issue plan "#42" --agent cursor # Target specific agent
skillkit issue plan "#42" --no-tests # Skip test steps
skillkit issue plan "#42" --json # JSON output
skillkit issue plan "#42" --tech-stack react,ts # Override tech stack
```
### Issue Plan Options
| Option | Short | Default | Purpose |
|--------|-------|---------|---------|
| `--agent` | `-a` | `claude-code` | Target agent |
| `--output` | `-o` | `.skillkit/plans/issue-<n>.md` | Output file path |
| `--no-tests` | — | `false` | Skip test steps |
| `--json` | — | `false` | Output as JSON |
| `--tech-stack` | — | — | Comma-separated tech stack |
### Issue List
```bash
skillkit issue list # List open issues
skillkit issue list --repo owner/repo # Specific repo
skillkit issue list --label bug # Filter by label
skillkit issue list --limit 20 # More results
skillkit issue list --json # JSON output
```
The planner extracts task lists (checkboxes) from the issue body, infers file mentions from backtick-quoted paths, and maps labels to tags (e.g., `bug` → `fix`, `enhancement` → `feature`). Generated plans work with `skillkit plan validate` and `skillkit plan execute`.
## Session Intelligence
Track skill executions, generate handoff documents, and analyze skill impact.
### Timeline
View a unified chronological event stream of all session activity.
```bash
skillkit timeline # Last 50 events
skillkit timeline --type git_commit # Filter by event type
skillkit timeline --skill code-simplifier # Filter by skill
skillkit timeline --since 2026-02-10 # Date filter
skillkit timeline --limit 20 --json # JSON output
```
| Option | Short | Purpose |
|--------|-------|---------|
| `--type` | `-t` | Filter: skill_start, skill_complete, task_progress, git_commit, observation, decision, snapshot |
| `--skill` | `-s` | Filter events by skill name |
| `--since` | — | Show events since date (YYYY-MM-DD) |
| `--limit` | `-l` | Max events (default: 50) |
| `--json` | `-j` | JSON output |
### Session Handoff
Generate a structured context document for agent switching.
```bash
skillkit session handoff # Print markdown to stdout
skillkit session handoff --to cursor # Target agent recommendations
skillkit session handoff --out handoff.md # Save to file
skillkit session handoff --json # JSON output
```
| Option | Short | Purpose |
|--------|-------|---------|
| `--to` | — | Target agent for recommendations |
| `--out` | `-o` | Save to file path |
| `--json` | `-j` | JSON output |
### Lineage
Show which skills produced which code changes with aggregate impact stats.
```bash
skillkit lineage # Full overview
skillkit lineage --skill code-simplifier # Single skill
skillkit lineage --file src/index.ts # Single file
skillkit lineage --since 2026-02-01 --json # Date filter + JSON
```
| Option | Short | Purpose |
|--------|-------|---------|
| `--skill` | `-s` | Filter by skill name |
| `--file` | `-f` | Filter by file path |
| `--since` | — | Show lineage since date |
| `--limit` | `-l` | Max entries |
| `--json` | `-j` | JSON output |
## Utility Commands
```bash
@@ -233,10 +486,93 @@ skillkit init # Initialize project
skillkit create <name> # Create new skill
skillkit validate [path] # Validate skill format
skillkit read <skills> # Read skill content
skillkit publish # Publish to marketplace
skillkit settings --set key=value # Configure settings
```
## Publishing Commands
```bash
skillkit publish [path] # Generate well-known hosting structure
skillkit publish --output dir # Output to specific directory
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
skillkit scan <path> # Scan skill for vulnerabilities
skillkit scan <path> --format json # Output as JSON
skillkit scan <path> --format table # Tabular output
skillkit scan <path> --format sarif # SARIF for GitHub Code Scanning
skillkit scan <path> --fail-on high # Exit 1 if HIGH+ findings
skillkit scan <path> --skip-rules UC001 # Skip specific rules
```
**Threat Categories:**
| Category | Description |
|----------|-------------|
| Prompt Injection | Override/bypass agent instructions |
| Command Injection | eval(), exec(), shell commands |
| Data Exfiltration | Webhook URLs, env var reads, credential access |
| Tool Abuse | Tool shadowing, autonomy escalation |
| Hardcoded Secrets | API keys, tokens, private keys |
| Unicode Steganography | Zero-width chars, bidi overrides |
**Install Integration:**
Skills are automatically scanned during `skillkit install`. Use `--no-scan` to skip, or `--force` to install despite findings.
**Output Formats:**
- `summary` (default) - colored terminal output
- `json` - machine-readable JSON
- `table` - tabular format
- `sarif` - SARIF v2.1 for GitHub Code Scanning / IDE integration
## 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/ # 32 adapters
│ └── agents/ # 45 adapters
├── marketplace/ # Skills data
│ ├── skills.json
│ └── sources.json
+135 -105
View File
@@ -1,148 +1,178 @@
---
title: SkillKit Documentation
description: Universal CLI for managing AI agent skills across 32 coding platforms
title: SkillKit
description: Universal skill management for AI coding agents
---
# SkillKit
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across **32 AI coding platforms**.
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.
**Current Version:** v1.8.0
SkillKit fixes this. Write a skill once, deploy it to all 45 agents.
## The Problem
Each AI coding agent uses different skill formats and directory structures:
- Claude Code uses `.claude/skills/` with SKILL.md
- Cursor uses `.cursor/skills/` with .mdc format
- GitHub Copilot uses `.github/skills/`
Without SkillKit, you either rewrite skills for each agent, lock into one platform, or abandon skills entirely.
## The Solution
SkillKit provides a **"write once, deploy everywhere"** platform. Maintain a single skill definition that automatically translates across all 32 platforms.
## Quick Install
## Get Started
```bash
# Run instantly with npx (no install required)
npx skillkit@latest
```
# Or install globally for frequent use
That's it. No global install needed. Or if you prefer:
```bash
npm install -g skillkit
skillkit init
skillkit install anthropics/skills
skillkit sync
```
## Core Features
Four commands. Your agents now have skills for PDF processing, code review, and more.
| Feature | Description |
|---------|-------------|
| **Cross-Platform Translation** | Automatic conversion between 32 agent formats |
| **Smart Recommendations** | AI-powered skill suggestions based on your tech stack |
| **Session Memory** | Persistent learning that survives across sessions |
| **Primer** | Auto-generate agent instructions from your codebase |
| **Mesh Network** | Multi-machine agent distribution with encrypted P2P |
| **Inter-Agent Messaging** | Send messages between AI agents across your network |
| **Team Collaboration** | Git-based `.skills` manifest for sharing |
| **Workflow Orchestration** | Compose skills into multi-step automated workflows |
| **Skill Testing** | Built-in test framework with assertions |
| **CI/CD Integration** | GitHub Actions, GitLab CI, and pre-commit hooks |
| **TypeScript API** | Full programmatic access to all features |
| **Interactive TUI** | Beautiful terminal interface with real-time updates |
## What Can You Do?
## Advanced Capabilities
### Session Memory System
Your AI agents learn patterns during sessions—then forget everything. SkillKit captures these learnings and makes them permanent.
### Install skills from anywhere
```bash
skillkit memory compress # Compress learnings
skillkit memory search auth # Search knowledge
skillkit memory export auth-patterns # Export as skill
skillkit install anthropics/skills # GitHub
skillkit install skills.sh/owner/repo/skill # skills.sh registry
skillkit install gitlab:team/skills # GitLab
skillkit install ./my-local-skills # Local
```
[Learn more →](/docs/memory)
### Translate between agents
### Primer - Auto-Generate Instructions
Automatically generate CLAUDE.md, .cursorrules, and agent instructions by analyzing your codebase.
Write for Claude, deploy to Cursor:
```bash
skillkit primer # Analyze project
skillkit primer --all-agents # Generate for all 32 agents
skillkit translate my-skill --to cursor
skillkit translate --all --to windsurf # All skills at once
```
[Learn more →](/docs/primer)
### Get smart recommendations
SkillKit reads your `package.json`, detects your stack, and suggests relevant skills:
```bash
skillkit recommend
# 92% vercel-react-best-practices
# 87% tailwind-v4-patterns
# 85% nextjs-app-router
```
### Discover skills at runtime
Start an API server and let agents find skills on demand:
```bash
skillkit serve
# Server running at http://localhost:3737
```
```bash
curl "http://localhost:3737/search?q=react+performance"
```
Or use MCP for native agent integration:
```json
{
"mcpServers": {
"skillkit": { "command": "npx", "args": ["@skillkit/mcp"] }
}
}
```
[REST API](/docs/rest-api) | [MCP Server](/docs/mcp-server) | [Python Client](/docs/python-client)
## How It Works
SkillKit sits between your skills and your agents. It handles format translation, discovery, and synchronization automatically.
| Layer | What It Does |
|-------|-------------|
| **CLI + TUI** | Install, translate, recommend, sync |
| **APIs** | REST server on :3737, MCP via stdio |
| **Core** | Translation engine, relevance ranker, skill parser |
| **Data** | 15,000+ skills from 31 curated sources |
## Supported Agents
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
Every skill is scanned for threats before installation — prompt injection, hardcoded secrets, command injection, and more:
```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
```
[Security Scanner](/docs/security)
## Beyond Basic Skills
### Session Memory
Your AI agents learn patterns during sessions, then forget everything. SkillKit captures those learnings and makes them permanent.
```bash
skillkit memory compress
skillkit memory search "auth patterns"
skillkit memory export auth-patterns
```
### Session Intelligence
Track skill executions, generate handoff documents for agent switching, and view skill impact lineage:
```bash
skillkit timeline # Unified event stream
skillkit session handoff # Agent-to-agent context
skillkit lineage # Skill impact graph
```
### Primer
Auto-generate CLAUDE.md, .cursorrules, and agent instructions by analyzing your codebase:
```bash
skillkit primer --all-agents
```
### Mesh Network
Run agents across multiple machines with encrypted P2P communication.
Distribute agents across machines with encrypted P2P:
```bash
skillkit mesh init # Initialize mesh node
skillkit mesh discover # Find peers on LAN
skillkit mesh security init # Setup Ed25519 encryption
skillkit mesh init
skillkit mesh discover
```
[Learn more →](/docs/mesh)
### Team Collaboration
### Inter-Agent Messaging
Send messages between AI agents across your mesh network.
Share skills via a Git-committable `.skills` manifest:
```bash
skillkit message send # Send to another agent
skillkit message inbox # Check your inbox
skillkit manifest init
skillkit manifest add anthropics/skills
git commit -m "add team skills"
```
[Learn more →](/docs/messaging)
Team members run `skillkit manifest install` and they're in sync.
## Architecture
## Next Steps
| Tier | Components |
|------|------------|
| **User Interfaces** | CLI (Clipanion v4), TUI (OpenTUI/React), Documentation |
| **Business Logic** | @skillkit/core, @skillkit/agents (32 adapters) |
| **Data Layer** | @skillkit/memory (CozoDB), @skillkit/mesh (WebSocket/UDP) |
| **External Systems** | GitHub/GitLab, Marketplace (15,000+ skills) |
- [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
- [Commands](/docs/commands) — Full CLI reference
- [REST API](/docs/rest-api) — Runtime discovery server
- [MCP Server](/docs/mcp-server) — Agent-native discovery
- [Python Client](/docs/python-client) — Python SDK
## Supported Agents (32)
Claude Code, Cursor, Codex, Gemini CLI, OpenCode, GitHub Copilot, Windsurf, Antigravity, Amp, Clawdbot, Droid, Goose, Kilo Code, Kiro CLI, Roo Code, Trae, Cline, CodeBuddy, Continue, Crush, Factory, MCPJam, Mux, Neovate, OpenHands, Pi, Qoder, Qwen, Vercel, Zencoder, CommandCode, Universal
[Full agent details →](/docs/agents)
## Popular Skill Sources
| Repository | Skills |
|------------|--------|
| anthropics/skills | PDF, XLSX, DOCX processing |
| vercel-labs/agent-skills | React/Next.js best practices |
| nextlevelbuilder/ui-ux-pro-max-skill | UI/UX design patterns |
| superdesigndev/superdesign-skill | Modern design systems |
## Get Started
1. [Installation](/docs/installation) - Install and initialize
2. [Quick Start](/docs/quickstart) - 5-minute guide
3. [Commands](/docs/commands) - Full CLI reference
4. [Skills](/docs/skills) - Skill format and lifecycle
5. [API Reference](/docs/api-reference) - Programmatic access
## Use Cases
- **Multi-Agent Developer** - Write skills once, use across Claude, Cursor, Windsurf, and more
- **Team Lead** - Share skills via Git-based manifest, ensure team alignment
- **New Project Starter** - Auto-generate agent instructions with Primer
- **Enterprise Architect** - Distribute agents across multiple machines with Mesh Network
## Enterprise Features
- **Private Registries** - Host internal skills in private repos
- **Git-Based Sync** - Skills live in your repo, push to share
- **CI/CD Integration** - Auto-validate and deploy skills on every commit
- **TypeScript API** - Full programmatic access for custom workflows
- **Security** - Ed25519 encryption, XChaCha20-Poly1305, TLS 1.3
**Current version:** v1.19.2 | [npm](https://www.npmjs.com/package/skillkit) | [GitHub](https://github.com/rohitg00/skillkit) | Apache-2.0
+87 -89
View File
@@ -5,139 +5,137 @@ description: Install SkillKit and set up your first project
# Installation
SkillKit is distributed as an npm package. Current version: **v1.8.0**
## No install needed
## Quick Start (No Install)
The fastest way to start:
```bash
# Run without installing
npx skillkit@latest
# Run specific commands
npx skillkit recommend
npx skillkit install anthropics/skills
```
## Install Globally
This runs the latest version directly. No global install, no setup.
## Global install
For frequent use, install globally:
```bash
npm install -g skillkit
```
The CLI provides two command aliases: `skillkit` and `sk` (shorthand).
## Alternative Methods
Also works with pnpm, yarn, or bun:
```bash
# pnpm
pnpm add -g skillkit
# yarn
yarn global add skillkit
# bun
bun add -g skillkit
# npx (no install required)
npx skillkit <command>
```
## GitHub Packages
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
npm install -g @rohitg00/skillkit --registry=https://npm.pkg.github.com
# 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
```
## Verify Installation
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
skillkit --version
# or
sk --version
```
## Requirements
**Requirements:** Node.js 18+ (Bun 1.2+ for the TUI).
- **Node.js** 18.0.0 or higher
- **Bun** 1.2.0 or higher (for TUI only)
## First Run Experience
When you run SkillKit for the first time, it initiates an interactive onboarding that:
1. Detects your current AI agent automatically
2. Creates necessary project directories
3. Gathers user preferences for future sessions
4. Displays contextual guidance
Preferences are stored in `~/.skillkit/preferences.json`.
## Initialize a Project
## Initialize a project
```bash
cd my-project
skillkit init
```
### Init Command Options
The init command:
| Flag | Short | Purpose |
|------|-------|---------|
| `--agent` | `-a` | Specify target agent (auto-detected if omitted) |
| `--list` | `-l` | Display all supported agents |
| `--quiet` | `-q` | Suppress welcome logo and confirmations |
1. **Detects your AI agent** — scans for `.claude/`, `.cursor/`, `.github/` directories
2. **Creates the skills folder** — sets up the right directory for your agent
3. **Saves preferences** — remembers your choices for next time
### What Init Creates
### Specify an agent directly
| Agent | Skills Directory | Config File |
|-------|-----------------|-------------|
```bash
skillkit init --agent cursor
skillkit init --list # Show all 45 supported agents
skillkit init --quiet # Skip logo and prompts (for CI)
```
### What gets created
| Agent | Skills Directory | Config |
|-------|-----------------|--------|
| Claude Code | `.claude/skills/` | `.claude/config.json` |
| Cursor | `.cursor/skills/` | `.cursor/config.mdc` |
| Codex | `.codex/skills/` | `AGENTS.md` |
| GitHub Copilot | `.github/skills/` | — |
| Universal | `skills/` | `AGENTS.md` |
## Visual Theme
Preferences are stored in `~/.skillkit/preferences.json`.
The CLI adapts its logo based on terminal width:
- **≥70 columns** - Full ASCII art with block characters
- **50-69 columns** - Spaced text display
- **less than 50 columns** - Minimal format with symbols
## Agent Icons
| Agent | Icon |
|-------|------|
| Claude Code | ⟁ |
| Cursor | ◫ |
| Codex | ◎ |
| Gemini CLI | ✦ |
| OpenCode | ⬡ |
## Non-Interactive Mode
For CI/CD or piped input environments:
## Next steps
```bash
skillkit init --quiet
skillkit recommend # Get skill suggestions for your project
skillkit install anthropics/skills # Install skills from GitHub
skillkit sync # Deploy to your agent
skillkit ui # Launch the terminal UI
```
This skips the welcome logo, runs agent detection automatically, and produces minimal output.
## Next Steps
After installation, continue with:
```bash
# Install skills from GitHub
skillkit install anthropics/skills
# Browse marketplace
skillkit marketplace
# Synchronize to agent directories
skillkit sync
# Launch interactive terminal UI
skillkit ui
```
[Quick Start guide](/docs/quickstart) | [Full command reference](/docs/commands)
+32 -1
View File
@@ -48,8 +48,39 @@ skillkit install anthropics/skills --agent claude-code,cursor
## Publish Skills
### Self-Host on Your Domain (Recommended)
Generate a well-known URI structure (RFC 8615) to host skills on your own domain:
```bash
# Create and validate your skill
skillkit create my-skill
skillkit validate my-skill
skillkit publish
# Generate hosting structure
skillkit publish ./my-skill --output ./public
```
This creates:
```
.well-known/skills/
index.json # Skill manifest for auto-discovery
my-skill/
SKILL.md # Your skill content
```
Deploy the `.well-known` folder to your web server. Users can then install via:
```bash
skillkit add https://your-domain.com
```
### Submit to SkillKit Marketplace
To submit your skill for inclusion in the central marketplace:
```bash
skillkit publish submit
```
This opens a GitHub issue for review by maintainers.
+105
View File
@@ -0,0 +1,105 @@
---
title: MCP Server
description: Agent-native skill discovery via Model Context Protocol
---
# MCP Server
The REST API works great for HTTP clients. But AI agents speak MCP — the Model Context Protocol. The `@skillkit/mcp` package lets agents discover skills natively, without HTTP calls or curl commands.
Think of it as giving your agent a direct line to the entire skill catalog.
## Setup
### Claude Desktop
Add this to `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"skillkit": {
"command": "npx",
"args": ["@skillkit/mcp"]
}
}
}
```
Restart Claude Desktop. Done.
### Cursor
Add to `.cursor/mcp.json` in your project:
```json
{
"mcpServers": {
"skillkit": {
"command": "npx",
"args": ["@skillkit/mcp"]
}
}
}
```
### Any MCP client
The server uses stdio transport. Works with any MCP-compatible client:
```bash
npx @skillkit/mcp
```
## What your agent can do
Once connected, your agent gets four tools:
### Search skills
Ask your agent: *"Find skills for React performance optimization"*
Behind the scenes, it calls `search_skills` with your query and returns ranked results. You can filter by tags, category, or source repository.
```
> Search for authentication skills tagged with "security"
```
The agent searches across the full catalog, ranks results by relevance, and shows you the best matches.
### Get a specific skill
Ask: *"Get the pdf-processing skill from anthropics/skills"*
The agent calls `get_skill` and returns the full skill details — description, tags, content, and references.
### Get recommendations
Ask: *"What skills would you recommend for my TypeScript React project?"*
The agent calls `recommend_skills` with your stack context (languages, frameworks, libraries) and returns personalized suggestions ranked by relevance.
### Browse categories
Ask: *"What skill categories are available?"*
The agent calls `list_categories` and returns all categories with counts, so you know what's out there.
## Resources
The server also exposes two read-only resources:
- **`skills://trending`** — Top 20 skills by relevance score
- **`skills://categories`** — All categories with counts
Agents can read these without making a tool call.
## How it works
1. On startup, the server loads all skills from the marketplace catalog
2. Your agent sends a natural language request
3. The MCP client translates it into a tool call
4. The `RelevanceRanker` scores and ranks results (same algorithm as the REST API)
5. Results come back as structured JSON through the MCP protocol
Same ranking, same data, same quality — just native to your agent instead of going through HTTP.
+141 -9
View File
@@ -5,25 +5,51 @@ description: Persistent learning across AI agent sessions
# Memory System
Capture learnings from AI sessions and convert them into reusable skills.
Capture learnings from AI sessions and convert them into reusable skills. SkillKit's memory system provides automatic observation capture, intelligent compression, and token-optimized retrieval.
## Commands
```bash
skillkit memory status # View status
skillkit memory search <q> # Search learnings
skillkit memory compress # Compress observations
skillkit memory compress # Compress observations to learnings
skillkit memory export <name> # Export as skill
skillkit memory --global # Global memory
skillkit memory sync-claude # Update CLAUDE.md with learnings
skillkit memory index # View memory index (Layer 1)
skillkit memory --global # Global memory operations
```
## How It Works
1. **Observations** - Track patterns during sessions
2. **Compression** - Distill into reusable knowledge
3. **Injection** - Load into new sessions
### Observation → Learning Pipeline
1. **Observations** - Track patterns during sessions (tool use, errors, solutions)
2. **Compression** - Distill observations into reusable learnings
3. **Injection** - Load relevant learnings into new sessions
4. **Export** - Convert to shareable skills
### Lifecycle Hooks
SkillKit integrates with Claude Code's lifecycle hooks for automatic memory capture:
| Hook | Trigger | Action |
|------|---------|--------|
| **SessionStart** | Session begins | Inject relevant learnings |
| **PostToolUse** | Tool completes | Capture outcomes as observations |
| **SessionEnd** | Session closes | Compress observations to learnings |
### Progressive Disclosure (Token Optimization)
Memory retrieval uses a 3-layer system to minimize token usage:
| Layer | Content | ~Tokens |
|-------|---------|---------|
| **Index** | Titles, tags, timestamps | 50-100 |
| **Timeline** | Context, excerpts, activity | ~200 |
| **Details** | Full content, metadata | 500-1000 |
The system starts with Layer 1 and progressively fetches deeper layers based on relevance and token budget.
## Storage
```
@@ -31,17 +57,123 @@ skillkit memory --global # Global memory
├── observations/ # Raw session data
├── learnings/ # Compressed knowledge
└── index.json # Memory index
<project>/.skillkit/memory/
├── observations/ # Project-specific observations
├── learnings/ # Project learnings
└── index.json # Project memory index
```
## Auto-CLAUDE.md Updates
Sync your most effective learnings to CLAUDE.md:
```bash
skillkit memory sync-claude
```
This populates the `## LEARNED` section with high-effectiveness insights, giving your agent persistent context across sessions.
## Programmatic API
### Memory Compression
```typescript
import { MemoryCompressor, LearningStore } from '@skillkit/core'
const compressor = new MemoryCompressor()
const learning = await compressor.compress(observations)
const compressor = new MemoryCompressor(projectPath)
const { learnings } = await compressor.compress(observations)
const store = new LearningStore()
const store = new LearningStore('project', projectPath)
await store.add(learning)
const results = await store.search('authentication')
```
### Lifecycle Hooks
```typescript
import { MemoryHookManager } from '@skillkit/core'
const manager = new MemoryHookManager(projectPath)
// Session start - inject relevant learnings
const startResult = await manager.onSessionStart()
// After tool use - capture outcomes
await manager.onToolUse({
tool_name: 'Write',
tool_input: { file_path: '/src/auth.ts' },
tool_result: 'File written successfully',
duration_ms: 150
})
// Session end - compress to learnings
const endResult = await manager.onSessionEnd()
```
### Progressive Disclosure
```typescript
import { ProgressiveDisclosureManager } from '@skillkit/core'
const pdm = new ProgressiveDisclosureManager(projectPath)
// Layer 1: Index (~50 tokens each)
const index = pdm.getIndex({ includeGlobal: true })
// Layer 2: Timeline (~200 tokens each)
const timeline = pdm.getTimeline(['id1', 'id2'])
// Layer 3: Full details (~600 tokens each)
const details = pdm.getDetails(['id1'])
// Smart retrieval with token budget
const result = pdm.smartRetrieve('authentication patterns', 2000)
// Returns optimal layer based on budget
```
### CLAUDE.md Updater
```typescript
import { ClaudeMdUpdater } from '@skillkit/core'
const updater = new ClaudeMdUpdater(projectPath)
// Preview what would be updated
const preview = updater.preview({ minEffectiveness: 70 })
// Update CLAUDE.md
const result = updater.update({
minEffectiveness: 60,
maxLearnings: 20,
preserveManualEntries: true
})
```
## Configuration
Configure memory behavior in `.skillkit/config.json`:
```json
{
"memory": {
"enabled": true,
"autoInjectOnSessionStart": true,
"autoCaptureToolUse": true,
"autoCompressOnSessionEnd": true,
"minRelevanceForCapture": 30,
"maxTokensForInjection": 2000,
"compressionThreshold": 50
}
}
```
## Claude Code Integration
Generate hooks configuration for Claude Code:
```typescript
const manager = new MemoryHookManager(projectPath)
const config = manager.generateClaudeCodeHooksConfig()
// Outputs hooks.json format for Claude Code integration
```
+7
View File
@@ -3,22 +3,29 @@
"pages": [
"index",
"installation",
"chrome-extension",
"quickstart",
"tui",
"skills",
"agents",
"translation",
"marketplace",
"tree",
"recommendations",
"primer",
"memory",
"methodology",
"mesh",
"messaging",
"workflows",
"security",
"testing",
"commands",
"configuration",
"api-reference",
"rest-api",
"mcp-server",
"python-client",
"cicd",
"teams",
"custom-agents",
@@ -0,0 +1,93 @@
---
title: Methodology Packs
description: Curated skill packs for debugging, testing, planning, and collaboration
---
# Methodology Packs
Methodology packs are curated collections of skills that guide AI agents through structured workflows. Each pack bundles related skills around a domain — debugging, testing, planning, or collaboration.
## Available Packs
| Pack | Skills | Description |
|------|--------|-------------|
| **debugging** | root-cause-analysis, trace-and-isolate, hypothesis-testing | Systematic bug investigation |
| **testing** | red-green-refactor, test-patterns, anti-patterns | Test-driven development |
| **planning** | design-first, task-decomposition, verification-gates | Design and decomposition |
| **collaboration** | structured-review, parallel-investigation, handoff-protocols | Code review and handoffs |
| **meta** | skill-authoring | Writing effective skills |
## Commands
```bash
skillkit methodology list # List available packs
skillkit methodology install debugging # Install a pack
skillkit methodology apply testing # Apply pack to current project
skillkit methodology validate planning # Validate pack skills
skillkit methodology load collaboration # Load pack into agent context
```
## Pack Structure
Each pack lives under `packages/core/src/methodology/packs/` with this structure:
```
packs/
debugging/
pack.json # Pack manifest (name, skills, tags)
root-cause-analysis/
SKILL.md # Skill content
trace-and-isolate/
SKILL.md
hypothesis-testing/
SKILL.md
```
## Skills Reference
### Debugging
- **root-cause-analysis** — Five Whys method, structured investigation phases, evidence collection, causal chain verification
- **trace-and-isolate** — Binary search debugging, git bisect, strategic logging, component isolation, minimal reproduction
- **hypothesis-testing** — Scientific method for debugging: observe, hypothesize, predict, test, conclude
### Testing
- **red-green-refactor** — Write a failing test, make it pass with minimal code, then refactor while green
- **test-patterns** — AAA, Given-When-Then, Test Data Builders, Object Mother, parameterized tests, fixtures, spies
- **anti-patterns** — Flaky tests, over-mocking, brittle assertions, test interdependency, hidden logic
### Planning
- **design-first** — Technical design documents before code: architecture, data models, API definitions, trade-off analysis
- **task-decomposition** — Vertical slicing, horizontal layering, workflow and component decomposition
- **verification-gates** — Validation checkpoints between phases with checklists and approval criteria
### Collaboration
- **structured-review** — Five-stage code review: requirements, correctness, quality, testing, security
- **parallel-investigation** — Coordinate multiple investigation threads with sync points and convergence decisions
- **handoff-protocols** — Structured work transitions: planned, unplanned, and partial handoffs
### Meta
- **skill-authoring** — Guidelines for writing SKILL.md files: frontmatter, triggers, directive language, content patterns
## Using with Agents
Once installed, methodology skills activate automatically based on trigger phrases. For example:
```
You: "I need to debug this failing API endpoint"
Agent: [Activates root-cause-analysis skill]
You: "Let's write tests first for this feature"
Agent: [Activates red-green-refactor skill]
You: "Break down this feature into tasks"
Agent: [Activates task-decomposition skill]
```
## TUI Integration
Access methodology packs from the TUI by pressing `o` (Methodology screen). Browse, install, and apply packs interactively.
+4 -4
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 32 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 32 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 32 Agents
### All 45 Agents
Each agent gets optimized instructions in their native format.
## Example Output
@@ -86,7 +86,7 @@ Detected:
- Claude Code (.claude/CLAUDE.md)
- Cursor (.cursor/.cursorrules)
- Codex (.codex/instructions.md)
+ 29 more agents
+ 41 more agents
💡 Tip: Run `skillkit sync` to apply changes
```
@@ -0,0 +1,105 @@
---
title: Python Client
description: Async Python SDK for skill discovery
---
# Python Client
Not everything runs on Node. The `skillkit-client` package gives Python apps the same skill discovery capabilities as the REST API — async, typed, and ready to go.
## Install
```bash
pip install skillkit-client
```
Requires Python 3.10+.
## Quick start
```python
from skillkit import SkillKitClient
async with SkillKitClient() as client:
results = await client.search("react performance", limit=5)
for skill in results.skills:
print(f"{skill.name}: {skill.description}")
```
The client connects to `http://localhost:3737` by default. Make sure the API server is running:
```bash
skillkit serve
```
## Search with filters
```python
results = await client.search_with_filters(
"authentication",
tags=["security"],
category="backend",
limit=10,
)
```
## Get a specific skill
```python
skill = await client.get_skill("anthropics/skills", "pdf-processing")
print(skill.name, skill.description, skill.tags)
```
## Trending and categories
```python
trending = await client.trending(limit=10)
categories = await client.categories()
for skill in trending:
print(f"{skill.name} ({skill.source})")
for cat in categories:
print(f"{cat.name}: {cat.count} skills")
```
## Health and cache
```python
health = await client.health()
print(f"v{health.version} — {health.skill_count} skills loaded")
stats = await client.cache_stats()
print(f"Cache hit rate: {stats.hit_rate:.0%}")
```
## Connect to a remote server
```python
async with SkillKitClient("https://my-server.example.com:3737") as client:
results = await client.search("deployment")
```
## Models
The client returns typed dataclasses:
```python
Skill(name, source, description, tags, category, content, score)
SearchResponse(skills, total, query, limit)
HealthResponse(status, version, skill_count, uptime)
Category(name, count)
CacheStats(hits, misses, size, max_size, hit_rate)
```
All fields except `name` and `source` on `Skill` are optional — they depend on what the server returns and whether you requested `include_content`.
## Prerequisites
The Python client talks to the SkillKit REST API. You need a running server:
```bash
skillkit serve
```
Then run your Python script in another terminal. The client handles connection management, retries, and cleanup automatically when used with `async with`.
+52 -225
View File
@@ -1,58 +1,27 @@
---
title: Quick Start
description: Get up and running with SkillKit in 5 minutes
description: Get productive with SkillKit in under 5 minutes
---
# Quick Start
This guide walks you through installing SkillKit, setting up your first project, and installing skills.
Go from zero to skills-enabled in four steps.
## 1. Run SkillKit
No installation required! Use npx:
## 1. Init
```bash
npx skillkit@latest
npx skillkit@latest init
```
Or install globally for frequent use:
SkillKit detects your AI agent, creates the skills directory, and saves your preferences.
```bash
npm install -g skillkit
skillkit --version
```
## 2. Initialize Your Project
Navigate to your project directory and run:
```bash
skillkit init
```
This starts an interactive onboarding that:
1. **Detects your AI agent** - Scans for `.claude/`, `.cursor/`, `.github/` directories
2. **Creates directories** - Sets up the skills folder for your agent
3. **Saves preferences** - Remembers your choices for future commands
### Quick Agent Selection
Three options appear for faster interaction:
- **"Same as last time"** - Reuse previous agent choices
- **"All detected agents"** - Select every agent found
- **"Select specific agents"** - Open full selection menu
## 3. Get Recommendations
SkillKit analyzes your project and suggests relevant skills:
## 2. Get recommendations
```bash
skillkit recommend
```
Example output:
SkillKit reads your project (package.json, languages, frameworks) and suggests relevant skills:
```
Project: my-app (Next.js + TypeScript + Tailwind)
@@ -61,235 +30,93 @@ Recommended Skills:
92% vercel-react-best-practices
87% tailwind-v4-patterns
85% nextjs-app-router
78% typescript-strict-mode
```
## 4. Install Skills
### Interactive Installation
## 3. Install
```bash
skillkit install anthropics/skills
```
This prompts you to:
- Select which skills to install
- Choose target agents
- Pick installation method (symlink or copy)
### Non-Interactive Installation
For CI/CD or scripting:
Pick which skills to install, choose target agents, and you're set. For CI/CD or scripting:
```bash
skillkit install anthropics/skills --skills=pdf,xlsx --agent claude --yes
```
### List Available Skills
Preview without installing:
Install for multiple agents at once:
```bash
skillkit install anthropics/skills --list
skillkit install vercel-labs/agent-skills --agent claude,cursor,windsurf
```
## 5. Sync to Your Agent
Deploy installed skills to your agent's configuration:
## 4. Sync
```bash
skillkit sync
```
## 6. Launch the TUI
Skills are now in your agent's configuration. Start coding.
For a visual interface:
## What else?
### Translate between agents
Already have Claude skills? Deploy them to Cursor:
```bash
skillkit translate my-skill --to cursor
```
### Auto-generate agent instructions
Let SkillKit analyze your codebase and create CLAUDE.md, .cursorrules, etc.:
```bash
skillkit primer --all-agents
```
### Launch the TUI
```bash
skillkit ui
# or just
skillkit
```
**Navigation:** `h` Home | `m` Marketplace | `r` Recommend | `i` Installed | `s` Sync | `q` Quit
`h` Home | `m` Marketplace | `r` Recommend | `i` Installed | `s` Sync | `q` Quit
## Complete Example
### Start the discovery server
Let agents find skills at runtime:
```bash
# Install SkillKit
npm install -g skillkit
# Initialize in your project
cd my-project
skillkit init
# Get recommendations
skillkit recommend
# Install from official marketplace
skillkit install anthropics/skills
# Install for multiple agents
skillkit install vercel-labs/agent-skills --agent claude,cursor,windsurf
# Sync to agents
skillkit sync
skillkit serve
```
## 7. Advanced Features
[REST API](/docs/rest-api) | [MCP Server](/docs/mcp-server)
### Auto-Generate Instructions (Primer)
Let SkillKit analyze your codebase and generate optimized instructions:
### Share with your team
```bash
skillkit primer # Analyze and generate
skillkit primer --all-agents # Generate for all 32 agents
```
[Learn more about Primer →](/docs/primer)
### Session Memory
Capture learnings from your AI sessions:
```bash
skillkit memory compress # Compress learnings
skillkit memory search auth # Search knowledge
skillkit memory export auth-skill # Export as skill
```
[Learn more about Memory →](/docs/memory)
### Mesh Network (Multi-Machine)
Distribute agents across multiple machines:
```bash
skillkit mesh init # Initialize mesh node
skillkit mesh discover # Find peers on LAN
skillkit mesh security init # Setup encryption
```
[Learn more about Mesh →](/docs/mesh)
### Inter-Agent Messaging
Send messages between AI agents:
```bash
skillkit message send # Send to another agent
skillkit message inbox # Check your inbox
skillkit message reply <id> # Reply to message
```
[Learn more about Messaging →](/docs/messaging)
## Team Collaboration
Share skills with your team using manifest files:
```bash
# Create manifest
skillkit manifest init
# Add skill sources
skillkit manifest add anthropics/skills
skillkit manifest add ./local-skills
# Team members install from manifest
skillkit manifest install
git add .skills && git commit -m "add team skills"
```
The `.skills` file can be committed to Git for team-wide consistency.
Team members run `skillkit manifest install` and get the same setup.
## Workflows & Automation
### Workflow Orchestration
Compose skills into multi-step workflows:
## Full workflow
```bash
skillkit workflow create feature-development
skillkit workflow run feature-development
npx skillkit@latest init # Detect agents, create dirs
skillkit recommend # Get smart suggestions
skillkit install anthropics/skills # Install from marketplace
skillkit primer --all-agents # Generate agent instructions
skillkit sync # Deploy everything
```
[Learn more about Workflows →](/docs/workflows)
## Next steps
### Skill Testing
Test skills before deployment:
```bash
skillkit test # Run all tests
skillkit test --tags unit # Run specific tests
```
[Learn more about Testing →](/docs/testing)
### CI/CD Integration
Generate GitHub Actions, GitLab CI configs:
```bash
skillkit cicd init --provider github
skillkit cicd init --provider gitlab
```
[Learn more about CI/CD →](/docs/cicd)
## User Preferences
Your choices are saved to `~/.skillkit/preferences.json`:
```json
{
"lastSelectedAgents": ["claude", "cursor"],
"autoSync": true,
"marketplace": {
"lastRefresh": "2025-01-01T00:00:00Z"
}
}
```
## Complete Workflow Example
```bash
# 1. Install SkillKit
npm install -g skillkit
# 2. Initialize in your project
cd my-project
skillkit init
# 3. Auto-generate base instructions
skillkit primer --all-agents
# 4. Get smart recommendations
skillkit recommend
# 5. Install recommended skills
skillkit install anthropics/skills
# 6. Setup mesh network (optional)
skillkit mesh init
# 7. Setup session memory (optional)
skillkit memory compress
# 8. Sync everything to agents
skillkit sync
# 9. Launch TUI for visual management
skillkit
```
## Next Steps
- **Browse Marketplace** - `skillkit marketplace`
- **Create Custom Skills** - `skillkit create my-skill`
- **Translate Between Agents** - `skillkit translate skill --to cursor`
- **Auto-Generate Instructions** - `skillkit primer`
- **Setup Memory System** - `skillkit memory compress`
- **View All Commands** - `skillkit --help`
- **API Reference** - [Programmatic Access →](/docs/api-reference)
- [Commands](/docs/commands) — Full CLI reference
- [Skills](/docs/skills) — Skill format and lifecycle
- [Memory](/docs/memory) — Persistent session learning
- [Mesh](/docs/mesh) — Multi-machine distribution
+41 -1
View File
@@ -32,6 +32,33 @@ skillkit recommend --category security
skillkit recommend --min-score 80
```
## Explainable Recommendations
See WHY skills match your project:
```bash
skillkit recommend --explain
```
Output:
```
vercel-react-best-practices (Score: 92)
├── Matched: React, TypeScript, Next.js
├── Your stack: Next.js 14, React 18
└── Path: Frontend > React > Best Practices
```
## LLM-Based Reasoning
Use reasoning-based discovery for complex queries:
```bash
skillkit recommend --reasoning
```
This uses an LLM to traverse the skill taxonomy and find the most relevant skills based on semantic understanding.
## How It Works
The engine analyzes:
@@ -50,9 +77,22 @@ Scores based on:
## Programmatic API
```typescript
import { RecommendationEngine, analyzeProject } from '@skillkit/core'
import {
RecommendationEngine,
ReasoningRecommendationEngine,
analyzeProject
} from '@skillkit/core'
// Basic recommendations
const engine = new RecommendationEngine()
const profile = await analyzeProject('./my-project')
const recs = engine.recommend(profile)
// With reasoning and explanations
const reasoningEngine = new ReasoningRecommendationEngine()
await reasoningEngine.initReasoning()
const explained = await reasoningEngine.recommendWithReasoning(profile, {
reasoning: true,
explain: true
})
```
+205
View File
@@ -0,0 +1,205 @@
---
title: REST API
description: Runtime skill discovery via HTTP
---
# REST API
Skills shouldn't require pre-installation. With the SkillKit REST API, any agent, framework, or tool can discover and retrieve skills on demand over HTTP.
## Start the server
```bash
skillkit serve
```
That's it. The API is now running at `http://localhost:3737`.
## Search for skills
```bash
curl "http://localhost:3737/search?q=react+performance"
```
```json
{
"skills": [
{
"name": "react-performance",
"description": "React app performance optimization",
"source": "anthropics/skills",
"tags": ["react", "performance"],
"score": 87
}
],
"total": 42,
"query": "react performance",
"limit": 20
}
```
Results are ranked by a multi-signal scoring system. The best matches come first.
### With filters
Use POST for advanced filtering:
```bash
curl -X POST http://localhost:3737/search \
-H "Content-Type: application/json" \
-d '{
"query": "auth",
"filters": { "tags": ["security"], "category": "backend" }
}'
```
### Include full content
Add `include_content=true` to get the complete SKILL.md body:
```bash
curl "http://localhost:3737/search?q=pdf&include_content=true&limit=3"
```
## Get a specific skill
```bash
curl http://localhost:3737/skills/anthropics/skills/pdf-processing
```
The path follows the pattern `/skills/:owner/:repo/:skill-name`.
## Browse trending skills
```bash
curl http://localhost:3737/trending?limit=10
```
Returns the top skills ranked by relevance score across all sources.
## List categories
```bash
curl http://localhost:3737/categories
```
```json
{
"categories": [
{ "name": "react", "count": 156 },
{ "name": "typescript", "count": 134 },
{ "name": "testing", "count": 89 }
],
"total": 89
}
```
## How ranking works
Every search result gets a score from 0 to 100, computed from four signals:
| Signal | Points | What it measures |
|--------|--------|-----------------|
| Content | 40 | Has a description and SKILL.md body |
| Query match | 30 | How well the name/description matches your search |
| Popularity | 15 | GitHub stars + install count (log-scaled) |
| References | 15 | Has example files, docs, or resources |
A skill with full content, an exact name match, high stars, and example files scores close to 100. A skill with just a name and no content scores around 10.
## Server options
```bash
skillkit serve --port 8080 --host localhost --cors "http://localhost:3000"
```
| Option | Default | What it does |
|--------|---------|-------------|
| `--port` / `-p` | `3737` | Port to listen on |
| `--host` / `-H` | `0.0.0.0` | Host to bind to |
| `--cors` | `*` | Allowed CORS origin |
| `--cache-ttl` | `86400000` | Cache lifetime in ms (default 24h) |
## Rate limiting
60 requests per minute per IP. Response headers tell you where you stand:
| Header | Meaning |
|--------|---------|
| `X-RateLimit-Remaining` | Requests left in this window |
| `X-RateLimit-Reset` | When the window resets |
Exceed the limit and you'll get HTTP 429 with a `retryAfter` field.
## Caching
Search results are cached in memory using an LRU strategy. Same query, same results, no recomputation. Check cache performance:
```bash
curl http://localhost:3737/cache/stats
```
```json
{
"hits": 142,
"misses": 38,
"size": 45,
"maxSize": 500,
"hitRate": 0.789
}
```
## Health check
```bash
curl http://localhost:3737/health
```
```json
{
"status": "ok",
"version": "1.19.2",
"skillCount": 15062,
"uptime": 3600
}
```
## Use it programmatically
```typescript
import { createApp, startServer } from '@skillkit/api';
const { server, app, cache } = await startServer({
port: 3737,
skills: mySkillsArray,
});
```
Or get just the Hono app for testing:
```typescript
const { app, cache } = createApp({
skills: mySkillsArray,
cacheTtlMs: 3_600_000,
});
```
## Interactive docs
The server includes built-in Swagger UI at `/docs` and an OpenAPI 3.1 spec at `/openapi.json`. Open `http://localhost:3737/docs` in your browser to try endpoints interactively.
The hosted version is available at [skillkit.sh/api](https://skillkit.sh/api) and [agenstskills.com/api](https://agenstskills.com/api).
## All endpoints
| Method | Path | Description |
|--------|------|-------------|
| GET | `/search?q=...` | Search skills |
| POST | `/search` | Search with filters |
| GET | `/skills/:owner/:repo/:id` | Get specific skill |
| GET | `/trending?limit=20` | Trending skills |
| GET | `/categories` | Skill categories |
| GET | `/health` | Server health |
| GET | `/cache/stats` | Cache statistics |
| GET | `/docs` | Swagger UI |
| GET | `/openapi.json` | OpenAPI spec |
+281
View File
@@ -0,0 +1,281 @@
---
title: Security Scanner
description: Detect malicious patterns, secrets, and vulnerabilities in AI agent skills
---
# Security Scanner
SkillKit includes a built-in security scanner that analyzes skills for prompt injection, command injection, data exfiltration, hardcoded secrets, and other threats before installation.
## Quick Start
```bash
skillkit scan ./my-skill
```
The scanner runs automatically during `skillkit install`. Use `--no-scan` to skip or `--force` to install despite findings.
## CLI Usage
```bash
skillkit scan <path> # Scan skill directory
skillkit scan <path> --format json # JSON output
skillkit scan <path> --format table # Tabular output
skillkit scan <path> --format sarif # SARIF v2.1 for GitHub Code Scanning
skillkit scan <path> --fail-on high # Exit code 1 if HIGH+ findings
skillkit scan <path> --skip-rules UC001 # Skip specific rules
skillkit scan <path> --skip-rules PI001,PI002 # Skip multiple rules
```
## Threat Categories
The scanner detects 46+ patterns across 6 threat categories:
### Prompt Injection (PI001–PI015)
Detects attempts to override, bypass, or manipulate agent instructions.
| Rule | Severity | Description |
|------|----------|-------------|
| PI001 | Critical | Instruction override ("ignore previous instructions") |
| PI002 | Critical | Context clearing ("forget everything") |
| PI003 | Critical | Training bypass ("disregard your training") |
| PI004 | Critical | System prompt injection ("new instructions:") |
| PI005 | High | Role manipulation ("you are now a...") |
| PI006 | High | Roleplay manipulation ("pretend to be...") |
| PI007 | High | Persistent behavior change ("from now on...") |
| PI008 | High | System prompt extraction ("show me your instructions") |
| PI009 | Critical | Policy bypass (jailbreak, unrestricted mode, DAN) |
| PI010 | High | Concealment ("don't tell the user") |
| PI011 | High | Delimiter injection (conversation role markers) |
| PI012 | High | Model-specific delimiters (Llama [INST] tags) |
| PI013 | Medium | YAML front-matter injection |
| PI014 | Medium | Hidden HTML comments with instructions |
| PI015 | Medium | Hidden Markdown comments with instructions |
### Command Injection (CI001–CI010)
Detects code execution, shell injection, and path traversal patterns.
| Rule | Severity | Description |
|------|----------|-------------|
| CI001 | Critical | `eval()` calls |
| CI002 | Critical | `Function()` constructor |
| CI003 | Critical | `child_process` exec/execSync |
| CI004 | Critical | Python `subprocess` with `shell=True` |
| CI005 | Medium | Template literals with dynamic content in command context |
| CI006 | Medium | Path traversal (`../`) |
| CI007 | High | Shell command chaining with dangerous commands |
| CI008 | Medium | Process execution functions |
| CI009 | High | Python dynamic import/compile |
| CI010 | Medium | Node.js `vm` module usage |
### Data Exfiltration (DE001–DE008)
Detects network requests, webhook URLs, and credential access patterns.
| Rule | Severity | Description |
|------|----------|-------------|
| DE001 | Critical | Discord webhook URLs |
| DE002 | Critical | Telegram bot API URLs |
| DE003 | High | Slack webhook URLs |
| DE004 | High | HTTP POST with env variables |
| DE005 | High | Fetch/axios sending to external URLs |
| DE006 | Medium | Reading `.env` or credentials files |
| DE007 | Medium | Environment variable access patterns |
| DE008 | Medium | DNS/IP-based exfiltration patterns |
### Tool Abuse (TA001–TA006)
Detects tool shadowing, autonomy escalation, and capability manipulation.
| Rule | Severity | Description |
|------|----------|-------------|
| TA001 | High | Tool shadowing (redefining built-in tools) |
| TA002 | High | Autonomy abuse ("keep retrying", "run without confirmation") |
| TA003 | High | Capability inflation (discovering/enabling extra tools) |
| TA004 | Medium | Tool chaining (read sensitive data then send externally) |
| TA005 | Medium | Permission escalation patterns |
| TA006 | Medium | Recursive self-invocation |
### Hardcoded Secrets (SK001–SK013)
Detects API keys, tokens, and credentials embedded in skill files.
| Rule | Severity | Description |
|------|----------|-------------|
| SK001 | Critical | OpenAI API key (`sk-...`) |
| SK002 | Critical | Stripe live publishable key |
| SK003 | Critical | Stripe secret key |
| SK004 | Critical | GitHub personal access token |
| SK005 | Critical | GitHub OAuth token |
| SK006 | Critical | AWS access key (`AKIA...`) |
| SK007 | Critical | Slack bot token (`xoxb-...`) |
| SK008 | Critical | Slack user token (`xoxp-...`) |
| SK009 | Critical | Private key block |
| SK010 | High | Google API key |
| SK011 | Critical | Anthropic API key (`sk-ant-...`) |
| SK012 | High | npm token |
| SK013 | Low | UUID patterns (with credential context) |
| SK-ENV | High | Environment file included in skill |
### Unicode Steganography (UC001–UC007)
Detects invisible characters and obfuscation techniques.
| Rule | Severity | Description |
|------|----------|-------------|
| UC001 | Medium | Zero-width characters (U+200B, U+200C, U+200D, U+FEFF) |
| UC002 | High | Bidirectional text override (U+202A–U+202E) |
| UC003 | High | Bidirectional isolate characters (U+2066–U+2069) |
| UC004 | High | Unicode tag characters (U+E0001–U+E007F) |
| UC005 | Medium | Control characters |
| UC006 | Medium | Base64-encoded payloads |
| UC007 | Medium | Hex/Unicode escape sequences |
### Manifest Validation (MF001–MF008)
Validates SKILL.md frontmatter and skill structure.
| Rule | Severity | Description |
|------|----------|-------------|
| MF001 | Low | Missing SKILL.md frontmatter |
| MF002 | Low | Missing skill name |
| MF003 | Low | Invalid skill name format |
| MF004 | Info | Missing skill description |
| MF005 | Info | Short skill description |
| MF006 | High | Dangerous tool in allowed-tools (Bash, shell) |
| MF007 | High | Impersonation (claiming official affiliation) |
| MF008 | Medium | Binary files in skill directory |
## Analyzers
The scanner uses three analyzers that run in parallel:
| Analyzer | Purpose | Rules |
|----------|---------|-------|
| **StaticAnalyzer** | Regex pattern matching against security rules | PI, CI, DE, TA, UC |
| **ManifestAnalyzer** | SKILL.md frontmatter validation | MF |
| **SecretsAnalyzer** | Credential and secret detection | SK |
## Output Formats
### Summary (default)
Colored terminal output with severity indicators, file locations, snippets, and remediation advice.
### JSON
Machine-readable JSON with all findings, stats, and verdict.
```bash
skillkit scan ./my-skill --format json | jq '.findings[] | {ruleId, severity, title}'
```
### Table
Tabular format for quick review:
```bash
skillkit scan ./my-skill --format table
```
### SARIF
SARIF v2.1 for GitHub Code Scanning and IDE integration:
```bash
skillkit scan ./my-skill --format sarif > results.sarif
```
Upload to GitHub:
```bash
gh api repos/{owner}/{repo}/code-scanning/sarifs \
-f "sarif=$(gzip -c results.sarif | base64)"
```
## CI/CD Integration
### GitHub Actions
```yaml
- name: Scan skills
run: npx skillkit scan ./skills --format sarif --fail-on high > results.sarif
- name: Upload SARIF
uses: github/codeql-action/upload-sarif@v3
with:
sarif_file: results.sarif
```
### Pre-commit Hook
```bash
skillkit scan . --fail-on medium
```
## Programmatic Usage
```typescript
import { SkillScanner, formatResult } from '@skillkit/core';
const scanner = new SkillScanner({
failOnSeverity: 'high',
skipRules: ['UC001', 'MF004'],
});
const result = await scanner.scan('./my-skill');
console.log(formatResult(result, 'summary'));
console.log(`Verdict: ${result.verdict}`);
console.log(`Findings: ${result.findings.length}`);
```
## Severity Levels
| Level | Exit Code | Description |
|-------|-----------|-------------|
| **Critical** | 1 (with `--fail-on critical`) | Immediate security threat |
| **High** | 1 (with `--fail-on high`, default) | Significant security risk |
| **Medium** | 1 (with `--fail-on medium`) | Potential security concern |
| **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:
- **Placeholder patterns**: `your-api-key`, `example`, `sample`, `dummy`, `xxx`
- **Test files**: `*.test.ts`, `*.spec.ts`, `__tests__/`
- **Import statements**: `import ... from '../'` (not path traversal)
- **Comments**: Code comments mentioning patterns
- **Security discussions**: Text discussing jailbreaks or vulnerabilities (uses negative lookbehind)
To skip specific rules:
```bash
skillkit scan . --skip-rules UC001,UC002,MF004
```
+18 -2
View File
@@ -94,6 +94,22 @@ Or manually create a `SKILL.md` file following the format above.
# Test locally
skillkit validate ./my-skill
# Publish to marketplace
skillkit publish
# Generate well-known hosting structure for self-hosting
skillkit publish ./my-skill --output ./public
# Or submit to SkillKit marketplace
skillkit publish submit
```
### Self-Hosting
The `skillkit publish` command generates an RFC 8615 well-known URI structure:
```
.well-known/skills/
index.json # Manifest for auto-discovery
my-skill/
SKILL.md # Skill content
```
Deploy to your domain and users can install via `skillkit add https://your-domain.com`.
+1 -1
View File
@@ -5,7 +5,7 @@ description: Convert skills between AI agent formats
# Translation
SkillKit automatically converts between all 32 agent formats using an adapter pattern.
SkillKit automatically converts between all 45 agent formats using an adapter pattern.
## Basic Translation
+144
View File
@@ -0,0 +1,144 @@
---
title: Skill Tree
description: Browse skills in a hierarchical taxonomy
---
# Skill Tree
Browse and navigate skills organized in a hierarchical taxonomy structure.
## Quick Start
```bash
# Show full skill tree
skillkit tree
# Navigate to a category
skillkit tree Frontend
# Navigate to subcategory
skillkit tree "Frontend > React"
```
## Commands
### Display Tree
```bash
skillkit tree # Full tree
skillkit tree Development # Specific category
skillkit tree --depth 2 # Limit display depth
```
### Generate Tree
```bash
skillkit tree --generate # Generate from skill index
```
This builds a hierarchical tree from the skill index based on tags and metadata.
### Export Formats
```bash
skillkit tree --json # JSON output
skillkit tree --markdown # Markdown output
```
### Statistics
```bash
skillkit tree --stats
```
Output:
```
Overview:
Total Skills: 15,064
Categories: 156
Max Depth: 4
Top-Level Categories:
Development 4,521 skills (30.0%)
Frontend (1,245), Backend (1,102), Mobile (456)
DevOps 2,340 skills (15.5%)
CI/CD (890), Kubernetes (567), Docker (445)
AI/ML 1,890 skills (12.5%)
LLM Integration (756), Agents (445), RAG (312)
```
## Categories
The tree organizes skills into 12 top-level categories:
| Category | Description |
|----------|-------------|
| Development | General coding, programming patterns |
| Frontend | React, Vue, Angular, Svelte, UI/UX |
| Backend | Node.js, Python, Go, APIs, servers |
| Mobile | React Native, Flutter, iOS, Android |
| DevOps | CI/CD, Kubernetes, Docker, cloud |
| Testing | Unit, E2E, integration, TDD |
| Security | Auth, encryption, vulnerabilities |
| AI/ML | LLM, agents, RAG, embeddings |
| Database | SQL, NoSQL, ORM, migrations |
| Tooling | Linting, formatting, bundling |
| Documentation | API docs, guides, READMEs |
| Performance | Optimization, caching, profiling |
## TUI Tree View
In the TUI, press `v` to toggle tree view in the Marketplace:
- **Arrow keys** - Navigate tree
- **Enter** - Expand category / select skill
- **←** - Go back / collapse
- **v** - Toggle list/tree view
## Related Skills Graph
Find skills related to each other:
```typescript
import { buildSkillGraph, getRelatedSkills } from '@skillkit/core'
const graph = buildSkillGraph(skills)
const related = getRelatedSkills('react-patterns', graph, skills, {
limit: 5,
types: ['similar', 'complementary']
})
```
### Relation Types
- **similar** - Shares tags and functionality
- **complementary** - Works well together
- **dependency** - Required by other skills
- **alternative** - Different approach to same problem
## Programmatic API
```typescript
import {
TreeGenerator,
generateSkillTree,
loadTree,
saveTree,
treeToMarkdown
} from '@skillkit/core'
// Generate tree from skills
const generator = new TreeGenerator({ maxDepth: 3 })
const tree = generator.generateTree(skills)
// Or use the helper function
const tree = generateSkillTree(skills)
// Save and load
saveTree(tree, './skill-tree.json')
const loaded = loadTree('./skill-tree.json')
// Export to markdown
const markdown = treeToMarkdown(tree)
```
+41 -9
View File
@@ -18,10 +18,12 @@ skillkit
## Framework
Built on modern technologies:
- **@opentui/react** - Terminal rendering
- **React 19.0.0** - Component architecture
- **@opentui/solid** - Terminal rendering with Solid.js
- **Solid.js 1.9.0** - Reactive component architecture
- **Bun 1.2.0+** - Runtime requirement
The TUI was migrated from React to Solid.js in v1.8.0 for improved performance and smaller bundle size.
## Screens
| Screen | Key | Purpose |
@@ -103,6 +105,20 @@ Browse 15,000+ skills:
- Featured skills
- 3-phase animation loading
- Quality scoring
- **Tree View** - Press `v` to toggle hierarchical navigation
#### Tree View Mode
Navigate skills in a hierarchical taxonomy:
| Key | Action |
|-----|--------|
| `v` | Toggle tree/list view |
| `→` or `Enter` | Expand category |
| `←` | Collapse / go back |
| `↑`/`↓` | Navigate |
Categories include: Development, Frontend, Backend, Mobile, DevOps, Testing, Security, AI/ML, Database, Tooling, Documentation, Performance
### Recommend Screen
@@ -159,8 +175,10 @@ loadSkills()
### Performance Optimizations
- `useMemo` for filtered lists
- `useCallback` for event handlers
- `createMemo` for filtered lists and computed values
- `createSignal` for reactive state management
- `createEffect` for side effects and subscriptions
- Windowed list rendering for large datasets
- Pagination limits rendered items
- Progressive animation with phases
@@ -174,18 +192,32 @@ loadSkills()
## Integration
The TUI integrates with @skillkit/core:
The TUI integrates with @skillkit/core using Solid.js reactive patterns:
```typescript
findAllSkills(searchDirs) // Returns skill metadata
evaluateSkillDirectory(path) // Quality metrics
getQualityGrade(score) // 0-100 to A-F
import { createSignal, createMemo, createEffect } from 'solid-js';
const [skills, setSkills] = createSignal([]);
createEffect(async () => {
const result = await findAllSkills(searchDirs);
setSkills(result);
});
const filteredSkills = createMemo(() =>
skills().filter(s => s.name.includes(searchTerm()))
);
```
Core functions:
- `findAllSkills(searchDirs)` - Returns skill metadata
- `evaluateSkillDirectory(path)` - Quality metrics
- `getQualityGrade(score)` - 0-100 to A-F
## Graceful Exit
The TUI handles shutdown gracefully:
1. Unmounts React components
1. Runs Solid.js cleanup functions (`onCleanup`)
2. Restores terminal state
3. Cleans up signal handlers
4. Exits process cleanly
+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);
+4 -2
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit-docs",
"version": "1.8.0",
"version": "1.24.0",
"private": true,
"scripts": {
"build": "next build",
@@ -21,7 +21,8 @@
"next-themes": "^0.4.6",
"react": "^19.2.3",
"react-dom": "^19.2.3",
"tailwind-merge": "^3.4.0"
"tailwind-merge": "^3.4.0",
"turndown": "^7.2.2"
},
"devDependencies": {
"@tailwindcss/postcss": "^4.1.18",
@@ -29,6 +30,7 @@
"@types/node": "^24.10.2",
"@types/react": "^19.2.7",
"@types/react-dom": "^19.2.3",
"@types/turndown": "^5.0.6",
"postcss": "^8.5.6",
"tailwindcss": "^4.1.18",
"typescript": "^5.9.3"
+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
+5 -5
View File
@@ -18,7 +18,7 @@ export default function HomePage() {
<p className="text-lg text-zinc-400 mb-8 max-w-2xl mx-auto font-mono">
One CLI to install, sync, and manage skills across Claude Code, Cursor,
Windsurf, Copilot, and 28 more agents. 15,000+ skills ready to use.
Windsurf, Copilot, and 40 more agents. 400K+ skills ready to use.
</p>
<div className="flex flex-wrap justify-center gap-4 mb-12">
@@ -39,12 +39,12 @@ 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">32 Agents</h3>
<p className="text-zinc-500 text-sm">Claude, Cursor, Codex, Windsurf, Copilot, and 27 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">15,000+ Skills</h3>
<p className="text-zinc-500 text-sm">Browse the marketplace or create your own. Install with a single command.</p>
<h3 className="text-lg font-bold text-white mb-2 font-mono">400K+ Skills</h3>
<p className="text-zinc-500 text-sm">Aggregated from 34+ registries and repositories. Install with a single command.</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">Auto Translation</h3>
@@ -0,0 +1,291 @@
import { NextRequest, NextResponse } from 'next/server';
import TurndownService from 'turndown';
const rateLimitMap = new Map<string, { count: number; resetTime: number }>();
const RATE_LIMIT_WINDOW_MS = 60 * 1000;
const RATE_LIMIT_MAX_REQUESTS = 10;
function checkRateLimit(key: string): { allowed: boolean; remaining: number } {
const now = Date.now();
const entry = rateLimitMap.get(key);
if (!entry || now > entry.resetTime) {
rateLimitMap.set(key, { count: 1, resetTime: now + RATE_LIMIT_WINDOW_MS });
return { allowed: true, remaining: RATE_LIMIT_MAX_REQUESTS - 1 };
}
if (entry.count >= RATE_LIMIT_MAX_REQUESTS) {
return { allowed: false, remaining: 0 };
}
entry.count++;
return { allowed: true, remaining: RATE_LIMIT_MAX_REQUESTS - entry.count };
}
const BLOCKED_HOSTS = new Set(['localhost', '127.0.0.1', '[::1]', '::1', '0.0.0.0']);
function isAllowedUrl(url: string): boolean {
try {
const parsed = new URL(url);
if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') return false;
const hostname = parsed.hostname.toLowerCase();
const bare = hostname.replace(/^\[|\]$/g, '');
if (BLOCKED_HOSTS.has(hostname) || BLOCKED_HOSTS.has(bare)) return false;
if (bare.startsWith('::ffff:')) return isAllowedUrl(`http://${bare.slice(7)}`);
if (/^127\./.test(bare) || /^0\./.test(bare)) return false;
if (bare.startsWith('10.') || bare.startsWith('192.168.')) return false;
if (/^172\.(1[6-9]|2\d|3[01])\./.test(bare)) return false;
if (bare.startsWith('169.254.')) return false;
if (bare.startsWith('fe80:') || bare.startsWith('fc00:') || bare.startsWith('fd')) return false;
if (/^(22[4-9]|23\d|24\d|25[0-5])\./.test(bare)) return false;
if (/^ff[0-9a-f]{2}:/.test(bare)) return false;
return true;
} catch {
return false;
}
}
const GITHUB_URL_PATTERN = /^https?:\/\/github\.com\/([^/]+)\/([^/]+)\/blob\/([^/]+)\/(.+)$/;
const GITHUB_RAW_PATTERN = /^https?:\/\/raw\.githubusercontent\.com\//;
const FETCH_TIMEOUT = 30_000;
const TECH_KEYWORDS = new Set([
'react', 'vue', 'angular', 'svelte', 'nextjs', 'nuxt', 'remix',
'typescript', 'javascript', 'python', 'rust', 'go', 'java', 'ruby',
'node', 'deno', 'bun', 'docker', 'kubernetes', 'terraform',
'aws', 'gcp', 'azure', 'vercel', 'netlify', 'cloudflare',
'graphql', 'rest', 'grpc', 'websocket', 'redis', 'postgres',
'mongodb', 'sqlite', 'mysql', 'prisma', 'drizzle',
'tailwind', 'css', 'html', 'sass', 'webpack', 'vite', 'esbuild',
'git', 'ci', 'cd', 'testing', 'security', 'authentication',
'api', 'cli', 'sdk', 'mcp', 'llm', 'ai', 'ml', 'openai', 'anthropic',
]);
const TAG_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;
const turndown = new TurndownService({ headingStyle: 'atx', codeBlockStyle: 'fenced' });
interface ExtractedContent {
title: string;
content: string;
sourceUrl: string;
contentType: string;
language?: string;
}
async function extractFromUrl(url: string): Promise<ExtractedContent> {
if (GITHUB_URL_PATTERN.test(url) || GITHUB_RAW_PATTERN.test(url)) {
return fetchGitHubContent(url);
}
const MAX_BODY_SIZE = 5 * 1024 * 1024;
const response = await fetch(url, { signal: AbortSignal.timeout(FETCH_TIMEOUT) });
if (!response.ok) {
throw new Error(`Failed to fetch ${url}: ${response.status} ${response.statusText}`);
}
const contentLength = Number(response.headers.get('content-length') || '0');
if (contentLength > MAX_BODY_SIZE) {
throw new Error('Response too large');
}
const contentType = response.headers.get('content-type') ?? '';
const body = await response.text();
if (body.length > MAX_BODY_SIZE) {
throw new Error('Response too large');
}
if (contentType.includes('text/html')) {
const titleMatch = body.match(/<title[^>]*>([^<]+)<\/title>/i);
const title = titleMatch?.[1]?.trim() ?? new URL(url).hostname;
const bodyMatch = body.match(/<body[^>]*>([\s\S]*)<\/body>/i);
const content = turndown.turndown(bodyMatch?.[1] ?? body);
return { title, content, sourceUrl: url, contentType: 'webpage' };
}
const title = new URL(url).pathname.split('/').pop() ?? 'Untitled';
return { title, content: body, sourceUrl: url, contentType: 'text' };
}
const LANG_MAP: Record<string, string> = {
'.ts': 'typescript', '.tsx': 'typescript', '.js': 'javascript', '.jsx': 'javascript',
'.py': 'python', '.rb': 'ruby', '.go': 'go', '.rs': 'rust', '.java': 'java',
'.kt': 'kotlin', '.swift': 'swift', '.sh': 'shell', '.yml': 'yaml', '.yaml': 'yaml',
'.json': 'json', '.md': 'markdown', '.html': 'html', '.css': 'css', '.sql': 'sql',
};
async function fetchGitHubContent(url: string): Promise<ExtractedContent> {
let rawUrl = url;
const match = url.match(GITHUB_URL_PATTERN);
if (match) {
const [, owner, repo, branch, path] = match;
rawUrl = `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${path}`;
}
const MAX_BODY_SIZE = 5 * 1024 * 1024;
const response = await fetch(rawUrl, { signal: AbortSignal.timeout(FETCH_TIMEOUT) });
if (!response.ok) {
throw new Error(`Failed to fetch GitHub content: ${response.status} ${response.statusText}`);
}
const contentLength = Number(response.headers.get('content-length') || '0');
if (contentLength > MAX_BODY_SIZE) {
throw new Error('Response too large');
}
const body = await response.text();
if (body.length > MAX_BODY_SIZE) {
throw new Error('Response too large');
}
const filename = rawUrl.split('/').pop() ?? 'file';
const ext = filename.includes('.') ? '.' + filename.split('.').pop()!.toLowerCase() : '';
const language = LANG_MAP[ext];
const isCode = language !== undefined && language !== 'markdown';
const content = isCode ? `\`\`\`${language}\n${body}\n\`\`\`` : body;
return { title: filename, content, sourceUrl: url, contentType: 'github', language };
}
function addTag(counts: Map<string, number>, tag: string, weight: number): void {
if (TAG_PATTERN.test(tag)) {
counts.set(tag, (counts.get(tag) ?? 0) + weight);
}
}
function detectTags(extracted: ExtractedContent): string[] {
const counts = new Map<string, number>();
try {
const segments = new URL(extracted.sourceUrl).pathname
.split('/').filter(Boolean)
.map((s) => s.toLowerCase().replace(/[^a-z0-9-]/g, ''));
for (const seg of segments) {
if (seg.length >= 2 && seg.length <= 30) {
addTag(counts, seg, 2);
}
}
} catch { /* skip */ }
const headingRe = /^#{1,2}\s+(.+)$/gm;
let m: RegExpExecArray | null;
while ((m = headingRe.exec(extracted.content)) !== null) {
for (const word of m[1].toLowerCase().split(/\s+/)) {
const cleaned = word.replace(/[^a-z0-9-]/g, '');
if (cleaned.length >= 2) {
addTag(counts, cleaned, 2);
}
}
}
const codeBlockRe = /^```(\w+)/gm;
while ((m = codeBlockRe.exec(extracted.content)) !== null) {
const lang = m[1].toLowerCase();
if (lang.length >= 2) {
addTag(counts, lang, 3);
}
}
const lower = extracted.content.toLowerCase();
for (const keyword of TECH_KEYWORDS) {
if (new RegExp(`\\b${keyword}\\b`, 'i').test(lower)) {
addTag(counts, keyword, 1);
}
}
if (extracted.language) {
addTag(counts, extracted.language.toLowerCase(), 3);
}
return Array.from(counts.entries())
.sort((a, b) => b[1] - a[1])
.slice(0, 10)
.map(([tag]) => tag);
}
function slugify(input: string): string {
const slug = input
.toLowerCase()
.replace(/[^a-z0-9]+/g, '-')
.replace(/^-+|-+$/g, '')
.replace(/-{2,}/g, '-');
return slug.slice(0, 64).replace(/-+$/, '') || 'untitled-skill';
}
function yamlEscape(value: string): string {
const singleLine = value.replace(/\r?\n/g, ' ').trim();
if (/[:#{}[\],&*?|>!%@`]/.test(singleLine) || singleLine.startsWith("'") || singleLine.startsWith('"')) {
return `"${singleLine.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
}
return singleLine;
}
export async function POST(request: NextRequest) {
const ip = request.headers.get('x-forwarded-for')?.split(',')[0]?.trim() ?? 'unknown';
const { allowed, remaining } = checkRateLimit(ip);
if (!allowed) {
return NextResponse.json(
{ error: 'Too many requests. Try again in a minute.' },
{ status: 429, headers: { 'X-RateLimit-Remaining': '0', 'Retry-After': '60' } },
);
}
let body: { url?: string; name?: string };
try {
body = await request.json();
} catch {
return NextResponse.json({ error: 'Invalid JSON body' }, { status: 400 });
}
const { url, name } = body;
if (!url || typeof url !== 'string') {
return NextResponse.json({ error: 'Missing required field: url' }, { status: 400 });
}
if (name !== undefined && typeof name !== 'string') {
return NextResponse.json({ error: 'Field "name" must be a string' }, { status: 400 });
}
if (!isAllowedUrl(url)) {
return NextResponse.json({ error: 'URL not allowed' }, { status: 403 });
}
try {
const extracted = await extractFromUrl(url);
const tags = detectTags(extracted);
const skillName = slugify(name || extracted.title || 'untitled');
const description = extracted.content
.split('\n')
.find((l) => l.trim().length > 0)
?.replace(/^#+\s*/, '')
.trim()
.slice(0, 200) || 'Saved skill';
const savedAt = new Date().toISOString();
const yamlTags = tags.length > 0
? `tags:\n${tags.map((t) => ` - ${t}`).join('\n')}\n`
: '';
const skillMd =
`---\n` +
`name: ${skillName}\n` +
`description: ${yamlEscape(description)}\n` +
yamlTags +
`metadata:\n` +
` source: ${yamlEscape(url)}\n` +
` savedAt: ${savedAt}\n` +
`---\n\n` +
extracted.content + '\n';
return NextResponse.json(
{ name: skillName, skillMd, tags, description },
{ headers: { 'X-RateLimit-Remaining': String(remaining) } },
);
} catch (err) {
const message = err instanceof Error ? err.message : 'Failed to extract content';
return NextResponse.json({ error: message }, { status: 502 });
}
}
+2 -2
View File
@@ -13,7 +13,7 @@ export const metadata: Metadata = {
default: 'SkillKit - Universal Skills for AI Coding Agents',
template: '%s | SkillKit',
},
description: 'One CLI to install, sync, and manage skills across Claude Code, Cursor, Windsurf, Copilot, and 28 more agents. 15,000+ skills ready to use.',
description: 'One CLI to install, sync, and manage skills across Claude Code, Cursor, Windsurf, Copilot, and 40 more agents. 400K+ skills ready to use.',
icons: {
icon: [
{ url: '/favicon.svg', type: 'image/svg+xml' },
@@ -24,7 +24,7 @@ export const metadata: Metadata = {
openGraph: {
title: 'SkillKit - Universal Skills for AI Coding Agents',
description: 'One CLI to install, sync, and manage skills across Claude Code, Cursor, Windsurf, Copilot, and 28 more agents.',
url: 'https://agenstskills.com',
url: 'https://skillkit.sh',
siteName: 'SkillKit',
images: [{ url: '/og-image.png', width: 1200, height: 630 }],
type: 'website',
+10 -1
View File
@@ -18,7 +18,7 @@ const COMMAND_GROUPS: CommandGroup[] = [
{
name: 'Discovery',
commands: [
{ cmd: 'find', desc: 'Search marketplace (15K+ skills)' },
{ cmd: 'find', desc: 'Search marketplace (400K+ skills)' },
{ cmd: 'recommend', desc: 'AI-powered suggestions' },
{ cmd: 'check', desc: 'Dry-run update check' },
{ cmd: 'list', desc: 'View installed skills' },
@@ -33,6 +33,15 @@ const COMMAND_GROUPS: CommandGroup[] = [
{ cmd: 'publish', desc: 'Submit to marketplace' },
],
},
{
name: 'Security',
commands: [
{ cmd: 'scan <path>', desc: 'Security vulnerability scanner' },
{ cmd: 'scan --format sarif', desc: 'SARIF for GitHub Code Scanning' },
{ cmd: 'scan --fail-on high', desc: 'CI security gate' },
{ cmd: 'audit log', desc: 'View audit trail' },
],
},
{
name: 'Advanced',
commands: [
+50 -10
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 32 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 15,000+ skills from marketplace with AI-powered recommendations</li>
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 32 agent-specific formats</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 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 32 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 32 AI coding agents with automatic format translation:
SkillKit supports 46 AI coding agents with automatic format translation:
</p>
<Table
@@ -167,6 +195,18 @@ skillkit install anthropics/skills`}</CodeBlock>
['Trae', '.trae/skills/', 'SKILL.md'],
['Vercel', '.vercel/skills/', 'SKILL.md'],
['Zencoder', '.zencoder/skills/', 'SKILL.md'],
['Devin', '.devin/skills/', 'SKILL.md'],
['Aider', '.aider/skills/', 'SKILL.md'],
['Sourcegraph Cody', '.cody/skills/', 'SKILL.md'],
['Amazon Q', '.amazonq/skills/', 'SKILL.md'],
['Augment Code', '.augment/skills/', 'SKILL.md'],
['Replit Agent', '.replit/skills/', 'SKILL.md'],
['Bolt', '.bolt/skills/', 'SKILL.md'],
['Lovable', '.lovable/skills/', 'SKILL.md'],
['Tabby', '.tabby/skills/', 'SKILL.md'],
['Tabnine', '.tabnine/skills/', 'SKILL.md'],
['CodeGPT', '.codegpt/skills/', 'SKILL.md'],
['PlayCode Agent', '.playcode/skills/', 'SKILL.md'],
['Universal', 'skills/', 'SKILL.md'],
]}
/>
+3 -3
View File
@@ -9,7 +9,7 @@ interface Feature {
const FEATURES: Feature[] = [
{
title: 'Multi-Agent',
description: 'Deploy to 32 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', '32'],
['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">32</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>
+1 -1
View File
@@ -18,7 +18,7 @@ export function Footer(): React.ReactElement {
</p>
<span className="hidden sm:inline text-zinc-700">•</span>
<a
href="https://agenstskills.com"
href="https://skillkit.sh"
target="_blank"
rel="noopener noreferrer"
className="text-zinc-600 hover:text-zinc-400 text-xs font-mono transition-colors"
+1 -1
View File
@@ -135,7 +135,7 @@ export function Hero(): React.ReactElement {
<p className="text-sm text-zinc-400 mb-5 max-w-lg font-mono leading-relaxed">
One CLI to install, sync, and manage skills across Claude Code, Cursor,
Windsurf, Copilot, and 28 more agents. 15,000+ skills ready to use.
Windsurf, Copilot, and 40 more agents. 400K+ skills ready to use.
</p>
<div className="flex flex-wrap items-center gap-3 mb-4">
+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).*)',
};
+1
View File
@@ -1,5 +1,6 @@
{
"$schema": "https://openapi.vercel.sh/vercel.json",
"ignoreCommand": "git diff --quiet HEAD^ HEAD -- .",
"buildCommand": "next build",
"installCommand": "npm install",
"outputDirectory": ".next",
+82
View File
@@ -0,0 +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:#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:#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:#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="0.5" y="0.5" width="1199" height="419" fill="none" stroke="url(#border)" stroke-width="1" rx="12"/>
<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="#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="#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="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="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, 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(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(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(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, 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>

After

Width:  |  Height:  |  Size: 4.8 KiB

+63 -51
View File
@@ -5,13 +5,12 @@ import { Agents } from './components/Agents';
import { Footer } from './components/Footer';
import { SkillGenerator } from './components/SkillGenerator';
import { SkillSubmitForm } from './components/SkillSubmitForm';
import { Commands } from './components/Commands';
import { StackBuilder } from './components/StackBuilder';
import { TrendingSkills } from './components/TrendingSkills';
import { Attribution } from './components/Attribution';
import { AdvancedFeatures } from './components/AdvancedFeatures';
import { UseCases } from './components/UseCases';
import { TeamEnterprise } from './components/TeamEnterprise';
import { CompatibilityMatrix } from './components/CompatibilityMatrix';
import { useStats } from './hooks/useStats';
const GITHUB_ICON = (
<svg className="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
@@ -34,11 +33,13 @@ function scrollToSection(e: React.MouseEvent, sectionId: string): void {
}
export default function App(): React.ReactElement {
const stats = useStats();
return (
<div className="min-h-screen text-zinc-100 font-sans selection:bg-white selection:text-black" style={{ backgroundColor: '#000000' }}>
<nav className="fixed top-0 left-0 right-0 z-50 border-b border-zinc-800 backdrop-blur-md" style={{ backgroundColor: 'rgba(0,0,0,0.9)' }}>
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="flex h-14 items-center justify-between">
<div className="flex h-14 items-center justify-between gap-2">
<a href="#" onClick={scrollToTop} className="flex items-center gap-2 cursor-pointer">
<div className="w-4 h-4 bg-white"></div>
<span className="text-base font-bold tracking-tight text-white font-mono">SKILLKIT</span>
@@ -52,11 +53,11 @@ export default function App(): React.ReactElement {
Trending
</a>
<a
href="#stack"
onClick={(e) => scrollToSection(e, 'stack')}
href="#matrix"
onClick={(e) => scrollToSection(e, 'matrix')}
className="text-zinc-500 hover:text-white transition-colors"
>
Stack
Matrix
</a>
<a
href="#advanced"
@@ -82,19 +83,29 @@ export default function App(): React.ReactElement {
</div>
<div className="flex items-center gap-3 sm:gap-4">
<a
href="https://agenstskills.com/docs"
href="/docs"
className="text-zinc-400 hover:text-white transition-colors text-xs sm:text-sm font-mono"
>
Docs
</a>
<a
href="/api"
className="text-zinc-400 hover:text-white transition-colors text-xs sm:text-sm font-mono"
>
API
</a>
<a
href="https://github.com/rohitg00/skillkit"
target="_blank"
rel="noopener noreferrer"
className="text-zinc-400 hover:text-white transition-colors p-1"
aria-label="GitHub"
className="inline-flex items-center gap-1.5 border border-zinc-700 hover:border-zinc-500 px-2 py-1 transition-colors group"
aria-label="GitHub Stars"
>
{GITHUB_ICON}
<svg className="w-3.5 h-3.5 text-zinc-500 group-hover:text-yellow-500 transition-colors" fill="currentColor" viewBox="0 0 24 24">
<path d="M12 2l3.09 6.26L22 9.27l-5 4.87 1.18 6.88L12 17.77l-6.18 3.25L7 14.14 2 9.27l6.91-1.01L12 2z" />
</svg>
<span className="text-xs font-mono text-zinc-400 group-hover:text-white transition-colors">{stats.stars || '—'}</span>
</a>
</div>
</div>
@@ -102,7 +113,7 @@ export default function App(): React.ReactElement {
</nav>
<main className="pt-14">
<Hero />
<Hero version={stats.version || '—'} stars={stats.stars || '—'} />
<div className="border-b border-zinc-800/50 py-2.5" style={{ background: 'linear-gradient(to bottom, rgba(9,9,11,0.95), rgba(0,0,0,1))' }}>
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
@@ -114,7 +125,7 @@ export default function App(): React.ReactElement {
className="flex items-center gap-1.5 text-zinc-500 hover:text-white transition-colors group"
>
<span className="text-zinc-600 group-hover:text-zinc-400">v</span>
<span className="text-white font-medium">1.8.0</span>
<span className="text-white font-medium">{stats.version || '—'}</span>
</a>
<span className="text-zinc-800">·</span>
<a
@@ -126,7 +137,7 @@ export default function App(): React.ReactElement {
<svg className="w-3 h-3 text-zinc-600 group-hover:text-zinc-400" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-4l-4 4m0 0l-4-4m4 4V4" />
</svg>
<span className="text-white font-medium">2.4k</span>
<span className="text-white font-medium">{stats.downloads || '—'}</span>
</a>
<span className="text-zinc-800">·</span>
<a
@@ -138,16 +149,7 @@ export default function App(): React.ReactElement {
<svg className="w-3 h-3 text-zinc-600 group-hover:text-yellow-500" fill="currentColor" viewBox="0 0 24 24">
<path d="M12 2l3.09 6.26L22 9.27l-5 4.87 1.18 6.88L12 17.77l-6.18 3.25L7 14.14 2 9.27l6.91-1.01L12 2z" />
</svg>
<span className="text-white font-medium">66</span>
</a>
<span className="text-zinc-800 hidden sm:inline">·</span>
<a
href="https://github.com/rohitg00/skillkit/blob/main/LICENSE"
target="_blank"
rel="noopener noreferrer"
className="text-zinc-500 hover:text-white transition-colors hidden sm:inline"
>
Apache 2.0
<span className="text-white font-medium">{stats.stars || '—'}</span>
</a>
</div>
</div>
@@ -159,34 +161,6 @@ export default function App(): React.ReactElement {
{/* Core Features & Comparison - Value prop at a glance */}
<Features />
{/* Trending Skills - Social proof, what's popular */}
<section id="trending" style={{ scrollMarginTop: '4rem' }}>
<TrendingSkills />
</section>
{/* Stack Builder - Interactive, engaging */}
<section id="stack" style={{ scrollMarginTop: '4rem' }}>
<StackBuilder />
</section>
{/* Advanced Capabilities: Memory, Primer, Mesh, Messaging */}
<section id="advanced" style={{ scrollMarginTop: '4rem' }}>
<AdvancedFeatures />
</section>
{/* Commands Reference */}
<Commands />
{/* Real-World Use Cases */}
<section id="use-cases" style={{ scrollMarginTop: '4rem' }}>
<UseCases />
</section>
{/* Team & Enterprise */}
<section id="team" style={{ scrollMarginTop: '4rem' }}>
<TeamEnterprise />
</section>
{/* Skill Generator */}
<section id="skills" className="py-12 border-b border-zinc-800" style={{ scrollMarginTop: '4rem' }}>
<SkillGenerator />
@@ -205,6 +179,44 @@ export default function App(): React.ReactElement {
</div>
</section>
{/* Trending Skills - Social proof, what's popular */}
<section id="trending" style={{ scrollMarginTop: '4rem' }}>
<TrendingSkills />
</section>
{/* Compatibility Matrix */}
<section id="matrix" style={{ scrollMarginTop: '4rem' }}>
<CompatibilityMatrix />
</section>
{/* Advanced Capabilities: Memory, Primer, Mesh, Messaging */}
<section id="advanced" style={{ scrollMarginTop: '4rem' }}>
<AdvancedFeatures />
</section>
{/* Docs CTA */}
<section className="py-8 border-b border-zinc-800">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8 text-center">
<p className="text-sm font-mono text-zinc-400">
Explore all 50+ commands, team workflows, and integrations in the{' '}
<a
href="/docs"
target="_blank"
rel="noopener noreferrer"
className="text-white underline underline-offset-4 hover:text-zinc-300 transition-colors"
>
documentation
</a>
.
</p>
</div>
</section>
{/* Real-World Use Cases */}
<section id="use-cases" style={{ scrollMarginTop: '4rem' }}>
<UseCases />
</section>
{/* Attribution & Sources */}
<section id="sources" style={{ scrollMarginTop: '4rem' }}>
<Attribution />
+40 -4
View File
@@ -11,6 +11,24 @@ interface AdvancedFeature {
}
const ADVANCED_FEATURES: AdvancedFeature[] = [
{
id: 'generate',
title: 'AI Generate',
subtitle: 'Create Skills from Natural Language',
description: 'Generate skills from plain English with multi-source context. Pulls from documentation (Context7), your codebase patterns, 400K+ marketplace skills, and your corrections. Works with any LLM: Claude, GPT-4, Gemini, Ollama, or OpenRouter.',
highlight: 'Multi-provider AI with 4 context sources',
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="M13 10V3L4 14h7v7l9-11h-7z" />
</svg>
),
commands: [
{ cmd: 'generate', desc: 'Interactive skill wizard' },
{ cmd: 'generate --provider openai', desc: 'Use specific LLM' },
{ cmd: 'generate --compose "testing"', desc: 'Compose from skills' },
{ cmd: 'generate --agents claude,cursor', desc: 'Multi-agent output' },
],
},
{
id: 'memory',
title: 'Session Memory',
@@ -29,12 +47,30 @@ const ADVANCED_FEATURES: AdvancedFeature[] = [
{ cmd: 'memory --global', desc: 'Share across all projects' },
],
},
{
id: 'session',
title: 'Session Intelligence',
subtitle: 'Skill Lineage & Agent Handoffs',
description: 'Track which skills produced which code changes. Generate handoff documents when switching agents. View unified timelines of all session events — skill executions, git commits, observations, and decisions in one stream.',
highlight: 'Timeline, handoff, and lineage in one place',
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="M12 8v4l3 3m6-3a9 9 0 11-18 0 9 9 0 0118 0z" />
</svg>
),
commands: [
{ cmd: 'timeline', desc: 'Unified event stream' },
{ cmd: 'session handoff', desc: 'Agent-to-agent context' },
{ cmd: 'lineage', desc: 'Skill impact graph' },
{ cmd: 'lineage --skill code-simplifier', desc: 'Per-skill impact' },
],
},
{
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 32 agents.',
highlight: 'Auto-generates instructions for 32 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" />
@@ -42,7 +78,7 @@ const ADVANCED_FEATURES: AdvancedFeature[] = [
),
commands: [
{ cmd: 'primer', desc: 'Analyze & generate for detected agents' },
{ cmd: 'primer --all-agents', desc: 'Generate for all 32 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' },
],
@@ -86,7 +122,7 @@ const ADVANCED_FEATURES: AdvancedFeature[] = [
];
export function AdvancedFeatures(): React.ReactElement {
const [activeFeature, setActiveFeature] = useState<string>('memory');
const [activeFeature, setActiveFeature] = useState<string>('generate');
const feature = ADVANCED_FEATURES.find(f => f.id === activeFeature) || ADVANCED_FEATURES[0];
return (
+119 -2
View File
@@ -293,6 +293,123 @@ const AGENTS: Agent[] = [
</svg>
)
},
{
name: "Devin",
url: "https://devin.ai",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M35 35h10c8.284 0 15 6.716 15 15s-6.716 15-15 15H35V35zm6 6v18h4c4.97 0 9-4.03 9-9s-4.03-9-9-9h-4z"/>
</svg>
)
},
{
name: "Aider",
url: "https://aider.chat",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M50 33l-17 34h8l3-6h12l3 6h8L50 33zm0 12l4 10h-8l4-10z"/>
</svg>
)
},
{
name: "Cody",
url: "https://sourcegraph.com/cody",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M50 33c-9.389 0-17 7.611-17 17s7.611 17 17 17 17-7.611 17-17-7.611-17-17-17zm-7 21l-3-4 3-4 3 4-3 4zm7 5l-3-4 3-4 3 4-3 4zm7-5l-3-4 3-4 3 4-3 4z"/>
</svg>
)
},
{
name: "Amazon Q",
url: "https://aws.amazon.com/q",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M50 33c-9.389 0-17 7.611-17 17s7.611 17 17 17c3.144 0 6.09-.855 8.618-2.343l4.725 4.725 4.243-4.243-4.725-4.725A16.928 16.928 0 0067 50c0-9.389-7.611-17-17-17zm0 6c6.075 0 11 4.925 11 11s-4.925 11-11 11-11-4.925-11-11 4.925-11 11-11z"/>
</svg>
)
},
{
name: "Augment",
url: "https://augmentcode.com",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M50 33c-9.389 0-17 7.611-17 17s7.611 17 17 17 17-7.611 17-17-7.611-17-17-17zm0 6v8h-8v6h8v8h6v-8h8v-6h-8v-8h-6z"/>
</svg>
)
},
{
name: "Replit",
url: "https://replit.com",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M40 33c-2.761 0-5 2.239-5 5v8h15c2.761 0 5 2.239 5 5s-2.239 5-5 5H35v8c0 2.761 2.239 5 5 5h20c2.761 0 5-2.239 5-5V38c0-2.761-2.239-5-5-5H40z"/>
</svg>
)
},
{
name: "Bolt",
url: "https://bolt.new",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M55 33H40l-5 20h10l-5 14 20-20H50l5-14z"/>
</svg>
)
},
{
name: "Lovable",
url: "https://lovable.dev",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M50 62l-12.728-12.728c-3.515-3.515-3.515-9.213 0-12.728 3.514-3.515 9.213-3.515 12.728 0 3.515-3.515 9.214-3.515 12.728 0 3.515 3.515 3.515 9.213 0 12.728L50 62z"/>
</svg>
)
},
{
name: "Tabby",
url: "https://tabby.tabbyml.com",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M35 45l5-12h6l-5 12h-6zm14 0l5-12h6l-5 12h-6zM33 48v17h34V48H33zm6 6h6v5h-6v-5zm10 0h6v5h-6v-5zm10 0h6v5h-6v-5z"/>
</svg>
)
},
{
name: "Tabnine",
url: "https://tabnine.com",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M38 35v6h9v24h6V41h9v-6H38z"/>
</svg>
)
},
{
name: "CodeGPT",
url: "https://codegpt.co",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M42 40l-9 10 9 10 4-4-6-6 6-6-4-4zm16 0l-4 4 6 6-6 6 4 4 9-10-9-10z"/>
</svg>
)
},
{
name: "PlayCode",
url: "https://playcode.io",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M38 33v34l28-17-28-17z"/>
</svg>
)
},
{
name: "Universal",
url: "https://github.com/rohitg00/skillkit",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M50 33c-9.389 0-17 7.611-17 17s7.611 17 17 17 17-7.611 17-17-7.611-17-17-17zm0 6c6.075 0 11 4.925 11 11s-4.925 11-11 11-11-4.925-11-11 4.925-11 11-11zm0 4c-3.866 0-7 3.134-7 7s3.134 7 7 7 7-3.134 7-7-3.134-7-7-7z"/>
</svg>
)
},
];
const SCROLL_ANIMATION_STYLES = `
@@ -301,7 +418,7 @@ const SCROLL_ANIMATION_STYLES = `
100% { transform: translateX(-50%); }
}
.animate-scroll {
animation: scroll 35s linear infinite;
animation: scroll 45s linear infinite;
}
`;
@@ -312,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 32 AI Agents
Works with 46 AI Agents
</p>
</div>
+18 -37
View File
@@ -1,34 +1,15 @@
import React from 'react';
import sourcesData from '../../../marketplace/sources.json';
const OFFICIAL_SOURCES = [
{ repo: 'anthropics/skills', name: 'Anthropic' },
{ repo: 'vercel-labs/agent-skills', name: 'Vercel' },
{ repo: 'expo/skills', name: 'Expo' },
{ repo: 'remotion-dev/skills', name: 'Remotion' },
{ repo: 'supabase/agent-skills', name: 'Supabase' },
{ repo: 'stripe/ai', name: 'Stripe' },
];
interface Source {
source: string;
name: string;
official?: boolean;
registry?: string;
}
const COMMUNITY_SOURCES = [
'trailofbits/skills',
'obra/superpowers',
'wshobson/agents',
'ComposioHQ/awesome-claude-skills',
'travisvn/awesome-claude-skills',
'mhattingpete/claude-skills-marketplace',
'langgenius/dify',
'better-auth/skills',
'onmax/nuxt-skills',
'elysiajs/skills',
'kadajett/agent-nestjs-skills',
'cloudai-x/threejs-skills',
'dimillian/skills',
'waynesutton/convexskills',
'kepano/obsidian-skills',
'giuseppe-trisciuoglio/developer-kit',
'openrouterteam/agent-skills',
'intellectronica/agent-skills',
];
const OFFICIAL_SOURCES = (sourcesData.sources as Source[]).filter(s => s.official);
const COMMUNITY_SOURCES = (sourcesData.sources as Source[]).filter(s => !s.official && s.source !== 'skills.sh');
export function Attribution(): React.ReactElement {
return (
@@ -37,19 +18,19 @@ export function Attribution(): React.ReactElement {
<div className="text-center mb-8">
<h2 className="text-xl font-bold text-white mb-2 font-mono">Skill Sources</h2>
<p className="text-zinc-500 font-mono text-xs">
Skills aggregated from open source repositories
{sourcesData.sources.length} sources aggregated from open source repositories and registries
</p>
</div>
<div className="mb-8">
<div className="text-xs font-mono text-zinc-500 uppercase tracking-wider mb-4">
Official
Official ({OFFICIAL_SOURCES.length})
</div>
<div className="flex flex-wrap gap-2">
{OFFICIAL_SOURCES.map(source => (
<a
key={source.repo}
href={`https://github.com/${source.repo}`}
key={source.source}
href={source.registry ? `https://${source.source}` : `https://github.com/${source.source}`}
target="_blank"
rel="noopener noreferrer"
className="inline-flex items-center gap-2 bg-zinc-900 border border-zinc-800 px-3 py-2 hover:border-zinc-600 hover:text-white transition-colors text-zinc-400 font-mono text-xs"
@@ -65,18 +46,18 @@ export function Attribution(): React.ReactElement {
<div className="mb-8">
<div className="text-xs font-mono text-zinc-500 uppercase tracking-wider mb-4">
Community
Community ({COMMUNITY_SOURCES.length})
</div>
<div className="flex flex-wrap gap-1.5">
{COMMUNITY_SOURCES.map(repo => (
{COMMUNITY_SOURCES.map(source => (
<a
key={repo}
href={`https://github.com/${repo}`}
key={source.source}
href={`https://github.com/${source.source}`}
target="_blank"
rel="noopener noreferrer"
className="text-zinc-600 hover:text-white transition-colors font-mono text-[11px] px-2 py-1 bg-zinc-900/50 border border-zinc-800/50 hover:border-zinc-700"
>
{repo}
{source.source}
</a>
))}
</div>
+201
View File
@@ -0,0 +1,201 @@
import React, { useState, useMemo } from 'react';
const SKILLKIT_LOGO_SVG_BASE64 =
'PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0id2hpdGUiPjxyZWN0IHdpZHRoPSI2IiBoZWlnaHQ9IjYiIHg9IjEiIHk9IjEiLz48cmVjdCB3aWR0aD0iNiIgaGVpZ2h0PSI2IiB4PSI5IiB5PSIxIi8+PHJlY3Qgd2lkdGg9IjYiIGhlaWdodD0iNiIgeD0iMSIgeT0iOSIvPjxyZWN0IHdpZHRoPSI2IiBoZWlnaHQ9IjYiIHg9IjkiIHk9IjkiLz48L3N2Zz4=';
const SUGGESTED_SKILLS = [
'react', 'typescript', 'nextjs', 'python', 'docker',
'kubernetes', 'tailwind', 'graphql', 'prisma', 'langchain',
'openai', 'rust', 'go', 'vue', 'svelte',
'security', 'testing', 'cicd', 'aws', 'terraform',
];
function encodeBadgeSegment(text: string): string {
return encodeURIComponent(text).replace(/-/g, '--');
}
function buildBadgeUrl(skills: string[]): string {
if (skills.length === 0) {
return `https://img.shields.io/badge/SkillKit-No%20Skills-555555?style=flat-square&logo=data:image/svg+xml;base64,${SKILLKIT_LOGO_SVG_BASE64}`;
}
const maxDisplay = 5;
const displayNames = skills.slice(0, maxDisplay);
const suffix = skills.length > maxDisplay ? ` +${skills.length - maxDisplay} more` : '';
const label = `SkillKit ${skills.length} skills`;
const message = displayNames.join(' | ') + suffix;
return `https://img.shields.io/badge/${encodeBadgeSegment(label)}-${encodeBadgeSegment(message)}-black?style=flat-square&logo=data:image/svg+xml;base64,${SKILLKIT_LOGO_SVG_BASE64}`;
}
export function BadgeGenerator(): React.ReactElement {
const [skills, setSkills] = useState<string[]>(['react', 'typescript', 'nextjs']);
const [inputValue, setInputValue] = useState('');
const [copiedType, setCopiedType] = useState<string | null>(null);
const badgeUrl = useMemo(() => buildBadgeUrl(skills), [skills]);
const markdown = `[![SkillKit Stack](${badgeUrl})](https://skillkit.sh)`;
const html = `<a href="https://skillkit.sh"><img src="${badgeUrl}" alt="SkillKit Stack" /></a>`;
function addSkill(skill: string): void {
const trimmed = skill.trim().toLowerCase();
if (trimmed && !skills.includes(trimmed)) {
setSkills([...skills, trimmed]);
}
setInputValue('');
}
function removeSkill(skill: string): void {
setSkills(skills.filter(s => s !== skill));
}
function handleKeyDown(e: React.KeyboardEvent<HTMLInputElement>): void {
if (e.key === 'Enter' && inputValue.trim()) {
e.preventDefault();
addSkill(inputValue);
}
}
async function copyToClipboard(text: string, type: string): Promise<void> {
try {
await navigator.clipboard.writeText(text);
setCopiedType(type);
setTimeout(() => setCopiedType(null), 2000);
} catch {
// silently ignore
}
}
const availableSuggestions = SUGGESTED_SKILLS.filter(s => !skills.includes(s));
return (
<section className="py-12 border-b border-zinc-800">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="mb-6">
<h2 className="text-xl font-bold text-white mb-1 font-mono">Badge Generator</h2>
<p className="text-zinc-500 font-mono text-xs">
Create a shareable badge for your skill stack. Add it to your README.
</p>
</div>
<div className="flex flex-col lg:flex-row gap-6">
<div className="flex-1 space-y-4">
<div className="relative">
<input
type="text"
value={inputValue}
onChange={(e) => setInputValue(e.target.value)}
onKeyDown={handleKeyDown}
placeholder="Type a skill name and press Enter..."
className="w-full bg-zinc-900 border border-zinc-700 text-white px-4 py-3 focus:ring-2 focus:ring-white focus:border-transparent outline-none font-mono text-sm placeholder-zinc-600"
/>
</div>
<div className="space-y-2">
<span className="text-zinc-500 text-xs font-mono block">Quick add:</span>
<div className="flex flex-wrap gap-1.5">
{availableSuggestions.slice(0, 12).map(skill => (
<button
key={skill}
onClick={() => addSkill(skill)}
className="text-[10px] sm:text-xs bg-zinc-900 text-zinc-400 px-2 sm:px-3 py-1 sm:py-1.5 border border-zinc-700 hover:border-zinc-500 hover:text-white transition-colors font-mono"
>
+ {skill}
</button>
))}
</div>
</div>
{skills.length > 0 && (
<div className="space-y-2">
<div className="flex items-center justify-between">
<div className="text-xs font-mono text-zinc-500 uppercase tracking-wider">
Skills in Badge ({skills.length})
</div>
<button
onClick={() => setSkills([])}
className="text-zinc-500 hover:text-red-400 font-mono text-xs transition-colors"
>
Clear All
</button>
</div>
<div className="flex flex-wrap gap-2">
{skills.map(skill => (
<div
key={skill}
className="flex items-center gap-1.5 bg-zinc-900/50 border border-zinc-800 px-3 py-1.5 group"
>
<span className="font-mono text-sm text-white">{skill}</span>
<button
onClick={() => removeSkill(skill)}
aria-label={`Remove ${skill}`}
className="text-zinc-600 hover:text-red-400 transition-colors opacity-0 group-hover:opacity-100 focus-visible:opacity-100"
>
<svg className="w-3 h-3" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M6 18L18 6M6 6l12 12" />
</svg>
</button>
</div>
))}
</div>
</div>
)}
</div>
<div className="lg:w-80 lg:flex-shrink-0">
<div className="lg:sticky lg:top-20 bg-zinc-900/30 border border-zinc-800 p-4 space-y-4">
<div className="text-xs font-mono text-zinc-500 uppercase tracking-wider">Preview</div>
<div className="flex justify-center py-3 bg-black/50 border border-zinc-800">
{skills.length > 0 ? (
<img
src={badgeUrl}
alt="SkillKit Stack Badge"
className="h-5"
/>
) : (
<span className="text-zinc-600 text-xs font-mono">Add skills to preview</span>
)}
</div>
<div className="space-y-2">
<div className="text-xs font-mono text-zinc-500">Markdown</div>
<pre className="bg-black/50 p-2 overflow-x-auto text-[10px] border border-zinc-800">
<code className="font-mono text-zinc-300 whitespace-pre-wrap break-all">
{markdown}
</code>
</pre>
<button
onClick={() => copyToClipboard(markdown, 'markdown')}
className="w-full bg-zinc-800 text-zinc-300 py-1.5 font-mono text-xs hover:bg-zinc-700 hover:text-white transition-colors flex items-center justify-center gap-1.5 border border-zinc-700"
>
{copiedType === 'markdown' ? 'Copied!' : 'Copy Markdown'}
</button>
</div>
<div className="space-y-2">
<div className="text-xs font-mono text-zinc-500">HTML</div>
<pre className="bg-black/50 p-2 overflow-x-auto text-[10px] border border-zinc-800">
<code className="font-mono text-zinc-300 whitespace-pre-wrap break-all">
{html}
</code>
</pre>
<button
onClick={() => copyToClipboard(html, 'html')}
className="w-full bg-zinc-800 text-zinc-300 py-1.5 font-mono text-xs hover:bg-zinc-700 hover:text-white transition-colors flex items-center justify-center gap-1.5 border border-zinc-700"
>
{copiedType === 'html' ? 'Copied!' : 'Copy HTML'}
</button>
</div>
<div className="text-[10px] font-mono text-zinc-600 text-center pt-2 border-t border-zinc-800">
Powered by shields.io
</div>
</div>
</div>
</div>
</div>
</section>
);
}
+58 -5
View File
@@ -13,7 +13,7 @@ const COMMAND_GROUPS: CommandGroup[] = [
{ cmd: 'install <repo>', desc: 'Install from GitHub' },
{ cmd: 'add <repo>', desc: 'Alias for install' },
{ cmd: 'recommend', desc: 'Smart suggestions' },
{ cmd: 'find <query>', desc: 'Search 15K+ skills' },
{ cmd: 'tree', desc: 'Browse skill taxonomy' },
{ cmd: 'marketplace', desc: 'Browse skills' },
],
},
@@ -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,11 +77,54 @@ 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' },
],
},
{
name: 'Server',
commands: [
{ cmd: 'serve', desc: 'Start REST API' },
{ cmd: 'serve --port 8080', desc: 'Custom port' },
{ cmd: 'serve --host localhost', desc: 'Bind host' },
{ cmd: 'serve --cors "*"', desc: 'Set CORS origin' },
{ cmd: 'serve --cache-ttl 3600000', desc: 'Cache TTL' },
],
},
{
name: 'Security',
commands: [
{ cmd: 'scan <path>', desc: 'Security scan' },
{ cmd: 'scan --format sarif', desc: 'SARIF output' },
{ cmd: 'scan --fail-on high', desc: 'CI gate' },
{ cmd: 'install --no-scan', desc: 'Skip scan' },
{ cmd: 'audit log', desc: 'View audit logs' },
{ cmd: 'validate', desc: 'Validate format' },
],
},
{
name: 'Issues',
commands: [
{ cmd: 'issue plan "#42"', desc: 'Plan from issue' },
{ cmd: 'issue plan owner/repo#42', desc: 'Cross-repo plan' },
{ cmd: 'issue plan "#42" --agent cursor', desc: 'Target agent' },
{ cmd: 'issue plan "#42" --json', desc: 'JSON output' },
{ cmd: 'issue list', desc: 'List open issues' },
{ cmd: 'issue list --label bug', desc: 'Filter by label' },
],
},
{
name: 'Session',
commands: [
{ cmd: 'timeline', desc: 'Unified event stream' },
{ cmd: 'session handoff', desc: 'Agent handoff doc' },
{ cmd: 'lineage', desc: 'Skill impact graph' },
{ cmd: 'session explain', desc: 'Session summary' },
{ cmd: 'activity', desc: 'Skill activity log' },
{ cmd: 'session snapshot save', desc: 'Save state' },
],
},
{
name: 'Advanced',
commands: [
@@ -93,7 +146,7 @@ export function Commands(): React.ReactElement {
<section className="py-12 border-b border-zinc-800">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="text-center mb-8">
<h2 className="text-xl font-bold text-white mb-2 font-mono">40+ Commands</h2>
<h2 className="text-xl font-bold text-white mb-2 font-mono">50+ Commands</h2>
<p className="text-zinc-500 font-mono text-sm">
Everything you need from the terminal.
</p>
@@ -0,0 +1,395 @@
import React, { useState, useMemo } from 'react';
type Support = 'full' | 'partial' | 'none';
interface AgentDef {
id: string;
name: string;
icon: string;
group: string;
}
interface CategoryDef {
id: string;
name: string;
icon: string;
}
const AGENTS: AgentDef[] = [
{ id: 'claude-code', name: 'Claude', icon: '\u27C1', group: 'Tier 1' },
{ id: 'cursor', name: 'Cursor', icon: '\u25EB', group: 'Tier 1' },
{ id: 'codex', name: 'Codex', icon: '\u25CE', group: 'Tier 1' },
{ id: 'gemini-cli', name: 'Gemini', icon: '\u2726', group: 'Tier 1' },
{ id: 'opencode', name: 'OpenCode', icon: '\u2B21', group: 'Tier 1' },
{ id: 'windsurf', name: 'Windsurf', icon: '\u25C7', group: 'Tier 1' },
{ id: 'github-copilot', name: 'Copilot', icon: '\u2318', group: 'Tier 1' },
{ id: 'cline', name: 'Cline', icon: '\u25CF', group: 'Tier 1' },
{ id: 'devin', name: 'Devin', icon: '\u25C9', group: 'Tier 1' },
{ id: 'roo', name: 'Roo', icon: '\u25C6', group: 'Tier 2' },
{ id: 'kilo', name: 'Kilo', icon: '\u25B3', group: 'Tier 2' },
{ id: 'kiro-cli', name: 'Kiro CLI', icon: '\u25BD', group: 'Tier 2' },
{ id: 'goose', name: 'Goose', icon: '\u25CA', group: 'Tier 2' },
{ id: 'trae', name: 'Trae', icon: '\u25A0', group: 'Tier 2' },
{ id: 'amp', name: 'AMP', icon: '\u26A1', group: 'Tier 2' },
{ id: 'aider', name: 'Aider', icon: '\u25E6', group: 'Tier 2' },
{ id: 'cody', name: 'Cody', icon: '\u25D0', group: 'Tier 2' },
{ id: 'amazon-q', name: 'Amazon Q', icon: '\u25A3', group: 'Tier 2' },
{ id: 'antigravity', name: 'Antigrav', icon: '\u2191', group: 'Tier 3' },
{ id: 'continue', name: 'Continue', icon: '\u25B6', group: 'Tier 3' },
{ id: 'augment', name: 'Augment', icon: '\u25C8', group: 'Tier 3' },
{ id: 'replit', name: 'Replit', icon: '\u25B7', group: 'Tier 3' },
{ id: 'bolt', name: 'Bolt', icon: '\u2605', group: 'Tier 3' },
{ id: 'lovable', name: 'Lovable', icon: '\u2665', group: 'Tier 3' },
{ id: 'tabby', name: 'Tabby', icon: '\u25AB', group: 'Tier 3' },
{ id: 'tabnine', name: 'Tabnine', icon: '\u25AA', group: 'Tier 3' },
{ id: 'codegpt', name: 'CodeGPT', icon: '\u25E7', group: 'Tier 3' },
{ id: 'playcode', name: 'PlayCode', icon: '\u25B9', group: 'Tier 3' },
{ id: 'clawdbot', name: 'Clawdbot', icon: '\u25D1', group: 'Tier 3' },
{ id: 'droid', name: 'Droid', icon: '\u25D2', group: 'Tier 3' },
{ id: 'codebuddy', name: 'CodeBuddy', icon: '\u25D3', group: 'Tier 3' },
{ id: 'commandcode', name: 'CmdCode', icon: '\u25D4', group: 'Tier 3' },
{ id: 'crush', name: 'Crush', icon: '\u25D5', group: 'Tier 3' },
{ id: 'factory', name: 'Factory', icon: '\u25D6', group: 'Tier 3' },
{ id: 'mcpjam', name: 'MCPJam', icon: '\u25D7', group: 'Tier 3' },
{ id: 'mux', name: 'Mux', icon: '\u25E0', group: 'Tier 3' },
{ id: 'neovate', name: 'Neovate', icon: '\u25E1', group: 'Tier 3' },
{ id: 'openhands', name: 'OpenHands', icon: '\u25E2', group: 'Tier 3' },
{ id: 'pi', name: 'Pi', icon: '\u25E3', group: 'Tier 3' },
{ id: 'qoder', name: 'Qoder', icon: '\u25E4', group: 'Tier 3' },
{ id: 'qwen', name: 'Qwen', icon: '\u25E5', group: 'Tier 3' },
{ id: 'vercel', name: 'Vercel', icon: '\u25B2', group: 'Tier 3' },
{ id: 'zencoder', name: 'Zencoder', icon: '\u25E8', group: 'Tier 3' },
{ id: 'universal', name: 'Universal', icon: '\u25CB', group: 'Tier 3' },
];
const CATEGORIES: CategoryDef[] = [
{ id: 'translation', name: 'Skill Translation', icon: '\u21C4' },
{ id: 'hooks', name: 'Hooks', icon: '\u2693' },
{ id: 'mcp-tools', name: 'MCP & Tools', icon: '\u2699' },
{ id: 'context', name: 'Context Window', icon: '\u25A3' },
{ id: 'security', name: 'Security Skills', icon: '\u25D0' },
{ id: 'testing', name: 'Testing Skills', icon: '\u25D2' },
{ id: 'frontend', name: 'Frontend Skills', icon: '\u269B' },
{ id: 'backend', name: 'Backend Skills', icon: '\u2393' },
{ id: 'devops', name: 'DevOps Skills', icon: '\u25D1' },
{ id: 'docs', name: 'Documentation', icon: '\u25A1' },
];
// Based on actual SkillKit translator, agent constraints, and compatibility scoring:
// - claude-code, cline, roo: MCP + Tools + Hooks + large context (full support)
// - cursor: 32K context, no MCP/tools, hooks need manual adjustment
// - gemini-cli: 128K context, no MCP/tools, JSON-in-markdown format
// - opencode: 100K context, no MCP/tools, XML skills format
// - codex, github-copilot: 8K context, no MCP/tools (content condensed)
// - windsurf: 32K context, no MCP/tools, workflow YAML format
// - kilo, kiro-cli: XML block format, multi-mode support, no MCP
// - goose, amp, antigravity, trae, continue: varies, mostly universal adapter
const T3_FULL: Record<string, Support> = {
'augment': 'full', 'replit': 'full', 'bolt': 'full', 'lovable': 'full',
'tabby': 'full', 'tabnine': 'full', 'codegpt': 'full', 'playcode': 'full',
'clawdbot': 'full', 'droid': 'full', 'codebuddy': 'full', 'commandcode': 'full',
'crush': 'full', 'factory': 'full', 'mcpjam': 'full', 'mux': 'full',
'neovate': 'full', 'openhands': 'full', 'pi': 'full', 'qoder': 'full',
'qwen': 'full', 'vercel': 'full', 'zencoder': 'full', 'universal': 'full',
};
const T3_PARTIAL: Record<string, Support> = Object.fromEntries(Object.keys(T3_FULL).map(k => [k, 'partial']));
const T3_NONE: Record<string, Support> = Object.fromEntries(Object.keys(T3_FULL).map(k => [k, 'none']));
const MATRIX: Record<string, Record<string, Support>> = {
'translation': {
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'full', 'cline': 'full',
'devin': 'full', 'roo': 'full', 'kilo': 'full', 'kiro-cli': 'partial', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'aider': 'full', 'cody': 'full', 'amazon-q': 'full',
'antigravity': 'full', 'continue': 'full', ...T3_FULL,
},
'hooks': {
'claude-code': 'full', 'cursor': 'partial', 'codex': 'partial', 'gemini-cli': 'partial',
'opencode': 'partial', 'windsurf': 'none', 'github-copilot': 'none', 'cline': 'full',
'devin': 'partial', 'roo': 'full', 'kilo': 'partial', 'kiro-cli': 'partial', 'goose': 'partial',
'trae': 'partial', 'amp': 'partial', 'aider': 'none', 'cody': 'none', 'amazon-q': 'none',
'antigravity': 'none', 'continue': 'none', ...T3_NONE,
},
'mcp-tools': {
'claude-code': 'full', 'cursor': 'none', 'codex': 'none', 'gemini-cli': 'none',
'opencode': 'none', 'windsurf': 'none', 'github-copilot': 'none', 'cline': 'full',
'devin': 'partial', 'roo': 'full', 'kilo': 'none', 'kiro-cli': 'none', 'goose': 'none',
'trae': 'none', 'amp': 'none', 'aider': 'none', 'cody': 'none', 'amazon-q': 'none',
'antigravity': 'none', 'continue': 'none', ...T3_NONE,
},
'context': {
'claude-code': 'full', 'cursor': 'partial', 'codex': 'partial', 'gemini-cli': 'full',
'opencode': 'full', 'windsurf': 'partial', 'github-copilot': 'partial', 'cline': 'full',
'devin': 'full', 'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'partial', 'amp': 'full', 'aider': 'full', 'cody': 'full', 'amazon-q': 'partial',
'antigravity': 'partial', 'continue': 'partial', ...T3_PARTIAL,
},
'security': {
'claude-code': 'full', 'cursor': 'full', 'codex': 'partial', 'gemini-cli': 'full',
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'partial', 'cline': 'full',
'devin': 'full', 'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'aider': 'full', 'cody': 'full', 'amazon-q': 'full',
'antigravity': 'partial', 'continue': 'partial', ...T3_PARTIAL,
},
'testing': {
'claude-code': 'full', 'cursor': 'full', 'codex': 'partial', 'gemini-cli': 'full',
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'partial', 'cline': 'full',
'devin': 'full', 'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'aider': 'full', 'cody': 'full', 'amazon-q': 'partial',
'antigravity': 'partial', 'continue': 'partial', ...T3_PARTIAL,
},
'frontend': {
'claude-code': 'full', 'cursor': 'full', 'codex': 'partial', 'gemini-cli': 'full',
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'partial', 'cline': 'full',
'devin': 'full', 'roo': 'full', 'kilo': 'partial', 'kiro-cli': 'partial', 'goose': 'partial',
'trae': 'full', 'amp': 'full', 'aider': 'partial', 'cody': 'partial', 'amazon-q': 'partial',
'antigravity': 'partial', 'continue': 'partial', ...T3_PARTIAL,
},
'backend': {
'claude-code': 'full', 'cursor': 'full', 'codex': 'partial', 'gemini-cli': 'full',
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'partial', 'cline': 'full',
'devin': 'full', 'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'aider': 'full', 'cody': 'full', 'amazon-q': 'partial',
'antigravity': 'partial', 'continue': 'partial', ...T3_PARTIAL,
},
'devops': {
'claude-code': 'full', 'cursor': 'full', 'codex': 'partial', 'gemini-cli': 'full',
'opencode': 'full', 'windsurf': 'partial', 'github-copilot': 'partial', 'cline': 'full',
'devin': 'full', 'roo': 'full', 'kilo': 'partial', 'kiro-cli': 'partial', 'goose': 'partial',
'trae': 'partial', 'amp': 'partial', 'aider': 'partial', 'cody': 'partial', 'amazon-q': 'partial',
'antigravity': 'partial', 'continue': 'partial', ...T3_PARTIAL,
},
'docs': {
'claude-code': 'full', 'cursor': 'full', 'codex': 'partial', 'gemini-cli': 'full',
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'full', 'cline': 'full',
'devin': 'full', 'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'aider': 'full', 'cody': 'full', 'amazon-q': 'full',
'antigravity': 'full', 'continue': 'full', ...T3_FULL,
},
};
const SUPPORT_CONFIG: Record<Support, { color: string; bg: string; label: string }> = {
full: { color: 'text-green-400', bg: 'bg-green-400/10', label: 'Full' },
partial: { color: 'text-yellow-400', bg: 'bg-yellow-400/10', label: 'Partial' },
none: { color: 'text-red-400', bg: 'bg-red-400/10', label: 'None' },
};
const SUPPORT_SCORE: Record<Support, number> = { full: 2, partial: 1, none: 0 };
function SupportCell({ support }: { support: Support }): React.ReactElement {
const config = SUPPORT_CONFIG[support];
return (
<td className="px-1 py-2 text-center">
<div className={`inline-flex items-center justify-center w-5 h-5 rounded-full ${config.bg}`}>
<span className={`text-[10px] font-bold ${config.color}`}>
{support === 'full' ? '\u2713' : support === 'partial' ? '\u25CB' : '\u2715'}
</span>
</div>
</td>
);
}
function getAgentScore(agentId: string): number {
return Object.values(MATRIX).reduce((sum, row) => sum + SUPPORT_SCORE[row[agentId] || 'none'], 0);
}
function getMaxScore(): number {
return CATEGORIES.length * 2;
}
export function CompatibilityMatrix(): React.ReactElement {
const [filter, setFilter] = useState('');
const [groupFilter, setGroupFilter] = useState<string | null>(null);
const groups = useMemo(() => {
const seen = new Set<string>();
return AGENTS.reduce<string[]>((acc, a) => {
if (!seen.has(a.group)) {
seen.add(a.group);
acc.push(a.group);
}
return acc;
}, []);
}, []);
const { filteredAgents, filteredCategories } = useMemo(() => {
let agents = AGENTS;
if (groupFilter) {
agents = agents.filter(a => a.group === groupFilter);
}
if (!filter.trim()) {
return { filteredAgents: agents, filteredCategories: CATEGORIES };
}
const q = filter.toLowerCase();
const matchedAgents = agents.filter(a =>
a.name.toLowerCase().includes(q) || a.id.toLowerCase().includes(q)
);
const matchedCategories = CATEGORIES.filter(c =>
c.name.toLowerCase().includes(q) || c.id.toLowerCase().includes(q)
);
return {
filteredAgents: matchedAgents.length > 0 ? matchedAgents : (matchedCategories.length > 0 ? agents : []),
filteredCategories: matchedCategories.length > 0 ? matchedCategories : (matchedAgents.length > 0 ? CATEGORIES : []),
};
}, [filter, groupFilter]);
const maxScore = getMaxScore();
return (
<section className="py-12 border-b border-zinc-800" style={{ backgroundColor: '#09090b' }}>
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="flex flex-col sm:flex-row sm:items-center justify-between gap-2 mb-6">
<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 46 agents and {CATEGORIES.length} categories.
</p>
</div>
<div className="flex items-center gap-2">
<span className="w-2 h-2 bg-green-500 rounded-full"></span>
<span className="text-[10px] sm:text-xs font-mono text-zinc-500">Updated Feb 2026</span>
</div>
</div>
<div className="flex flex-col sm:flex-row gap-2 sm:gap-3 mb-6">
<div className="relative flex-1">
<svg className="absolute left-2.5 top-1/2 -translate-y-1/2 w-3.5 h-3.5 text-zinc-600" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z" />
</svg>
<input
type="text"
value={filter}
onChange={(e) => setFilter(e.target.value)}
placeholder="Filter agents or categories..."
className="w-full bg-black border border-zinc-800 text-zinc-300 placeholder-zinc-700 font-mono text-xs px-8 py-2 focus:outline-none focus:border-zinc-600 transition-colors"
/>
{filter && (
<button
onClick={() => setFilter('')}
className="absolute right-2.5 top-1/2 -translate-y-1/2 text-zinc-600 hover:text-zinc-400 transition-colors"
>
<svg className="w-3.5 h-3.5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M6 18L18 6M6 6l12 12" />
</svg>
</button>
)}
</div>
<div className="flex gap-1.5">
<button
onClick={() => setGroupFilter(null)}
className={`px-2.5 py-1.5 font-mono text-[10px] sm:text-xs transition-all ${
groupFilter === null
? 'bg-white text-black'
: 'bg-zinc-900 text-zinc-400 border border-zinc-800 hover:border-zinc-600 hover:text-white'
}`}
>
All
</button>
{groups.map(g => (
<button
key={g}
onClick={() => setGroupFilter(groupFilter === g ? null : g)}
className={`px-2.5 py-1.5 font-mono text-[10px] sm:text-xs transition-all ${
groupFilter === g
? 'bg-white text-black'
: 'bg-zinc-900 text-zinc-400 border border-zinc-800 hover:border-zinc-600 hover:text-white'
}`}
>
{g}
</button>
))}
</div>
</div>
<div className="flex items-center gap-4 mb-4">
{Object.entries(SUPPORT_CONFIG).map(([key, config]) => (
<div key={key} className="flex items-center gap-1.5">
<div className={`w-3 h-3 rounded-full ${config.bg} flex items-center justify-center`}>
<span className={`text-[8px] font-bold ${config.color}`}>
{key === 'full' ? '\u2713' : key === 'partial' ? '\u25CB' : '\u2715'}
</span>
</div>
<span className="text-[10px] font-mono text-zinc-500">{config.label}</span>
</div>
))}
</div>
<div className="overflow-x-auto -mx-4 px-4 sm:mx-0 sm:px-0">
<div className="min-w-[700px]">
<table className="w-full border-collapse font-mono text-[10px]">
<thead>
<tr className="border-b border-zinc-800">
<th className="text-left text-zinc-500 uppercase tracking-wider py-2 pr-3 sticky left-0 bg-[#09090b] z-10 min-w-[120px]">
Category
</th>
{filteredAgents.map(agent => (
<th key={agent.id} className="px-1 py-2 text-center">
<div className="flex flex-col items-center gap-0.5">
<span className="text-sm">{agent.icon}</span>
<span className="text-zinc-400 whitespace-nowrap max-w-[50px] truncate" title={agent.name}>
{agent.name.length > 7 ? agent.name.slice(0, 7) : agent.name}
</span>
</div>
</th>
))}
</tr>
</thead>
<tbody>
{filteredCategories.map(category => (
<tr key={category.id} className="border-b border-zinc-800/50 hover:bg-zinc-900/50 transition-colors">
<td className="py-2 pr-3 sticky left-0 bg-[#09090b] z-10">
<div className="flex items-center gap-1.5">
<span className="text-zinc-600">{category.icon}</span>
<span className="text-zinc-300 whitespace-nowrap">{category.name}</span>
</div>
</td>
{filteredAgents.map(agent => (
<SupportCell
key={agent.id}
support={MATRIX[category.id]?.[agent.id] || 'none'}
/>
))}
</tr>
))}
</tbody>
<tfoot>
<tr className="border-t border-zinc-700">
<td className="py-3 pr-3 sticky left-0 bg-[#09090b] z-10">
<span className="text-zinc-400 font-bold uppercase tracking-wider">Score</span>
</td>
{filteredAgents.map(agent => {
const score = getAgentScore(agent.id);
const pct = Math.round((score / maxScore) * 100);
const color = pct >= 80 ? 'text-green-400' : pct >= 50 ? 'text-yellow-400' : 'text-red-400';
return (
<td key={agent.id} className="px-1 py-3 text-center">
<div className={`font-bold text-xs ${color}`}>{pct}%</div>
<div className="text-zinc-600 text-[9px]">{score}/{maxScore}</div>
</td>
);
})}
</tr>
</tfoot>
</table>
</div>
</div>
{filteredAgents.length === 0 && (
<div className="text-center py-8 text-zinc-600 font-mono text-sm">
No agents match your filter.
</div>
)}
{filteredCategories.length === 0 && filteredAgents.length > 0 && (
<div className="text-center py-8 text-zinc-600 font-mono text-sm">
No categories match your filter.
</div>
)}
</div>
</section>
);
}
+47 -12
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 32 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 32 agents</li>
<li><span className="text-white">Skill Discovery</span> - Browse 15,000+ skills from marketplace with AI-powered recommendations</li>
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 32 agent-specific formats</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 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 32 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 32 AI coding agents with automatic format translation:
SkillKit supports 46 AI coding agents with automatic format translation:
</p>
<Table
@@ -206,13 +234,20 @@ 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 32 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
skillkit primer --json # Output analysis as JSON
skillkit primer --output ./dir # Custom output directory`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Session Intelligence</h3>
<CodeBlock>{`skillkit timeline # Unified event stream
skillkit session handoff # Agent-to-agent context
skillkit lineage # Skill impact graph
skillkit session explain # Session summary
skillkit activity # Skill activity log`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Advanced</h3>
<CodeBlock>{`skillkit ui # Launch Terminal UI
skillkit workflow # Manage workflows
+47 -27
View File
@@ -9,7 +9,7 @@ interface Feature {
const FEATURES: Feature[] = [
{
title: 'Smart Recommendations',
description: 'AI analyzes your codebase and suggests perfect skills.',
description: 'AI analyzes your codebase and recommends from 400K+ skills.',
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.663 17h4.673M12 3v1m6.364 1.636l-.707.707M21 12h-1M4 12H3m3.343-5.657l-.707-.707m2.828 9.9a5 5 0 117.072 0l-.548.547A3.374 3.374 0 0014 18.469V19a2 2 0 11-4 0v-.531c0-.895-.356-1.754-.988-2.386l-.548-.547z" />
@@ -18,7 +18,7 @@ const FEATURES: Feature[] = [
},
{
title: 'Auto Translation',
description: 'Write once, deploy to 32 agents. Zero manual conversion.',
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,13 +36,22 @@ const FEATURES: Feature[] = [
},
{
title: 'Primer',
description: 'Auto-generate agent instructions for all 32 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" />
</svg>
)
},
{
title: 'Skill Tree',
description: 'Browse 400K+ skills in a hierarchical taxonomy with 12 categories.',
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="M3 7v10a2 2 0 002 2h14a2 2 0 002-2V9a2 2 0 00-2-2h-6l-2-2H5a2 2 0 00-2 2z" />
</svg>
)
},
{
title: 'Workflows',
description: 'Compose multi-step automated skill sequences.',
@@ -61,6 +70,15 @@ const FEATURES: Feature[] = [
</svg>
)
},
{
title: 'Security Scanner',
description: 'Detect prompt injection, secrets, and malicious patterns in skills.',
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 12.75L11.25 15 15 9.75m-3-7.036A11.959 11.959 0 013.598 6 11.99 11.99 0 003 9.749c0 5.592 3.824 10.29 9 11.623 5.176-1.332 9-6.03 9-11.622 0-1.31-.21-2.571-.598-3.751h-.152c-3.196 0-6.1-1.248-8.25-3.285z" />
</svg>
)
},
{
title: 'Testing',
description: 'Built-in test framework with assertions.',
@@ -80,46 +98,48 @@ const FEATURES: Feature[] = [
)
},
{
title: 'TS API',
description: 'Programmatic access for custom tooling.',
title: 'REST & MCP APIs',
description: 'REST server, MCP server, and Python client for runtime discovery.',
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="M10 20l4-16m4 4l4 4-4 4M6 16l-4-4 4-4" />
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M5 12h14M5 12a2 2 0 01-2-2V6a2 2 0 012-2h14a2 2 0 012 2v4a2 2 0 01-2 2M5 12a2 2 0 00-2 2v4a2 2 0 002 2h14a2 2 0 002-2v-4a2 2 0 00-2-2m-2-4h.01M17 16h.01" />
</svg>
)
}
];
const COMPARISONS = [
['Agent Support', '1 agent', '32 agents'],
['Setup', 'Write rules manually', 'Auto-generate (Primer)'],
['Learning', 'Lost each session', 'Persistent memory'],
['Translation', 'Rewrite for each', 'One-click conversion'],
['Team Sharing', 'Copy/paste files', '.skills manifest'],
['Discovery', 'Search forums', 'AI recommendations'],
['Agent Support', '1-17 agents', '46 agents'],
['Sources', 'Single registry', '34+ aggregated'],
['Translation', 'None or limited', 'All 45 formats'],
['Memory', 'None', 'Persistent learning'],
['Security', 'None', '46-rule scanner'],
['Team Sync', 'None', '.skills manifest'],
['Telemetry', 'Varies', 'Zero. Ever.'],
['API Access', 'None', 'REST + MCP + Python'],
] as const;
export function Features(): React.ReactElement {
return (
<section id="features" className="py-12 border-b border-zinc-800 bg-surface">
<section id="features" className="py-8 border-b border-zinc-800 bg-surface">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="grid grid-cols-1 lg:grid-cols-5 gap-6 lg:gap-8 mb-10">
<div className="grid grid-cols-1 lg:grid-cols-5 gap-6 lg:gap-8 mb-6">
<div className="lg:col-span-2">
<h2 className="text-xl font-bold text-white mb-2 font-mono">Why SkillKit?</h2>
<h2 className="text-xl font-bold text-white mb-2 font-mono">At a Glance</h2>
<p className="text-zinc-500 font-mono text-sm mb-6">
Universal bridge for AI coding agents.
What you get vs. a simple installer.
</p>
<div className="flex gap-6 sm:gap-8">
<div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">32</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>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">50+</div>
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Commands</div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">34+</div>
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Sources</div>
</div>
<div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">15K+</div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">400K+</div>
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Skills</div>
</div>
</div>
@@ -127,8 +147,8 @@ export function Features(): React.ReactElement {
<div className="lg:col-span-3 border border-zinc-800 bg-black/50 p-4 font-mono text-xs backdrop-blur-sm">
<div className="grid grid-cols-3 gap-2 border-b border-zinc-800 pb-2 mb-3 text-zinc-500 uppercase tracking-wider text-[10px]">
<div>Feature</div>
<div className="text-center">Without</div>
<div>Capability</div>
<div className="text-center">Simple Installers</div>
<div className="text-right">SkillKit</div>
</div>
<div className="space-y-1">
@@ -147,20 +167,20 @@ export function Features(): React.ReactElement {
</div>
</div>
<div className="grid grid-cols-2 sm:grid-cols-3 gap-3">
<div className="grid grid-cols-3 sm:grid-cols-4 gap-2">
{FEATURES.map((feature, index) => (
<div
key={feature.title}
className="group relative p-4 border border-zinc-800 bg-zinc-900/30 hover:bg-zinc-900/80 hover:border-zinc-700 transition-all duration-300 cursor-default"
className="group relative p-2.5 border border-zinc-800 bg-zinc-900/30 hover:bg-zinc-900/80 hover:border-zinc-700 transition-all duration-300 cursor-default"
style={{ animationDelay: `${index * 50}ms` }}
>
<div className="absolute inset-0 bg-gradient-to-b from-zinc-800/0 to-zinc-800/20 opacity-0 group-hover:opacity-100 transition-opacity"></div>
<div className="relative">
<div className="text-zinc-500 group-hover:text-white transition-colors mb-2">
<div className="text-zinc-500 group-hover:text-white transition-colors mb-1">
{feature.icon}
</div>
<h4 className="text-xs font-bold text-white mb-1 font-mono">{feature.title}</h4>
<p className="text-zinc-600 text-[10px] leading-relaxed font-mono group-hover:text-zinc-400 transition-colors">
<h4 className="text-[11px] font-bold text-white mb-0.5 font-mono">{feature.title}</h4>
<p className="text-zinc-600 text-[10px] leading-snug font-mono group-hover:text-zinc-400 transition-colors">
{feature.description}
</p>
</div>
+1 -1
View File
@@ -18,7 +18,7 @@ export function Footer(): React.ReactElement {
</p>
<span className="hidden sm:inline text-zinc-700">•</span>
<a
href="https://agenstskills.com"
href="https://skillkit.sh"
target="_blank"
rel="noopener noreferrer"
className="text-zinc-600 hover:text-zinc-400 text-xs font-mono transition-colors"
+71 -28
View File
@@ -1,5 +1,9 @@
import React, { useState, useEffect } from 'react';
import { Button } from './Button';
interface HeroProps {
version: string;
stars?: number;
}
const ASCII_LOGO = `
███████╗██╗ ██╗██╗██╗ ██╗ ██╗ ██╗██╗████████╗
@@ -16,17 +20,18 @@ interface TerminalLine {
}
const TERMINAL_LINES: TerminalLine[] = [
{ type: 'cmd', text: 'skillkit primer --all-agents' },
{ type: 'out', text: '→ Analyzing codebase...' },
{ type: 'out', text: ' ✓ Generated CLAUDE.md' },
{ type: 'out', text: ' ✓ Generated .cursorrules' },
{ type: 'cmd', text: 'skillkit install anthropics/skills' },
{ type: 'out', text: '→ Fetched from github.com/anthropics/skills' },
{ 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' },
{ type: 'cmd', text: 'skillkit translate --all --to cursor' },
{ type: 'out', text: '→ 26 skills → .cursor/skills/' },
{ type: 'cmd', text: 'skillkit recommend' },
{ type: 'out', text: ' 92% vercel-react-best-practices' },
{ type: 'out', text: ' 87% typescript-strict-mode' },
{ type: 'cmd', text: 'skillkit install anthropics/skills --agent all' },
{ type: 'out', text: '→ Installed to 32 agents' },
{ type: 'cmd', text: 'skillkit memory compress' },
{ type: 'out', text: '→ 12 learnings persisted' },
{ type: 'out', text: ' 92% react-best-practices (vercel)' },
{ type: 'out', text: ' 87% strict-typescript (anthropic)' },
{ type: 'out', text: ' 85% supabase-auth (supabase)' },
];
const FADE_ANIMATION_STYLES = `
@@ -55,7 +60,7 @@ const COPY_ICON = (
</svg>
);
export function Hero(): React.ReactElement {
export function Hero({ version, stars }: HeroProps): React.ReactElement {
const [copied, setCopied] = useState(false);
const [visibleLines, setVisibleLines] = useState(0);
const [typingIndex, setTypingIndex] = useState(0);
@@ -104,10 +109,6 @@ export function Hero(): React.ReactElement {
}
}
function openGitHub(): void {
window.open('https://github.com/rohitg00/skillkit', '_blank', 'noopener,noreferrer');
}
const isTyping = visibleLines < TERMINAL_LINES.length && TERMINAL_LINES[visibleLines].type === 'cmd';
const isComplete = visibleLines >= TERMINAL_LINES.length;
@@ -116,31 +117,43 @@ export function Hero(): React.ReactElement {
<div className="absolute inset-0 bg-gradient-to-b from-zinc-900/50 to-transparent pointer-events-none"></div>
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8 pt-8 pb-10 relative">
<div className="hidden lg:block mb-6 overflow-hidden">
<pre className="text-zinc-600 text-[10px] leading-none font-mono select-none whitespace-pre" style={{ fontFamily: 'JetBrains Mono, Consolas, monospace' }}>
<div className="flex flex-col sm:flex-row sm:items-center sm:justify-between gap-3 mb-4 lg:mb-6">
<pre className="hidden sm:block text-zinc-600 text-[6px] sm:text-[8px] lg:text-[10px] leading-none font-mono select-none whitespace-pre overflow-x-auto" style={{ fontFamily: 'JetBrains Mono, Consolas, monospace' }}>
{ASCII_LOGO}
</pre>
<a
href="https://www.producthunt.com/products/skillkit-2?embed=true&utm_source=badge-top-post-badge&utm_medium=badge&utm_campaign=badge-skillkit-2"
target="_blank"
rel="noopener noreferrer"
className="inline-flex items-center gap-2 sm:gap-3 bg-zinc-900/80 border border-zinc-800 hover:border-zinc-600 transition-colors rounded-full px-3 sm:px-4 py-1.5 sm:py-2 group shrink-0 self-start"
>
<span className="flex items-center justify-center w-6 h-6 sm:w-8 sm:h-8 rounded-full border border-zinc-600 bg-transparent text-white font-bold text-xs sm:text-sm">P</span>
<span className="flex flex-col">
<span className="text-[8px] sm:text-[10px] font-semibold text-zinc-500 tracking-wider uppercase leading-tight">Product Hunt</span>
<span className="text-[11px] sm:text-sm font-bold text-white group-hover:text-zinc-300 transition-colors leading-tight">#3 Product of the Day</span>
</span>
</a>
</div>
<div className="grid grid-cols-1 md:grid-cols-2 gap-6 lg:gap-8 items-start">
<div className="animate-fade-in">
<div className="inline-flex items-center space-x-2 border border-zinc-800 bg-zinc-900/50 px-2 py-0.5 mb-3 backdrop-blur-sm">
<span className="flex h-1.5 w-1.5 bg-white rounded-full"></span>
<span className="text-xs font-mono text-zinc-400">v1.8.0</span>
<span className="text-xs font-mono text-zinc-400">v{version}</span>
</div>
<h1 className="text-2xl sm:text-3xl lg:text-4xl font-bold tracking-tight text-white mb-3 font-mono">
Write Once.<br />
<span className="text-zinc-500">Deploy to 32 Agents.</span>
One CLI. Every Source.<br />
<span className="text-zinc-500">Every Agent. Zero Telemetry.</span>
</h1>
<p className="text-sm text-zinc-400 mb-5 max-w-lg font-mono leading-relaxed">
The universal skill platform for AI coding agents. Auto-generate instructions
with Primer, persist learnings with Memory, distribute across Mesh networks.
One CLI for Claude, Cursor, Windsurf, Copilot, and 28 more.
The open source package manager that aggregates 34+ skill sources,
scans 400K+ skills from registries, auto-translates to 46 agent formats,
and adds memory, security scanning, and team workflows. Everything runs locally.
</p>
<div className="flex flex-wrap items-center gap-3 mb-4">
<div className="flex flex-wrap items-center gap-2 mb-4">
<button
onClick={copyInstall}
className="inline-flex items-center bg-black border border-zinc-700 px-3 py-2 hover:border-zinc-500 transition-colors"
@@ -158,9 +171,39 @@ export function Hero(): React.ReactElement {
)}
</span>
</button>
<Button variant="outline" onClick={openGitHub}>
GITHUB
</Button>
<a
href="https://github.com/rohitg00/skillkit/tree/main/packages/extension#readme"
target="_blank"
rel="noopener noreferrer"
className="inline-flex items-center gap-2 bg-white text-black border border-zinc-300 px-3 py-2 hover:bg-zinc-200 transition-colors font-mono text-sm font-semibold"
>
<svg className="w-4 h-4" viewBox="0 0 24 24" fill="none">
<circle cx="12" cy="12" r="10" fill="#09090b"/>
<circle cx="12" cy="12" r="4.5" fill="white"/>
<path d="M12 2v5.5M12 16.5V22M2 12h5.5M16.5 12H22" stroke="white" strokeWidth="1.5"/>
</svg>
Add to Chrome
</a>
<a
href="https://github.com/rohitg00/skillkit"
target="_blank"
rel="noopener noreferrer"
className="sm:hidden inline-flex items-center gap-2 border border-zinc-700 px-3 py-2 hover:border-zinc-500 transition-colors group"
>
<svg className="w-4 h-4 text-zinc-400 group-hover:text-white transition-colors" fill="currentColor" viewBox="0 0 24 24">
<path fillRule="evenodd" d="M12 2C6.477 2 2 6.484 2 12.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.531 1.032 1.531 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0112 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.202 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.943.359.309.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482A10.019 10.019 0 0022 12.017C22 6.484 17.522 2 12 2z" clipRule="evenodd" />
</svg>
<span className="font-mono text-sm text-zinc-300 group-hover:text-white transition-colors">Star</span>
{typeof stars === 'number' && stars > 0 && (
<>
<span className="w-px h-4 bg-zinc-700"></span>
<svg className="w-3.5 h-3.5 text-yellow-500" fill="currentColor" viewBox="0 0 24 24">
<path d="M12 2l3.09 6.26L22 9.27l-5 4.87 1.18 6.88L12 17.77l-6.18 3.25L7 14.14 2 9.27l6.91-1.01L12 2z" />
</svg>
<span className="font-mono text-sm text-white font-medium">{stars}</span>
</>
)}
</a>
</div>
</div>
+1 -1
View File
@@ -31,7 +31,7 @@ export function SkillGenerator(): React.ReactElement {
<div className="text-center mb-8">
<h2 className="text-xl font-bold text-white mb-2 font-mono">Find Skills</h2>
<p className="text-zinc-500 font-mono text-xs">
Search 15,000+ skills from the marketplace
Search 400K+ skills across registries
</p>
</div>
+2 -2
View File
@@ -92,7 +92,7 @@ export function TeamEnterprise(): React.ReactElement {
</p>
</div>
<a
href="https://agenstskills.com/docs/api-reference"
href="https://skillkit.sh/docs/api-reference"
target="_blank"
rel="noopener noreferrer"
className="inline-flex items-center gap-2 px-3 sm:px-4 py-2 bg-zinc-800 text-white font-mono text-xs sm:text-sm hover:bg-zinc-700 transition-colors border border-zinc-700 whitespace-nowrap"
@@ -108,7 +108,7 @@ export function TeamEnterprise(): React.ReactElement {
{/* Bottom CTA */}
<div className="mt-6 sm:mt-8 text-center">
<a
href="https://agenstskills.com/docs"
href="https://skillkit.sh/docs"
target="_blank"
rel="noopener noreferrer"
className="inline-flex items-center gap-2 px-4 sm:px-6 py-2.5 sm:py-3 bg-white text-black font-mono text-xs sm:text-sm hover:bg-zinc-200 transition-colors cursor-pointer"
+8 -8
View File
@@ -13,14 +13,14 @@ const CATEGORIES = [
] as const;
const TRENDING_SKILLS = [
'anthropics/skills/claude-code-guide',
'anthropics/skills/claude-code-setup',
'obra/superpowers/tdd',
'vercel-labs/agent-skills/nextjs',
'trailofbits/skills/security-review',
'expo/skills/react-native',
'remotion-dev/skills/video',
'supabase/agent-skills/database',
'anthropics/skills/frontend-design',
'anthropics/skills/typescript-best-practices',
'obra/superpowers/test-driven-development',
'vercel-labs/agent-skills/vercel-react-best-practices',
'trailofbits/skills/semgrep',
'expo/skills/building-native-ui',
'sickn33/antigravity-awesome-skills/senior-architect',
'supabase/agent-skills/supabase-postgres-best-practices',
];
function getTrendingSkills(): IndexedSkill[] {
+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 32 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: (
+159
View File
@@ -0,0 +1,159 @@
import React from 'react';
interface Competitor {
name: string;
type: string;
agents: string;
translate: boolean;
memory: boolean;
security: boolean;
team: boolean;
tui: boolean;
api: boolean;
}
const COMPETITORS: Competitor[] = [
{ name: 'Vercel skills', type: 'Installer', agents: '~17', translate: false, memory: false, security: false, team: false, tui: false, api: false },
{ name: 'PRPM', type: 'Registry', agents: '~6', translate: true, memory: false, security: false, team: false, tui: false, api: false },
{ 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: '46', translate: true, memory: true, security: true, team: true, tui: true, api: true },
];
const SOURCES = [
{ name: 'Anthropic', repo: 'anthropics/skills', official: true },
{ name: 'Vercel', repo: 'vercel-labs/agent-skills', official: true },
{ name: 'Expo', repo: 'expo/skills', official: true },
{ name: 'Supabase', repo: 'supabase/agent-skills', official: true },
{ name: 'Stripe', repo: 'stripe/ai', official: true },
{ name: 'Remotion', repo: 'remotion-dev/skills', official: true },
{ name: 'Trail of Bits', repo: 'trailofbits/skills', official: false },
{ name: 'Better Auth', repo: 'better-auth/skills', official: false },
{ name: 'ElysiaJS', repo: 'elysiajs/skills', official: false },
{ name: 'Nuxt', repo: 'onmax/nuxt-skills', official: false },
{ name: 'NestJS', repo: 'kadajett/agent-nestjs-skills', official: false },
{ name: 'Three.js', repo: 'cloudai-x/threejs-skills', official: false },
];
function Check(): React.ReactElement {
return <span className="text-green-400 text-xs font-bold">&#10003;</span>;
}
function Cross(): React.ReactElement {
return <span className="text-zinc-700 text-xs">&#8212;</span>;
}
export function WhySkillKit(): React.ReactElement {
return (
<section id="why" className="py-12 sm:py-16 border-b border-zinc-800" style={{ scrollMarginTop: '4rem' }}>
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="text-center mb-8 sm:mb-12">
<div className="inline-flex items-center gap-2 border border-zinc-700 bg-zinc-900/80 px-2 sm:px-3 py-1 mb-4 backdrop-blur-sm">
<span className="w-1.5 h-1.5 bg-white rounded-full"></span>
<span className="text-[10px] sm:text-xs font-mono text-zinc-300 uppercase tracking-wider">Not Another Installer</span>
</div>
<h2 className="text-2xl sm:text-3xl lg:text-4xl font-bold text-white mb-3 font-mono tracking-tight">
Others Install. SkillKit Orchestrates.
</h2>
<p className="text-zinc-400 font-mono text-xs sm:text-sm max-w-2xl mx-auto">
Most skill tools are simple installers with 3-5 commands.
SkillKit is a full platform that aggregates every source, translates to every format,
and adds memory, security, and team workflows on top.
</p>
</div>
<div className="overflow-x-auto -mx-4 px-4 sm:mx-0 sm:px-0 mb-12">
<div className="min-w-[640px]">
<table className="w-full border-collapse font-mono text-[10px] sm:text-xs">
<thead>
<tr className="border-b border-zinc-800">
<th className="text-left text-zinc-500 uppercase tracking-wider py-2 pr-3">Tool</th>
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">Agents</th>
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">Translate</th>
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">Memory</th>
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">Security</th>
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">Team</th>
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">TUI</th>
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">API</th>
</tr>
</thead>
<tbody>
{COMPETITORS.map((c) => {
const isSkillKit = c.name === 'SkillKit';
const rowClass = isSkillKit
? 'bg-white/[0.03] border-b border-zinc-700'
: 'border-b border-zinc-800/50 hover:bg-zinc-900/50';
const nameClass = isSkillKit ? 'text-white font-bold' : 'text-zinc-400';
return (
<tr key={c.name} className={rowClass}>
<td className="py-2.5 pr-3">
<div className="flex items-center gap-2">
<span className={nameClass}>{c.name}</span>
<span className="text-zinc-700 text-[9px]">{c.type}</span>
</div>
</td>
<td className={`px-2 py-2.5 text-center ${isSkillKit ? 'text-white font-bold' : 'text-zinc-500'}`}>{c.agents}</td>
<td className="px-2 py-2.5 text-center">{c.translate ? <Check /> : <Cross />}</td>
<td className="px-2 py-2.5 text-center">{c.memory ? <Check /> : <Cross />}</td>
<td className="px-2 py-2.5 text-center">{c.security ? <Check /> : <Cross />}</td>
<td className="px-2 py-2.5 text-center">{c.team ? <Check /> : <Cross />}</td>
<td className="px-2 py-2.5 text-center">{c.tui ? <Check /> : <Cross />}</td>
<td className="px-2 py-2.5 text-center">{c.api ? <Check /> : <Cross />}</td>
</tr>
);
})}
</tbody>
</table>
</div>
</div>
<div className="mb-8">
<h3 className="text-lg font-bold text-white mb-2 font-mono">
One CLI. Every Source. Zero Telemetry.
</h3>
<p className="text-zinc-400 font-mono text-xs sm:text-sm mb-6">
SkillKit doesn't compete with skill sources &mdash; it aggregates them.
Install from 34+ curated repositories, any GitHub/GitLab repo, or local paths.
Everything runs locally. No accounts, no tracking, no lock-in.
</p>
<div className="grid grid-cols-2 sm:grid-cols-3 md:grid-cols-4 gap-2">
{SOURCES.map((s) => (
<a
key={s.repo}
href={`https://github.com/${s.repo}`}
target="_blank"
rel="noopener noreferrer"
className="group flex items-center gap-2 px-3 py-2 border border-zinc-800 bg-zinc-900/30 hover:border-zinc-600 hover:bg-zinc-900/80 transition-all"
>
<span className="text-zinc-400 group-hover:text-white text-xs font-mono transition-colors">{s.name}</span>
{s.official && (
<span className="text-[8px] text-zinc-600 border border-zinc-800 px-1 py-0.5 uppercase tracking-wider">official</span>
)}
</a>
))}
<div className="flex items-center gap-2 px-3 py-2 border border-dashed border-zinc-800 text-zinc-600 text-xs font-mono">
+ 22 more community sources
</div>
</div>
</div>
<div className="grid grid-cols-1 sm:grid-cols-3 gap-3">
<div className="p-4 border border-zinc-800 bg-zinc-900/30">
<div className="text-2xl font-bold text-white font-mono mb-1">0 bytes</div>
<div className="text-zinc-500 text-xs font-mono">telemetry collected</div>
</div>
<div className="p-4 border border-zinc-800 bg-zinc-900/30">
<div className="text-2xl font-bold text-white font-mono mb-1">Apache 2.0</div>
<div className="text-zinc-500 text-xs font-mono">fully open source</div>
</div>
<div className="p-4 border border-zinc-800 bg-zinc-900/30">
<div className="text-2xl font-bold text-white font-mono mb-1">No account</div>
<div className="text-zinc-500 text-xs font-mono">required to use</div>
</div>
</div>
</div>
</section>
);
}
+119
View File
@@ -0,0 +1,119 @@
import { useState, useEffect } from 'react';
interface Stats {
version: string;
downloads: string;
stars: number;
loading: boolean;
}
const CACHE_KEY = 'skillkit_stats_cache';
const CACHE_TTL = 5 * 60 * 1000; // 5 minutes
interface CachedStats {
data: Omit<Stats, 'loading'>;
timestamp: number;
}
function formatDownloads(count: number): string {
if (count >= 1000000) {
return `${(count / 1000000).toFixed(1)}M`;
}
if (count >= 1000) {
return `${(count / 1000).toFixed(1)}k`;
}
return count.toString();
}
function getCachedStats(): CachedStats | null {
try {
const cached = localStorage.getItem(CACHE_KEY);
if (cached) {
const parsed: CachedStats = JSON.parse(cached);
if (Date.now() - parsed.timestamp < CACHE_TTL) {
return parsed;
}
}
} catch {
// Ignore localStorage errors
}
return null;
}
function setCachedStats(data: Omit<Stats, 'loading'>): void {
try {
const cached: CachedStats = {
data,
timestamp: Date.now(),
};
localStorage.setItem(CACHE_KEY, JSON.stringify(cached));
} catch {
// Ignore localStorage errors
}
}
export function useStats(): Stats {
const [stats, setStats] = useState<Stats>({
version: '',
downloads: '',
stars: 0,
loading: true,
});
useEffect(() => {
const cached = getCachedStats();
if (cached) {
setStats({ ...cached.data, loading: false });
return;
}
async function fetchStats(): Promise<void> {
try {
const [npmResponse, githubResponse] = await Promise.allSettled([
fetch('https://api.npmjs.org/downloads/point/last-month/skillkit'),
fetch('https://api.github.com/repos/rohitg00/skillkit'),
]);
let downloads = '';
let stars = 0;
let version = '';
if (npmResponse.status === 'fulfilled' && npmResponse.value.ok) {
const npmData = await npmResponse.value.json();
if (typeof npmData.downloads === 'number' && Number.isFinite(npmData.downloads)) {
downloads = formatDownloads(npmData.downloads);
}
}
if (githubResponse.status === 'fulfilled' && githubResponse.value.ok) {
const githubData = await githubResponse.value.json();
if (typeof githubData.stargazers_count === 'number' && Number.isFinite(githubData.stargazers_count)) {
stars = githubData.stargazers_count;
}
}
try {
const registryResponse = await fetch('https://registry.npmjs.org/skillkit/latest');
if (registryResponse.ok) {
const registryData = await registryResponse.json();
if (registryData.version) {
version = registryData.version;
}
}
} catch {
// Use default version
}
const newStats = { version, downloads, stars };
setCachedStats(newStats);
setStats({ ...newStats, loading: false });
} catch {
setStats((prev) => ({ ...prev, loading: false }));
}
}
fetchStats();
}, []);
return stats;
}
+7 -7
View File
@@ -4,24 +4,24 @@
<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 32 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://agenstskills.com/">
<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 32 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
<meta property="og:image" content="https://agenstskills.com/og-image.png">
<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">
<meta property="og:site_name" content="SkillKit">
<!-- Twitter -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:url" content="https://agenstskills.com/">
<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 32 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
<meta name="twitter:image" content="https://agenstskills.com/og-image.png">
<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" />
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32.png" />
+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 32 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.8.0",
"version": "1.24.0",
"type": "module",
"scripts": {
"dev": "vite",
+354
View File
@@ -0,0 +1,354 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>SkillKit API</title>
<meta name="description" content="SkillKit REST API — discover and retrieve 400K+ AI agent skills on demand">
<link rel="icon" type="image/svg+xml" href="/favicon.svg">
<link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@5/swagger-ui.css">
<style>
* { margin: 0; padding: 0; box-sizing: border-box; }
body {
background: #0a0a0a;
color: #e4e4e7;
font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif;
}
.topbar {
position: sticky;
top: 0;
z-index: 50;
display: flex;
align-items: center;
justify-content: space-between;
height: 56px;
padding: 0 24px;
border-bottom: 1px solid #27272a;
background: rgba(10, 10, 10, 0.95);
backdrop-filter: blur(12px);
}
.topbar-left {
display: flex;
align-items: center;
gap: 12px;
}
.topbar-logo {
width: 16px;
height: 16px;
background: white;
}
.topbar-title {
font-family: 'JetBrains Mono', monospace;
font-weight: 700;
font-size: 14px;
color: white;
text-decoration: none;
letter-spacing: -0.025em;
}
.topbar-sep {
color: #3f3f46;
font-size: 18px;
}
.topbar-subtitle {
font-family: 'JetBrains Mono', monospace;
font-size: 12px;
color: #71717a;
}
.topbar-links {
display: flex;
align-items: center;
gap: 16px;
}
.topbar-links a {
font-family: 'JetBrains Mono', monospace;
font-size: 12px;
color: #71717a;
text-decoration: none;
transition: color 0.2s;
}
.topbar-links a:hover { color: white; }
.topbar-version {
display: inline-flex;
align-items: center;
gap: 6px;
padding: 2px 8px;
border: 1px solid #27272a;
background: rgba(24, 24, 27, 0.5);
font-family: 'JetBrains Mono', monospace;
font-size: 11px;
color: #a1a1aa;
}
.topbar-version .dot {
width: 6px;
height: 6px;
background: #22c55e;
border-radius: 50%;
}
#swagger-ui {
max-width: 1200px;
margin: 0 auto;
padding: 0 16px 64px;
}
/* Dark theme overrides */
.swagger-ui .topbar { display: none; }
.swagger-ui,
.swagger-ui .wrapper { background: transparent; }
.swagger-ui .info { margin: 32px 0 16px; }
.swagger-ui .info .title {
font-family: 'JetBrains Mono', monospace;
color: white;
}
.swagger-ui .info .description,
.swagger-ui .info .description p {
font-family: 'Inter', sans-serif;
color: #a1a1aa;
font-size: 14px;
}
.swagger-ui .info .description code {
background: #18181b;
border: 1px solid #27272a;
padding: 2px 6px;
border-radius: 3px;
color: #e4e4e7;
font-size: 13px;
}
.swagger-ui .info .description pre {
background: #18181b;
border: 1px solid #27272a;
border-radius: 6px;
padding: 16px;
}
.swagger-ui .scheme-container {
background: #18181b;
border: 1px solid #27272a;
box-shadow: none;
padding: 12px 16px;
}
.swagger-ui .opblock-tag {
color: white;
border-bottom: 1px solid #27272a;
font-family: 'JetBrains Mono', monospace;
}
.swagger-ui .opblock-tag small { color: #71717a; }
.swagger-ui .opblock {
border-color: #27272a;
background: #0f0f0f;
box-shadow: none;
}
.swagger-ui .opblock .opblock-summary {
border-bottom: 1px solid #27272a;
}
.swagger-ui .opblock .opblock-summary-description {
color: #a1a1aa;
font-family: 'Inter', sans-serif;
}
.swagger-ui .opblock .opblock-summary-path {
color: white;
font-family: 'JetBrains Mono', monospace;
}
.swagger-ui .opblock .opblock-section-header {
background: #18181b;
border-bottom: 1px solid #27272a;
}
.swagger-ui .opblock .opblock-section-header h4 {
color: #e4e4e7;
font-family: 'JetBrains Mono', monospace;
}
.swagger-ui .opblock-body pre.microlight {
background: #18181b;
border: 1px solid #27272a;
border-radius: 4px;
color: #e4e4e7;
font-family: 'JetBrains Mono', monospace;
font-size: 13px;
}
.swagger-ui .opblock.opblock-get {
border-color: #27272a;
background: rgba(34, 197, 94, 0.05);
}
.swagger-ui .opblock.opblock-get .opblock-summary-method {
background: #166534;
}
.swagger-ui .opblock.opblock-post {
border-color: #27272a;
background: rgba(59, 130, 246, 0.05);
}
.swagger-ui .opblock.opblock-post .opblock-summary-method {
background: #1e40af;
}
.swagger-ui .btn {
border-color: #3f3f46;
color: #e4e4e7;
}
.swagger-ui .btn:hover {
background: #27272a;
}
.swagger-ui .btn.execute {
background: white;
color: black;
border-color: white;
}
.swagger-ui .btn.execute:hover {
background: #e4e4e7;
}
.swagger-ui table thead tr th,
.swagger-ui table thead tr td,
.swagger-ui .parameter__name,
.swagger-ui .parameter__type {
color: #a1a1aa;
}
.swagger-ui .parameter__name.required span { color: #ef4444; }
.swagger-ui table tbody tr td {
color: #e4e4e7;
border-bottom: 1px solid #1c1c1e;
}
.swagger-ui input[type=text],
.swagger-ui textarea,
.swagger-ui select {
background: #18181b;
border: 1px solid #3f3f46;
color: #e4e4e7;
}
.swagger-ui .model-box {
background: #18181b;
border: 1px solid #27272a;
}
.swagger-ui .model { color: #a1a1aa; }
.swagger-ui .model-title { color: white; }
.swagger-ui .prop-type { color: #22c55e; }
.swagger-ui .prop-format { color: #71717a; }
.swagger-ui section.models {
border: 1px solid #27272a;
border-radius: 0;
}
.swagger-ui section.models h4 {
color: white;
border-bottom: 1px solid #27272a;
font-family: 'JetBrains Mono', monospace;
}
.swagger-ui section.models .model-container {
border-bottom: 1px solid #27272a;
background: transparent;
}
.swagger-ui .response-col_status { color: #22c55e; font-family: 'JetBrains Mono', monospace; }
.swagger-ui .response-col_description { color: #a1a1aa; }
.swagger-ui .responses-inner h4,
.swagger-ui .responses-inner h5 {
color: #e4e4e7;
}
.swagger-ui .filter .operation-filter-input {
background: #18181b;
border: 1px solid #3f3f46;
color: #e4e4e7;
}
.swagger-ui .loading-container .loading::after {
color: #71717a;
}
@media (max-width: 768px) {
.topbar { padding: 0 16px; }
.topbar-sep, .topbar-subtitle { display: none; }
}
@media (prefers-color-scheme: light) {
body { background: #0a0a0a; }
}
</style>
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
</head>
<body>
<div class="topbar">
<div class="topbar-left">
<a href="/" style="display:flex;align-items:center;gap:8px;text-decoration:none;">
<div class="topbar-logo"></div>
<span class="topbar-title">SKILLKIT</span>
</a>
<span class="topbar-sep">/</span>
<span class="topbar-subtitle">API Reference</span>
</div>
<div class="topbar-links">
<span class="topbar-version">
<span class="dot"></span>
v1.12.0
</span>
<a href="/">Home</a>
<a href="/docs">Docs</a>
<a href="https://github.com/rohitg00/skillkit" target="_blank" rel="noopener">GitHub</a>
</div>
</div>
<div id="swagger-ui"></div>
<script src="https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js"></script>
<script>
SwaggerUIBundle({
url: '/openapi.json',
dom_id: '#swagger-ui',
deepLinking: true,
showExtensions: true,
showCommonExtensions: true,
defaultModelsExpandDepth: 2,
defaultModelExpandDepth: 2,
docExpansion: 'list',
filter: true,
tryItOutEnabled: true,
persistAuthorization: true,
displayRequestDuration: true,
syntaxHighlight: { theme: 'monokai' },
});
</script>
</body>
</html>
+368
View File
@@ -0,0 +1,368 @@
{
"openapi": "3.1.0",
"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 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"
},
"contact": {
"name": "SkillKit",
"url": "https://github.com/rohitg00/skillkit"
}
},
"servers": [
{
"url": "http://localhost:3737",
"description": "Local development (skillkit serve)"
}
],
"tags": [
{ "name": "Search", "description": "Skill search and filtering" },
{ "name": "Skills", "description": "Individual skill retrieval" },
{ "name": "Discovery", "description": "Trending skills and categories" },
{ "name": "System", "description": "Health checks and diagnostics" }
],
"paths": {
"/search": {
"get": {
"summary": "Search skills",
"description": "Find skills matching your query. Results are ranked by relevance: content availability (40pts), query match (30pts), popularity (15pts), and references (15pts). Best matches come first.",
"operationId": "searchSkillsGet",
"tags": ["Search"],
"parameters": [
{
"name": "q",
"in": "query",
"required": true,
"schema": { "type": "string", "minLength": 1, "maxLength": 200 },
"description": "Search query (e.g., 'react performance', 'authentication')",
"example": "react hooks"
},
{
"name": "limit",
"in": "query",
"schema": { "type": "integer", "default": 20, "minimum": 1, "maximum": 100 },
"description": "Maximum results to return"
},
{
"name": "include_content",
"in": "query",
"schema": { "type": "boolean", "default": false },
"description": "Include full SKILL.md content in response"
}
],
"responses": {
"200": {
"description": "Search results ranked by relevance",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/SearchResponse" },
"example": {
"skills": [
{
"name": "react-performance",
"description": "React app performance optimization patterns",
"source": "anthropics/skills",
"tags": ["react", "performance"],
"category": "frontend"
}
],
"total": 42,
"query": "react hooks",
"limit": 20
}
}
}
},
"400": {
"description": "Missing query parameter",
"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
},
"429": {
"description": "Rate limit exceeded (60 req/min per IP)",
"content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitResponse" } } }
}
}
},
"post": {
"summary": "Search skills with filters",
"description": "Search with filters. Narrow results by tags, category, or source repository.",
"operationId": "searchSkillsPost",
"tags": ["Search"],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": ["query"],
"properties": {
"query": { "type": "string", "description": "Search query" },
"limit": { "type": "integer", "default": 20, "minimum": 1, "maximum": 100 },
"include_content": { "type": "boolean", "default": false },
"filters": {
"type": "object",
"properties": {
"tags": { "type": "array", "items": { "type": "string" }, "description": "Filter by tags" },
"category": { "type": "string", "description": "Filter by category" },
"source": { "type": "string", "description": "Filter by source repository" }
}
}
}
},
"example": {
"query": "authentication",
"limit": 10,
"filters": { "tags": ["security"], "category": "backend" }
}
}
}
},
"responses": {
"200": {
"description": "Filtered search results",
"content": { "application/json": { "schema": { "$ref": "#/components/schemas/SearchResponse" } } }
},
"400": {
"description": "Invalid request body",
"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
}
}
}
},
"/skills/{owner}/{repo}/{id}": {
"get": {
"summary": "Get skill by ID",
"description": "Get full details of a specific skill by its source repository and name.",
"operationId": "getSkill",
"tags": ["Skills"],
"parameters": [
{
"name": "owner",
"in": "path",
"required": true,
"schema": { "type": "string" },
"description": "Repository owner",
"example": "anthropics"
},
{
"name": "repo",
"in": "path",
"required": true,
"schema": { "type": "string" },
"description": "Repository name",
"example": "skills"
},
{
"name": "id",
"in": "path",
"required": true,
"schema": { "type": "string" },
"description": "Skill name",
"example": "pdf-processing"
}
],
"responses": {
"200": {
"description": "Skill details",
"content": { "application/json": { "schema": { "$ref": "#/components/schemas/Skill" } } }
},
"404": {
"description": "Skill not found",
"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
}
}
}
},
"/trending": {
"get": {
"summary": "Trending skills",
"description": "The most popular skills right now, ranked by relevance score across all sources.",
"operationId": "getTrending",
"tags": ["Discovery"],
"parameters": [
{
"name": "limit",
"in": "query",
"schema": { "type": "integer", "default": 20, "minimum": 1, "maximum": 100 },
"description": "Maximum results"
}
],
"responses": {
"200": {
"description": "Trending skills list",
"content": { "application/json": { "schema": { "$ref": "#/components/schemas/TrendingResponse" } } }
}
}
}
},
"/categories": {
"get": {
"summary": "Skill categories",
"description": "Browse all skill categories with counts. See what's available before searching.",
"operationId": "getCategories",
"tags": ["Discovery"],
"responses": {
"200": {
"description": "Category list with counts",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/CategoriesResponse" },
"example": {
"categories": [
{ "name": "react", "count": 156 },
{ "name": "typescript", "count": 134 },
{ "name": "testing", "count": 89 }
],
"total": 89
}
}
}
}
}
}
},
"/health": {
"get": {
"summary": "Health check",
"description": "Check if the server is running. Returns version, skill count, and uptime.",
"operationId": "getHealth",
"tags": ["System"],
"responses": {
"200": {
"description": "Server health",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/HealthResponse" },
"example": {
"status": "ok",
"version": "1.12.0",
"skillCount": 15062,
"uptime": 3600
}
}
}
}
}
}
},
"/cache/stats": {
"get": {
"summary": "Cache statistics",
"description": "See how the cache is performing. Shows hit/miss rates and current size.",
"operationId": "getCacheStats",
"tags": ["System"],
"responses": {
"200": {
"description": "Cache statistics",
"content": {
"application/json": {
"schema": { "$ref": "#/components/schemas/CacheStatsResponse" },
"example": {
"hits": 142,
"misses": 38,
"size": 45,
"maxSize": 500,
"hitRate": 0.789
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"Skill": {
"type": "object",
"description": "An AI agent skill from the marketplace",
"properties": {
"name": { "type": "string", "description": "Skill name" },
"description": { "type": "string", "description": "What this skill does" },
"source": { "type": "string", "description": "Source repository (owner/repo)" },
"repo": { "type": "string", "description": "Full repository URL" },
"tags": { "type": "array", "items": { "type": "string" }, "description": "Skill tags" },
"category": { "type": "string", "description": "Primary category" },
"content": { "type": "string", "description": "Full SKILL.md content (when include_content=true)" },
"stars": { "type": "integer", "description": "GitHub stars" },
"installs": { "type": "integer", "description": "Install count" }
},
"required": ["name", "source"]
},
"SearchResponse": {
"type": "object",
"properties": {
"skills": { "type": "array", "items": { "$ref": "#/components/schemas/Skill" } },
"total": { "type": "integer", "description": "Total matching skills (before limit)" },
"query": { "type": "string", "description": "Original search query" },
"limit": { "type": "integer", "description": "Applied result limit" }
},
"required": ["skills", "total", "query", "limit"]
},
"TrendingResponse": {
"type": "object",
"properties": {
"skills": { "type": "array", "items": { "$ref": "#/components/schemas/Skill" } },
"limit": { "type": "integer" }
},
"required": ["skills", "limit"]
},
"CategoriesResponse": {
"type": "object",
"properties": {
"categories": { "type": "array", "items": { "$ref": "#/components/schemas/CategoryCount" } },
"total": { "type": "integer" }
},
"required": ["categories", "total"]
},
"CategoryCount": {
"type": "object",
"properties": {
"name": { "type": "string" },
"count": { "type": "integer" }
},
"required": ["name", "count"]
},
"HealthResponse": {
"type": "object",
"properties": {
"status": { "type": "string", "enum": ["ok"] },
"version": { "type": "string" },
"skillCount": { "type": "integer" },
"uptime": { "type": "number", "description": "Seconds since server start" }
},
"required": ["status", "version", "skillCount", "uptime"]
},
"CacheStatsResponse": {
"type": "object",
"properties": {
"hits": { "type": "integer" },
"misses": { "type": "integer" },
"size": { "type": "integer", "description": "Current cached entries" },
"maxSize": { "type": "integer", "description": "Maximum cache capacity" },
"hitRate": { "type": "number", "description": "Hit rate (0.0 - 1.0)" }
},
"required": ["hits", "misses", "size", "maxSize", "hitRate"]
},
"ErrorResponse": {
"type": "object",
"properties": {
"error": { "type": "string", "description": "Error message" }
},
"required": ["error"]
},
"RateLimitResponse": {
"type": "object",
"properties": {
"error": { "type": "string" },
"retryAfter": { "type": "integer", "description": "Seconds until rate limit window resets" }
},
"required": ["error", "retryAfter"]
}
}
}
}
+76
View File
@@ -0,0 +1,76 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Privacy Policy — SkillKit</title>
<style>
* { margin: 0; padding: 0; box-sizing: border-box; }
body { background: #09090b; color: #d4d4d8; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif; line-height: 1.7; }
.container { max-width: 640px; margin: 0 auto; padding: 48px 24px; }
h1 { color: #fafafa; font-size: 28px; font-weight: 700; margin-bottom: 8px; font-family: 'JetBrains Mono', monospace; }
.updated { color: #71717a; font-size: 13px; margin-bottom: 32px; }
h2 { color: #fafafa; font-size: 18px; font-weight: 600; margin-top: 32px; margin-bottom: 12px; }
p { margin-bottom: 16px; font-size: 15px; }
ul { margin-bottom: 16px; padding-left: 24px; }
li { margin-bottom: 8px; font-size: 15px; }
a { color: #fafafa; text-decoration: underline; text-underline-offset: 2px; }
a:hover { color: #a1a1aa; }
.back { display: inline-block; margin-bottom: 24px; color: #71717a; font-size: 13px; text-decoration: none; font-family: 'JetBrains Mono', monospace; }
.back:hover { color: #fafafa; }
</style>
</head>
<body>
<div class="container">
<a href="/" class="back">&larr; Back to SkillKit</a>
<h1>Privacy Policy</h1>
<p class="updated">Last updated: February 14, 2026</p>
<h2>Overview</h2>
<p>SkillKit ("we", "our", "us") is an open-source CLI tool and Chrome extension for managing AI agent skills. We are committed to protecting your privacy. This policy explains what data we collect (or don't) across all SkillKit products.</p>
<h2>Chrome Extension — "SkillKit - Save as Skill"</h2>
<p>The Chrome extension helps you save webpages as AI agent skill files.</p>
<ul>
<li><strong>What data is sent:</strong> When you click "Save as Skill", the extension sends the URL of the current page to our server at <code>https://skillkit.sh/api/save-skill</code>. This is required to fetch and convert the webpage content into a skill file.</li>
<li><strong>What data is NOT sent:</strong> We do not send page content, browsing history, personal information, cookies, authentication tokens, or any data beyond the single URL you choose to save.</li>
<li><strong>No data stored on server:</strong> The URL is processed in real time to extract content, generate tags, and build the skill file. No URLs, page content, or user data are stored, logged, or retained on the server after the response is returned.</li>
<li><strong>Selection saves are local:</strong> When you save selected text via the right-click menu, the skill file is built entirely in the browser with no network requests.</li>
<li><strong>No analytics or tracking:</strong> We do not use any analytics, telemetry, or tracking services.</li>
<li><strong>No user accounts:</strong> No login, API key, or account is required.</li>
<li><strong>Downloads:</strong> Generated skill files are saved to your local filesystem via the Chrome Downloads API. No files are uploaded anywhere.</li>
</ul>
<h2>Permissions Used</h2>
<ul>
<li><strong>activeTab:</strong> Read the URL and title of the tab you are viewing when you click the extension. Only accessed when you actively use the extension.</li>
<li><strong>contextMenus:</strong> Add "Save page as Skill" and "Save selection as Skill" to the right-click menu.</li>
<li><strong>downloads:</strong> Save the generated SKILL.md file to your Downloads folder.</li>
</ul>
<h2>CLI Tool</h2>
<p>The SkillKit CLI runs entirely on your local machine. It does not phone home, collect telemetry, or transmit any data to external servers unless you explicitly use network features (e.g., <code>skillkit install</code> fetches public GitHub repositories).</p>
<h2>MCP Server</h2>
<p>The SkillKit MCP server runs locally and provides skill discovery over the Model Context Protocol. It loads skill data from a bundled JSON file and does not make external network requests or collect user data.</p>
<h2>Website</h2>
<p>The SkillKit website is available at <a href="https://skillkit.sh">skillkit.sh</a> and <a href="https://agenstskills.com">agenstskills.com</a>. It is a static site hosted on Vercel. We do not use cookies, analytics trackers, or collect personal information. Vercel may collect standard web server logs (IP address, user agent) as described in their <a href="https://vercel.com/legal/privacy-policy">privacy policy</a>.</p>
<h2>Third-Party Services</h2>
<p>The Chrome extension communicates with <code>skillkit.sh</code> and <code>agenstskills.com</code> (both our own servers, hosted on Vercel) to process webpage URLs. No third-party data processors, advertising networks, or analytics services are used.</p>
<h2>Data Retention</h2>
<p>We do not retain any user data. URLs sent to the API are processed in memory and discarded immediately after the response.</p>
<h2>Changes to This Policy</h2>
<p>We may update this privacy policy from time to time. Changes will be posted on this page with an updated revision date.</p>
<h2>Contact</h2>
<p>If you have questions about this privacy policy, contact us at <a href="mailto:ghumare64@gmail.com">ghumare64@gmail.com</a>.</p>
<h2>Open Source</h2>
<p>SkillKit is open source under the Apache 2.0 license. You can review all source code at <a href="https://github.com/rohitg00/skillkit">github.com/rohitg00/skillkit</a>.</p>
</div>
</body>
</html>

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