Commit Graph
292 Commits
Author SHA1 Message Date
Rohit Ghumare 145bf80342 chore: bump to 1.23.0, rewrite README, drop dead LLM SDK deps, add branded tags
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:11:44 +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
Rohit Ghumare ae8c7a1abb chore: bump version to 1.22.1 v1.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 v1.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 v1.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 v1.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