Compare commits

..
Author SHA1 Message Date
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 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
221 changed files with 13055 additions and 4459 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
+3 -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
+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
+19 -9
View File
@@ -15,9 +15,9 @@
[![GitHub stars](https://img.shields.io/github/stars/rohitg00/skillkit?style=flat-square)](https://github.com/rohitg00/skillkit/stargazers)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg?style=flat-square)](https://opensource.org/licenses/Apache-2.0)
**SkillKit** is the open source package manager for AI agent skills. Write a skill once, deploy it to **44 agents** — Claude, Cursor, Copilot, Windsurf, Devin, Codex, and 38 more. No rewrites. 15,000+ skills in the marketplace.
**SkillKit** is the open source package manager for AI agent skills. Write a skill once, deploy it to **44 agents** — Claude, Cursor, Copilot, Windsurf, Devin, Codex, and 38 more. No rewrites. 400K+ skills across registries.
[Website](https://agenstskills.com) &middot; [Docs](https://agenstskills.com/docs) &middot; [API Explorer](https://agenstskills.com/api) &middot; [Chrome Extension](https://github.com/rohitg00/skillkit/tree/main/packages/extension#readme) &middot; [npm](https://www.npmjs.com/package/skillkit)
[Website](https://skillkit.sh) &middot; [Docs](https://skillkit.sh/docs) &middot; [API Explorer](https://skillkit.sh/api) &middot; [Chrome Extension](https://github.com/rohitg00/skillkit/tree/main/packages/extension#readme) &middot; [npm](https://www.npmjs.com/package/skillkit)
</div>
@@ -34,7 +34,7 @@ Skills make AI coding agents smarter. But every agent uses a different format:
You end up rewriting the same skill for each agent, or locking into one platform.
**SkillKit fixes this.** Install from 15,000+ skills, auto-translate between formats, persist learnings with Memory. Works with Claude, Cursor, Windsurf, Copilot, and 40 more.
**SkillKit fixes this.** Install from 400K+ skills across registries, auto-translate between formats, persist learnings with Memory. Works with Claude, Cursor, Windsurf, Copilot, and 40 more.
```bash
npx skillkit@latest
@@ -125,7 +125,7 @@ async with SkillKitClient() as client:
results = await client.search("react performance", limit=5)
```
[REST API docs](https://agenstskills.com/docs/rest-api) &middot; [MCP Server docs](https://agenstskills.com/docs/mcp-server) &middot; [Python Client docs](https://agenstskills.com/docs/python-client) &middot; [Interactive API explorer](https://agenstskills.com/api)
[REST API docs](https://skillkit.sh/docs/rest-api) &middot; [MCP Server docs](https://skillkit.sh/docs/mcp-server) &middot; [Python Client docs](https://skillkit.sh/docs/python-client) &middot; [Interactive API explorer](https://skillkit.sh/api)
### Auto-generate agent instructions
@@ -154,7 +154,7 @@ skillkit generate
# Interactive wizard with 4 context sources:
# - Documentation (via Context7)
# - Your codebase patterns
# - 15,000+ marketplace skills
# - 400K+ marketplace skills
# - Memory (your corrections)
```
@@ -191,7 +191,7 @@ Save any webpage as a skill directly from your browser.
The extension sends the page URL to the SkillKit API for server-side extraction with Turndown, 5-source weighted tag detection, and GitHub URL support. The resulting SKILL.md downloads automatically. Then run `skillkit install ~/Downloads/skillkit-skills/my-skill` to deploy to all agents.
[Extension docs](https://agenstskills.com/docs/chrome-extension)
[Extension docs](https://skillkit.sh/docs/chrome-extension)
### Interactive TUI
@@ -221,7 +221,7 @@ skillkit ui
Plus 33 more: Amp, Antigravity, Augment Code, Bolt, Clawdbot, Cline, CodeBuddy, CodeGPT, CommandCode, Continue, Crush, Droid, Factory, Goose, Kilo Code, Kiro CLI, Lovable, MCPJam, Mux, Neovate, OpenHands, Pi, PlayCode, Qoder, Qwen, Replit Agent, Roo Code, Tabby, Tabnine, Trae, Vercel, Zencoder, Universal
[Full agent details](https://agenstskills.com/docs/agents)
[Full agent details](https://skillkit.sh/docs/agents)
## Commands
@@ -254,6 +254,16 @@ skillkit issue plan owner/repo#42 # Cross-repo plan
skillkit issue list # List open issues
```
### Session Intelligence
```bash
skillkit timeline # Unified event stream
skillkit session handoff # Agent-to-agent context
skillkit lineage # Skill impact graph
skillkit session explain # Human-readable summary
skillkit activity # Skill activity log
```
### Advanced
```bash
@@ -266,7 +276,7 @@ skillkit test # Test skills
skillkit cicd init # CI/CD templates
```
[Full command reference](https://agenstskills.com/docs/commands)
[Full command reference](https://skillkit.sh/docs/commands)
## Creating Skills
@@ -357,4 +367,4 @@ Apache License 2.0 — see [LICENSE](LICENSE).
## Links
[Documentation](https://agenstskills.com/docs) &middot; [Website](https://agenstskills.com) &middot; [API Explorer](https://agenstskills.com/api) &middot; [npm](https://www.npmjs.com/package/skillkit) &middot; [GitHub](https://github.com/rohitg00/skillkit)
[Documentation](https://skillkit.sh/docs) &middot; [Website](https://skillkit.sh) &middot; [API Explorer](https://skillkit.sh/api) &middot; [npm](https://www.npmjs.com/package/skillkit) &middot; [GitHub](https://github.com/rohitg00/skillkit)
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit",
"version": "1.19.0",
"version": "1.19.2",
"description": "Supercharge AI coding agents with portable skills. Install, translate, and share skills across Claude Code, Cursor, Codex, Copilot & 13 more",
"type": "module",
"bin": {
+14
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,
@@ -110,6 +112,7 @@ import {
SkillMdCheckCommand,
ServeCommand,
ScanCommand,
EvalCommand,
DoctorCommand,
SaveCommand,
AgentsMdCommand,
@@ -118,6 +121,9 @@ import {
AgentsMdShowCommand,
IssuePlanCommand,
IssueListCommand,
TimelineCommand,
SessionHandoffCommand,
LineageCommand,
} from '@skillkit/cli';
const __filename = fileURLToPath(import.meta.url);
@@ -126,6 +132,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',
@@ -253,6 +262,7 @@ cli.register(SkillMdCheckCommand);
cli.register(ServeCommand);
cli.register(ScanCommand);
cli.register(EvalCommand);
cli.register(DoctorCommand);
cli.register(SaveCommand);
cli.register(AgentsMdCommand);
@@ -263,4 +273,8 @@ cli.register(AgentsMdShowCommand);
cli.register(IssuePlanCommand);
cli.register(IssueListCommand);
cli.register(TimelineCommand);
cli.register(SessionHandoffCommand);
cli.register(LineageCommand);
cli.runExit(process.argv.slice(2));
+1 -1
View File
@@ -38,5 +38,5 @@ dev = [
[project.urls]
Homepage = "https://github.com/rohitg00/skillkit"
Documentation = "https://agenstskills.com"
Documentation = "https://skillkit.sh"
Repository = "https://github.com/rohitg00/skillkit"
@@ -65,7 +65,7 @@ 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 `agenstskills.com/api/save-skill`:
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)
+60
View File
@@ -378,6 +378,66 @@ 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
+1 -1
View File
@@ -29,7 +29,7 @@ skillkit/
│ ├── core/ # Business logic
│ ├── cli/ # CLI
│ ├── tui/ # Terminal UI
│ └── agents/ # 32 adapters
│ └── agents/ # 44 adapters
├── marketplace/ # Skills data
│ ├── skills.json
│ └── sources.json
+16 -4
View File
@@ -31,9 +31,10 @@ Four commands. Your agents now have skills for PDF processing, code review, and
### Install skills from anywhere
```bash
skillkit install anthropics/skills # GitHub
skillkit install gitlab:team/skills # GitLab
skillkit install ./my-local-skills # Local
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
```
### Translate between agents
@@ -124,6 +125,16 @@ 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:
@@ -157,10 +168,11 @@ Team members run `skillkit manifest install` and they're in sync.
- [Installation](/docs/installation) — Install and configure
- [Quick Start](/docs/quickstart) — First project setup
- [Methodology Packs](/docs/methodology) — Debugging, testing, planning skills
- [Security Scanner](/docs/security) — Threat detection for skills
- [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
**Current version:** v1.12.0 | [npm](https://www.npmjs.com/package/skillkit) | [GitHub](https://github.com/rohitg00/skillkit) | Apache-2.0
**Current version:** v1.19.2 | [npm](https://www.npmjs.com/package/skillkit) | [GitHub](https://github.com/rohitg00/skillkit) | Apache-2.0
+1
View File
@@ -14,6 +14,7 @@
"recommendations",
"primer",
"memory",
"methodology",
"mesh",
"messaging",
"workflows",
@@ -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.
+3 -3
View File
@@ -5,7 +5,7 @@ description: Auto-generate AI agent instructions from your codebase
# Primer
Primer analyzes your codebase and automatically generates optimized instructions for all 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 44 AI agents. No more manual configuration—let SkillKit detect your tech stack, coding patterns, and project structure.
## Quick Start
@@ -65,7 +65,7 @@ Primer creates agent-specific instructions for:
└── copilot-instructions.md
```
### All 32 Agents
### All 44 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
```
+2 -2
View File
@@ -158,7 +158,7 @@ curl http://localhost:3737/health
```json
{
"status": "ok",
"version": "1.12.0",
"version": "1.19.2",
"skillCount": 15062,
"uptime": 3600
}
@@ -188,7 +188,7 @@ const { app, cache } = createApp({
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 [agenstskills.com/api](https://agenstskills.com/api).
The hosted version is available at [skillkit.sh/api](https://skillkit.sh/api) and [agenstskills.com/api](https://agenstskills.com/api).
## All endpoints
+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 44 agent formats using an adapter pattern.
## Basic Translation
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit-docs",
"version": "1.19.0",
"version": "1.19.2",
"private": true,
"scripts": {
"build": "next build",
+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">44 Agents</h3>
<p className="text-zinc-500 text-sm">Claude, Cursor, Codex, Windsurf, Copilot, and 39 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>
+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',
+1 -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' },
+17 -5
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 44 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 44 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>
@@ -102,7 +102,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 44 AI agents</li>
</ul>
<h3 className="text-lg font-semibold text-white mt-6">Monorepo Structure</h3>
@@ -130,7 +130,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 44 AI coding agents with automatic format translation:
</p>
<Table
@@ -167,6 +167,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 44 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', '44'],
['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">44</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">
+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",
+44 -70
View File
@@ -5,14 +5,10 @@ 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 { BadgeGenerator } from './components/BadgeGenerator';
import { CompatibilityMatrix } from './components/CompatibilityMatrix';
import { useStats } from './hooks/useStats';
@@ -56,13 +52,6 @@ export default function App(): React.ReactElement {
>
Trending
</a>
<a
href="#stack"
onClick={(e) => scrollToSection(e, 'stack')}
className="text-zinc-500 hover:text-white transition-colors"
>
Stack
</a>
<a
href="#matrix"
onClick={(e) => scrollToSection(e, 'matrix')}
@@ -70,13 +59,6 @@ export default function App(): React.ReactElement {
>
Matrix
</a>
<a
href="#badge"
onClick={(e) => scrollToSection(e, 'badge')}
className="text-zinc-500 hover:text-white transition-colors"
>
Badge
</a>
<a
href="#advanced"
onClick={(e) => scrollToSection(e, 'advanced')}
@@ -98,28 +80,20 @@ export default function App(): React.ReactElement {
>
Generator
</a>
<a
href="https://github.com/rohitg00/skillkit/tree/main/packages/extension#readme"
target="_blank"
rel="noopener noreferrer"
className="text-zinc-500 hover:text-white transition-colors"
>
Extension
</a>
</div>
<div className="flex items-center gap-3 sm:gap-4">
<a
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://agenstskills.com/docs"
className="text-zinc-400 hover:text-white transition-colors text-xs sm:text-sm font-mono"
>
Docs
</a>
<a
href="https://github.com/rohitg00/skillkit"
target="_blank"
@@ -187,44 +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>
{/* Compatibility Matrix */}
<section id="matrix" style={{ scrollMarginTop: '4rem' }}>
<CompatibilityMatrix />
</section>
{/* Badge Generator */}
<section id="badge" style={{ scrollMarginTop: '4rem' }}>
<BadgeGenerator />
</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 />
@@ -243,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 />
+19 -1
View File
@@ -15,7 +15,7 @@ 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, 15,000+ marketplace skills, and your corrections. Works with any LLM: Claude, GPT-4, Gemini, Ollama, or OpenRouter.',
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">
@@ -47,6 +47,24 @@ 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',
+118 -1
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;
}
`;
+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>
+2 -2
View File
@@ -35,8 +35,8 @@ export function BadgeGenerator(): React.ReactElement {
const badgeUrl = useMemo(() => buildBadgeUrl(skills), [skills]);
const markdown = `[![SkillKit Stack](${badgeUrl})](https://agenstskills.com)`;
const html = `<a href="https://agenstskills.com"><img src="${badgeUrl}" alt="SkillKit Stack" /></a>`;
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();
+11
View File
@@ -104,6 +104,17 @@ const COMMAND_GROUPS: CommandGroup[] = [
{ 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: [
@@ -24,14 +24,42 @@ const AGENTS: AgentDef[] = [
{ 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[] = [
@@ -56,66 +84,87 @@ const CATEGORIES: CategoryDef[] = [
// - 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',
'roo': 'full', 'kilo': 'full', 'kiro-cli': 'partial', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'antigravity': 'full', 'continue': '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',
'roo': 'full', 'kilo': 'partial', 'kiro-cli': 'partial', 'goose': 'partial',
'trae': 'partial', 'amp': 'partial', 'antigravity': 'none', 'continue': 'none',
'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',
'roo': 'full', 'kilo': 'none', 'kiro-cli': 'none', 'goose': 'none',
'trae': 'none', 'amp': 'none', 'antigravity': 'none', 'continue': 'none',
'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',
'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'partial', 'amp': 'full', 'antigravity': 'partial', 'continue': 'partial',
'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',
'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'antigravity': 'partial', 'continue': 'partial',
'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',
'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'antigravity': 'partial', 'continue': 'partial',
'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',
'roo': 'full', 'kilo': 'partial', 'kiro-cli': 'partial', 'goose': 'partial',
'trae': 'full', 'amp': 'full', 'antigravity': 'partial', 'continue': 'partial',
'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',
'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'antigravity': 'partial', 'continue': 'partial',
'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',
'roo': 'full', 'kilo': 'partial', 'kiro-cli': 'partial', 'goose': 'partial',
'trae': 'partial', 'amp': 'partial', 'antigravity': 'partial', 'continue': 'partial',
'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',
'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'antigravity': 'full', 'continue': '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,
},
};
@@ -197,7 +246,7 @@ export function CompatibilityMatrix(): React.ReactElement {
<div>
<h2 className="text-lg sm:text-xl font-bold text-white mb-1 font-mono">Compatibility Matrix</h2>
<p className="text-zinc-500 font-mono text-[10px] sm:text-xs">
Skill support across {AGENTS.length} agents and {CATEGORIES.length} categories.
Skill support across all 44 agents and {CATEGORIES.length} categories.
</p>
</div>
<div className="flex items-center gap-2">
+8 -1
View File
@@ -47,7 +47,7 @@ const sections: DocSection[] = [
<h3 className="text-lg font-semibold text-white mt-6">Core Capabilities</h3>
<ul className="list-disc list-inside space-y-2 text-zinc-400">
<li><span className="text-white">AI Instruction Generation (Primer)</span> - Analyze your codebase and generate customized instruction files for all 44 agents</li>
<li><span className="text-white">Skill Discovery</span> - Browse 15,000+ skills from marketplace with AI-powered recommendations</li>
<li><span className="text-white">Skill Discovery</span> - Browse 400K+ skills from registries with AI-powered recommendations</li>
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 44 agent-specific formats</li>
<li><span className="text-white">Team Collaboration</span> - Share skills via .skills manifest files and publish to marketplace</li>
</ul>
@@ -213,6 +213,13 @@ 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
+24 -24
View File
@@ -9,7 +9,7 @@ interface Feature {
const FEATURES: Feature[] = [
{
title: 'Smart Recommendations',
description: 'AI analyzes your codebase and recommends from 15,000+ 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" />
@@ -45,7 +45,7 @@ const FEATURES: Feature[] = [
},
{
title: 'Skill Tree',
description: 'Browse 15K+ skills in a hierarchical taxonomy with 12 categories.',
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" />
@@ -109,37 +109,37 @@ const FEATURES: Feature[] = [
];
const COMPARISONS = [
['Agent Support', '1 agent', '44 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'],
['Security', 'Manual review', 'Auto-scan on install'],
['Agent Support', '1-17 agents', '44 agents'],
['Sources', 'Single registry', '34+ aggregated'],
['Translation', 'None or limited', 'All 44 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">44</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>
@@ -147,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">
@@ -167,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"
+16 -14
View File
@@ -20,16 +20,18 @@ interface TerminalLine {
}
const TERMINAL_LINES: TerminalLine[] = [
{ type: 'cmd', text: 'skillkit install anthropics/skills --agent all' },
{ type: 'out', text: '→ Installed to 44 agents' },
{ type: 'cmd', text: 'skillkit install anthropics/skills' },
{ type: 'out', text: '→ Fetched from github.com/anthropics/skills' },
{ type: 'out', text: '→ Translated to 44 agent formats' },
{ type: 'out', text: '→ 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 serve' },
{ type: 'out', text: '→ API server on http://0.0.0.0:3737' },
{ type: 'out', text: ' GET /search · /trending · /categories' },
{ type: 'cmd', text: 'curl localhost:3737/search?q=react' },
{ type: 'out', text: ' {"skills":[...],"total":42}' },
{ 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 = `
@@ -141,14 +143,14 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
</div>
<h1 className="text-2xl sm:text-3xl lg:text-4xl font-bold tracking-tight text-white mb-3 font-mono">
One Skill.<br />
<span className="text-zinc-500">44 Agents. Zero Rewrites.</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 open source package manager for AI agent skills. Install from 15,000+ skills,
auto-translate between formats, persist learnings with Memory.
Works with Claude, Cursor, Windsurf, Copilot, Devin, Codex, and 38 more.
The open source package manager that aggregates 34+ skill sources,
scans 400K+ skills from registries, auto-translates to 44 agent formats,
and adds memory, security scanning, and team workflows. Everything runs locally.
</p>
<div className="flex flex-wrap items-center gap-2 mb-4">
+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[] {
+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: '44', 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>
);
}
+4 -4
View File
@@ -8,20 +8,20 @@
<!-- 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 44 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: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 44 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: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,7 +1,7 @@
{
"name": "skillkit",
"private": true,
"version": "1.19.0",
"version": "1.19.2",
"type": "module",
"scripts": {
"dev": "vite",
+1 -1
View File
@@ -4,7 +4,7 @@
<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 15,000+ AI agent skills on demand">
<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>
+1 -1
View File
@@ -3,7 +3,7 @@
"info": {
"title": "SkillKit",
"version": "1.12.0",
"description": "Skills shouldn't require pre-installation. This API lets any agent, framework, or tool discover and retrieve skills on demand.\n\n15,000+ skills across 44 AI coding agents. Results ranked by a multi-signal scoring system (content 40pts, query match 30pts, popularity 15pts, references 15pts).\n\n## Quick Start\n\n```bash\nnpx skillkit serve\n```\n\nThe API is now running at http://localhost:3737\n\n## MCP Server\n\nFor agent-native discovery (Claude Desktop, Cursor):\n\n```json\n{\n \"mcpServers\": {\n \"skillkit\": { \"command\": \"npx\", \"args\": [\"@skillkit/mcp\"] }\n }\n}\n```\n\n## Python Client\n\n```bash\npip install skillkit-client\n```",
"description": "Skills shouldn't require pre-installation. This API lets any agent, framework, or tool discover and retrieve skills on demand.\n\n400K+ skills across 44 AI coding agents. Results ranked by a multi-signal scoring system (content 40pts, query match 30pts, popularity 15pts, references 15pts).\n\n## Quick Start\n\n```bash\nnpx skillkit serve\n```\n\nThe API is now running at http://localhost:3737\n\n## MCP Server\n\nFor agent-native discovery (Claude Desktop, Cursor):\n\n```json\n{\n \"mcpServers\": {\n \"skillkit\": { \"command\": \"npx\", \"args\": [\"@skillkit/mcp\"] }\n }\n}\n```\n\n## Python Client\n\n```bash\npip install skillkit-client\n```",
"license": {
"name": "Apache-2.0",
"url": "https://opensource.org/licenses/Apache-2.0"
+3 -3
View File
@@ -32,7 +32,7 @@
<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>agenstskills.com/api/save-skill</code>. This is required to fetch and convert the webpage content into a skill file.</li>
<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>
@@ -55,10 +55,10 @@
<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 (<a href="https://agenstskills.com">agenstskills.com</a>) 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>
<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>agenstskills.com</code> (our own server, hosted on Vercel) to process webpage URLs. No third-party data processors, advertising networks, or analytics services are used.</p>
<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>
Binary file not shown.
+1
View File
@@ -23,6 +23,7 @@
"./*"
]
},
"resolveJsonModule": true,
"allowImportingTsExtensions": true,
"noEmit": true
}
+1
View File
@@ -1,4 +1,5 @@
{
"ignoreCommand": "git diff --quiet HEAD^ HEAD -- .",
"buildCommand": "npm run build",
"outputDirectory": "dist",
"installCommand": "npm install",
+845 -175
View File
File diff suppressed because it is too large Load Diff
+5 -2
View File
@@ -1,7 +1,7 @@
{
"$schema": "./sources-schema.json",
"version": 1,
"updatedAt": "2026-01-26",
"updatedAt": "2026-02-28",
"description": "Curated skill repository sources - THE SINGLE SOURCE OF TRUTH",
"sources": [
{ "source": "anthropics/skills", "name": "Anthropic Official", "official": true },
@@ -34,6 +34,9 @@
{ "source": "jimliu/baoyu-skills", "name": "Baoyu Tools" },
{ "source": "giuseppe-trisciuoglio/developer-kit", "name": "Shadcn / Radix" },
{ "source": "openrouterteam/agent-skills", "name": "OpenRouter SDK" },
{ "source": "intellectronica/agent-skills", "name": "Context7" }
{ "source": "intellectronica/agent-skills", "name": "Context7" },
{ "source": "muratcankoylan/Agent-Skills-for-Context-Engineering", "name": "Context Engineering" },
{ "source": "sickn33/antigravity-awesome-skills", "name": "Antigravity Awesome Skills" },
{ "source": "skills.sh", "name": "Skills.sh Leaderboard", "official": true, "registry": "skills-sh" }
]
}
+2 -2
View File
@@ -1,8 +1,8 @@
{
"name": "skillkit-monorepo",
"version": "1.19.0",
"version": "1.19.2",
"private": true,
"description": "The package manager for AI agent skills — install, translate, share across 32 coding agents",
"description": "The package manager for AI agent skills — install, translate, share across 44 coding agents",
"type": "module",
"scripts": {
"build": "turbo run build",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/agents",
"version": "1.19.0",
"version": "1.19.2",
"description": "Agent adapters for SkillKit - supports 32 AI coding agents",
"type": "module",
"main": "./dist/index.js",
@@ -35,10 +35,10 @@ const ALL_AGENTS = AgentType.options;
describe('Agent Adapters', () => {
describe('getAllAdapters', () => {
it('should return all 44 registered adapters', () => {
it('should return all 45 registered adapters', () => {
const adapters = getAllAdapters();
expect(adapters).toBeInstanceOf(Array);
expect(adapters.length).toBe(44);
expect(adapters.length).toBe(45);
});
it('should include common agents', () => {
@@ -236,16 +236,6 @@ describe('ClawdbotAdapter', () => {
});
describe('isDetected', () => {
it('should detect Clawdbot from workspace skills directory', async () => {
mockExistsSync.mockImplementation((path) => {
return path === join(process.cwd(), 'skills');
});
const detected = await adapter.isDetected();
expect(detected).toBe(true);
});
it('should detect Clawdbot from global directory', async () => {
mockExistsSync.mockImplementation((path) => {
return path === join(homedir(), '.clawdbot');
@@ -287,7 +277,6 @@ describe('ClawdbotAdapter', () => {
await adapter.isDetected();
expect(mockExistsSync).toHaveBeenCalledWith(join(process.cwd(), 'skills'));
expect(mockExistsSync).toHaveBeenCalledWith(join(homedir(), '.clawdbot'));
expect(mockExistsSync).toHaveBeenCalledWith(join(process.cwd(), 'clawdbot.json'));
});
+4 -5
View File
@@ -10,9 +10,9 @@ const config = AGENT_CONFIG.clawdbot;
export class ClawdbotAdapter implements AgentAdapter {
readonly type: AgentType = 'clawdbot';
readonly name = 'Clawdbot';
readonly skillsDir = config.skillsDir;
readonly configFile = config.configFile;
readonly name: string = 'Clawdbot';
readonly skillsDir: string = config.skillsDir;
readonly configFile: string = config.configFile;
generateConfig(skills: Skill[]): string {
const enabledSkills = skills.filter(s => s.enabled);
@@ -69,10 +69,9 @@ ${skillsXml}
}
async isDetected(): Promise<boolean> {
const projectSkills = join(process.cwd(), 'skills');
const globalClawdbot = join(homedir(), '.clawdbot');
const clawdbotConfig = join(process.cwd(), 'clawdbot.json');
return existsSync(projectSkills) || existsSync(globalClawdbot) || existsSync(clawdbotConfig);
return existsSync(globalClawdbot) || existsSync(clawdbotConfig);
}
}
+8
View File
@@ -8,6 +8,7 @@ import { OpenCodeAdapter } from './opencode.js';
import { AntigravityAdapter } from './antigravity.js';
import { AmpAdapter } from './amp.js';
import { ClawdbotAdapter } from './clawdbot.js';
import { OpenClawAdapter } from './openclaw.js';
import { DroidAdapter } from './droid.js';
import { FactoryAdapter } from './factory.js';
import { GitHubCopilotAdapter } from './github-copilot.js';
@@ -29,6 +30,7 @@ export * from './opencode.js';
export * from './antigravity.js';
export * from './amp.js';
export * from './clawdbot.js';
export * from './openclaw.js';
export * from './droid.js';
export * from './factory.js';
export * from './github-copilot.js';
@@ -53,6 +55,7 @@ const adapters: Record<AgentType, AgentAdapter> = {
antigravity: new AntigravityAdapter(),
amp: new AmpAdapter(),
clawdbot: new ClawdbotAdapter(),
openclaw: new OpenClawAdapter(),
droid: new DroidAdapter(),
'github-copilot': new GitHubCopilotAdapter(),
goose: new GooseAdapter(),
@@ -107,6 +110,10 @@ export function getAllAdapters(): AgentAdapterWithType[] {
}));
}
export function getAdapterCount(): number {
return Object.keys(adapters).length;
}
export async function detectAgent(): Promise<AgentType> {
const checkOrder: AgentType[] = [
'claude-code',
@@ -116,6 +123,7 @@ export async function detectAgent(): Promise<AgentType> {
'opencode',
'antigravity',
'amp',
'openclaw',
'clawdbot',
'droid',
'github-copilot',
+22
View File
@@ -0,0 +1,22 @@
import { existsSync } from 'node:fs';
import { join } from 'node:path';
import { homedir } from 'node:os';
import { ClawdbotAdapter } from './clawdbot.js';
import type { AgentType } from '@skillkit/core';
import { AGENT_CONFIG } from '@skillkit/core';
const config = AGENT_CONFIG.openclaw;
export class OpenClawAdapter extends ClawdbotAdapter {
override readonly type: AgentType = 'openclaw';
override readonly name = 'OpenClaw';
override readonly skillsDir = config.skillsDir;
override readonly configFile = config.configFile;
override async isDetected(): Promise<boolean> {
const globalOpenClaw = join(homedir(), '.openclaw');
const openclawConfig = join(process.cwd(), 'openclaw.json');
return existsSync(globalOpenClaw) || existsSync(openclawConfig);
}
}
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/api",
"version": "1.19.0",
"version": "1.19.2",
"description": "REST API server for SkillKit skill discovery",
"type": "module",
"main": "./dist/index.js",
+20 -7
View File
@@ -1,4 +1,4 @@
import type { Context, Next } from 'hono';
import type { Context, Next } from "hono";
interface RateLimitEntry {
count: number;
@@ -18,8 +18,12 @@ export function rateLimiter(maxRequests = 60, windowMs = 60_000) {
}, windowMs).unref();
return async (c: Context, next: Next): Promise<Response | void> => {
const forwardedFor = c.req.header('x-forwarded-for');
const ip = (forwardedFor?.split(',')[0]?.trim()) || c.req.header('x-real-ip') || 'unknown';
const xRealIp = c.req.header("x-real-ip");
const forwarded = c.req.header("x-forwarded-for");
const forwardedIp = forwarded
? forwarded.split(",").at(-1)?.trim()
: undefined;
const ip = xRealIp || forwardedIp || "unknown";
const now = Date.now();
let entry = windows.get(ip);
@@ -30,12 +34,21 @@ export function rateLimiter(maxRequests = 60, windowMs = 60_000) {
entry.count++;
c.header('X-RateLimit-Limit', String(maxRequests));
c.header('X-RateLimit-Remaining', String(Math.max(0, maxRequests - entry.count)));
c.header('X-RateLimit-Reset', String(Math.ceil(entry.resetAt / 1000)));
c.header("X-RateLimit-Limit", String(maxRequests));
c.header(
"X-RateLimit-Remaining",
String(Math.max(0, maxRequests - entry.count)),
);
c.header("X-RateLimit-Reset", String(Math.ceil(entry.resetAt / 1000)));
if (entry.count > maxRequests) {
return c.json({ error: 'Too many requests', retryAfter: Math.ceil((entry.resetAt - now) / 1000) }, 429);
return c.json(
{
error: "Too many requests",
retryAfter: Math.ceil((entry.resetAt - now) / 1000),
},
429,
);
}
await next();
+1 -1
View File
@@ -5,7 +5,7 @@ const OPENAPI_SPEC = {
info: {
title: 'SkillKit',
version: '1.12.0',
description: 'Skill Discovery API for AI coding agents. Search, browse, and retrieve skills from the SkillKit marketplace (15,000+ skills across 44 agents).',
description: 'Skill Discovery API for AI coding agents. Search, browse, and retrieve skills from the SkillKit marketplace (400K+ skills across 44 agents).',
license: { name: 'Apache-2.0', url: 'https://opensource.org/licenses/Apache-2.0' },
contact: { name: 'SkillKit', url: 'https://github.com/rohitg00/skillkit' },
},
+50 -19
View File
@@ -1,5 +1,5 @@
import { Hono } from 'hono';
import { ContentExtractor, SkillGenerator, AutoTagger } from '@skillkit/core';
import { Hono } from "hono";
import { ContentExtractor, SkillGenerator, AutoTagger } from "@skillkit/core";
interface SaveRequest {
url?: string;
@@ -10,25 +10,40 @@ interface SaveRequest {
const MAX_TEXT_LENGTH = 500_000;
const BLOCKED_HOSTS = new Set(['localhost', '127.0.0.1', '[::1]', '::1', '0.0.0.0']);
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;
if (parsed.protocol !== "http:" && parsed.protocol !== "https:")
return false;
const hostname = parsed.hostname.toLowerCase();
const bare = hostname.replace(/^\[|\]$/g, '');
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 (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 (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('fc') || bare.startsWith('fd')) return false;
if (bare.startsWith("169.254.")) return false;
if (bare.includes(":")) {
if (
bare.startsWith("fe80:") ||
bare.startsWith("fc") ||
bare.startsWith("fd")
)
return false;
if (bare.startsWith("ff")) return false;
}
if (/^(22[4-9]|23\d|24\d|25[0-5])\./.test(bare)) return false;
if (bare.startsWith('ff')) return false;
return true;
} catch {
return false;
@@ -41,12 +56,12 @@ export function saveRoutes() {
const generator = new SkillGenerator();
const tagger = new AutoTagger();
app.post('/save', async (c) => {
app.post("/save", async (c) => {
let body: SaveRequest;
try {
body = await c.req.json();
} catch {
return c.json({ error: 'Invalid JSON body' }, 400);
return c.json({ error: "Invalid JSON body" }, 400);
}
if (!body.url && !body.text) {
@@ -54,11 +69,26 @@ export function saveRoutes() {
}
if (body.url && !isAllowedUrl(body.url)) {
return c.json({ error: 'URL must be a public HTTP(S) address' }, 400);
return c.json({ error: "URL must be a public HTTP(S) address" }, 400);
}
if (body.name && !/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/.test(body.name)) {
return c.json(
{
error:
"Name must be alphanumeric (hyphens, underscores, dots allowed)",
},
400,
);
}
if (body.text && body.text.length > MAX_TEXT_LENGTH) {
return c.json({ error: `Text exceeds maximum length of ${MAX_TEXT_LENGTH} characters` }, 400);
return c.json(
{
error: `Text exceeds maximum length of ${MAX_TEXT_LENGTH} characters`,
},
400,
);
}
try {
@@ -78,16 +108,17 @@ export function saveRoutes() {
tags: tagger.detectTags(content),
});
} catch (err) {
const message = err instanceof Error ? err.message : 'Unknown error';
console.error("Save extraction failed:", err);
const isTimeout =
(err instanceof DOMException && err.name === 'TimeoutError') ||
(err instanceof Error && (err.name === 'TimeoutError' || err.name === 'AbortError'));
(err instanceof DOMException && err.name === "TimeoutError") ||
(err instanceof Error &&
(err.name === "TimeoutError" || err.name === "AbortError"));
if (isTimeout) {
return c.json({ error: `Fetch timeout: ${message}` }, 504);
return c.json({ error: "Fetch timed out" }, 504);
}
return c.json({ error: `Extraction failed: ${message}` }, 422);
return c.json({ error: "Extraction failed" }, 422);
}
});
+33 -23
View File
@@ -1,15 +1,15 @@
import { Hono } from 'hono';
import { cors } from 'hono/cors';
import { MemoryCache } from '@skillkit/core';
import { rateLimiter } from './middleware/rate-limit.js';
import { healthRoutes } from './routes/health.js';
import { searchRoutes } from './routes/search.js';
import { skillRoutes } from './routes/skills.js';
import { trendingRoutes } from './routes/trending.js';
import { categoryRoutes } from './routes/categories.js';
import { docsRoutes } from './routes/docs.js';
import { saveRoutes } from './routes/save.js';
import type { ApiSkill, SearchResponse } from './types.js';
import { Hono } from "hono";
import { cors } from "hono/cors";
import { MemoryCache } from "@skillkit/core";
import { rateLimiter } from "./middleware/rate-limit.js";
import { healthRoutes } from "./routes/health.js";
import { searchRoutes } from "./routes/search.js";
import { skillRoutes } from "./routes/skills.js";
import { trendingRoutes } from "./routes/trending.js";
import { categoryRoutes } from "./routes/categories.js";
import { docsRoutes } from "./routes/docs.js";
import { saveRoutes } from "./routes/save.js";
import type { ApiSkill, SearchResponse } from "./types.js";
export interface ServerOptions {
port?: number;
@@ -29,26 +29,36 @@ export function createApp(options: ServerOptions = {}) {
const app = new Hono();
app.use('*', cors({ origin: options.corsOrigin || '*' }));
app.use('*', rateLimiter(options.rateLimitMax ?? 60));
app.use("*", cors({ origin: options.corsOrigin || "*" }));
app.use("*", async (c, next) => {
await next();
c.header("X-Content-Type-Options", "nosniff");
c.header("X-Frame-Options", "DENY");
c.header(
"Content-Security-Policy",
"default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'",
);
c.header("Referrer-Policy", "strict-origin-when-cross-origin");
});
app.use("*", rateLimiter(options.rateLimitMax ?? 60));
app.route('/', healthRoutes(skills.length, cache));
app.route('/', searchRoutes(skills, cache));
app.route('/', skillRoutes(skills));
app.route('/', trendingRoutes(skills));
app.route('/', categoryRoutes(skills));
app.route('/', docsRoutes());
app.route('/', saveRoutes());
app.route("/", healthRoutes(skills.length, cache));
app.route("/", searchRoutes(skills, cache));
app.route("/", skillRoutes(skills));
app.route("/", trendingRoutes(skills));
app.route("/", categoryRoutes(skills));
app.route("/", docsRoutes());
app.route("/", saveRoutes());
return { app, cache };
}
export async function startServer(options: ServerOptions = {}) {
const port = options.port ?? 3737;
const host = options.host ?? '0.0.0.0';
const host = options.host ?? "127.0.0.1";
const { app, cache } = createApp(options);
const { serve } = await import('@hono/node-server');
const { serve } = await import("@hono/node-server");
const server = serve({ fetch: app.fetch, port, hostname: host }, () => {
console.log(`SkillKit API server running at http://${host}:${port}`);
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/cli",
"version": "1.19.0",
"version": "1.19.2",
"description": "CLI commands for SkillKit",
"type": "module",
"main": "./dist/index.js",
+4 -4
View File
@@ -16,8 +16,8 @@ export function generateBadge(skills: string[]): {
const url = `https://img.shields.io/badge/SkillKit-No%20Skills-555555?style=flat-square&logo=data:image/svg+xml;base64,${SKILLKIT_LOGO_SVG_BASE64}`;
return {
url,
markdown: `[![SkillKit Stack](${url})](https://agenstskills.com)`,
html: `<a href="https://agenstskills.com"><img src="${url}" alt="SkillKit Stack" /></a>`,
markdown: `[![SkillKit Stack](${url})](https://skillkit.sh)`,
html: `<a href="https://skillkit.sh"><img src="${url}" alt="SkillKit Stack" /></a>`,
};
}
@@ -33,7 +33,7 @@ export function generateBadge(skills: string[]): {
return {
url,
markdown: `[![SkillKit Stack](${url})](https://agenstskills.com)`,
html: `<a href="https://agenstskills.com"><img src="${url}" alt="SkillKit Stack" /></a>`,
markdown: `[![SkillKit Stack](${url})](https://skillkit.sh)`,
html: `<a href="https://skillkit.sh"><img src="${url}" alt="SkillKit Stack" /></a>`,
};
}
+7 -7
View File
@@ -1,5 +1,5 @@
import { Command, Option } from 'clipanion';
import chalk from 'chalk';
import { colors, warn } from '../onboarding/index.js';
import { ActivityLog } from '@skillkit/core';
export class ActivityCommand extends Command {
@@ -42,16 +42,16 @@ export class ActivityCommand extends Command {
}
if (activities.length === 0) {
console.log(chalk.yellow('No activity recorded'));
warn('No activity recorded');
console.log(
chalk.dim(
colors.muted(
'Activity is recorded when skills are active during git commits.'
)
);
return 0;
}
console.log(chalk.cyan(' Recent Skill Activity\n'));
console.log(colors.cyan(' Recent Skill Activity\n'));
const displayed = activities.slice(0, limit);
@@ -61,10 +61,10 @@ export class ActivityCommand extends Command {
const files = activity.filesChanged.join(', ');
const ago = formatTimeAgo(activity.committedAt);
console.log(` ${chalk.bold(shortSha)} ${activity.message}`);
console.log(` Skills: ${chalk.green(skills)}`);
console.log(` ${colors.bold(shortSha)} ${activity.message}`);
console.log(` Skills: ${colors.success(skills)}`);
console.log(
` Files: ${files} ${chalk.dim(`(${ago})`)}`
` Files: ${files} ${colors.muted(`(${ago})`)}`
);
console.log();
}
+110 -110
View File
@@ -4,7 +4,7 @@
* Manage custom AI sub-agents (e.g., .claude/agents/*.md)
*/
import chalk from 'chalk';
import { colors } from '../onboarding/index.js';
import { Command, Option } from 'clipanion';
import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
import { join, basename } from 'node:path';
@@ -67,7 +67,7 @@ export class AgentCommand extends Command {
});
async execute(): Promise<number> {
console.log(chalk.cyan('Agent management commands:\n'));
console.log(colors.cyan('Agent management commands:\n'));
console.log(' agent list List all installed agents');
console.log(' agent show <name> Show agent details');
console.log(' agent create <name> Create a new agent');
@@ -76,7 +76,7 @@ export class AgentCommand extends Command {
console.log(' agent sync Sync agents to target AI agent');
console.log(' agent validate [path] Validate agent definitions');
console.log();
console.log(chalk.dim('Run `skillkit agent <subcommand> --help` for more info'));
console.log(colors.muted('Run `skillkit agent <subcommand> --help` for more info'));
return 0;
}
}
@@ -136,18 +136,18 @@ export class AgentListCommand extends Command {
}
if (agents.length === 0) {
console.log(chalk.yellow('No agents found'));
console.log(chalk.dim('Create an agent with: skillkit agent create <name>'));
console.log(colors.warning('No agents found'));
console.log(colors.muted('Create an agent with: skillkit agent create <name>'));
return 0;
}
console.log(chalk.cyan(`Installed agents (${agents.length}):\n`));
console.log(colors.cyan(`Installed agents (${agents.length}):\n`));
const projectAgents = agents.filter((a: CustomAgent) => a.location === 'project');
const globalAgents = agents.filter((a: CustomAgent) => a.location === 'global');
if (projectAgents.length > 0) {
console.log(chalk.blue('Project agents:'));
console.log(colors.info('Project agents:'));
for (const agent of projectAgents) {
printAgent(agent);
}
@@ -155,7 +155,7 @@ export class AgentListCommand extends Command {
}
if (globalAgents.length > 0) {
console.log(chalk.dim('Global agents:'));
console.log(colors.muted('Global agents:'));
for (const agent of globalAgents) {
printAgent(agent);
}
@@ -163,7 +163,7 @@ export class AgentListCommand extends Command {
}
console.log(
chalk.dim(`${projectAgents.length} project, ${globalAgents.length} global`)
colors.muted(`${projectAgents.length} project, ${globalAgents.length} global`)
);
return 0;
@@ -187,47 +187,47 @@ export class AgentShowCommand extends Command {
const agent = findAgent(this.name, searchDirs);
if (!agent) {
console.log(chalk.red(`Agent not found: ${this.name}`));
console.log(colors.error(`Agent not found: ${this.name}`));
return 1;
}
console.log(chalk.cyan(`Agent: ${agent.name}\n`));
console.log(`${chalk.dim('Description:')} ${agent.description}`);
console.log(`${chalk.dim('Location:')} ${agent.location} (${agent.path})`);
console.log(`${chalk.dim('Enabled:')} ${agent.enabled ? chalk.green('yes') : chalk.red('no')}`);
console.log(colors.cyan(`Agent: ${agent.name}\n`));
console.log(`${colors.muted('Description:')} ${agent.description}`);
console.log(`${colors.muted('Location:')} ${agent.location} (${agent.path})`);
console.log(`${colors.muted('Enabled:')} ${agent.enabled ? colors.success('yes') : colors.error('no')}`);
const fm = agent.frontmatter;
if (fm.model) {
console.log(`${chalk.dim('Model:')} ${fm.model}`);
console.log(`${colors.muted('Model:')} ${fm.model}`);
}
if (fm.permissionMode) {
console.log(`${chalk.dim('Permission Mode:')} ${fm.permissionMode}`);
console.log(`${colors.muted('Permission Mode:')} ${fm.permissionMode}`);
}
if (fm.context) {
console.log(`${chalk.dim('Context:')} ${fm.context}`);
console.log(`${colors.muted('Context:')} ${fm.context}`);
}
if (fm.disallowedTools && fm.disallowedTools.length > 0) {
console.log(`${chalk.dim('Disallowed Tools:')} ${fm.disallowedTools.join(', ')}`);
console.log(`${colors.muted('Disallowed Tools:')} ${fm.disallowedTools.join(', ')}`);
}
if (fm.skills && fm.skills.length > 0) {
console.log(`${chalk.dim('Skills:')} ${fm.skills.join(', ')}`);
console.log(`${colors.muted('Skills:')} ${fm.skills.join(', ')}`);
}
if (fm.hooks && fm.hooks.length > 0) {
console.log(`${chalk.dim('Hooks:')} ${fm.hooks.length} defined`);
console.log(`${colors.muted('Hooks:')} ${fm.hooks.length} defined`);
}
if (fm.tags && fm.tags.length > 0) {
console.log(`${chalk.dim('Tags:')} ${fm.tags.join(', ')}`);
console.log(`${colors.muted('Tags:')} ${fm.tags.join(', ')}`);
}
if (fm.author) {
console.log(`${chalk.dim('Author:')} ${fm.author}`);
console.log(`${colors.muted('Author:')} ${fm.author}`);
}
if (fm.version) {
console.log(`${chalk.dim('Version:')} ${fm.version}`);
console.log(`${colors.muted('Version:')} ${fm.version}`);
}
console.log();
console.log(chalk.dim('Content preview:'));
console.log(chalk.dim('─'.repeat(40)));
console.log(colors.muted('Content preview:'));
console.log(colors.muted('─'.repeat(40)));
const preview = agent.content.slice(0, 500);
console.log(preview + (agent.content.length > 500 ? '\n...' : ''));
@@ -264,8 +264,8 @@ export class AgentCreateCommand extends Command {
async execute(): Promise<number> {
const namePattern = /^[a-z0-9]+(-[a-z0-9]+)*$/;
if (!namePattern.test(this.name)) {
console.log(chalk.red('Invalid agent name: must be lowercase alphanumeric with hyphens'));
console.log(chalk.dim('Examples: my-agent, code-reviewer, security-expert'));
console.log(colors.error('Invalid agent name: must be lowercase alphanumeric with hyphens'));
console.log(colors.muted('Examples: my-agent, code-reviewer, security-expert'));
return 1;
}
@@ -282,7 +282,7 @@ export class AgentCreateCommand extends Command {
const agentPath = join(targetDir, `${this.name}.md`);
if (existsSync(agentPath)) {
console.log(chalk.red(`Agent already exists: ${agentPath}`));
console.log(colors.error(`Agent already exists: ${agentPath}`));
return 1;
}
@@ -291,10 +291,10 @@ export class AgentCreateCommand extends Command {
writeFileSync(agentPath, content);
console.log(chalk.green(`Created agent: ${agentPath}`));
console.log(colors.success(`Created agent: ${agentPath}`));
console.log();
console.log(chalk.dim('Edit the file to customize the agent system prompt.'));
console.log(chalk.dim(`Invoke with: @${this.name}`));
console.log(colors.muted('Edit the file to customize the agent system prompt.'));
console.log(colors.muted(`Invoke with: @${this.name}`));
return 0;
}
@@ -360,23 +360,23 @@ export class AgentTranslateCommand extends Command {
: join(process.cwd(), this.source);
if (!existsSync(sourcePath)) {
console.log(chalk.red(`Source path not found: ${sourcePath}`));
console.log(colors.error(`Source path not found: ${sourcePath}`));
return 1;
}
agents = discoverAgentsFromPath(sourcePath, this.recursive);
if (agents.length === 0) {
console.log(chalk.yellow(`No agents found in: ${sourcePath}`));
console.log(colors.warning(`No agents found in: ${sourcePath}`));
if (!this.recursive) {
console.log(chalk.dim('Tip: Use --recursive to scan subdirectories'));
console.log(colors.muted('Tip: Use --recursive to scan subdirectories'));
}
return 0;
}
} else if (this.name) {
const agent = findAgent(this.name, searchDirs);
if (!agent) {
console.log(chalk.red(`Agent not found: ${this.name}`));
console.log(colors.error(`Agent not found: ${this.name}`));
return 1;
}
agents = [agent];
@@ -387,13 +387,13 @@ export class AgentTranslateCommand extends Command {
}
if (agents.length === 0) {
console.log(chalk.yellow('No agents found to translate'));
console.log(colors.warning('No agents found to translate'));
return 0;
}
const outputDir = this.output || getAgentTargetDirectory(process.cwd(), targetAgent);
console.log(chalk.cyan(`Translating ${agents.length} agent(s) to ${targetAgent} format...\n`));
console.log(colors.cyan(`Translating ${agents.length} agent(s) to ${targetAgent} format...\n`));
let successCount = 0;
let errorCount = 0;
@@ -403,7 +403,7 @@ export class AgentTranslateCommand extends Command {
const result = translateAgent(agent, targetAgent, { addMetadata: true });
if (!result.success) {
console.log(chalk.red(`✗ ${agent.name}: Translation failed`));
console.log(colors.error(`✗ ${agent.name}: Translation failed`));
errorCount++;
continue;
}
@@ -411,15 +411,15 @@ export class AgentTranslateCommand extends Command {
const outputPath = join(outputDir, result.filename);
if (this.dryRun) {
console.log(chalk.blue(`Would write: ${outputPath}`));
console.log(colors.info(`Would write: ${outputPath}`));
if (result.warnings.length > 0) {
for (const warning of result.warnings) {
console.log(chalk.yellow(` ⚠ ${warning}`));
console.log(colors.warning(` ⚠ ${warning}`));
}
}
if (result.incompatible.length > 0) {
for (const incompat of result.incompatible) {
console.log(chalk.dim(` ○ ${incompat}`));
console.log(colors.muted(` ○ ${incompat}`));
}
}
} else {
@@ -427,21 +427,21 @@ export class AgentTranslateCommand extends Command {
mkdirSync(outputDir, { recursive: true });
}
writeFileSync(outputPath, result.content);
console.log(chalk.green(`✓ ${agent.name} → ${outputPath}`));
console.log(colors.success(`✓ ${agent.name} → ${outputPath}`));
}
successCount++;
} catch (error) {
console.log(chalk.red(`✗ ${agent.name}: ${error instanceof Error ? error.message : 'Unknown error'}`));
console.log(colors.error(`✗ ${agent.name}: ${error instanceof Error ? error.message : 'Unknown error'}`));
errorCount++;
}
}
console.log();
if (this.dryRun) {
console.log(chalk.dim(`Would translate ${successCount} agent(s)`));
console.log(colors.muted(`Would translate ${successCount} agent(s)`));
} else {
console.log(chalk.dim(`Translated ${successCount} agent(s)${errorCount > 0 ? `, ${errorCount} failed` : ''}`));
console.log(colors.muted(`Translated ${successCount} agent(s)${errorCount > 0 ? `, ${errorCount} failed` : ''}`));
}
return errorCount > 0 ? 1 : 0;
@@ -468,7 +468,7 @@ export class AgentSyncCommand extends Command {
const agents = findAllAgents(searchDirs);
if (agents.length === 0) {
console.log(chalk.yellow('No agents found to sync'));
console.log(colors.warning('No agents found to sync'));
return 0;
}
@@ -476,12 +476,12 @@ export class AgentSyncCommand extends Command {
? this.agent.split(',').map(a => a.trim() as AgentType)
: ['claude-code' as AgentType];
console.log(chalk.cyan(`Syncing ${agents.length} agent(s)...\n`));
console.log(colors.cyan(`Syncing ${agents.length} agent(s)...\n`));
for (const targetAgent of targetAgents) {
const outputDir = getAgentTargetDirectory(process.cwd(), targetAgent);
console.log(chalk.blue(`→ ${targetAgent} (${outputDir})`));
console.log(colors.info(`→ ${targetAgent} (${outputDir})`));
if (!existsSync(outputDir)) {
mkdirSync(outputDir, { recursive: true });
@@ -492,15 +492,15 @@ export class AgentSyncCommand extends Command {
if (result.success) {
const outputPath = join(outputDir, result.filename);
writeFileSync(outputPath, result.content);
console.log(chalk.green(` ✓ ${agent.name}`));
console.log(colors.success(` ✓ ${agent.name}`));
} else {
console.log(chalk.red(` ✗ ${agent.name}`));
console.log(colors.error(` ✗ ${agent.name}`));
}
}
}
console.log();
console.log(chalk.dim('Sync complete'));
console.log(colors.muted('Sync complete'));
return 0;
}
@@ -535,11 +535,11 @@ export class AgentValidateCommand extends Command {
const agents = findAllAgents(searchDirs);
if (agents.length === 0) {
console.log(chalk.yellow('No agents found'));
console.log(colors.warning('No agents found'));
return 0;
}
console.log(chalk.cyan(`Validating ${agents.length} agent(s)...\n`));
console.log(colors.cyan(`Validating ${agents.length} agent(s)...\n`));
for (const agent of agents) {
const result = validateAgent(agent.path);
@@ -547,7 +547,7 @@ export class AgentValidateCommand extends Command {
if (!result.valid) hasErrors = true;
}
} else {
console.log(chalk.yellow('Specify a path or use --all to validate all agents'));
console.log(colors.warning('Specify a path or use --all to validate all agents'));
return 1;
}
@@ -556,10 +556,10 @@ export class AgentValidateCommand extends Command {
}
function printAgent(agent: CustomAgent): void {
const status = agent.enabled ? chalk.green('✓') : chalk.red('○');
const name = agent.enabled ? agent.name : chalk.dim(agent.name);
const model = agent.frontmatter.model ? chalk.blue(`[${agent.frontmatter.model}]`) : '';
const desc = chalk.dim(truncate(agent.description, 40));
const status = agent.enabled ? colors.success('✓') : colors.error('○');
const name = agent.enabled ? agent.name : colors.muted(agent.name);
const model = agent.frontmatter.model ? colors.info(`[${agent.frontmatter.model}]`) : '';
const desc = colors.muted(truncate(agent.description, 40));
console.log(` ${status} ${name} ${model}`);
if (agent.description) {
@@ -572,17 +572,17 @@ function printValidationResult(
result: { valid: boolean; errors: string[]; warnings: string[] }
): void {
if (result.valid) {
console.log(chalk.green(`✓ ${name}`));
console.log(colors.success(`✓ ${name}`));
for (const warning of result.warnings) {
console.log(chalk.yellow(` ⚠ ${warning}`));
console.log(colors.warning(` ⚠ ${warning}`));
}
} else {
console.log(chalk.red(`✗ ${name}`));
for (const error of result.errors) {
console.log(chalk.red(` • ${error}`));
console.log(colors.error(`✗ ${name}`));
for (const err of result.errors) {
console.log(colors.error(` • ${err}`));
}
for (const warning of result.warnings) {
console.log(chalk.yellow(` ⚠ ${warning}`));
console.log(colors.warning(` ⚠ ${warning}`));
}
}
}
@@ -671,15 +671,15 @@ export class AgentInstallCommand extends Command {
}
if (!this.name) {
console.log(chalk.yellow('Please specify an agent name or use --all'));
console.log(chalk.dim('Run `skillkit agent available` to see available agents'));
console.log(colors.warning('Please specify an agent name or use --all'));
console.log(colors.muted('Run `skillkit agent available` to see available agents'));
return 1;
}
const agent = getBundledAgent(this.name);
if (!agent) {
console.log(chalk.red(`Bundled agent not found: ${this.name}`));
console.log(chalk.dim('Run `skillkit agent available` to see available agents'));
console.log(colors.error(`Bundled agent not found: ${this.name}`));
console.log(colors.muted('Run `skillkit agent available` to see available agents'));
return 1;
}
@@ -689,11 +689,11 @@ export class AgentInstallCommand extends Command {
});
if (result.success) {
console.log(chalk.green(`✓ Installed: ${agent.name}`));
console.log(chalk.dim(` Path: ${result.path}`));
console.log(chalk.dim(` Invoke with: @${agent.id}`));
console.log(colors.success(`✓ Installed: ${agent.name}`));
console.log(colors.muted(` Path: ${result.path}`));
console.log(colors.muted(` Invoke with: @${agent.id}`));
} else {
console.log(chalk.red(`✗ Failed: ${result.message}`));
console.log(colors.error(`✗ Failed: ${result.message}`));
return 1;
}
@@ -702,7 +702,7 @@ export class AgentInstallCommand extends Command {
private async installAll(): Promise<number> {
const agents = getBundledAgents();
console.log(chalk.cyan(`Installing ${agents.length} bundled agents...\n`));
console.log(colors.cyan(`Installing ${agents.length} bundled agents...\n`));
let successCount = 0;
let skipCount = 0;
@@ -715,20 +715,20 @@ export class AgentInstallCommand extends Command {
});
if (result.success) {
console.log(chalk.green(` ✓ ${agent.name}`));
console.log(colors.success(` ✓ ${agent.name}`));
successCount++;
} else if (result.message.includes('already exists')) {
console.log(chalk.yellow(` ○ ${agent.name} (already installed)`));
console.log(colors.warning(` ○ ${agent.name} (already installed)`));
skipCount++;
} else {
console.log(chalk.red(` ✗ ${agent.name}: ${result.message}`));
console.log(colors.error(` ✗ ${agent.name}: ${result.message}`));
errorCount++;
}
}
console.log();
console.log(
chalk.dim(
colors.muted(
`Installed: ${successCount}, Skipped: ${skipCount}, Errors: ${errorCount}`
)
);
@@ -781,10 +781,10 @@ export class AgentAvailableCommand extends Command {
if (agents.length === 0) {
if (this.installed) {
console.log(chalk.yellow('No bundled agents installed'));
console.log(chalk.dim('Run `skillkit agent install <name>` to install'));
console.log(colors.warning('No bundled agents installed'));
console.log(colors.muted('Run `skillkit agent install <name>` to install'));
} else {
console.log(chalk.green('All bundled agents are already installed!'));
console.log(colors.success('All bundled agents are already installed!'));
}
return 0;
}
@@ -793,7 +793,7 @@ export class AgentAvailableCommand extends Command {
? 'Installed Bundled Agents'
: 'Available Bundled Agents';
console.log(chalk.cyan(`${title} (${agents.length}):\n`));
console.log(colors.cyan(`${title} (${agents.length}):\n`));
const categories = new Map<string, BundledAgent[]>();
for (const agent of agents) {
@@ -805,20 +805,20 @@ export class AgentAvailableCommand extends Command {
}
for (const [category, catAgents] of categories) {
console.log(chalk.blue(` ${formatCategoryName(category)}`));
console.log(colors.info(` ${formatCategoryName(category)}`));
for (const agent of catAgents) {
const installed = isAgentInstalled(agent.id);
const status = installed ? chalk.green('✓') : chalk.dim('○');
const model = agent.model ? chalk.blue(`[${agent.model}]`) : '';
console.log(` ${status} ${chalk.bold(agent.id)} ${model}`);
console.log(` ${chalk.dim(agent.description)}`);
const status = installed ? colors.success('✓') : colors.muted('○');
const model = agent.model ? colors.info(`[${agent.model}]`) : '';
console.log(` ${status} ${colors.bold(agent.id)} ${model}`);
console.log(` ${colors.muted(agent.description)}`);
}
console.log();
}
if (!this.installed) {
console.log(chalk.dim('Install with: skillkit agent install <name>'));
console.log(chalk.dim('Install all: skillkit agent install --all'));
console.log(colors.muted('Install with: skillkit agent install <name>'));
console.log(colors.muted('Install all: skillkit agent install --all'));
}
return 0;
@@ -877,20 +877,20 @@ export class AgentFromSkillCommand extends Command {
const skill = skills.find((s: Skill) => s.name === this.skillName);
if (!skill) {
console.log(chalk.red(`Skill not found: ${this.skillName}`));
console.log(chalk.dim('Available skills:'));
console.log(colors.error(`Skill not found: ${this.skillName}`));
console.log(colors.muted('Available skills:'));
for (const s of skills.slice(0, 10)) {
console.log(chalk.dim(` - ${s.name}`));
console.log(colors.muted(` - ${s.name}`));
}
if (skills.length > 10) {
console.log(chalk.dim(` ... and ${skills.length - 10} more`));
console.log(colors.muted(` ... and ${skills.length - 10} more`));
}
return 1;
}
const skillContent = readSkillContent(skill.path);
if (!skillContent) {
console.log(chalk.red(`Could not read skill content: ${skill.path}`));
console.log(colors.error(`Could not read skill content: ${skill.path}`));
return 1;
}
@@ -901,8 +901,8 @@ export class AgentFromSkillCommand extends Command {
if (this.model) {
const validModels = ['sonnet', 'opus', 'haiku', 'inherit'];
if (!validModels.includes(this.model)) {
console.log(chalk.red(`Invalid model: ${this.model}`));
console.log(chalk.dim(`Valid options: ${validModels.join(', ')}`));
console.log(colors.error(`Invalid model: ${this.model}`));
console.log(colors.muted(`Valid options: ${validModels.join(', ')}`));
return 1;
}
options.model = this.model as 'sonnet' | 'opus' | 'haiku' | 'inherit';
@@ -911,8 +911,8 @@ export class AgentFromSkillCommand extends Command {
if (this.permission) {
const validModes = ['default', 'plan', 'auto-edit', 'full-auto', 'bypassPermissions'];
if (!validModes.includes(this.permission)) {
console.log(chalk.red(`Invalid permission mode: ${this.permission}`));
console.log(chalk.dim(`Valid options: ${validModes.join(', ')}`));
console.log(colors.error(`Invalid permission mode: ${this.permission}`));
console.log(colors.muted(`Valid options: ${validModes.join(', ')}`));
return 1;
}
options.permissionMode = this.permission as AgentPermissionMode;
@@ -928,16 +928,16 @@ export class AgentFromSkillCommand extends Command {
if (this.output) {
const sanitized = sanitizeFilename(this.output);
if (!sanitized) {
console.log(chalk.red(`Invalid output filename: ${this.output}`));
console.log(chalk.dim('Filename must contain only alphanumeric characters, hyphens, and underscores'));
console.log(colors.error(`Invalid output filename: ${this.output}`));
console.log(colors.muted('Filename must contain only alphanumeric characters, hyphens, and underscores'));
return 1;
}
filename = `${sanitized}.md`;
} else {
const sanitized = sanitizeFilename(skill.name);
if (!sanitized) {
console.log(chalk.red(`Invalid skill name for filename: ${skill.name}`));
console.log(chalk.dim('Skill name must contain only alphanumeric characters, hyphens, and underscores'));
console.log(colors.error(`Invalid skill name for filename: ${skill.name}`));
console.log(colors.muted('Skill name must contain only alphanumeric characters, hyphens, and underscores'));
return 1;
}
filename = `${sanitized}.md`;
@@ -946,11 +946,11 @@ export class AgentFromSkillCommand extends Command {
const outputPath = join(targetDir, filename);
if (this.dryRun) {
console.log(chalk.cyan('Preview (dry run):\n'));
console.log(chalk.dim(`Would write to: ${outputPath}`));
console.log(chalk.dim('─'.repeat(50)));
console.log(colors.cyan('Preview (dry run):\n'));
console.log(colors.muted(`Would write to: ${outputPath}`));
console.log(colors.muted('─'.repeat(50)));
console.log(content);
console.log(chalk.dim('─'.repeat(50)));
console.log(colors.muted('─'.repeat(50)));
return 0;
}
@@ -959,18 +959,18 @@ export class AgentFromSkillCommand extends Command {
}
if (existsSync(outputPath)) {
console.log(chalk.yellow(`Overwriting existing file: ${outputPath}`));
console.log(colors.warning(`Overwriting existing file: ${outputPath}`));
}
writeFileSync(outputPath, content);
console.log(chalk.green(`Created subagent: ${outputPath}`));
console.log(colors.success(`Created subagent: ${outputPath}`));
console.log();
console.log(chalk.dim(`Invoke with: @${skill.name}`));
console.log(colors.muted(`Invoke with: @${skill.name}`));
if (!this.inline) {
console.log(chalk.dim(`Skills referenced: ${skill.name}`));
console.log(colors.muted(`Skills referenced: ${skill.name}`));
} else {
console.log(chalk.dim('Skill content embedded inline'));
console.log(colors.muted('Skill content embedded inline'));
}
return 0;
+10 -10
View File
@@ -1,6 +1,6 @@
import { existsSync, readFileSync, writeFileSync } from 'node:fs';
import { join } from 'node:path';
import chalk from 'chalk';
import { colors, warn, success, error } from '../onboarding/index.js';
import { Command } from 'clipanion';
import { AgentsMdGenerator, AgentsMdParser } from '@skillkit/core';
@@ -40,7 +40,7 @@ export class AgentsMdInitCommand extends Command {
const agentsPath = join(projectPath, 'AGENTS.md');
if (existsSync(agentsPath)) {
console.log(chalk.yellow('AGENTS.md already exists. Use `skillkit agents sync` to update.'));
warn('AGENTS.md already exists. Use `skillkit agents sync` to update.');
return 1;
}
@@ -48,15 +48,15 @@ export class AgentsMdInitCommand extends Command {
const generator = new AgentsMdGenerator({ projectPath });
const result = generator.generate();
console.log(chalk.dim('Preview:'));
console.log(colors.muted('Preview:'));
console.log('');
console.log(result.content);
writeFileSync(agentsPath, result.content, 'utf-8');
console.log(chalk.green(`Created ${agentsPath}`));
success(`Created ${agentsPath}`);
return 0;
} catch (err) {
console.log(chalk.red(`Failed to generate AGENTS.md: ${err instanceof Error ? err.message : String(err)}`));
error(`Failed to generate AGENTS.md: ${err instanceof Error ? err.message : String(err)}`);
return 1;
}
}
@@ -74,7 +74,7 @@ export class AgentsMdSyncCommand extends Command {
const agentsPath = join(projectPath, 'AGENTS.md');
if (!existsSync(agentsPath)) {
console.log(chalk.yellow('No AGENTS.md found. Run `skillkit agents init` first.'));
warn('No AGENTS.md found. Run `skillkit agents init` first.');
return 1;
}
@@ -83,7 +83,7 @@ export class AgentsMdSyncCommand extends Command {
const parser = new AgentsMdParser();
if (!parser.hasManagedSections(existing)) {
console.log(chalk.yellow('No managed sections found in AGENTS.md. Nothing to update.'));
warn('No managed sections found in AGENTS.md. Nothing to update.');
return 0;
}
@@ -93,10 +93,10 @@ export class AgentsMdSyncCommand extends Command {
const updated = parser.updateManagedSections(existing, managedSections);
writeFileSync(agentsPath, updated, 'utf-8');
console.log(chalk.green(`Updated ${managedSections.length} managed section(s) in AGENTS.md`));
success(`Updated ${managedSections.length} managed section(s) in AGENTS.md`);
return 0;
} catch (err) {
console.log(chalk.red(`Failed to sync AGENTS.md: ${err instanceof Error ? err.message : String(err)}`));
error(`Failed to sync AGENTS.md: ${err instanceof Error ? err.message : String(err)}`);
return 1;
}
}
@@ -113,7 +113,7 @@ export class AgentsMdShowCommand extends Command {
const agentsPath = join(process.cwd(), 'AGENTS.md');
if (!existsSync(agentsPath)) {
console.log(chalk.yellow('No AGENTS.md found. Run `skillkit agents init` to create one.'));
warn('No AGENTS.md found. Run `skillkit agents init` to create one.');
return 1;
}
+65 -63
View File
@@ -1,8 +1,7 @@
import { Command, Option } from 'clipanion';
import { resolve } from 'node:path';
import { promises as fs } from 'fs';
import chalk from 'chalk';
import ora from 'ora';
import { colors, spinner } from '../onboarding/index.js';
import {
type SearchableSkill,
type SkillExample,
@@ -88,7 +87,7 @@ export class AICommand extends Command {
const providerName = manager.getProviderName();
if (providerName === 'mock') {
console.log(
chalk.yellow(
colors.warning(
'⚠ Using mock AI provider (limited functionality)\n' +
' Set ANTHROPIC_API_KEY or OPENAI_API_KEY for real AI features\n'
)
@@ -110,7 +109,7 @@ export class AICommand extends Command {
return this.handleProviders();
default:
console.error(
chalk.red(`Unknown subcommand: ${this.subcommand}\n`)
colors.error(`Unknown subcommand: ${this.subcommand}\n`)
);
console.log('Valid subcommands: search, generate, similar, wizard, providers');
return 1;
@@ -120,19 +119,20 @@ export class AICommand extends Command {
private async handleSearch(manager: AIManager): Promise<number> {
const query = this.query || this.skillName;
if (!query) {
console.error(chalk.red('Search query required (--query or positional argument)'));
console.error(colors.error('Search query required (--query or positional argument)'));
return 1;
}
const skills = await this.loadSkills();
if (skills.length === 0) {
console.log(
chalk.yellow('No skills found. Run "skillkit recommend --update" first.')
colors.warning('No skills found. Run "skillkit recommend --update" first.')
);
return 0;
}
const spinner = ora('Searching with AI...').start();
const s = spinner();
s.start('Searching with AI...');
try {
const results = await manager.searchSkills(query, skills, {
@@ -143,7 +143,7 @@ export class AICommand extends Command {
includeReasoning: !this.json,
});
spinner.stop();
s.stop();
if (this.json) {
console.log(JSON.stringify(results, null, 2));
@@ -151,37 +151,37 @@ export class AICommand extends Command {
}
if (results.length === 0) {
console.log(chalk.yellow(`No skills found matching "${query}"`));
console.log(colors.warning(`No skills found matching "${query}"`));
return 0;
}
console.log(chalk.cyan(`\nAI Search Results (${results.length} found):\n`));
console.log(colors.cyan(`\nAI Search Results (${results.length} found):\n`));
for (const result of results) {
const score = Math.round(result.relevance * 100);
const scoreColor =
score >= 70 ? chalk.green : score >= 50 ? chalk.yellow : chalk.dim;
score >= 70 ? colors.success : score >= 50 ? colors.warning : colors.muted;
console.log(
` ${scoreColor(`${score}%`)} ${chalk.bold(result.skill.name)}`
` ${scoreColor(`${score}%`)} ${colors.bold(result.skill.name)}`
);
if (result.skill.description) {
console.log(` ${chalk.dim(result.skill.description)}`);
console.log(` ${colors.muted(result.skill.description)}`);
}
if (result.reasoning) {
console.log(` ${chalk.dim('→ ' + result.reasoning)}`);
console.log(` ${colors.muted('→ ' + result.reasoning)}`);
}
console.log();
}
return 0;
} catch (error) {
spinner.fail('Search failed');
} catch (err) {
s.stop(colors.error('Search failed'));
console.error(
chalk.red(error instanceof Error ? error.message : String(error))
colors.error(err instanceof Error ? err.message : String(err))
);
return 1;
}
@@ -190,7 +190,7 @@ export class AICommand extends Command {
private async handleGenerate(manager: AIManager): Promise<number> {
const description = this.description;
if (!description) {
console.error(chalk.red('Description required (--description)'));
console.error(colors.error('Description required (--description)'));
return 1;
}
@@ -201,7 +201,7 @@ export class AICommand extends Command {
const code = await fs.readFile(codePath, 'utf-8');
codeExamples = [code];
} catch {
console.error(chalk.red(`Failed to read code file: ${codePath}`));
console.error(colors.error(`Failed to read code file: ${codePath}`));
return 1;
}
}
@@ -213,7 +213,8 @@ export class AICommand extends Command {
targetAgent: this.targetAgent,
};
const spinner = ora('Generating skill with AI...').start();
const s = spinner();
s.start('Generating skill with AI...');
try {
const generated = await manager.generateSkill(example, {
@@ -222,13 +223,13 @@ export class AICommand extends Command {
includeDocumentation: true,
});
spinner.stop();
s.stop();
const validation = manager.validateGenerated(generated);
if (!validation.valid) {
console.log(chalk.yellow('\n⚠ Generated skill has validation warnings:'));
for (const error of validation.errors) {
console.log(chalk.dim(` • ${error}`));
console.log(colors.warning('\n⚠ Generated skill has validation warnings:'));
for (const err of validation.errors) {
console.log(colors.muted(` • ${err}`));
}
console.log();
}
@@ -238,41 +239,41 @@ export class AICommand extends Command {
return 0;
}
console.log(chalk.green('\n✓ Generated skill successfully\n'));
console.log(chalk.cyan('Name:') + ` ${generated.name}`);
console.log(chalk.cyan('Description:') + ` ${generated.description}`);
console.log(colors.success('\n✓ Generated skill successfully\n'));
console.log(colors.cyan('Name:') + ` ${generated.name}`);
console.log(colors.cyan('Description:') + ` ${generated.description}`);
console.log(
chalk.cyan('Tags:') + ` ${generated.tags.join(', ')}`
colors.cyan('Tags:') + ` ${generated.tags.join(', ')}`
);
console.log(
chalk.cyan('Confidence:') +
colors.cyan('Confidence:') +
` ${Math.round(generated.confidence * 100)}%`
);
if (generated.reasoning) {
console.log(chalk.cyan('Reasoning:') + ` ${generated.reasoning}`);
console.log(colors.cyan('Reasoning:') + ` ${generated.reasoning}`);
}
console.log('\n' + chalk.dim('Content:'));
console.log(chalk.dim('─'.repeat(60)));
console.log('\n' + colors.muted('Content:'));
console.log(colors.muted('─'.repeat(60)));
console.log(generated.content);
console.log(chalk.dim('─'.repeat(60)));
console.log(colors.muted('─'.repeat(60)));
if (this.output) {
const outputPath = resolve(this.output);
await fs.writeFile(outputPath, generated.content, 'utf-8');
console.log(chalk.green(`\n✓ Saved to: ${outputPath}`));
console.log(colors.success(`\n✓ Saved to: ${outputPath}`));
} else {
console.log(
chalk.dim('\nSave with: --output <filename>')
colors.muted('\nSave with: --output <filename>')
);
}
return 0;
} catch (error) {
spinner.fail('Generation failed');
} catch (err) {
s.stop(colors.error('Generation failed'));
console.error(
chalk.red(error instanceof Error ? error.message : String(error))
colors.error(err instanceof Error ? err.message : String(err))
);
return 1;
}
@@ -281,14 +282,14 @@ export class AICommand extends Command {
private async handleSimilar(manager: AIManager): Promise<number> {
const skillName = this.skillName;
if (!skillName) {
console.error(chalk.red('Skill name required'));
console.error(colors.error('Skill name required'));
return 1;
}
const skills = await this.loadSkills();
if (skills.length === 0) {
console.log(
chalk.yellow('No skills found. Run "skillkit recommend --update" first.')
colors.warning('No skills found. Run "skillkit recommend --update" first.')
);
return 0;
}
@@ -298,11 +299,12 @@ export class AICommand extends Command {
);
if (!targetSkill) {
console.error(chalk.red(`Skill not found: ${skillName}`));
console.error(colors.error(`Skill not found: ${skillName}`));
return 1;
}
const spinner = ora('Finding similar skills...').start();
const s = spinner();
s.start('Finding similar skills...');
try {
const results = await manager.findSimilar(targetSkill, skills, {
@@ -313,7 +315,7 @@ export class AICommand extends Command {
includeReasoning: !this.json,
});
spinner.stop();
s.stop();
if (this.json) {
console.log(JSON.stringify(results, null, 2));
@@ -322,40 +324,40 @@ export class AICommand extends Command {
if (results.length === 0) {
console.log(
chalk.yellow(`No similar skills found for "${skillName}"`)
colors.warning(`No similar skills found for "${skillName}"`)
);
return 0;
}
console.log(
chalk.cyan(`\nSkills similar to "${skillName}" (${results.length} found):\n`)
colors.cyan(`\nSkills similar to "${skillName}" (${results.length} found):\n`)
);
for (const result of results) {
const score = Math.round(result.relevance * 100);
const scoreColor =
score >= 70 ? chalk.green : score >= 50 ? chalk.yellow : chalk.dim;
score >= 70 ? colors.success : score >= 50 ? colors.warning : colors.muted;
console.log(
` ${scoreColor(`${score}%`)} ${chalk.bold(result.skill.name)}`
` ${scoreColor(`${score}%`)} ${colors.bold(result.skill.name)}`
);
if (result.skill.description) {
console.log(` ${chalk.dim(result.skill.description)}`);
console.log(` ${colors.muted(result.skill.description)}`);
}
if (result.reasoning) {
console.log(` ${chalk.dim('→ ' + result.reasoning)}`);
console.log(` ${colors.muted('→ ' + result.reasoning)}`);
}
console.log();
}
return 0;
} catch (error) {
spinner.fail('Search failed');
} catch (err) {
s.stop(colors.error('Search failed'));
console.error(
chalk.red(error instanceof Error ? error.message : String(error))
colors.error(err instanceof Error ? err.message : String(err))
);
return 1;
}
@@ -377,8 +379,8 @@ export class AICommand extends Command {
}
private async handleWizard(): Promise<number> {
console.log(chalk.cyan('\nLaunching Smart Generate Wizard...\n'));
console.log(chalk.dim('For the full wizard experience, use: skillkit generate\n'));
console.log(colors.cyan('\nLaunching Smart Generate Wizard...\n'));
console.log(colors.muted('For the full wizard experience, use: skillkit generate\n'));
const { GenerateCommand } = await import('./generate.js');
const generateCmd = new GenerateCommand();
@@ -389,31 +391,31 @@ export class AICommand extends Command {
const detected = detectProviders();
const defaultProvider = getDefaultProvider();
console.log(chalk.cyan('\nAvailable LLM Providers:\n'));
console.log(colors.cyan('\nAvailable LLM Providers:\n'));
for (const provider of detected) {
const isDefault = provider.provider === defaultProvider;
const status = provider.configured
? chalk.green('✓ Configured')
: chalk.dim('○ Not configured');
const defaultBadge = isDefault ? chalk.yellow(' (default)') : '';
? colors.success('✓ Configured')
: colors.muted('○ Not configured');
const defaultBadge = isDefault ? colors.warning(' (default)') : '';
console.log(` ${provider.displayName}${defaultBadge}`);
console.log(` ${status}`);
if (provider.envVar) {
console.log(` ${chalk.dim(`Set ${provider.envVar} to configure`)}`);
console.log(` ${colors.muted(`Set ${provider.envVar} to configure`)}`);
}
console.log();
}
if (defaultProvider === 'mock') {
console.log(` Mock Provider${chalk.yellow(' (default)')}`);
console.log(` ${chalk.green('✓ Always available')}`);
console.log(` ${chalk.dim('Basic functionality without API keys')}`);
console.log(` Mock Provider${colors.warning(' (default)')}`);
console.log(` ${colors.success('✓ Always available')}`);
console.log(` ${colors.muted('Basic functionality without API keys')}`);
console.log();
}
console.log(chalk.dim('Use "skillkit generate --provider <name>" to use a specific provider\n'));
console.log(colors.muted('Use "skillkit generate --provider <name>" to use a specific provider\n'));
return 0;
}
+25 -29
View File
@@ -2,7 +2,7 @@ import { Command, Option } from 'clipanion';
import { resolve } from 'node:path';
import { promises as fs } from 'fs';
import path from 'path';
import chalk from 'chalk';
import { colors, warn, success } from '../onboarding/index.js';
import { AuditLogger, type AuditQuery, type AuditEventType } from '@skillkit/core';
export class AuditCommand extends Command {
@@ -104,7 +104,7 @@ export class AuditCommand extends Command {
case 'clear':
return await this.handleClear(logger);
default:
console.error(chalk.red(`Unknown subcommand: ${this.subcommand}\n`));
console.error(colors.error(`Unknown subcommand: ${this.subcommand}\n`));
console.log('Valid subcommands: log, export, stats, clear');
return 1;
}
@@ -123,37 +123,37 @@ export class AuditCommand extends Command {
}
if (events.length === 0) {
console.log(chalk.yellow('No audit events found'));
warn('No audit events found');
return 0;
}
console.log(chalk.cyan(`\nAudit Log (${events.length} entries):\n`));
console.log(colors.cyan(`\nAudit Log (${events.length} entries):\n`));
for (const event of events) {
const statusIcon = event.success ? chalk.green('✓') : chalk.red('✗');
const statusIcon = event.success ? colors.success('✓') : colors.error('✗');
const timestamp = event.timestamp.toLocaleString();
console.log(
`${statusIcon} ${chalk.dim(timestamp)} ${chalk.bold(event.type)}`
`${statusIcon} ${colors.muted(timestamp)} ${colors.bold(event.type)}`
);
console.log(
` ${event.action} on ${chalk.cyan(event.resource)}`
` ${event.action} on ${colors.cyan(event.resource)}`
);
if (event.user) {
console.log(` ${chalk.dim('User:')} ${event.user}`);
console.log(` ${colors.muted('User:')} ${event.user}`);
}
if (event.duration) {
console.log(` ${chalk.dim('Duration:')} ${event.duration}ms`);
console.log(` ${colors.muted('Duration:')} ${event.duration}ms`);
}
if (event.error) {
console.log(` ${chalk.red('Error:')} ${event.error}`);
console.log(` ${colors.error('Error:')} ${event.error}`);
}
if (event.details && Object.keys(event.details).length > 0) {
console.log(` ${chalk.dim('Details:')} ${JSON.stringify(event.details)}`);
console.log(` ${colors.muted('Details:')} ${JSON.stringify(event.details)}`);
}
console.log();
@@ -171,7 +171,7 @@ export class AuditCommand extends Command {
if (this.output) {
const outputPath = resolve(this.output);
await fs.writeFile(outputPath, content, 'utf-8');
console.log(chalk.green(`✓ Exported audit log to: ${outputPath}`));
success(`✓ Exported audit log to: ${outputPath}`);
} else {
console.log(content);
}
@@ -187,14 +187,14 @@ export class AuditCommand extends Command {
return 0;
}
console.log(chalk.cyan('\nAudit Statistics:\n'));
console.log(`Total Events: ${chalk.bold(stats.totalEvents.toString())}`);
console.log(colors.cyan('\nAudit Statistics:\n'));
console.log(`Total Events: ${colors.bold(stats.totalEvents.toString())}`);
console.log(
`Success Rate: ${chalk.bold(`${(stats.successRate * 100).toFixed(1)}%`)}`
`Success Rate: ${colors.bold(`${(stats.successRate * 100).toFixed(1)}%`)}`
);
if (Object.keys(stats.eventsByType).length > 0) {
console.log(chalk.cyan('\nEvents by Type:'));
console.log(colors.cyan('\nEvents by Type:'));
const sorted = Object.entries(stats.eventsByType).sort(
([, a], [, b]) => b - a
);
@@ -204,21 +204,21 @@ export class AuditCommand extends Command {
}
if (stats.topResources.length > 0) {
console.log(chalk.cyan('\nTop Resources:'));
console.log(colors.cyan('\nTop Resources:'));
for (const { resource, count } of stats.topResources) {
console.log(` ${resource.padEnd(40)} ${count}`);
}
}
if (stats.recentErrors.length > 0) {
console.log(chalk.cyan(`\nRecent Errors (${stats.recentErrors.length}):`));
for (const error of stats.recentErrors.slice(0, 5)) {
const timestamp = error.timestamp.toLocaleString();
console.log(colors.cyan(`\nRecent Errors (${stats.recentErrors.length}):`));
for (const err of stats.recentErrors.slice(0, 5)) {
const timestamp = err.timestamp.toLocaleString();
console.log(
` ${chalk.red('✗')} ${chalk.dim(timestamp)} ${error.type}`
` ${colors.error('✗')} ${colors.muted(timestamp)} ${err.type}`
);
if (error.error) {
console.log(` ${chalk.dim(error.error)}`);
if (err.error) {
console.log(` ${colors.muted(err.error)}`);
}
}
}
@@ -229,7 +229,7 @@ export class AuditCommand extends Command {
private async handleClear(logger: AuditLogger): Promise<number> {
if (!this.days) {
console.error(chalk.red('--days option required'));
console.error(colors.error('--days option required'));
return 1;
}
@@ -239,11 +239,7 @@ export class AuditCommand extends Command {
const cleared = await logger.clear(cutoffDate);
console.log(
chalk.green(
`✓ Cleared ${cleared} audit entries older than ${daysAgo} days`
)
);
success(`✓ Cleared ${cleared} audit entries older than ${daysAgo} days`);
return 0;
}
+9 -9
View File
@@ -1,5 +1,5 @@
import { Command, Option } from 'clipanion';
import chalk from 'chalk';
import { colors } from '../onboarding/index.js';
import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'node:fs';
import { join } from 'node:path';
@@ -247,7 +247,7 @@ export class CICDCommand extends Command {
? ['github', 'gitlab', 'circleci']
: [this.provider as CICDProvider];
console.log(chalk.cyan('Initializing CI/CD workflows...'));
console.log(colors.cyan('Initializing CI/CD workflows...'));
console.log();
let success = true;
@@ -256,29 +256,29 @@ export class CICDCommand extends Command {
for (const provider of providers) {
const result = this.createWorkflow(projectPath, provider);
if (result.skipped) {
console.log(chalk.yellow(` ${result.message}`));
console.log(colors.warning(` ${result.message}`));
continue;
}
if (!result.success) {
success = false;
console.error(chalk.red(` ${result.message}`));
console.error(colors.error(` ${result.message}`));
continue;
}
created = true;
console.log(chalk.green(` ✓ ${result.message}`));
console.log(colors.success(` ✓ ${result.message}`));
}
if (success) {
console.log();
console.log(
created
? chalk.green('CI/CD workflows initialized successfully!')
: chalk.yellow('CI/CD workflows already exist; nothing to do.')
? colors.success('CI/CD workflows initialized successfully!')
: colors.warning('CI/CD workflows already exist; nothing to do.')
);
console.log();
if (created) {
console.log(chalk.dim('The workflows will run on push/PR to validate your skills.'));
console.log(chalk.dim('Commit the generated files to enable CI/CD.'));
console.log(colors.muted('The workflows will run on push/PR to validate your skills.'));
console.log(colors.muted('Commit the generated files to enable CI/CD.'));
}
}
+60 -62
View File
@@ -1,7 +1,7 @@
import { Command, Option } from 'clipanion';
import { existsSync, readFileSync, writeFileSync } from 'node:fs';
import { resolve } from 'node:path';
import chalk from 'chalk';
import { colors } from '../onboarding/index.js';
import {
type AgentType,
type ProjectContext,
@@ -103,8 +103,8 @@ export class ContextCommand extends Command {
case 'agents':
return this.listAgents();
default:
console.error(chalk.red(`Unknown action: ${action}`));
console.log(chalk.gray('Available actions: init, show, export, import, sync, detect, agents'));
console.error(colors.error(`Unknown action: ${action}`));
console.log(colors.muted('Available actions: init, show, export, import, sync, detect, agents'));
return 1;
}
}
@@ -116,16 +116,16 @@ export class ContextCommand extends Command {
const manager = new ContextManager(process.cwd());
if (manager.exists() && !this.force) {
console.log(chalk.yellow('Context already exists. Use --force to reinitialize.'));
console.log(colors.warning('Context already exists. Use --force to reinitialize.'));
return this.showContext();
}
console.log(chalk.cyan('Initializing project context...\n'));
console.log(colors.cyan('Initializing project context...\n'));
const context = manager.init({ force: this.force });
console.log(chalk.green('✓ Context initialized\n'));
console.log(chalk.gray(` Location: .skillkit/context.yaml\n`));
console.log(colors.success('✓ Context initialized\n'));
console.log(colors.muted(` Location: .skillkit/context.yaml\n`));
// Show summary
this.printContextSummary(context);
@@ -134,9 +134,9 @@ export class ContextCommand extends Command {
const sync = createContextSync(process.cwd());
const detected = sync.detectAgents();
if (detected.length > 0) {
console.log(chalk.cyan('\nDetected agents:'));
console.log(colors.cyan('\nDetected agents:'));
for (const agent of detected) {
console.log(` ${chalk.green('•')} ${agent}`);
console.log(` ${colors.success('•')} ${agent}`);
}
// Update context with detected agents
@@ -146,7 +146,7 @@ export class ContextCommand extends Command {
});
}
console.log(chalk.gray('\nRun `skillkit context sync` to sync skills to all agents.'));
console.log(colors.muted('\nRun `skillkit context sync` to sync skills to all agents.'));
return 0;
}
@@ -159,7 +159,7 @@ export class ContextCommand extends Command {
const context = manager.load();
if (!context) {
console.log(chalk.yellow('No context found. Run `skillkit context init` first.'));
console.log(colors.warning('No context found. Run `skillkit context init` first.'));
return 1;
}
@@ -171,8 +171,8 @@ export class ContextCommand extends Command {
this.printContextSummary(context);
if (this.verbose) {
console.log(chalk.gray('\nFull context:'));
console.log(chalk.gray(JSON.stringify(context, null, 2)));
console.log(colors.muted('\nFull context:'));
console.log(colors.muted(JSON.stringify(context, null, 2)));
}
return 0;
@@ -186,7 +186,7 @@ export class ContextCommand extends Command {
const context = manager.get();
if (!context) {
console.error(chalk.red('No context found. Run `skillkit context init` first.'));
console.error(colors.error('No context found. Run `skillkit context init` first.'));
return 1;
}
@@ -200,12 +200,12 @@ export class ContextCommand extends Command {
if (this.output) {
const outputPath = resolve(this.output);
if (existsSync(outputPath) && !this.force) {
console.error(chalk.red(`File exists: ${outputPath}. Use --force to overwrite.`));
console.error(colors.error(`File exists: ${outputPath}. Use --force to overwrite.`));
return 1;
}
writeFileSync(outputPath, content, 'utf-8');
console.log(chalk.green(`✓ Context exported to ${outputPath}`));
console.log(colors.success(`✓ Context exported to ${outputPath}`));
} else {
// Print to stdout
console.log(content);
@@ -219,13 +219,13 @@ export class ContextCommand extends Command {
*/
private async importContext(): Promise<number> {
if (!this.input) {
console.error(chalk.red('Error: --input/-i file path is required'));
console.error(colors.error('Error: --input/-i file path is required'));
return 1;
}
const inputPath = resolve(this.input);
if (!existsSync(inputPath)) {
console.error(chalk.red(`File not found: ${inputPath}`));
console.error(colors.error(`File not found: ${inputPath}`));
return 1;
}
@@ -238,11 +238,11 @@ export class ContextCommand extends Command {
overwrite: this.force,
});
console.log(chalk.green('✓ Context imported successfully'));
console.log(colors.success('✓ Context imported successfully'));
this.printContextSummary(context);
return 0;
} catch (error) {
console.error(chalk.red(`Import failed: ${error}`));
console.error(colors.error(`Import failed: ${error}`));
return 1;
}
}
@@ -255,13 +255,13 @@ export class ContextCommand extends Command {
const context = manager.get();
if (!context) {
console.log(chalk.yellow('No context found. Initializing...'));
console.log(colors.warning('No context found. Initializing...'));
manager.init();
}
const sync = createContextSync(process.cwd());
console.log(chalk.cyan('Syncing skills across agents...\n'));
console.log(colors.cyan('Syncing skills across agents...\n'));
// Determine target agents
const agents = this.agent ? [this.agent as AgentType] : undefined;
@@ -274,33 +274,33 @@ export class ContextCommand extends Command {
// Print results
for (const result of report.results) {
const status = result.success ? chalk.green('✓') : chalk.red('✗');
const status = result.success ? colors.success('✓') : colors.error('✗');
console.log(`${status} ${result.agent}: ${result.skillsSynced} synced, ${result.skillsSkipped} skipped`);
if (this.verbose && result.files.length > 0) {
for (const file of result.files) {
console.log(chalk.gray(` → ${file}`));
console.log(colors.muted(` → ${file}`));
}
}
if (result.warnings.length > 0) {
for (const warning of result.warnings) {
console.log(chalk.yellow(` ⚠ ${warning}`));
console.log(colors.warning(` ⚠ ${warning}`));
}
}
if (result.errors.length > 0) {
for (const error of result.errors) {
console.log(chalk.red(` ✗ ${error}`));
console.log(colors.error(` ✗ ${error}`));
}
}
}
console.log();
console.log(chalk.bold(`Summary: ${report.successfulAgents}/${report.totalAgents} agents, ${report.totalSkills} skills`));
console.log(colors.bold(`Summary: ${report.successfulAgents}/${report.totalAgents} agents, ${report.totalSkills} skills`));
if (this.dryRun) {
console.log(chalk.gray('\n(Dry run - no files were written)'));
console.log(colors.muted('\n(Dry run - no files were written)'));
}
return report.successfulAgents === report.totalAgents ? 0 : 1;
@@ -310,86 +310,86 @@ export class ContextCommand extends Command {
* Detect project stack
*/
private async detectProject(): Promise<number> {
console.log(chalk.cyan('Analyzing project...\n'));
console.log(colors.cyan('Analyzing project...\n'));
const stack = analyzeProject(process.cwd());
const tags = getStackTags(stack);
// Languages
if (stack.languages.length > 0) {
console.log(chalk.bold('Languages:'));
console.log(colors.bold('Languages:'));
for (const lang of stack.languages) {
const version = lang.version ? ` (${lang.version})` : '';
console.log(` ${chalk.green('•')} ${lang.name}${version}`);
console.log(` ${colors.success('•')} ${lang.name}${version}`);
}
console.log();
}
// Frameworks
if (stack.frameworks.length > 0) {
console.log(chalk.bold('Frameworks:'));
console.log(colors.bold('Frameworks:'));
for (const fw of stack.frameworks) {
const version = fw.version ? ` (${fw.version})` : '';
console.log(` ${chalk.green('•')} ${fw.name}${version}`);
console.log(` ${colors.success('•')} ${fw.name}${version}`);
}
console.log();
}
// Libraries
if (stack.libraries.length > 0) {
console.log(chalk.bold('Libraries:'));
console.log(colors.bold('Libraries:'));
for (const lib of stack.libraries) {
const version = lib.version ? ` (${lib.version})` : '';
console.log(` ${chalk.green('•')} ${lib.name}${version}`);
console.log(` ${colors.success('•')} ${lib.name}${version}`);
}
console.log();
}
// Styling
if (stack.styling.length > 0) {
console.log(chalk.bold('Styling:'));
console.log(colors.bold('Styling:'));
for (const style of stack.styling) {
console.log(` ${chalk.green('•')} ${style.name}`);
console.log(` ${colors.success('•')} ${style.name}`);
}
console.log();
}
// Testing
if (stack.testing.length > 0) {
console.log(chalk.bold('Testing:'));
console.log(colors.bold('Testing:'));
for (const test of stack.testing) {
console.log(` ${chalk.green('•')} ${test.name}`);
console.log(` ${colors.success('•')} ${test.name}`);
}
console.log();
}
// Databases
if (stack.databases.length > 0) {
console.log(chalk.bold('Databases:'));
console.log(colors.bold('Databases:'));
for (const db of stack.databases) {
console.log(` ${chalk.green('•')} ${db.name}`);
console.log(` ${colors.success('•')} ${db.name}`);
}
console.log();
}
// Tools
if (stack.tools.length > 0) {
console.log(chalk.bold('Tools:'));
console.log(colors.bold('Tools:'));
for (const tool of stack.tools) {
console.log(` ${chalk.green('•')} ${tool.name}`);
console.log(` ${colors.success('•')} ${tool.name}`);
}
console.log();
}
// Tags
if (tags.length > 0) {
console.log(chalk.bold('Recommended skill tags:'));
console.log(` ${chalk.cyan(tags.join(', '))}`);
console.log(colors.bold('Recommended skill tags:'));
console.log(` ${colors.cyan(tags.join(', '))}`);
console.log();
}
if (this.json) {
console.log(chalk.gray('\nJSON:'));
console.log(colors.muted('\nJSON:'));
console.log(JSON.stringify(stack, null, 2));
}
@@ -405,27 +405,27 @@ export class ContextCommand extends Command {
const status = sync.checkStatus();
const adapters = getAllAdapters();
console.log(chalk.bold('\nAgent Status:\n'));
console.log(colors.bold('\nAgent Status:\n'));
for (const [agent, info] of Object.entries(status)) {
const adapter = adapters.find(a => a.type === agent);
const name = adapter?.name || agent;
const isDetected = detected.includes(agent as AgentType);
const statusIcon = info.hasSkills ? chalk.green('●') : isDetected ? chalk.yellow('○') : chalk.gray('○');
const skillInfo = info.skillCount > 0 ? chalk.gray(` (${info.skillCount} skills)`) : '';
const statusIcon = info.hasSkills ? colors.success('●') : isDetected ? colors.warning('○') : colors.muted('○');
const skillInfo = info.skillCount > 0 ? colors.muted(` (${info.skillCount} skills)`) : '';
console.log(` ${statusIcon} ${name.padEnd(20)} ${chalk.gray(agent)}${skillInfo}`);
console.log(` ${statusIcon} ${name.padEnd(20)} ${colors.muted(agent)}${skillInfo}`);
if (this.verbose && info.skills.length > 0) {
for (const skill of info.skills) {
console.log(chalk.gray(` └─ ${skill}`));
console.log(colors.muted(` └─ ${skill}`));
}
}
}
console.log();
console.log(chalk.gray('Legend: ● has skills, ○ detected/configured, ○ not detected'));
console.log(colors.muted('Legend: ● has skills, ○ detected/configured, ○ not detected'));
console.log();
return 0;
@@ -435,8 +435,8 @@ export class ContextCommand extends Command {
* Print context summary
*/
private printContextSummary(context: ProjectContext): void {
console.log(chalk.bold('Project:'));
console.log(` Name: ${chalk.cyan(context.project.name)}`);
console.log(colors.bold('Project:'));
console.log(` Name: ${colors.cyan(context.project.name)}`);
if (context.project.type) {
console.log(` Type: ${context.project.type}`);
}
@@ -460,32 +460,30 @@ export class ContextCommand extends Command {
}
if (stackItems.length > 0) {
console.log(`\n${chalk.bold('Stack:')} ${stackItems.join(', ')}`);
console.log(`\n${colors.bold('Stack:')} ${stackItems.join(', ')}`);
// Show top items
const topFrameworks = context.stack.frameworks.slice(0, 3).map(f => f.name);
if (topFrameworks.length > 0) {
console.log(` Frameworks: ${chalk.cyan(topFrameworks.join(', '))}`);
console.log(` Frameworks: ${colors.cyan(topFrameworks.join(', '))}`);
}
const topLibs = context.stack.libraries.slice(0, 3).map(l => l.name);
if (topLibs.length > 0) {
console.log(` Libraries: ${chalk.cyan(topLibs.join(', '))}`);
console.log(` Libraries: ${colors.cyan(topLibs.join(', '))}`);
}
}
// Skills summary
if (context.skills) {
console.log(`\n${chalk.bold('Skills:')}`);
console.log(`\n${colors.bold('Skills:')}`);
console.log(` Installed: ${context.skills.installed?.length || 0}`);
console.log(` Auto-sync: ${context.skills.autoSync ? 'enabled' : 'disabled'}`);
}
// Agents summary
if (context.agents) {
console.log(`\n${chalk.bold('Agents:')}`);
console.log(`\n${colors.bold('Agents:')}`);
if (context.agents.primary) {
console.log(` Primary: ${chalk.cyan(context.agents.primary)}`);
console.log(` Primary: ${colors.cyan(context.agents.primary)}`);
}
if (context.agents.synced?.length) {
console.log(` Synced: ${context.agents.synced.join(', ')}`);
+18 -18
View File
@@ -1,6 +1,6 @@
import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
import { join } from 'node:path';
import chalk from 'chalk';
import { colors, success, error, step } from '../onboarding/index.js';
import { Command, Option } from 'clipanion';
export class CreateCommand extends Command {
@@ -41,8 +41,8 @@ export class CreateCommand extends Command {
const skillName = this.name.toLowerCase();
if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(skillName)) {
console.error(chalk.red('Invalid skill name'));
console.error(chalk.dim('Must be lowercase alphanumeric with hyphens (e.g., my-skill)'));
error('Invalid skill name');
console.log(colors.muted('Must be lowercase alphanumeric with hyphens (e.g., my-skill)'));
return 1;
}
@@ -50,7 +50,7 @@ export class CreateCommand extends Command {
const skillDir = join(parentDir, skillName);
if (existsSync(skillDir)) {
console.error(chalk.red(`Directory already exists: ${skillDir}`));
error(`Directory already exists: ${skillDir}`);
return 1;
}
@@ -78,24 +78,24 @@ export class CreateCommand extends Command {
writeFileSync(join(assetsDir, '.gitkeep'), '');
}
console.log(chalk.green(`Created skill: ${skillName}`));
success(`Created skill: ${skillName}`);
console.log();
console.log(chalk.dim('Structure:'));
console.log(chalk.dim(` ${skillDir}/`));
console.log(chalk.dim(' ├── SKILL.md'));
if (this.full || this.references) console.log(chalk.dim(' ├── references/'));
if (this.full || this.scripts) console.log(chalk.dim(' ├── scripts/'));
if (this.full || this.assets) console.log(chalk.dim(' └── assets/'));
console.log(colors.muted('Structure:'));
console.log(colors.muted(` ${skillDir}/`));
console.log(colors.muted(' ├── SKILL.md'));
if (this.full || this.references) console.log(colors.muted(' ├── references/'));
if (this.full || this.scripts) console.log(colors.muted(' ├── scripts/'));
if (this.full || this.assets) console.log(colors.muted(' └── assets/'));
console.log();
console.log(chalk.cyan('Next steps:'));
console.log(chalk.dim(' 1. Edit SKILL.md with your instructions'));
console.log(chalk.dim(' 2. Validate: skillkit validate ' + skillDir));
console.log(chalk.dim(' 3. Test: skillkit read ' + skillName));
step('Next steps:');
console.log(colors.muted(' 1. Edit SKILL.md with your instructions'));
console.log(colors.muted(' 2. Validate: skillkit validate ' + skillDir));
console.log(colors.muted(' 3. Test: skillkit read ' + skillName));
return 0;
} catch (error) {
console.error(chalk.red('Failed to create skill'));
console.error(chalk.dim(error instanceof Error ? error.message : String(error)));
} catch (err) {
error('Failed to create skill');
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
return 1;
}
}
+17 -17
View File
@@ -1,4 +1,4 @@
import chalk from 'chalk';
import { colors, warn, success, error } from '../onboarding/index.js';
import { Command, Option } from 'clipanion';
import { setSkillEnabled, findSkill } from '@skillkit/core';
import { getSearchDirs } from '../helpers.js';
@@ -18,36 +18,36 @@ export class EnableCommand extends Command {
async execute(): Promise<number> {
const searchDirs = getSearchDirs();
let success = 0;
let successCount = 0;
let failed = 0;
for (const skillName of this.skills) {
const skill = findSkill(skillName, searchDirs);
if (!skill) {
console.log(chalk.red(`Skill not found: ${skillName}`));
error(`Skill not found: ${skillName}`);
failed++;
continue;
}
if (skill.enabled) {
console.log(chalk.dim(`Already enabled: ${skillName}`));
console.log(colors.muted(`Already enabled: ${skillName}`));
continue;
}
const result = setSkillEnabled(skill.path, true);
if (result) {
console.log(chalk.green(`Enabled: ${skillName}`));
success++;
success(`Enabled: ${skillName}`);
successCount++;
} else {
console.log(chalk.red(`Failed to enable: ${skillName}`));
error(`Failed to enable: ${skillName}`);
failed++;
}
}
if (success > 0) {
console.log(chalk.dim('\nRun `skillkit sync` to update your agent config'));
if (successCount > 0) {
console.log(colors.muted('\nRun `skillkit sync` to update your agent config'));
}
return failed > 0 ? 1 : 0;
@@ -69,36 +69,36 @@ export class DisableCommand extends Command {
async execute(): Promise<number> {
const searchDirs = getSearchDirs();
let success = 0;
let successCount = 0;
let failed = 0;
for (const skillName of this.skills) {
const skill = findSkill(skillName, searchDirs);
if (!skill) {
console.log(chalk.red(`Skill not found: ${skillName}`));
error(`Skill not found: ${skillName}`);
failed++;
continue;
}
if (!skill.enabled) {
console.log(chalk.dim(`Already disabled: ${skillName}`));
console.log(colors.muted(`Already disabled: ${skillName}`));
continue;
}
const result = setSkillEnabled(skill.path, false);
if (result) {
console.log(chalk.yellow(`Disabled: ${skillName}`));
success++;
warn(`Disabled: ${skillName}`);
successCount++;
} else {
console.log(chalk.red(`Failed to disable: ${skillName}`));
error(`Failed to disable: ${skillName}`);
failed++;
}
}
if (success > 0) {
console.log(chalk.dim('\nRun `skillkit sync` to update your agent config'));
if (successCount > 0) {
console.log(colors.muted('\nRun `skillkit sync` to update your agent config'));
}
return failed > 0 ? 1 : 0;
+149
View File
@@ -0,0 +1,149 @@
import { Command, Option } from 'clipanion';
import { resolve } from 'node:path';
import { existsSync } from 'node:fs';
import {
createEvalEngine,
formatEvalResult,
LLMQualityEvaluator,
ContradictionEvaluator,
BehavioralSecurityEvaluator,
SandboxEvaluator,
DynamicBenchmarkEvaluator,
CommunitySignalsEvaluator,
} from '@skillkit/core';
import type { EvalTier, EvalOptions } from '@skillkit/core';
export class EvalCommand extends Command {
static override paths = [['eval']];
static override usage = Command.Usage({
description: 'Evaluate a skill with multi-tier analysis (LLM quality, contradictions, security, benchmarks)',
details: `
Runs a comprehensive evaluation engine across up to 6 tiers:
Tier 1: LLM-based quality scoring (G-Eval pattern)
Tier 2: Contradiction detection (formal + semantic)
Tier 3: Behavioral security analysis (AST + taint + LLM)
Tier 4: Sandbox execution testing (Docker)
Tier 5: Dynamic marketplace benchmarks
Tier 6: Community signals (GitHub, installs, freshness)
Works without API keys (heuristic fallback for Tier 1, Tiers 5-6 always available).
Configure a provider for full LLM-powered evaluation.
`,
examples: [
['Evaluate a skill', '$0 eval ./my-skill'],
['Run specific tiers', '$0 eval ./my-skill --tier 1,2,3'],
['Use Anthropic provider', '$0 eval ./my-skill --provider anthropic'],
['JSON output', '$0 eval ./my-skill --format json'],
['Set minimum score', '$0 eval ./my-skill --min-score 70'],
['Verbose output', '$0 eval ./my-skill --verbose'],
],
});
skillPath = Option.String({ required: true, name: 'path' });
tier = Option.String('--tier,-t', {
description: 'Comma-separated tier numbers to run (1-6). Default: 1,2,3,5,6',
});
provider = Option.String('--provider,-p', {
description: 'LLM provider: anthropic, openai, google, ollama, openrouter',
});
model = Option.String('--model,-m', {
description: 'Model name to use with the provider',
});
format = Option.String('--format,-f', 'summary', {
description: 'Output format: summary, json, table',
});
verbose = Option.Boolean('--verbose,-v', false, {
description: 'Show detailed output for each tier',
});
minScore = Option.String('--min-score', {
description: 'Exit with code 1 if overall score is below this threshold',
});
sandboxImage = Option.String('--sandbox-image', {
description: 'Docker image for sandbox testing (Tier 4)',
});
timeout = Option.String('--timeout', {
description: 'Timeout in seconds for each tier',
});
async execute(): Promise<number> {
const targetPath = resolve(this.skillPath);
if (!existsSync(targetPath)) {
this.context.stderr.write(`Path not found: ${targetPath}\n`);
return 1;
}
const validFormats = ['summary', 'json', 'table'];
if (!validFormats.includes(this.format)) {
this.context.stderr.write(`Invalid format: "${this.format}". Must be one of: ${validFormats.join(', ')}\n`);
return 1;
}
let tiers: EvalTier[] | undefined;
if (this.tier) {
tiers = this.tier.split(',').map((s) => {
const n = parseInt(s.trim(), 10);
if (isNaN(n) || n < 1 || n > 6) {
return null;
}
return n as EvalTier;
}).filter((n): n is EvalTier => n !== null);
if (tiers.length === 0) {
this.context.stderr.write(`Invalid --tier value: "${this.tier}". Must be comma-separated numbers 1-6.\n`);
return 1;
}
}
if (this.minScore) {
const threshold = parseInt(this.minScore, 10);
if (isNaN(threshold)) {
this.context.stderr.write(`Invalid --min-score value: "${this.minScore}". Must be a number.\n`);
return 1;
}
}
const parsedTimeout = this.timeout ? parseInt(this.timeout, 10) : NaN;
const options: EvalOptions = {
tiers,
provider: this.provider,
model: this.model,
format: this.format as 'summary' | 'json' | 'table',
verbose: this.verbose,
sandboxImage: this.sandboxImage,
timeout: !isNaN(parsedTimeout) ? parsedTimeout : undefined,
};
const engine = createEvalEngine();
engine.registerEvaluator(new LLMQualityEvaluator());
engine.registerEvaluator(new ContradictionEvaluator());
engine.registerEvaluator(new BehavioralSecurityEvaluator());
engine.registerEvaluator(new SandboxEvaluator());
engine.registerEvaluator(new DynamicBenchmarkEvaluator());
engine.registerEvaluator(new CommunitySignalsEvaluator());
const result = await engine.evaluate(targetPath, options);
this.context.stdout.write(formatEvalResult(result, this.format) + '\n');
if (this.minScore) {
const threshold = parseInt(this.minScore, 10);
if (result.overallScore < threshold) {
this.context.stderr.write(`Score ${result.overallScore} is below minimum ${threshold}\n`);
return 1;
}
}
return 0;
}
}
+175 -92
View File
@@ -1,4 +1,4 @@
import { Command, Option } from 'clipanion';
import { Command, Option } from "clipanion";
import {
colors,
symbols,
@@ -7,8 +7,13 @@ import {
isCancel,
select,
header,
} from '../onboarding/index.js';
import { FederatedSearch, GitHubSkillRegistry, RateLimitError } from '@skillkit/core';
} from "../onboarding/index.js";
import {
FederatedSearch,
GitHubSkillRegistry,
SkillsShRegistry,
} from "@skillkit/core";
import { formatCount } from "../helpers.js";
interface SkillResult {
name: string;
@@ -17,46 +22,46 @@ interface SkillResult {
repoName: string;
}
import skillsData from '../../../../marketplace/skills.json' with { type: 'json' };
import sourcesData from '../../../../marketplace/sources.json' with { type: 'json' };
import skillsData from "../../../../marketplace/skills.json" with { type: "json" };
import sourcesData from "../../../../marketplace/sources.json" with { type: "json" };
export class FindCommand extends Command {
static override paths = [['find'], ['search']];
static override paths = [["find"], ["search"]];
static override usage = Command.Usage({
description: 'Search for skills in the marketplace',
description: "Search for skills in the marketplace",
details: `
Quickly find and install skills from the marketplace.
Interactive mode lets you browse and install in one step.
`,
examples: [
['Interactive search', '$0 find'],
['Search for specific skill', '$0 find pdf'],
['Search with keyword', '$0 find "nextjs"'],
['List top skills', '$0 find --top'],
["Interactive search", "$0 find"],
["Search for specific skill", "$0 find pdf"],
["Search with keyword", '$0 find "nextjs"'],
["List top skills", "$0 find --top"],
],
});
query = Option.String({ required: false });
top = Option.Boolean('--top,-t', false, {
description: 'Show top/featured skills',
top = Option.Boolean("--top,-t", false, {
description: "Show top/featured skills",
});
limit = Option.String('--limit,-l', '10', {
description: 'Maximum results to show',
limit = Option.String("--limit,-l", "10", {
description: "Maximum results to show",
});
install = Option.Boolean('--install,-i', false, {
description: 'Prompt to install after finding',
install = Option.Boolean("--install,-i", false, {
description: "Prompt to install after finding",
});
quiet = Option.Boolean('--quiet,-q', false, {
description: 'Minimal output (just list skills)',
quiet = Option.Boolean("--quiet,-q", false, {
description: "Minimal output (just list skills)",
});
federated = Option.Boolean('--federated,-f', false, {
description: 'Search external registries (GitHub SKILL.md files)',
federated = Option.Boolean("--federated,-f", false, {
description: "Search external registries (GitHub SKILL.md files)",
});
async execute(): Promise<number> {
@@ -64,17 +69,25 @@ export class FindCommand extends Command {
const limit = parseInt(this.limit, 10) || 10;
if (!this.quiet) {
header('Find Skills');
header("Find Skills");
}
const allSkills: SkillResult[] = (skillsData.skills || []).map((skill: { name: string; description?: string; source?: string; repo?: string }) => ({
name: skill.name,
description: skill.description,
source: skill.source || '',
repoName: skill.repo || skill.source?.split('/').pop() || '',
}));
const allSkills: SkillResult[] = (skillsData.skills || []).map(
(skill: {
name: string;
description?: string;
source?: string;
repo?: string;
}) => ({
name: skill.name,
description: skill.description,
source: skill.source || "",
repoName: skill.repo || skill.source?.split("/").pop() || "",
}),
);
let results: SkillResult[];
let searchTerm: string | undefined;
if (this.top) {
const featured = sourcesData.sources
@@ -82,35 +95,43 @@ export class FindCommand extends Command {
.slice(0, 5);
results = allSkills
.filter(skill => featured.some((f: { source: string }) => skill.source.includes(f.source)))
.filter((skill) =>
featured.some((f: { source: string }) =>
skill.source.includes(f.source),
),
)
.slice(0, limit);
if (!this.quiet) {
step('Showing featured skills');
step("Showing featured skills");
}
} else if (this.query) {
const query = this.query.toLowerCase();
searchTerm = this.query;
s.start('Searching...');
s.start("Searching...");
results = allSkills.filter(skill =>
skill.name.toLowerCase().includes(query) ||
skill.description?.toLowerCase().includes(query) ||
skill.source.toLowerCase().includes(query) ||
skill.repoName.toLowerCase().includes(query)
).slice(0, limit);
results = allSkills
.filter(
(skill) =>
skill.name.toLowerCase().includes(query) ||
skill.description?.toLowerCase().includes(query) ||
skill.source.toLowerCase().includes(query) ||
skill.repoName.toLowerCase().includes(query),
)
.slice(0, limit);
s.stop(`Found ${results.length} skill(s)`);
} else {
if (!this.quiet) {
step('Enter a search term or browse featured skills');
step("Enter a search term or browse featured skills");
}
const { text } = await import('../onboarding/prompts.js');
const { text } = await import("../onboarding/prompts.js");
const searchResult = await text({
message: 'Search skills',
placeholder: 'e.g., pdf, nextjs, testing',
message: "Search skills",
placeholder: "e.g., pdf, nextjs, testing",
});
if (isCancel(searchResult)) {
@@ -118,101 +139,163 @@ export class FindCommand extends Command {
}
const query = (searchResult as string).toLowerCase();
searchTerm = searchResult as string;
if (query) {
s.start('Searching...');
results = allSkills.filter(skill =>
skill.name.toLowerCase().includes(query) ||
skill.description?.toLowerCase().includes(query) ||
skill.source.toLowerCase().includes(query) ||
skill.repoName.toLowerCase().includes(query)
).slice(0, limit);
s.start("Searching...");
results = allSkills
.filter(
(skill) =>
skill.name.toLowerCase().includes(query) ||
skill.description?.toLowerCase().includes(query) ||
skill.source.toLowerCase().includes(query) ||
skill.repoName.toLowerCase().includes(query),
)
.slice(0, limit);
s.stop(`Found ${results.length} skill(s)`);
} else {
results = allSkills.slice(0, limit);
}
}
if (this.federated && this.query) {
s.start('Searching external registries...');
if (searchTerm) {
s.start("Searching skills.sh + external registries...");
const fedSearch = new FederatedSearch();
fedSearch.addRegistry(new GitHubSkillRegistry());
fedSearch.addRegistry(new SkillsShRegistry());
if (this.federated) {
fedSearch.addRegistry(new GitHubSkillRegistry());
}
try {
const fedResult = await fedSearch.search(this.query, { limit: parseInt(this.limit, 10) || 10 });
s.stop(`Found ${fedResult.total} external skill(s) from ${fedResult.registries.join(', ') || 'none'}`);
const fedResult = await fedSearch.search(searchTerm, {
limit: parseInt(this.limit, 10) || 10,
});
const sourceLabel = fedResult.registries.join(", ") || "none";
s.stop(`Found ${fedResult.total} skill(s) from ${sourceLabel}`);
if (fedResult.skills.length > 0) {
console.log('');
console.log(colors.bold('External Skills (SKILL.md):'));
for (const skill of fedResult.skills) {
const stars = typeof skill.stars === 'number' ? colors.muted(` ★${skill.stars}`) : '';
const desc = skill.description
? colors.muted(` - ${skill.description.slice(0, 50)}${skill.description.length > 50 ? '...' : ''}`)
: '';
console.log(` ${colors.cyan(symbols.bullet)} ${colors.primary(skill.name)}${stars}${desc}`);
if (!this.quiet) {
console.log(` ${colors.muted(skill.source)}`);
const skillsShResults = fedResult.skills.filter(
(sk) => sk.registry === "skills.sh",
);
const githubResults = fedResult.skills.filter(
(sk) => sk.registry !== "skills.sh",
);
if (skillsShResults.length > 0) {
console.log("");
console.log(colors.bold("Skills.sh Registry:"));
for (const skill of skillsShResults) {
const installs =
typeof skill.stars === "number" && skill.stars > 0
? colors.muted(` ${formatCount(skill.stars)} installs`)
: "";
const desc = skill.description
? colors.muted(
` - ${skill.description.slice(0, 50)}${skill.description.length > 50 ? "..." : ""}`,
)
: "";
console.log(
` ${colors.cyan(symbols.bullet)} ${colors.primary(skill.name)}${installs}${desc}`,
);
if (!this.quiet) {
const installSource = skill.source.replace(
"https://github.com/",
"",
);
console.log(
` ${colors.muted(`skillkit install skills.sh/${installSource}/${skill.name}`)}`,
);
}
}
}
console.log('');
}
} catch (err) {
if (err instanceof RateLimitError) {
s.stop(colors.warning('Rate limited by GitHub API'));
console.log(colors.muted('Set GITHUB_TOKEN env var or wait before retrying.'));
} else {
s.stop(colors.warning('Federated search failed'));
if (githubResults.length > 0) {
console.log("");
console.log(colors.bold("GitHub (SKILL.md):"));
for (const skill of githubResults) {
const stars =
typeof skill.stars === "number"
? colors.muted(` ★${skill.stars}`)
: "";
const desc = skill.description
? colors.muted(
` - ${skill.description.slice(0, 50)}${skill.description.length > 50 ? "..." : ""}`,
)
: "";
console.log(
` ${colors.cyan(symbols.bullet)} ${colors.primary(skill.name)}${stars}${desc}`,
);
if (!this.quiet) {
console.log(` ${colors.muted(skill.source)}`);
}
}
}
console.log("");
}
} catch {
s.stop(colors.warning("External search unavailable"));
}
}
if (results.length === 0) {
console.log(colors.muted('No skills found matching your search'));
console.log('');
console.log(colors.muted('Try:'));
console.log(colors.muted(' skillkit find --top # Show featured skills'));
console.log(colors.muted(' skillkit find -f <query> # Search external registries'));
console.log(colors.muted(' skillkit ui # Browse in TUI'));
console.log(colors.muted("No skills found matching your search"));
console.log("");
console.log(colors.muted("Try:"));
console.log(
colors.muted(" skillkit find --top # Show featured skills"),
);
console.log(
colors.muted(
" skillkit find -f <query> # Also search GitHub SKILL.md files",
),
);
console.log(colors.muted(" skillkit ui # Browse in TUI"));
return 0;
}
console.log('');
console.log("");
for (const skill of results) {
const desc = skill.description
? colors.muted(` - ${skill.description.slice(0, 50)}${skill.description.length > 50 ? '...' : ''}`)
: '';
console.log(` ${colors.success(symbols.bullet)} ${colors.primary(skill.name)}${desc}`);
? colors.muted(
` - ${skill.description.slice(0, 50)}${skill.description.length > 50 ? "..." : ""}`,
)
: "";
console.log(
` ${colors.success(symbols.bullet)} ${colors.primary(skill.name)}${desc}`,
);
if (!this.quiet && skill.source) {
console.log(` ${colors.muted(skill.source)}`);
}
}
console.log('');
console.log(colors.muted(`Showing ${results.length} of ${allSkills.length} skills`));
console.log('');
console.log("");
console.log(
colors.muted(`Showing ${results.length} of ${allSkills.length} skills`),
);
console.log("");
if (this.install || (!this.query && !this.top && process.stdin.isTTY)) {
const installResult = await select({
message: 'Install a skill?',
message: "Install a skill?",
options: [
{ value: 'none', label: 'No, just browsing' },
...results.slice(0, 5).map(skill => ({
{ value: "none", label: "No, just browsing" },
...results.slice(0, 5).map((skill) => ({
value: skill.source,
label: skill.name,
hint: skill.repoName,
})),
],
initialValue: 'none',
initialValue: "none",
});
if (!isCancel(installResult) && installResult !== 'none') {
console.log('');
console.log(colors.cyan('To install, run:'));
if (!isCancel(installResult) && installResult !== "none") {
console.log("");
console.log(colors.cyan("To install, run:"));
console.log(` ${colors.bold(`skillkit install ${installResult}`)}`);
}
} else {
console.log(colors.muted('To install: skillkit install <source>'));
console.log(colors.muted("To install: skillkit install <source>"));
}
return 0;
+7 -4
View File
@@ -24,7 +24,7 @@ export class GenerateCommand extends Command {
- Documentation (Context7)
- Local codebase patterns
- Marketplace skills (15,000+)
- Marketplace skills (400K+)
- Memory observations and learnings
Supports multiple LLM providers: Claude, GPT-4, Gemini, Ollama, OpenRouter
@@ -33,7 +33,7 @@ export class GenerateCommand extends Command {
['Interactive wizard', '$0 generate'],
['Use specific provider', '$0 generate --provider openai'],
['Compose from existing skills', '$0 generate --compose "testing patterns for vitest"'],
['Target specific agents', '$0 generate --agents claude-code,cursor'],
['Target specific agents', '$0 generate --agent claude-code,cursor'],
['Skip memory context', '$0 generate --no-memory'],
],
});
@@ -50,7 +50,7 @@ export class GenerateCommand extends Command {
description: 'Natural language search to find skills to compose',
});
agents = Option.String('--agents,-a', {
agents = Option.String('--agent,--agents,-a', {
description: 'Target agents (comma-separated)',
});
@@ -243,7 +243,7 @@ Or use Ollama for local models (no API key needed)`,
const sourceOptions = [
{ value: 'docs', label: 'Documentation (Context7)', hint: 'Library docs & guides' },
{ value: 'codebase', label: 'Codebase (local)', hint: 'Project patterns & configs' },
{ value: 'skills', label: 'Marketplace Skills', hint: '15,000+ skills' },
{ value: 'skills', label: 'Marketplace Skills', hint: '400K+ skills' },
{ value: 'memory', label: 'Memory & Learnings', hint: 'Your corrections & patterns' },
];
@@ -536,6 +536,9 @@ ${trustScore.warnings.length > 0 ? `\nWarnings:\n${trustScore.warnings.map((w) =
let targetAgents: string[];
if (this.agents) {
if (process.argv.includes('--agents')) {
console.warn('Warning: --agents is deprecated, use --agent instead (--agents will be removed in v2.0)');
}
targetAgents = this.agents.split(',').map((a) => a.trim());
} else {
const agentOptions = [
+25 -25
View File
@@ -1,5 +1,5 @@
import { Command, Option } from 'clipanion';
import chalk from 'chalk';
import { colors } from '../onboarding/index.js';
import {
getAllGuidelines,
getEnabledGuidelines,
@@ -31,7 +31,7 @@ export class GuidelineCommand extends Command {
});
async execute(): Promise<number> {
console.log(chalk.cyan('Guideline commands:\n'));
console.log(colors.cyan('Guideline commands:\n'));
console.log(' guideline list List all guidelines');
console.log(' guideline show <id> Show guideline content');
console.log(' guideline enable Enable a guideline');
@@ -70,7 +70,7 @@ export class GuidelineListCommand extends Command {
}
const title = this.enabled ? 'Enabled Guidelines' : 'All Guidelines';
console.log(chalk.cyan(`${title} (${guidelines.length}):\n`));
console.log(colors.cyan(`${title} (${guidelines.length}):\n`));
const byCategory = new Map<GuidelineCategory, Guideline[]>();
for (const guideline of guidelines) {
@@ -81,22 +81,22 @@ export class GuidelineListCommand extends Command {
}
for (const [category, catGuidelines] of byCategory) {
console.log(chalk.blue(` ${formatCategoryName(category)}`));
console.log(colors.info(` ${formatCategoryName(category)}`));
for (const guideline of catGuidelines) {
const enabled = isGuidelineEnabled(guideline.id);
const status = enabled ? chalk.green('●') : chalk.dim('○');
const custom = isBuiltinGuideline(guideline.id) ? '' : chalk.dim(' (custom)');
const priority = chalk.dim(`[${guideline.priority}]`);
const status = enabled ? colors.success('●') : colors.muted('○');
const custom = isBuiltinGuideline(guideline.id) ? '' : colors.muted(' (custom)');
const priority = colors.muted(`[${guideline.priority}]`);
console.log(` ${status} ${chalk.bold(guideline.id)} ${priority}${custom}`);
console.log(` ${chalk.dim(guideline.description)}`);
console.log(` ${status} ${colors.bold(guideline.id)} ${priority}${custom}`);
console.log(` ${colors.muted(guideline.description)}`);
}
console.log();
}
console.log(chalk.dim('Enable with: skillkit guideline enable <id>'));
console.log(chalk.dim('Show content: skillkit guideline show <id>'));
console.log(colors.muted('Enable with: skillkit guideline enable <id>'));
console.log(colors.muted('Show content: skillkit guideline show <id>'));
return 0;
}
@@ -116,20 +116,20 @@ export class GuidelineShowCommand extends Command {
const guideline = getGuideline(this.id);
if (!guideline) {
console.log(chalk.red(`Guideline not found: ${this.id}`));
console.log(colors.error(`Guideline not found: ${this.id}`));
return 1;
}
const enabled = isGuidelineEnabled(this.id);
const status = enabled ? chalk.green('enabled') : chalk.dim('disabled');
const status = enabled ? colors.success('enabled') : colors.muted('disabled');
console.log(chalk.cyan(`Guideline: ${guideline.name}\n`));
console.log(colors.cyan(`Guideline: ${guideline.name}\n`));
console.log(`ID: ${guideline.id}`);
console.log(`Category: ${guideline.category}`);
console.log(`Priority: ${guideline.priority}`);
console.log(`Status: ${status}`);
console.log();
console.log(chalk.bold('Content:'));
console.log(colors.bold('Content:'));
console.log(guideline.content);
return 0;
@@ -150,11 +150,11 @@ export class GuidelineEnableCommand extends Command {
const success = enableGuideline(this.id);
if (!success) {
console.log(chalk.red(`Guideline not found: ${this.id}`));
console.log(colors.error(`Guideline not found: ${this.id}`));
return 1;
}
console.log(chalk.green(`✓ Enabled guideline: ${this.id}`));
console.log(colors.success(`✓ Enabled guideline: ${this.id}`));
return 0;
}
}
@@ -173,11 +173,11 @@ export class GuidelineDisableCommand extends Command {
const success = disableGuideline(this.id);
if (!success) {
console.log(chalk.yellow(`Guideline not found or already disabled: ${this.id}`));
console.log(colors.warning(`Guideline not found or already disabled: ${this.id}`));
return 0;
}
console.log(chalk.green(`✓ Disabled guideline: ${this.id}`));
console.log(colors.success(`✓ Disabled guideline: ${this.id}`));
return 0;
}
}
@@ -216,7 +216,7 @@ export class GuidelineCreateCommand extends Command {
async execute(): Promise<number> {
if (isBuiltinGuideline(this.id)) {
console.log(chalk.red(`Cannot create: ${this.id} is a built-in guideline`));
console.log(colors.error(`Cannot create: ${this.id} is a built-in guideline`));
return 1;
}
@@ -234,8 +234,8 @@ export class GuidelineCreateCommand extends Command {
addCustomGuideline(guideline);
enableGuideline(this.id);
console.log(chalk.green(`✓ Created guideline: ${this.id}`));
console.log(chalk.dim('Edit ~/.skillkit/guidelines.yaml to customize content'));
console.log(colors.success(`✓ Created guideline: ${this.id}`));
console.log(colors.muted('Edit ~/.skillkit/guidelines.yaml to customize content'));
return 0;
}
@@ -253,18 +253,18 @@ export class GuidelineRemoveCommand extends Command {
async execute(): Promise<number> {
if (isBuiltinGuideline(this.id)) {
console.log(chalk.red(`Cannot remove built-in guideline: ${this.id}`));
console.log(colors.error(`Cannot remove built-in guideline: ${this.id}`));
return 1;
}
const removed = removeCustomGuideline(this.id);
if (!removed) {
console.log(chalk.yellow(`Guideline not found: ${this.id}`));
console.log(colors.warning(`Guideline not found: ${this.id}`));
return 1;
}
console.log(chalk.green(`✓ Removed guideline: ${this.id}`));
console.log(colors.success(`✓ Removed guideline: ${this.id}`));
return 0;
}
}
+55
View File
@@ -0,0 +1,55 @@
import { Command, Option } from 'clipanion';
import { writeFileSync } from 'node:fs';
import { colors } from '../onboarding/index.js';
import { SessionHandoff } from '@skillkit/core';
export class SessionHandoffCommand extends Command {
static override paths = [['session', 'handoff']];
static override usage = Command.Usage({
description: 'Generate agent-to-agent session handoff document',
examples: [
['Print handoff to stdout', '$0 session handoff'],
['Target agent recommendations', '$0 session handoff --to cursor'],
['Save to file', '$0 session handoff --out handoff.md'],
['JSON output', '$0 session handoff --json'],
],
});
to = Option.String('--to', {
description: 'Target agent for recommendations',
});
out = Option.String('--out,-o', {
description: 'Save handoff to file',
});
json = Option.Boolean('--json,-j', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const projectPath = process.cwd();
const handoff = new SessionHandoff(projectPath);
const doc = handoff.generate({
targetAgent: this.to,
});
const output = this.json ? handoff.toJson(doc) : handoff.toMarkdown(doc);
if (this.out) {
try {
writeFileSync(this.out, output, 'utf-8');
console.log(colors.success(`Handoff saved to ${this.out}`));
} catch (error) {
console.error(colors.error(`Failed to write file: ${(error as Error).message}`));
return 1;
}
} else {
console.log(output);
}
return 0;
}
}
+41 -41
View File
@@ -5,7 +5,7 @@
*/
import { Command, Option } from 'clipanion';
import chalk from 'chalk';
import { colors } from '../onboarding/index.js';
import { createHookManager, type HookEvent, type InjectionMode } from '@skillkit/core';
import {
getHookTemplates,
@@ -60,12 +60,12 @@ export class HookCommand extends Command {
case 'info':
return await this.showHookInfo(projectPath);
default:
this.context.stderr.write(chalk.red(`Unknown action: ${this.action}\n`));
this.context.stderr.write(colors.error(`Unknown action: ${this.action}\n`));
this.context.stderr.write('Available actions: list, add, remove, enable, disable, generate, info\n');
return 1;
}
} catch (err) {
this.context.stderr.write(chalk.red(`✗ ${err instanceof Error ? err.message : 'Unknown error'}\n`));
this.context.stderr.write(colors.error(`✗ ${err instanceof Error ? err.message : 'Unknown error'}\n`));
return 1;
}
}
@@ -76,11 +76,11 @@ export class HookCommand extends Command {
if (hooks.length === 0) {
this.context.stdout.write('No hooks configured.\n');
this.context.stdout.write(chalk.gray('Run `skillkit hook add <event> <skill>` to add a hook.\n'));
this.context.stdout.write(colors.muted('Run `skillkit hook add <event> <skill>` to add a hook.\n'));
return 0;
}
this.context.stdout.write(chalk.cyan('Configured Hooks:\n\n'));
this.context.stdout.write(colors.cyan('Configured Hooks:\n\n'));
// Group by event
const eventGroups = new Map<string, typeof hooks>();
@@ -91,15 +91,15 @@ export class HookCommand extends Command {
}
for (const [event, eventHooks] of eventGroups) {
this.context.stdout.write(chalk.yellow(`${event}:\n`));
this.context.stdout.write(colors.warning(`${event}:\n`));
for (const hook of eventHooks) {
const status = hook.enabled ? chalk.green('●') : chalk.gray('○');
this.context.stdout.write(` ${status} ${chalk.white(hook.id.slice(0, 8))} → ${hook.skills.join(', ')}\n`);
const status = hook.enabled ? colors.success('●') : colors.muted('○');
this.context.stdout.write(` ${status} ${colors.primary(hook.id.slice(0, 8))} → ${hook.skills.join(', ')}\n`);
if (hook.matcher) {
this.context.stdout.write(chalk.gray(` Pattern: ${hook.matcher}\n`));
this.context.stdout.write(colors.muted(` Pattern: ${hook.matcher}\n`));
}
if (this.verbose) {
this.context.stdout.write(chalk.gray(` Inject: ${hook.inject}, Priority: ${hook.priority || 0}\n`));
this.context.stdout.write(colors.muted(` Inject: ${hook.inject}, Priority: ${hook.priority || 0}\n`));
}
}
}
@@ -110,14 +110,14 @@ export class HookCommand extends Command {
private async addHook(projectPath: string): Promise<number> {
if (!this.target) {
this.context.stderr.write(chalk.red('Event type required.\n'));
this.context.stderr.write(colors.error('Event type required.\n'));
this.context.stderr.write('Usage: skillkit hook add <event> <skill>\n');
this.context.stderr.write('Events: session:start, session:end, file:save, file:open, task:start, commit:pre, commit:post, error:occur, test:fail, build:fail\n');
return 1;
}
if (!this.skill) {
this.context.stderr.write(chalk.red('Skill name required.\n'));
this.context.stderr.write(colors.error('Skill name required.\n'));
this.context.stderr.write('Usage: skillkit hook add <event> <skill>\n');
return 1;
}
@@ -133,7 +133,7 @@ export class HookCommand extends Command {
];
if (!validEvents.includes(event)) {
this.context.stderr.write(chalk.red(`Invalid event: ${this.target}\n`));
this.context.stderr.write(colors.error(`Invalid event: ${this.target}\n`));
this.context.stderr.write(`Valid events: ${validEvents.join(', ')}\n`);
return 1;
}
@@ -151,7 +151,7 @@ export class HookCommand extends Command {
manager.save();
this.context.stdout.write(chalk.green(`✓ Hook added: ${hook.id.slice(0, 8)}\n`));
this.context.stdout.write(colors.success(`✓ Hook added: ${hook.id.slice(0, 8)}\n`));
this.context.stdout.write(` Event: ${event}\n`);
this.context.stdout.write(` Skill: ${this.skill}\n`);
if (this.pattern) {
@@ -163,7 +163,7 @@ export class HookCommand extends Command {
private async removeHook(projectPath: string): Promise<number> {
if (!this.target) {
this.context.stderr.write(chalk.red('Hook ID required.\n'));
this.context.stderr.write(colors.error('Hook ID required.\n'));
this.context.stderr.write('Usage: skillkit hook remove <hook-id>\n');
return 1;
}
@@ -174,20 +174,20 @@ export class HookCommand extends Command {
// Find hook by ID prefix
const hook = hooks.find((h) => h.id.startsWith(this.target!));
if (!hook) {
this.context.stderr.write(chalk.red(`Hook not found: ${this.target}\n`));
this.context.stderr.write(colors.error(`Hook not found: ${this.target}\n`));
return 1;
}
manager.unregisterHook(hook.id);
manager.save();
this.context.stdout.write(chalk.green(`✓ Hook removed: ${hook.id.slice(0, 8)}\n`));
this.context.stdout.write(colors.success(`✓ Hook removed: ${hook.id.slice(0, 8)}\n`));
return 0;
}
private async enableHook(projectPath: string): Promise<number> {
if (!this.target) {
this.context.stderr.write(chalk.red('Hook ID required.\n'));
this.context.stderr.write(colors.error('Hook ID required.\n'));
return 1;
}
@@ -196,20 +196,20 @@ export class HookCommand extends Command {
const hook = hooks.find((h) => h.id.startsWith(this.target!));
if (!hook) {
this.context.stderr.write(chalk.red(`Hook not found: ${this.target}\n`));
this.context.stderr.write(colors.error(`Hook not found: ${this.target}\n`));
return 1;
}
manager.enableHook(hook.id);
manager.save();
this.context.stdout.write(chalk.green(`✓ Hook enabled: ${hook.id.slice(0, 8)}\n`));
this.context.stdout.write(colors.success(`✓ Hook enabled: ${hook.id.slice(0, 8)}\n`));
return 0;
}
private async disableHook(projectPath: string): Promise<number> {
if (!this.target) {
this.context.stderr.write(chalk.red('Hook ID required.\n'));
this.context.stderr.write(colors.error('Hook ID required.\n'));
return 1;
}
@@ -218,14 +218,14 @@ export class HookCommand extends Command {
const hook = hooks.find((h) => h.id.startsWith(this.target!));
if (!hook) {
this.context.stderr.write(chalk.red(`Hook not found: ${this.target}\n`));
this.context.stderr.write(colors.error(`Hook not found: ${this.target}\n`));
return 1;
}
manager.disableHook(hook.id);
manager.save();
this.context.stdout.write(chalk.yellow(`○ Hook disabled: ${hook.id.slice(0, 8)}\n`));
this.context.stdout.write(colors.warning(`○ Hook disabled: ${hook.id.slice(0, 8)}\n`));
return 0;
}
@@ -241,7 +241,7 @@ export class HookCommand extends Command {
const agent = this.agent || 'claude-code';
const generated = manager.generateAgentHooks(agent as any);
this.context.stdout.write(chalk.cyan(`Generated hooks for ${agent}:\n\n`));
this.context.stdout.write(colors.cyan(`Generated hooks for ${agent}:\n\n`));
if (typeof generated === 'string') {
this.context.stdout.write(generated);
@@ -255,7 +255,7 @@ export class HookCommand extends Command {
private async showHookInfo(projectPath: string): Promise<number> {
if (!this.target) {
this.context.stderr.write(chalk.red('Hook ID required.\n'));
this.context.stderr.write(colors.error('Hook ID required.\n'));
return 1;
}
@@ -264,11 +264,11 @@ export class HookCommand extends Command {
const hook = hooks.find((h) => h.id.startsWith(this.target!));
if (!hook) {
this.context.stderr.write(chalk.red(`Hook not found: ${this.target}\n`));
this.context.stderr.write(colors.error(`Hook not found: ${this.target}\n`));
return 1;
}
this.context.stdout.write(chalk.cyan(`\nHook: ${hook.id}\n`));
this.context.stdout.write(colors.cyan(`\nHook: ${hook.id}\n`));
this.context.stdout.write(`Event: ${hook.event}\n`);
this.context.stdout.write(`Skills: ${hook.skills.join(', ')}\n`);
this.context.stdout.write(`Enabled: ${hook.enabled ? 'Yes' : 'No'}\n`);
@@ -317,7 +317,7 @@ export class HookTemplateListCommand extends Command {
return 0;
}
console.log(chalk.cyan(`Hook Templates (${templates.length}):\n`));
console.log(colors.cyan(`Hook Templates (${templates.length}):\n`));
const byCategory = new Map<HookTemplateCategory, HookTemplate[]>();
for (const template of templates) {
@@ -328,17 +328,17 @@ export class HookTemplateListCommand extends Command {
}
for (const [category, catTemplates] of byCategory) {
console.log(chalk.blue(` ${formatCategory(category)}`));
console.log(colors.info(` ${formatCategory(category)}`));
for (const template of catTemplates) {
const blocking = template.blocking ? chalk.yellow(' [blocking]') : '';
console.log(` ${chalk.bold(template.id)}${blocking}`);
console.log(` ${chalk.dim(template.description)}`);
const blocking = template.blocking ? colors.warning(' [blocking]') : '';
console.log(` ${colors.bold(template.id)}${blocking}`);
console.log(` ${colors.muted(template.description)}`);
console.log(` Event: ${template.event}`);
}
console.log();
}
console.log(chalk.dim('Apply with: skillkit hook template apply <id>'));
console.log(colors.muted('Apply with: skillkit hook template apply <id>'));
return 0;
}
@@ -361,8 +361,8 @@ export class HookTemplateApplyCommand extends Command {
const template = getHookTemplate(this.id);
if (!template) {
console.log(chalk.red(`Template not found: ${this.id}`));
console.log(chalk.dim('Run `skillkit hook template list` to see available templates'));
console.log(colors.error(`Template not found: ${this.id}`));
console.log(colors.muted('Run `skillkit hook template list` to see available templates'));
return 1;
}
@@ -385,12 +385,12 @@ export class HookTemplateApplyCommand extends Command {
manager.save();
console.log(chalk.green(`✓ Applied template: ${template.name}`));
console.log(colors.success(`✓ Applied template: ${template.name}`));
console.log(` Hook ID: ${hook.id.slice(0, 8)}`);
console.log(` Event: ${template.event}`);
console.log(` Command: ${chalk.dim(template.command)}`);
console.log(` Command: ${colors.muted(template.command)}`);
if (template.blocking) {
console.log(chalk.yellow(` Blocking: yes`));
console.log(colors.warning(` Blocking: yes`));
}
return 0;
@@ -411,11 +411,11 @@ export class HookTemplateShowCommand extends Command {
const template = getHookTemplate(this.id);
if (!template) {
console.log(chalk.red(`Template not found: ${this.id}`));
console.log(colors.error(`Template not found: ${this.id}`));
return 1;
}
console.log(chalk.cyan(`Template: ${template.name}\n`));
console.log(colors.cyan(`Template: ${template.name}\n`));
console.log(`ID: ${template.id}`);
console.log(`Category: ${template.category}`);
console.log(`Description: ${template.description}`);
@@ -426,7 +426,7 @@ export class HookTemplateShowCommand extends Command {
console.log(`Blocking: ${template.blocking ? 'yes' : 'no'}`);
console.log(`Timeout: ${template.timeout || 30000}ms`);
console.log();
console.log(chalk.bold('Command:'));
console.log(colors.bold('Command:'));
console.log(` ${template.command}`);
return 0;
+4
View File
@@ -125,8 +125,12 @@ export { SkillMdValidateCommand, SkillMdInitCommand, SkillMdCheckCommand } from
// API server
export { ServeCommand } from './serve.js';
export { ScanCommand } from './scan.js';
export { EvalCommand } from './eval.js';
export { IssuePlanCommand, IssueListCommand } from './issue.js';
export { DoctorCommand } from './doctor.js';
export { TimelineCommand } from './timeline.js';
export { SessionHandoffCommand } from './handoff.js';
export { LineageCommand } from './lineage.js';
export { SaveCommand } from './save.js';
export {
AgentsMdCommand,
File diff suppressed because it is too large Load Diff
+49 -49
View File
@@ -1,6 +1,6 @@
import { Command, Option } from 'clipanion';
import { resolve } from 'node:path';
import chalk from 'chalk';
import { colors } from '../onboarding/index.js';
import {
analyzeGitHistory,
loadPatternStore,
@@ -73,7 +73,7 @@ export class LearnCommand extends Command {
return this.showPatterns();
}
console.log(chalk.cyan('Analyzing git history for learnable patterns...\n'));
console.log(colors.cyan('Analyzing git history for learnable patterns...\n'));
const result = analyzeGitHistory(projectPath, {
commits: this.commits ? parseInt(this.commits) : 100,
@@ -88,8 +88,8 @@ export class LearnCommand extends Command {
this.printAnalysisResult(result);
if (result.patterns.length === 0) {
console.log(chalk.yellow('\nNo learnable patterns found.'));
console.log(chalk.dim('Try analyzing more commits or a different date range.'));
console.log(colors.warning('\nNo learnable patterns found.'));
console.log(colors.muted('Try analyzing more commits or a different date range.'));
return 0;
}
@@ -105,12 +105,12 @@ export class LearnCommand extends Command {
}
console.log();
console.log(chalk.green(`✓ Extracted ${added} patterns`));
console.log(colors.success(`✓ Extracted ${added} patterns`));
if (!this.approve) {
console.log(chalk.dim('Patterns are pending approval. Use:'));
console.log(chalk.dim(' skillkit pattern approve <id> - to approve'));
console.log(chalk.dim(' skillkit pattern status - to view all'));
console.log(colors.muted('Patterns are pending approval. Use:'));
console.log(colors.muted(' skillkit pattern approve <id> - to approve'));
console.log(colors.muted(' skillkit pattern status - to view all'));
}
return 0;
@@ -119,21 +119,21 @@ export class LearnCommand extends Command {
private printAnalysisResult(result: GitAnalysisResult): void {
const { summary, dateRange, languages, frameworks } = result;
console.log(chalk.bold('Analysis Summary'));
console.log(colors.bold('Analysis Summary'));
console.log(` Commits analyzed: ${summary.totalCommits}`);
console.log(` Files changed: ${summary.totalFilesChanged}`);
console.log(` Date range: ${dateRange.from || 'N/A'} to ${dateRange.to || 'N/A'}`);
console.log();
if (languages.length > 0) {
console.log(` Languages: ${chalk.cyan(languages.join(', '))}`);
console.log(` Languages: ${colors.cyan(languages.join(', '))}`);
}
if (frameworks.length > 0) {
console.log(` Frameworks: ${chalk.cyan(frameworks.join(', '))}`);
console.log(` Frameworks: ${colors.cyan(frameworks.join(', '))}`);
}
console.log();
console.log(chalk.bold('Commit Categories'));
console.log(colors.bold('Commit Categories'));
console.log(` Error fixes: ${summary.errorFixes}`);
console.log(` Refactors: ${summary.refactors}`);
console.log(` Features: ${summary.features}`);
@@ -141,15 +141,15 @@ export class LearnCommand extends Command {
console.log(` Tests: ${summary.tests}`);
console.log();
console.log(chalk.bold(`Patterns Extracted: ${result.patterns.length}`));
console.log(colors.bold(`Patterns Extracted: ${result.patterns.length}`));
for (const pattern of result.patterns.slice(0, 5)) {
const confidence = chalk.blue(`${(pattern.confidence * 100).toFixed(0)}%`);
console.log(` ${chalk.dim('○')} ${pattern.title} [${pattern.category}] ${confidence}`);
const confidence = colors.info(`${(pattern.confidence * 100).toFixed(0)}%`);
console.log(` ${colors.muted('○')} ${pattern.title} [${pattern.category}] ${confidence}`);
}
if (result.patterns.length > 5) {
console.log(chalk.dim(` ... and ${result.patterns.length - 5} more`));
console.log(colors.muted(` ... and ${result.patterns.length - 5} more`));
}
}
@@ -162,18 +162,18 @@ export class LearnCommand extends Command {
}
if (patterns.length === 0) {
console.log(chalk.yellow('No patterns stored yet.'));
console.log(chalk.dim('Run `skillkit learn` to extract patterns from git history.'));
console.log(colors.warning('No patterns stored yet.'));
console.log(colors.muted('Run `skillkit learn` to extract patterns from git history.'));
return 0;
}
console.log(chalk.cyan(`Stored Patterns (${patterns.length}):\n`));
console.log(colors.cyan(`Stored Patterns (${patterns.length}):\n`));
const approved = patterns.filter(p => p.approved);
const pending = patterns.filter(p => !p.approved);
if (approved.length > 0) {
console.log(chalk.green('Approved:'));
console.log(colors.success('Approved:'));
for (const pattern of approved) {
this.printPattern(pattern);
}
@@ -181,7 +181,7 @@ export class LearnCommand extends Command {
}
if (pending.length > 0) {
console.log(chalk.yellow('Pending Approval:'));
console.log(colors.warning('Pending Approval:'));
for (const pattern of pending) {
this.printPattern(pattern);
}
@@ -191,11 +191,11 @@ export class LearnCommand extends Command {
}
private printPattern(pattern: LearnedPattern): void {
const confidence = chalk.blue(`${(pattern.confidence * 100).toFixed(0)}%`);
const status = pattern.approved ? chalk.green('✓') : chalk.yellow('○');
console.log(` ${status} ${chalk.bold(pattern.id)}`);
const confidence = colors.info(`${(pattern.confidence * 100).toFixed(0)}%`);
const status = pattern.approved ? colors.success('✓') : colors.warning('○');
console.log(` ${status} ${colors.bold(pattern.id)}`);
console.log(` ${pattern.title} [${pattern.category}] ${confidence}`);
console.log(chalk.dim(` ${truncate(pattern.problem, 60)}`));
console.log(colors.muted(` ${truncate(pattern.problem, 60)}`));
}
}
@@ -226,18 +226,18 @@ export class PatternStatusCommand extends Command {
return 0;
}
console.log(chalk.cyan('Pattern Statistics\n'));
console.log(colors.cyan('Pattern Statistics\n'));
console.log(`Total patterns: ${stats.total}`);
console.log();
console.log(chalk.bold('By Confidence:'));
console.log(colors.bold('By Confidence:'));
console.log(` High (>70%): ${stats.byConfidenceRange.high}`);
console.log(` Medium (40-70%): ${stats.byConfidenceRange.medium}`);
console.log(` Low (<40%): ${stats.byConfidenceRange.low}`);
console.log();
if (stats.byDomain.size > 0) {
console.log(chalk.bold('By Domain:'));
console.log(colors.bold('By Domain:'));
for (const [domain, count] of stats.byDomain) {
console.log(` ${domain}: ${count}`);
}
@@ -245,7 +245,7 @@ export class PatternStatusCommand extends Command {
}
if (stats.mostUsed) {
console.log(chalk.bold('Most Used Pattern:'));
console.log(colors.bold('Most Used Pattern:'));
console.log(` ${stats.mostUsed.title} (${stats.mostUsed.useCount} uses)`);
}
@@ -276,7 +276,7 @@ export class PatternFeedbackCommand extends Command {
async execute(): Promise<number> {
if (!this.success && !this.failure) {
console.log(chalk.yellow('Please specify --success or --failure'));
console.log(colors.warning('Please specify --success or --failure'));
return 1;
}
@@ -285,12 +285,12 @@ export class PatternFeedbackCommand extends Command {
: recordFailure(this.id);
if (!result) {
console.log(chalk.red(`Pattern not found: ${this.id}`));
console.log(colors.error(`Pattern not found: ${this.id}`));
return 1;
}
const change = result.change === 'increased' ? chalk.green('↑') : chalk.red('↓');
console.log(chalk.green(`✓ Feedback recorded`));
const change = result.change === 'increased' ? colors.success('↑') : colors.error('↓');
console.log(colors.success(`✓ Feedback recorded`));
console.log(` Confidence: ${(result.previousConfidence * 100).toFixed(0)}% ${change} ${(result.newConfidence * 100).toFixed(0)}%`);
console.log(` Total uses: ${result.pattern.useCount}`);
@@ -312,11 +312,11 @@ export class PatternApproveCommand extends Command {
const pattern = approvePattern(this.id);
if (!pattern) {
console.log(chalk.red(`Pattern not found: ${this.id}`));
console.log(colors.error(`Pattern not found: ${this.id}`));
return 1;
}
console.log(chalk.green(`✓ Approved: ${pattern.title}`));
console.log(colors.success(`✓ Approved: ${pattern.title}`));
return 0;
}
}
@@ -335,11 +335,11 @@ export class PatternRejectCommand extends Command {
const removed = rejectPattern(this.id);
if (!removed) {
console.log(chalk.red(`Pattern not found: ${this.id}`));
console.log(colors.error(`Pattern not found: ${this.id}`));
return 1;
}
console.log(chalk.green(`✓ Removed pattern: ${this.id}`));
console.log(colors.success(`✓ Removed pattern: ${this.id}`));
return 0;
}
}
@@ -371,7 +371,7 @@ export class PatternExportCommand extends Command {
const patterns = this.approvedOnly ? getApprovedPatterns() : getAllPatterns();
if (patterns.length === 0) {
console.log(chalk.yellow('No patterns to export'));
console.log(colors.warning('No patterns to export'));
return 0;
}
@@ -386,7 +386,7 @@ export class PatternExportCommand extends Command {
if (this.output) {
writeFileSync(this.output, content);
console.log(chalk.green(`✓ Exported ${patterns.length} patterns to ${this.output}`));
console.log(colors.success(`✓ Exported ${patterns.length} patterns to ${this.output}`));
} else {
console.log(content);
}
@@ -407,7 +407,7 @@ export class PatternImportCommand extends Command {
async execute(): Promise<number> {
if (!existsSync(this.file)) {
console.log(chalk.red(`File not found: ${this.file}`));
console.log(colors.error(`File not found: ${this.file}`));
return 1;
}
@@ -415,7 +415,7 @@ export class PatternImportCommand extends Command {
const patterns = importPatternsFromJson(content);
if (patterns.length === 0) {
console.log(chalk.yellow('No patterns found in file'));
console.log(colors.warning('No patterns found in file'));
return 1;
}
@@ -423,7 +423,7 @@ export class PatternImportCommand extends Command {
addPattern(pattern);
}
console.log(chalk.green(`✓ Imported ${patterns.length} patterns`));
console.log(colors.success(`✓ Imported ${patterns.length} patterns`));
return 0;
}
}
@@ -451,21 +451,21 @@ export class PatternClusterCommand extends Command {
const patterns = getApprovedPatterns();
if (patterns.length === 0) {
console.log(chalk.yellow('No approved patterns to cluster'));
console.log(chalk.dim('Approve patterns first with: skillkit pattern approve <id>'));
console.log(colors.warning('No approved patterns to cluster'));
console.log(colors.muted('Approve patterns first with: skillkit pattern approve <id>'));
return 0;
}
const clusters = clusterPatterns(patterns);
console.log(chalk.cyan(`Pattern Clusters (${clusters.size}):\n`));
console.log(colors.cyan(`Pattern Clusters (${clusters.size}):\n`));
for (const [category, categoryPatterns] of clusters) {
console.log(chalk.bold(`${category.replace('_', ' ')} (${categoryPatterns.length}):`));
console.log(colors.bold(`${category.replace('_', ' ')} (${categoryPatterns.length}):`));
for (const pattern of categoryPatterns) {
const confidence = chalk.blue(`${(pattern.confidence * 100).toFixed(0)}%`);
console.log(` ${chalk.dim('○')} ${pattern.title} ${confidence}`);
const confidence = colors.info(`${(pattern.confidence * 100).toFixed(0)}%`);
console.log(` ${colors.muted('○')} ${pattern.title} ${confidence}`);
}
console.log();
@@ -476,7 +476,7 @@ export class PatternClusterCommand extends Command {
if (skill) {
const filepath = saveGeneratedSkill(skill);
console.log(chalk.green(` → Generated skill: ${filepath}`));
console.log(colors.success(` → Generated skill: ${filepath}`));
}
}
}
+66
View File
@@ -0,0 +1,66 @@
import { Command, Option } from 'clipanion';
import { colors } from '../onboarding/index.js';
import { SkillLineage } from '@skillkit/core';
export class LineageCommand extends Command {
static override paths = [['lineage']];
static override usage = Command.Usage({
description: 'Show skill impact lineage — which skills produced which changes',
examples: [
['Full overview', '$0 lineage'],
['Single skill', '$0 lineage --skill code-simplifier'],
['Single file', '$0 lineage --file src/index.ts'],
['Date filter + JSON', '$0 lineage --since 2026-02-01 --json'],
],
});
skill = Option.String('--skill,-s', {
description: 'Filter by skill name',
});
file = Option.String('--file,-f', {
description: 'Filter by file path',
});
since = Option.String('--since', {
description: 'Show lineage since date (YYYY-MM-DD)',
});
limit = Option.String('--limit,-l', {
description: 'Max entries to show',
});
json = Option.Boolean('--json,-j', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const projectPath = process.cwd();
const lineage = new SkillLineage(projectPath);
const parsed = this.limit ? parseInt(this.limit, 10) : undefined;
const limit = parsed && Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
const data = lineage.build({
skill: this.skill,
file: this.file,
since: this.since,
limit,
});
if (this.json) {
console.log(lineage.formatJson(data));
return 0;
}
if (data.skills.length === 0) {
console.log(colors.warning('No skill lineage found.'));
console.log(colors.muted('Lineage is built from skill execution history and activity logs.'));
return 0;
}
console.log(lineage.formatText(data));
return 0;
}
}
+10 -11
View File
@@ -1,8 +1,7 @@
import chalk from 'chalk';
import { Command, Option } from 'clipanion';
import { findAllSkills, evaluateSkillDirectory } from '@skillkit/core';
import { getSearchDirs } from '../helpers.js';
import { formatQualityBadge, colors } from '../onboarding/index.js';
import { formatQualityBadge, colors, warn } from '../onboarding/index.js';
export class ListCommand extends Command {
static override paths = [['list'], ['ls'], ['l']];
@@ -65,18 +64,18 @@ export class ListCommand extends Command {
}
if (skills.length === 0) {
console.log(chalk.yellow('No skills installed'));
console.log(chalk.dim('Install skills with: skillkit install <source>'));
warn('No skills installed');
console.log(colors.muted('Install skills with: skillkit install <source>'));
return 0;
}
console.log(chalk.cyan(`Installed skills (${skills.length}):\n`));
console.log(colors.cyan(`Installed skills (${skills.length}):\n`));
const projectSkills = skillsWithQuality.filter(s => s.location === 'project');
const globalSkills = skillsWithQuality.filter(s => s.location === 'global');
if (projectSkills.length > 0) {
console.log(chalk.blue('Project skills:'));
console.log(colors.info('Project skills:'));
for (const skill of projectSkills) {
printSkill(skill, this.quality);
}
@@ -84,7 +83,7 @@ export class ListCommand extends Command {
}
if (globalSkills.length > 0) {
console.log(chalk.dim('Global skills:'));
console.log(colors.muted('Global skills:'));
for (const skill of globalSkills) {
printSkill(skill, this.quality);
}
@@ -95,7 +94,7 @@ export class ListCommand extends Command {
const disabledCount = skills.length - enabledCount;
console.log(
chalk.dim(
colors.muted(
`${projectSkills.length} project, ${globalSkills.length} global` +
(disabledCount > 0 ? `, ${disabledCount} disabled` : '')
)
@@ -117,9 +116,9 @@ function printSkill(
skill: { name: string; description: string; enabled: boolean; location: string; quality: number | null },
showQuality = false
) {
const status = skill.enabled ? chalk.green('✓') : chalk.red('○');
const name = skill.enabled ? skill.name : chalk.dim(skill.name);
const desc = chalk.dim(truncate(skill.description, 50));
const status = skill.enabled ? colors.success('✓') : colors.error('○');
const name = skill.enabled ? skill.name : colors.muted(skill.name);
const desc = colors.muted(truncate(skill.description, 50));
const qualityBadge = showQuality && skill.quality !== null ? ` ${formatQualityBadge(skill.quality)}` : '';
console.log(` ${status} ${name}${qualityBadge}`);
+4 -1
View File
@@ -147,7 +147,7 @@ export class ManifestAddCommand extends Command {
description: 'Specific skills to include (comma-separated)',
});
agents = Option.String('--agents,-a', {
agents = Option.String('--agent,--agents,-a', {
description: 'Target agents (comma-separated)',
});
@@ -159,6 +159,9 @@ export class ManifestAddCommand extends Command {
}
if (this.agents) {
if (process.argv.includes('--agents')) {
console.warn('Warning: --agents is deprecated, use --agent instead (--agents will be removed in v2.0)');
}
options.agents = this.agents.split(',').map(s => s.trim());
}
+1 -1
View File
@@ -23,7 +23,7 @@ export class MarketplaceCommand extends Command {
from curated repositories.
Skills are aggregated from multiple sources including:
- composioHQ/awesome-claude-code-skills
- composioHQ/awesome-claude-skills
- anthropics/courses
- User-added custom sources
`,
+119 -119
View File
@@ -1,5 +1,5 @@
import { Command, Option } from 'clipanion';
import chalk from 'chalk';
import { colors, error, warn } from '../onboarding/index.js';
import {
ObservationStore,
LearningStore,
@@ -158,8 +158,8 @@ export class MemoryCommand extends Command {
case 'index':
return this.showIndex();
default:
console.error(chalk.red(`Unknown action: ${action}`));
console.log(chalk.gray('Available actions: status, search, list, show, compress, export, import, clear, add, rate, sync-claude, index, config'));
error(`Unknown action: ${action}`);
console.log(colors.muted('Available actions: status, search, list, show, compress, export, import, clear, add, rate, sync-claude, index, config'));
return 1;
}
}
@@ -194,32 +194,32 @@ export class MemoryCommand extends Command {
return 0;
}
console.log(chalk.bold('\nMemory Status\n'));
console.log(colors.bold('\nMemory Status\n'));
// Session observations
console.log(chalk.cyan('Session:'));
console.log(colors.cyan('Session:'));
console.log(` Observations: ${sessionObservations}`);
if (sessionId) {
console.log(` Session ID: ${chalk.gray(sessionId.slice(0, 8))}`);
console.log(` Session ID: ${colors.muted(sessionId.slice(0, 8))}`);
}
console.log();
// Project learnings
console.log(chalk.cyan('Project:'));
console.log(colors.cyan('Project:'));
console.log(` Learnings: ${projectLearnings}`);
console.log(` Path: ${chalk.gray(status.projectMemoryExists ? paths.projectMemoryDir : 'Not initialized')}`);
console.log(` Path: ${colors.muted(status.projectMemoryExists ? paths.projectMemoryDir : 'Not initialized')}`);
console.log();
// Global learnings
console.log(chalk.cyan('Global:'));
console.log(colors.cyan('Global:'));
console.log(` Learnings: ${globalLearnings}`);
console.log(` Path: ${chalk.gray(status.globalMemoryExists ? paths.globalMemoryDir : 'Not initialized')}`);
console.log(` Path: ${colors.muted(status.globalMemoryExists ? paths.globalMemoryDir : 'Not initialized')}`);
console.log();
// Recommendations
if (sessionObservations >= 50) {
console.log(chalk.yellow('💡 You have many uncompressed observations. Consider running:'));
console.log(chalk.gray(' skillkit memory compress'));
warn('💡 You have many uncompressed observations. Consider running:');
console.log(colors.muted(' skillkit memory compress'));
}
return 0;
@@ -231,8 +231,8 @@ export class MemoryCommand extends Command {
private async searchMemories(): Promise<number> {
const query = this.arg;
if (!query) {
console.error(chalk.red('Error: Search query is required'));
console.log(chalk.gray('Usage: skillkit memory search "your query"'));
error('Error: Search query is required');
console.log(colors.muted('Usage: skillkit memory search "your query"'));
return 1;
}
@@ -244,7 +244,7 @@ export class MemoryCommand extends Command {
if (this.limit) {
const parsed = parseInt(this.limit, 10);
if (isNaN(parsed) || parsed <= 0) {
console.log(chalk.red('Invalid --limit value. Must be a positive number.'));
console.log(colors.error('Invalid --limit value. Must be a positive number.'));
return 1;
}
maxLearnings = parsed;
@@ -269,15 +269,15 @@ export class MemoryCommand extends Command {
}
if (results.length === 0) {
console.log(chalk.yellow(`No memories found for: "${query}"`));
console.log(colors.warning(`No memories found for: "${query}"`));
return 0;
}
console.log(chalk.bold(`\nFound ${results.length} memories:\n`));
console.log(colors.bold(`\nFound ${results.length} memories:\n`));
for (const { learning, relevanceScore, matchedBy } of results) {
console.log(`${chalk.cyan('●')} ${chalk.bold(learning.title)}`);
console.log(` ID: ${chalk.gray(learning.id.slice(0, 8))}`);
console.log(`${colors.cyan('●')} ${colors.bold(learning.title)}`);
console.log(` ID: ${colors.muted(learning.id.slice(0, 8))}`);
console.log(` Relevance: ${this.formatScore(relevanceScore)}%`);
console.log(` Tags: ${learning.tags.join(', ')}`);
console.log(` Scope: ${learning.scope}`);
@@ -290,7 +290,7 @@ export class MemoryCommand extends Command {
// Show excerpt
const excerpt = learning.content.slice(0, 100);
console.log(` ${chalk.gray(excerpt)}${learning.content.length > 100 ? '...' : ''}`);
console.log(` ${colors.muted(excerpt)}${learning.content.length > 100 ? '...' : ''}`);
console.log();
}
@@ -327,12 +327,12 @@ export class MemoryCommand extends Command {
}
const scope = this.global ? 'Global' : 'Project';
console.log(chalk.bold(`\n${scope} Learnings (${learnings.length}):\n`));
console.log(colors.bold(`\n${scope} Learnings (${learnings.length}):\n`));
if (learnings.length === 0) {
console.log(chalk.gray('No learnings found.'));
console.log(chalk.gray('\nCapture learnings by running skills or add manually:'));
console.log(chalk.gray(' skillkit memory add --title "..." --content "..."'));
console.log(colors.muted('No learnings found.'));
console.log(colors.muted('\nCapture learnings by running skills or add manually:'));
console.log(colors.muted(' skillkit memory add --title "..." --content "..."'));
return 0;
}
@@ -341,12 +341,12 @@ export class MemoryCommand extends Command {
? ` [${this.formatScore(learning.effectiveness)}%]`
: '';
console.log(`${chalk.cyan('●')} ${learning.title}${chalk.green(effectiveness)}`);
console.log(` ${chalk.gray(learning.id.slice(0, 8))} | ${learning.tags.join(', ')} | ${learning.useCount} uses`);
console.log(`${colors.cyan('●')} ${learning.title}${colors.success(effectiveness)}`);
console.log(` ${colors.muted(learning.id.slice(0, 8))} | ${learning.tags.join(', ')} | ${learning.useCount} uses`);
if (this.verbose) {
const excerpt = learning.content.slice(0, 80);
console.log(` ${chalk.gray(excerpt)}${learning.content.length > 80 ? '...' : ''}`);
console.log(` ${colors.muted(excerpt)}${learning.content.length > 80 ? '...' : ''}`);
}
}
@@ -360,8 +360,8 @@ export class MemoryCommand extends Command {
private async showLearning(): Promise<number> {
const id = this.arg;
if (!id) {
console.error(chalk.red('Error: Learning ID is required'));
console.log(chalk.gray('Usage: skillkit memory show <id>'));
error('Error: Learning ID is required');
console.log(colors.muted('Usage: skillkit memory show <id>'));
return 1;
}
@@ -385,7 +385,7 @@ export class MemoryCommand extends Command {
}
if (!learning) {
console.error(chalk.red(`Learning not found: ${id}`));
error(`Learning not found: ${id}`);
return 1;
}
@@ -394,29 +394,29 @@ export class MemoryCommand extends Command {
return 0;
}
console.log(chalk.bold(`\n${learning.title}\n`));
console.log(chalk.gray(`ID: ${learning.id}`));
console.log(chalk.gray(`Scope: ${learning.scope}`));
console.log(chalk.gray(`Source: ${learning.source}`));
console.log(chalk.gray(`Tags: ${learning.tags.join(', ')}`));
console.log(colors.bold(`\n${learning.title}\n`));
console.log(colors.muted(`ID: ${learning.id}`));
console.log(colors.muted(`Scope: ${learning.scope}`));
console.log(colors.muted(`Source: ${learning.source}`));
console.log(colors.muted(`Tags: ${learning.tags.join(', ')}`));
if (learning.frameworks?.length) {
console.log(chalk.gray(`Frameworks: ${learning.frameworks.join(', ')}`));
console.log(colors.muted(`Frameworks: ${learning.frameworks.join(', ')}`));
}
if (learning.patterns?.length) {
console.log(chalk.gray(`Patterns: ${learning.patterns.join(', ')}`));
console.log(colors.muted(`Patterns: ${learning.patterns.join(', ')}`));
}
console.log(chalk.gray(`Created: ${new Date(learning.createdAt).toLocaleString()}`));
console.log(chalk.gray(`Updated: ${new Date(learning.updatedAt).toLocaleString()}`));
console.log(chalk.gray(`Uses: ${learning.useCount}`));
console.log(colors.muted(`Created: ${new Date(learning.createdAt).toLocaleString()}`));
console.log(colors.muted(`Updated: ${new Date(learning.updatedAt).toLocaleString()}`));
console.log(colors.muted(`Uses: ${learning.useCount}`));
if (learning.effectiveness !== undefined) {
console.log(chalk.gray(`Effectiveness: ${this.formatScore(learning.effectiveness)}%`));
console.log(colors.muted(`Effectiveness: ${this.formatScore(learning.effectiveness)}%`));
}
console.log(chalk.bold('\nContent:\n'));
console.log(colors.bold('\nContent:\n'));
console.log(learning.content);
console.log();
@@ -436,11 +436,11 @@ export class MemoryCommand extends Command {
const observations = observationStore.getAll();
if (observations.length === 0) {
console.log(chalk.yellow('No observations to compress.'));
console.log(colors.warning('No observations to compress.'));
return 0;
}
console.log(chalk.cyan(`Found ${observations.length} observations to compress...\n`));
console.log(colors.cyan(`Found ${observations.length} observations to compress...\n`));
const compressor = createMemoryCompressor(projectPath);
const compressionOptions = {
@@ -449,17 +449,17 @@ export class MemoryCommand extends Command {
};
if (this.dryRun) {
console.log(chalk.gray('(Dry run - no changes will be made)\n'));
console.log(colors.muted('(Dry run - no changes will be made)\n'));
// For dry-run, only compress without storing
const result = await compressor.compress(observations, compressionOptions);
console.log(chalk.green(`✓ Would compress ${result.stats.inputCount} observations into ${result.stats.outputCount} learnings\n`));
console.log(colors.success(`✓ Would compress ${result.stats.inputCount} observations into ${result.stats.outputCount} learnings\n`));
if (result.learnings.length > 0) {
console.log(chalk.bold('Learnings that would be created:'));
console.log(colors.bold('Learnings that would be created:'));
for (const learning of result.learnings) {
console.log(` ${chalk.cyan('●')} ${learning.title}`);
console.log(` ${colors.cyan('●')} ${learning.title}`);
console.log(` Tags: ${learning.tags.join(', ')}`);
}
console.log();
@@ -471,12 +471,12 @@ export class MemoryCommand extends Command {
// Actual compression with storage
const { learnings, result } = await compressor.compressAndStore(observations, compressionOptions);
console.log(chalk.green(`✓ Compressed ${result.stats.inputCount} observations into ${result.stats.outputCount} learnings\n`));
console.log(colors.success(`✓ Compressed ${result.stats.inputCount} observations into ${result.stats.outputCount} learnings\n`));
if (learnings.length > 0) {
console.log(chalk.bold('New Learnings:'));
console.log(colors.bold('New Learnings:'));
for (const learning of learnings) {
console.log(` ${chalk.cyan('●')} ${learning.title}`);
console.log(` ${colors.cyan('●')} ${learning.title}`);
console.log(` Tags: ${learning.tags.join(', ')}`);
}
console.log();
@@ -485,7 +485,7 @@ export class MemoryCommand extends Command {
if (result.processedObservationIds.length > 0) {
// Remove processed observations
const deleted = observationStore.deleteMany(result.processedObservationIds);
console.log(chalk.gray(`Cleared ${deleted} processed observations.`));
console.log(colors.muted(`Cleared ${deleted} processed observations.`));
}
return 0;
@@ -497,8 +497,8 @@ export class MemoryCommand extends Command {
private async exportLearning(): Promise<number> {
const id = this.arg;
if (!id) {
console.error(chalk.red('Error: Learning ID is required'));
console.log(chalk.gray('Usage: skillkit memory export <id> --name my-skill'));
error('Error: Learning ID is required');
console.log(colors.muted('Usage: skillkit memory export <id> --name my-skill'));
return 1;
}
@@ -519,7 +519,7 @@ export class MemoryCommand extends Command {
}
if (!learning) {
console.error(chalk.red(`Learning not found: ${id}`));
error(`Learning not found: ${id}`);
return 1;
}
@@ -530,7 +530,7 @@ export class MemoryCommand extends Command {
const skillContent = this.generateSkillContent(learning, skillName);
if (this.dryRun) {
console.log(chalk.gray('(Dry run preview)\n'));
console.log(colors.muted('(Dry run preview)\n'));
console.log(skillContent);
return 0;
}
@@ -547,8 +547,8 @@ export class MemoryCommand extends Command {
writeFileSync(outputPath, skillContent, 'utf-8');
console.log(chalk.green(`✓ Exported learning as skill: ${skillName}`));
console.log(chalk.gray(` Path: ${outputPath}`));
console.log(colors.success(`✓ Exported learning as skill: ${skillName}`));
console.log(colors.muted(` Path: ${outputPath}`));
return 0;
}
@@ -559,8 +559,8 @@ export class MemoryCommand extends Command {
private async importMemories(): Promise<number> {
const inputPath = this.input || this.arg;
if (!inputPath) {
console.error(chalk.red('Error: Input path is required'));
console.log(chalk.gray('Usage: skillkit memory import --input <path>'));
error('Error: Input path is required');
console.log(colors.muted('Usage: skillkit memory import --input <path>'));
return 1;
}
@@ -569,7 +569,7 @@ export class MemoryCommand extends Command {
const fullPath = resolve(inputPath);
if (!existsSync(fullPath)) {
console.error(chalk.red(`File not found: ${fullPath}`));
error(`File not found: ${fullPath}`);
return 1;
}
@@ -585,14 +585,14 @@ export class MemoryCommand extends Command {
const data = parseYaml(content) as { learnings?: Learning[] };
if (!data.learnings || !Array.isArray(data.learnings)) {
console.error(chalk.red('Invalid memory file format'));
error('Invalid memory file format');
return 1;
}
let imported = 0;
for (const learning of data.learnings) {
if (this.dryRun) {
console.log(chalk.gray(`Would import: ${learning.title}`));
console.log(colors.muted(`Would import: ${learning.title}`));
} else {
store.add({
source: 'imported',
@@ -608,14 +608,14 @@ export class MemoryCommand extends Command {
}
if (this.dryRun) {
console.log(chalk.gray(`\n(Dry run - ${data.learnings.length} learnings would be imported)`));
console.log(colors.muted(`\n(Dry run - ${data.learnings.length} learnings would be imported)`));
} else {
console.log(chalk.green(`✓ Imported ${imported} learnings`));
console.log(colors.success(`✓ Imported ${imported} learnings`));
}
return 0;
} catch (error) {
console.error(chalk.red(`Import failed: ${error}`));
} catch (err) {
error(`Import failed: ${err}`);
return 1;
}
}
@@ -630,7 +630,7 @@ export class MemoryCommand extends Command {
const observationStore = new ObservationStore(projectPath);
const learningStore = new LearningStore('project', projectPath);
console.log(chalk.gray('(Dry run preview)\n'));
console.log(colors.muted('(Dry run preview)\n'));
console.log(`Would clear ${observationStore.count()} observations`);
if (!this.keepLearnings) {
console.log(`Would clear ${learningStore.count()} learnings`);
@@ -640,12 +640,12 @@ export class MemoryCommand extends Command {
const observationStore = new ObservationStore(projectPath);
observationStore.clear();
console.log(chalk.green('✓ Cleared session observations'));
console.log(colors.success('✓ Cleared session observations'));
if (!this.keepLearnings) {
const learningStore = new LearningStore('project', projectPath);
learningStore.clear();
console.log(chalk.green('✓ Cleared project learnings'));
console.log(colors.success('✓ Cleared project learnings'));
}
return 0;
@@ -656,14 +656,14 @@ export class MemoryCommand extends Command {
*/
private async addLearning(): Promise<number> {
if (!this.title) {
console.error(chalk.red('Error: --title is required'));
console.log(chalk.gray('Usage: skillkit memory add --title "..." --content "..."'));
error('Error: --title is required');
console.log(colors.muted('Usage: skillkit memory add --title "..." --content "..."'));
return 1;
}
if (!this.content) {
console.error(chalk.red('Error: --content is required'));
console.log(chalk.gray('Usage: skillkit memory add --title "..." --content "..."'));
error('Error: --content is required');
console.log(colors.muted('Usage: skillkit memory add --title "..." --content "..."'));
return 1;
}
@@ -682,8 +682,8 @@ export class MemoryCommand extends Command {
tags,
});
console.log(chalk.green(`✓ Added learning: ${learning.title}`));
console.log(chalk.gray(` ID: ${learning.id}`));
console.log(colors.success(`✓ Added learning: ${learning.title}`));
console.log(colors.muted(` ID: ${learning.id}`));
return 0;
}
@@ -694,15 +694,15 @@ export class MemoryCommand extends Command {
private async rateLearning(): Promise<number> {
const id = this.arg;
if (!id) {
console.error(chalk.red('Error: Learning ID is required'));
console.log(chalk.gray('Usage: skillkit memory rate <id> <rating>'));
error('Error: Learning ID is required');
console.log(colors.muted('Usage: skillkit memory rate <id> <rating>'));
return 1;
}
const rating = parseInt(this.ratingArg || '0', 10);
if (isNaN(rating) || rating < 0 || rating > 100) {
console.error(chalk.red('Error: Rating must be 0-100'));
console.log(chalk.gray('Usage: skillkit memory rate <id> <rating>'));
error('Error: Rating must be 0-100');
console.log(colors.muted('Usage: skillkit memory rate <id> <rating>'));
return 1;
}
@@ -737,12 +737,12 @@ export class MemoryCommand extends Command {
}
if (!learning) {
console.error(chalk.red(`Learning not found: ${id}`));
error(`Learning not found: ${id}`);
return 1;
}
store.setEffectiveness(learning.id, rating);
console.log(chalk.green(`✓ Rated "${learning.title}" as ${rating}% effective`));
console.log(colors.success(`✓ Rated "${learning.title}" as ${rating}% effective`));
return 0;
}
@@ -759,14 +759,14 @@ export class MemoryCommand extends Command {
return 0;
}
console.log(chalk.bold('\nMemory Configuration\n'));
console.log(colors.bold('\nMemory Configuration\n'));
console.log(chalk.cyan('Paths:'));
console.log(` Project observations: ${chalk.gray(paths.observationsFile)}`);
console.log(` Project learnings: ${chalk.gray(paths.learningsFile)}`);
console.log(` Project index: ${chalk.gray(paths.indexFile)}`);
console.log(` Global learnings: ${chalk.gray(paths.globalLearningsFile)}`);
console.log(` Global index: ${chalk.gray(paths.globalIndexFile)}`);
console.log(colors.cyan('Paths:'));
console.log(` Project observations: ${colors.muted(paths.observationsFile)}`);
console.log(` Project learnings: ${colors.muted(paths.learningsFile)}`);
console.log(` Project index: ${colors.muted(paths.indexFile)}`);
console.log(` Global learnings: ${colors.muted(paths.globalLearningsFile)}`);
console.log(` Global index: ${colors.muted(paths.globalIndexFile)}`);
console.log();
return 0;
@@ -780,7 +780,7 @@ export class MemoryCommand extends Command {
if (this.global) {
if (this.dryRun) {
console.log(chalk.gray('(Dry run - previewing global CLAUDE.md sync)\n'));
console.log(colors.muted('(Dry run - previewing global CLAUDE.md sync)\n'));
}
const result = this.dryRun
@@ -792,21 +792,21 @@ export class MemoryCommand extends Command {
const learnings = globalStore.getAll()
.filter((l) => (l.effectiveness ?? 0) >= 60 || l.useCount >= 3)
.slice(0, 20);
console.log(chalk.cyan(`Would add ${learnings.length} learnings to global CLAUDE.md`));
console.log(colors.cyan(`Would add ${learnings.length} learnings to global CLAUDE.md`));
for (const l of learnings.slice(0, 5)) {
console.log(` ${chalk.gray('●')} ${l.title}`);
console.log(` ${colors.muted('●')} ${l.title}`);
}
if (learnings.length > 5) {
console.log(chalk.gray(` ... and ${learnings.length - 5} more`));
console.log(colors.muted(` ... and ${learnings.length - 5} more`));
}
return 0;
}
if (result.updated) {
console.log(chalk.green(`✓ Updated global CLAUDE.md with ${result.learningsAdded} learnings`));
console.log(chalk.gray(` Path: ${result.path}`));
console.log(colors.success(`✓ Updated global CLAUDE.md with ${result.learningsAdded} learnings`));
console.log(colors.muted(` Path: ${result.path}`));
} else {
console.log(chalk.yellow('No learnings to sync to global CLAUDE.md'));
console.log(colors.warning('No learnings to sync to global CLAUDE.md'));
}
return 0;
@@ -817,28 +817,28 @@ export class MemoryCommand extends Command {
if (this.dryRun) {
const preview = updater.preview({ minEffectiveness: 60 });
console.log(chalk.gray('(Dry run preview)\n'));
console.log(colors.muted('(Dry run preview)\n'));
if (!preview.wouldUpdate) {
console.log(chalk.yellow('No learnings to sync to CLAUDE.md'));
console.log(colors.warning('No learnings to sync to CLAUDE.md'));
return 0;
}
console.log(chalk.cyan(`Would add ${preview.learnings.length} learnings to CLAUDE.md\n`));
console.log(colors.cyan(`Would add ${preview.learnings.length} learnings to CLAUDE.md\n`));
for (const learning of preview.learnings.slice(0, 5)) {
console.log(` ${chalk.gray('●')} ${learning.title}`);
console.log(` ${colors.muted('●')} ${learning.title}`);
}
if (preview.learnings.length > 5) {
console.log(chalk.gray(` ... and ${preview.learnings.length - 5} more`));
console.log(colors.muted(` ... and ${preview.learnings.length - 5} more`));
}
console.log(chalk.bold('\nFormatted section preview:'));
console.log(chalk.gray('─'.repeat(50)));
console.log(colors.bold('\nFormatted section preview:'));
console.log(colors.muted('─'.repeat(50)));
console.log(preview.formattedSection.slice(0, 500));
if (preview.formattedSection.length > 500) {
console.log(chalk.gray('...'));
console.log(colors.muted('...'));
}
return 0;
@@ -847,17 +847,17 @@ export class MemoryCommand extends Command {
const result = updater.update({ minEffectiveness: 60 });
if (result.updated) {
console.log(chalk.green(`✓ Updated CLAUDE.md with ${result.learningsAdded} learnings`));
console.log(chalk.gray(` Path: ${result.path}`));
console.log(colors.success(`✓ Updated CLAUDE.md with ${result.learningsAdded} learnings`));
console.log(colors.muted(` Path: ${result.path}`));
if (this.verbose && result.learningSummaries.length > 0) {
console.log(chalk.cyan('\nLearnings added:'));
console.log(colors.cyan('\nLearnings added:'));
for (const title of result.learningSummaries.slice(0, 10)) {
console.log(` ${chalk.gray('●')} ${title}`);
console.log(` ${colors.muted('●')} ${title}`);
}
}
} else {
console.log(chalk.yellow('No learnings to sync to CLAUDE.md'));
console.log(colors.warning('No learnings to sync to CLAUDE.md'));
}
return 0;
@@ -874,7 +874,7 @@ export class MemoryCommand extends Command {
if (this.limit) {
const parsed = parseInt(this.limit, 10);
if (isNaN(parsed) || parsed <= 0) {
console.log(chalk.red('Invalid --limit value. Must be a positive number.'));
console.log(colors.error('Invalid --limit value. Must be a positive number.'));
return 1;
}
maxResults = parsed;
@@ -887,10 +887,10 @@ export class MemoryCommand extends Command {
return 0;
}
console.log(chalk.bold(`\nMemory Index (${index.length} entries)\n`));
console.log(colors.bold(`\nMemory Index (${index.length} entries)\n`));
if (index.length === 0) {
console.log(chalk.gray('No learnings found.'));
console.log(colors.muted('No learnings found.'));
return 0;
}
@@ -901,17 +901,17 @@ export class MemoryCommand extends Command {
const effectiveness = entry.effectiveness !== undefined
? ` [${this.formatScore(entry.effectiveness)}%]`
: '';
const scope = entry.scope === 'global' ? chalk.magenta('[G]') : chalk.blue('[P]');
const scope = entry.scope === 'global' ? colors.magenta('[G]') : colors.info('[P]');
console.log(`${scope} ${chalk.gray(entry.id.slice(0, 8))} ${entry.title}${chalk.green(effectiveness)}`);
console.log(`${scope} ${colors.muted(entry.id.slice(0, 8))} ${entry.title}${colors.success(effectiveness)}`);
console.log(` Tags: ${entry.tags.join(', ')} | Uses: ${entry.useCount}`);
}
if (index.length > displayLimit) {
console.log(chalk.gray(`\n... and ${index.length - displayLimit} more (use --limit to show more)`));
console.log(colors.muted(`\n... and ${index.length - displayLimit} more (use --limit to show more)`));
}
console.log(chalk.gray('\nUse "skillkit memory show <id>" to view full details'));
console.log(colors.muted('\nUse "skillkit memory show <id>" to view full details'));
return 0;
}
@@ -920,9 +920,9 @@ export class MemoryCommand extends Command {
* Format relevance/effectiveness score with color
*/
private formatScore(score: number): string {
if (score >= 80) return chalk.green(score.toString());
if (score >= 50) return chalk.yellow(score.toString());
return chalk.red(score.toString());
if (score >= 80) return colors.success(score.toString());
if (score >= 50) return colors.warning(score.toString());
return colors.error(score.toString());
}
/**
+111 -111
View File
@@ -1,5 +1,5 @@
import { Command, Option } from 'clipanion';
import chalk from 'chalk';
import { colors, error } from '../onboarding/index.js';
export class MeshCommand extends Command {
static override paths = [['mesh']];
@@ -72,8 +72,8 @@ export class MeshCommand extends Command {
case 'peer':
return this.handlePeer();
default:
console.error(chalk.red(`Unknown action: ${action}`));
console.log(chalk.gray('Available actions: init, add, remove, list, health, discover, status, security, peer'));
error(`Unknown action: ${action}`);
console.log(colors.muted('Available actions: init, add, remove, list, health, discover, status, security, peer'));
return 1;
}
}
@@ -86,10 +86,10 @@ export class MeshCommand extends Command {
const localConfig = hostsFile.localHost;
const localIP = getLocalIPAddress();
console.log(chalk.green('✓ Mesh network initialized\n'));
console.log(colors.success('✓ Mesh network initialized\n'));
console.log(chalk.bold('Local Host Configuration:'));
console.log(` ID: ${chalk.cyan(localConfig.id.slice(0, 8))}`);
console.log(colors.bold('Local Host Configuration:'));
console.log(` ID: ${colors.cyan(localConfig.id.slice(0, 8))}`);
console.log(` Name: ${localConfig.name}`);
console.log(` Address: ${localIP}:${localConfig.port}`);
@@ -102,20 +102,20 @@ export class MeshCommand extends Command {
}
console.log();
console.log(chalk.gray('Other hosts can connect to this machine using:'));
console.log(chalk.gray(` skillkit mesh add ${localIP}:${localConfig.port}`));
console.log(colors.muted('Other hosts can connect to this machine using:'));
console.log(colors.muted(` skillkit mesh add ${localIP}:${localConfig.port}`));
return 0;
} catch (err: any) {
console.error(chalk.red(`Failed to initialize mesh: ${err.message}`));
error(`Failed to initialize mesh: ${err.message}`);
return 1;
}
}
private async addHost(): Promise<number> {
if (!this.arg) {
console.error(chalk.red('Error: Host address is required'));
console.log(chalk.gray('Usage: skillkit mesh add <address>[:port]'));
error('Error: Host address is required');
console.log(colors.muted('Usage: skillkit mesh add <address>[:port]'));
return 1;
}
@@ -127,7 +127,7 @@ export class MeshCommand extends Command {
const portValue = portStr ?? this.port;
const port = portValue ? Number(portValue) : DEFAULT_PORT;
if (!Number.isInteger(port) || port < 1 || port > 65535) {
console.error(chalk.red(`Invalid port: ${portValue}`));
error(`Invalid port: ${portValue}`);
return 1;
}
@@ -142,23 +142,23 @@ export class MeshCommand extends Command {
await addKnownHost(host);
console.log(chalk.green(`✓ Added host: ${host.name}`));
console.log(` ID: ${chalk.gray(host.id.slice(0, 8))}`);
console.log(colors.success(`✓ Added host: ${host.name}`));
console.log(` ID: ${colors.muted(host.id.slice(0, 8))}`);
console.log(` Address: ${host.address}:${host.port}`);
console.log(chalk.gray('\nRun "skillkit mesh health" to verify connectivity.'));
console.log(colors.muted('\nRun "skillkit mesh health" to verify connectivity.'));
return 0;
} catch (err: any) {
console.error(chalk.red(`Failed to add host: ${err.message}`));
error(`Failed to add host: ${err.message}`);
return 1;
}
}
private async removeHost(): Promise<number> {
if (!this.arg) {
console.error(chalk.red('Error: Host ID is required'));
console.log(chalk.gray('Usage: skillkit mesh remove <hostId>'));
error('Error: Host ID is required');
console.log(colors.muted('Usage: skillkit mesh remove <hostId>'));
return 1;
}
@@ -169,22 +169,22 @@ export class MeshCommand extends Command {
const host = hosts.find(h => h.id === this.arg || h.id.startsWith(this.arg!) || h.name === this.arg);
if (!host) {
console.error(chalk.red(`Host not found: ${this.arg}`));
error(`Host not found: ${this.arg}`);
return 1;
}
const removed = await removeKnownHost(host.id);
if (removed) {
console.log(chalk.green(`✓ Removed host: ${host.name}`));
console.log(colors.success(`✓ Removed host: ${host.name}`));
} else {
console.error(chalk.red('Failed to remove host'));
error('Failed to remove host');
return 1;
}
return 0;
} catch (err: any) {
console.error(chalk.red(`Failed to remove host: ${err.message}`));
error(`Failed to remove host: ${err.message}`);
return 1;
}
}
@@ -202,23 +202,23 @@ export class MeshCommand extends Command {
return 0;
}
console.log(chalk.bold('\nLocal Host:\n'));
console.log(` ${chalk.cyan('●')} ${localConfig.name} ${chalk.green('[local]')}`);
console.log(` ID: ${chalk.gray(localConfig.id.slice(0, 8))}`);
console.log(colors.bold('\nLocal Host:\n'));
console.log(` ${colors.cyan('●')} ${localConfig.name} ${colors.success('[local]')}`);
console.log(` ID: ${colors.muted(localConfig.id.slice(0, 8))}`);
console.log(` Address: ${localIP}:${localConfig.port}`);
console.log(chalk.bold('\nKnown Hosts:\n'));
console.log(colors.bold('\nKnown Hosts:\n'));
if (hosts.length === 0) {
console.log(chalk.gray(' No hosts configured.'));
console.log(chalk.gray(' Add hosts with: skillkit mesh add <address>'));
console.log(colors.muted(' No hosts configured.'));
console.log(colors.muted(' Add hosts with: skillkit mesh add <address>'));
} else {
for (const host of hosts) {
const statusIcon = host.status === 'online' ? chalk.green('●') : host.status === 'offline' ? chalk.red('●') : chalk.gray('○');
const statusLabel = host.status === 'online' ? chalk.green('[online]') : host.status === 'offline' ? chalk.red('[offline]') : chalk.gray('[unknown]');
const statusIcon = host.status === 'online' ? colors.success('●') : host.status === 'offline' ? colors.error('●') : colors.muted('○');
const statusLabel = host.status === 'online' ? colors.success('[online]') : host.status === 'offline' ? colors.error('[offline]') : colors.muted('[unknown]');
console.log(` ${statusIcon} ${host.name} ${statusLabel}`);
console.log(` ID: ${chalk.gray(host.id.slice(0, 8))}`);
console.log(` ID: ${colors.muted(host.id.slice(0, 8))}`);
console.log(` Address: ${host.address}:${host.port}`);
if (host.tailscaleIP) {
console.log(` Tailscale: ${host.tailscaleIP}`);
@@ -235,9 +235,9 @@ export class MeshCommand extends Command {
const tailscaleHosts = await discoverTailscaleHosts(localConfig.port);
if (tailscaleHosts.length > 0) {
console.log(chalk.bold('\nTailscale Peers:\n'));
console.log(colors.bold('\nTailscale Peers:\n'));
for (const host of tailscaleHosts) {
console.log(` ${chalk.blue('◆')} ${host.name}`);
console.log(` ${colors.info('◆')} ${host.name}`);
console.log(` IP: ${host.tailscaleIP}`);
}
}
@@ -247,7 +247,7 @@ export class MeshCommand extends Command {
console.log();
return 0;
} catch (err: any) {
console.error(chalk.red(`Failed to list hosts: ${err.message}`));
error(`Failed to list hosts: ${err.message}`);
return 1;
}
}
@@ -259,12 +259,12 @@ export class MeshCommand extends Command {
const hosts = await getKnownHosts();
if (hosts.length === 0) {
console.log(chalk.yellow('No hosts configured.'));
console.log(chalk.gray('Add hosts with: skillkit mesh add <address>'));
console.log(colors.warning('No hosts configured.'));
console.log(colors.muted('Add hosts with: skillkit mesh add <address>'));
return 0;
}
console.log(chalk.bold('\nChecking host health...\n'));
console.log(colors.bold('\nChecking host health...\n'));
const timeout = this.timeout ? parseInt(this.timeout, 10) : undefined;
const results = await checkAllHostsHealth({ timeout });
@@ -281,10 +281,10 @@ export class MeshCommand extends Command {
const name = host?.name || result.hostId.slice(0, 8);
if (result.status === 'online') {
console.log(` ${chalk.green('✓')} ${name} - ${chalk.green('online')} (${result.latencyMs}ms)`);
console.log(` ${colors.success('✓')} ${name} - ${colors.success('online')} (${result.latencyMs}ms)`);
} else {
hasFailures = true;
console.log(` ${chalk.red('✗')} ${name} - ${chalk.red('offline')} ${result.error ? `(${result.error})` : ''}`);
console.log(` ${colors.error('✗')} ${name} - ${colors.error('offline')} ${result.error ? `(${result.error})` : ''}`);
}
}
@@ -296,7 +296,7 @@ export class MeshCommand extends Command {
return hasFailures ? 1 : 0;
} catch (err: any) {
console.error(chalk.red(`Failed to check health: ${err.message}`));
error(`Failed to check health: ${err.message}`);
return 1;
}
}
@@ -305,18 +305,18 @@ export class MeshCommand extends Command {
try {
const { discoverOnce, isTailscaleAvailable, discoverTailscaleHosts, getLocalHostConfig } = await import('@skillkit/mesh');
console.log(chalk.bold('\nDiscovering hosts on local network...\n'));
console.log(colors.bold('\nDiscovering hosts on local network...\n'));
const timeout = this.timeout ? parseInt(this.timeout, 10) : 5000;
const localHosts = await discoverOnce(timeout);
if (localHosts.length === 0) {
console.log(chalk.gray(' No hosts discovered on local network.'));
console.log(colors.muted(' No hosts discovered on local network.'));
} else {
console.log(chalk.cyan('Local Network:'));
console.log(colors.cyan('Local Network:'));
for (const host of localHosts) {
console.log(` ${chalk.green('●')} ${host.name}`);
console.log(` ${colors.success('●')} ${host.name}`);
console.log(` Address: ${host.address}:${host.port}`);
}
}
@@ -328,23 +328,23 @@ export class MeshCommand extends Command {
const tailscaleHosts = await discoverTailscaleHosts(localConfig.port);
if (tailscaleHosts.length > 0) {
console.log(chalk.cyan('\nTailscale Network:'));
console.log(colors.cyan('\nTailscale Network:'));
for (const host of tailscaleHosts) {
console.log(` ${chalk.blue('◆')} ${host.name}`);
console.log(` ${colors.info('◆')} ${host.name}`);
console.log(` Tailscale IP: ${host.tailscaleIP}`);
}
} else {
console.log(chalk.gray('\n No Tailscale peers found.'));
console.log(colors.muted('\n No Tailscale peers found.'));
}
} else {
console.log(chalk.gray('\n Tailscale not available.'));
console.log(colors.muted('\n Tailscale not available.'));
}
}
console.log();
return 0;
} catch (err: any) {
console.error(chalk.red(`Failed to discover hosts: ${err.message}`));
error(`Failed to discover hosts: ${err.message}`);
return 1;
}
}
@@ -373,31 +373,31 @@ export class MeshCommand extends Command {
return 0;
}
console.log(chalk.bold('\nMesh Network Status\n'));
console.log(colors.bold('\nMesh Network Status\n'));
console.log(chalk.cyan('Local Host:'));
console.log(colors.cyan('Local Host:'));
console.log(` Name: ${localConfig.name}`);
console.log(` ID: ${chalk.gray(localConfig.id.slice(0, 8))}`);
console.log(` ID: ${colors.muted(localConfig.id.slice(0, 8))}`);
console.log(` Address: ${localIP}:${localConfig.port}`);
if (hasTailscale) {
const tailscaleIP = await getTailscaleIP();
if (tailscaleIP) {
console.log(` Tailscale: ${chalk.blue(tailscaleIP)}`);
console.log(` Tailscale: ${colors.info(tailscaleIP)}`);
}
}
console.log();
console.log(chalk.cyan('Network:'));
console.log(colors.cyan('Network:'));
console.log(` Known hosts: ${hosts.length}`);
console.log(` Online: ${onlineHosts}`);
console.log(` Local peers: ${localPeers.length}`);
console.log(` Tailscale: ${hasTailscale ? chalk.green('available') : chalk.gray('not available')}`);
console.log(` Tailscale: ${hasTailscale ? colors.success('available') : colors.muted('not available')}`);
console.log();
return 0;
} catch (err: any) {
console.error(chalk.red(`Failed to get status: ${err.message}`));
error(`Failed to get status: ${err.message}`);
return 1;
}
}
@@ -411,8 +411,8 @@ export class MeshCommand extends Command {
case 'status':
return this.showSecurityStatus();
default:
console.error(chalk.red(`Unknown security action: ${subAction}`));
console.log(chalk.gray('Available actions: init, status'));
error(`Unknown security action: ${subAction}`);
console.log(colors.muted('Available actions: init, status'));
return 1;
}
}
@@ -421,33 +421,33 @@ export class MeshCommand extends Command {
try {
const { SecureKeystore, TLSManager, getLocalHostConfig, describeSecurityLevel, DEFAULT_SECURITY_CONFIG } = await import('@skillkit/mesh');
console.log(chalk.bold('\nInitializing mesh security...\n'));
console.log(colors.bold('\nInitializing mesh security...\n'));
const keystore = new SecureKeystore();
const identity = await keystore.loadOrCreateIdentity();
console.log(chalk.green('✓ Identity created/loaded'));
console.log(` Fingerprint: ${chalk.cyan(identity.fingerprint)}`);
console.log(` Public Key: ${chalk.gray(identity.publicKeyHex.slice(0, 32))}...`);
console.log(colors.success('✓ Identity created/loaded'));
console.log(` Fingerprint: ${colors.cyan(identity.fingerprint)}`);
console.log(` Public Key: ${colors.muted(identity.publicKeyHex.slice(0, 32))}...`);
const localConfig = await getLocalHostConfig();
const tlsManager = new TLSManager();
const certInfo = await tlsManager.loadOrCreateCertificate(localConfig.id, 'localhost');
console.log(chalk.green('\n✓ TLS certificate generated'));
console.log(` Fingerprint: ${chalk.gray(certInfo.fingerprint.slice(0, 16))}...`);
console.log(colors.success('\n✓ TLS certificate generated'));
console.log(` Fingerprint: ${colors.muted(certInfo.fingerprint.slice(0, 16))}...`);
console.log(` Valid until: ${certInfo.notAfter.toLocaleDateString()}`);
console.log(chalk.green('\n✓ Security initialized'));
console.log(` Mode: ${chalk.cyan(describeSecurityLevel(DEFAULT_SECURITY_CONFIG))}`);
console.log(colors.success('\n✓ Security initialized'));
console.log(` Mode: ${colors.cyan(describeSecurityLevel(DEFAULT_SECURITY_CONFIG))}`);
console.log(chalk.gray('\nOther hosts can trust this peer using:'));
console.log(chalk.gray(` skillkit mesh peer trust ${identity.fingerprint}`));
console.log(colors.muted('\nOther hosts can trust this peer using:'));
console.log(colors.muted(` skillkit mesh peer trust ${identity.fingerprint}`));
console.log();
return 0;
} catch (err: any) {
console.error(chalk.red(`Failed to initialize security: ${err.message}`));
error(`Failed to initialize security: ${err.message}`);
return 1;
}
}
@@ -465,7 +465,7 @@ export class MeshCommand extends Command {
const keystore = new SecureKeystore();
console.log(chalk.bold('\nMesh Security Status\n'));
console.log(colors.bold('\nMesh Security Status\n'));
const hasIdentity = await keystore.hasIdentity();
@@ -474,47 +474,47 @@ export class MeshCommand extends Command {
const trustedPeers = await keystore.getTrustedPeers();
const revokedPeers = await keystore.getRevokedFingerprints();
console.log(chalk.cyan('Identity:'));
console.log(` Fingerprint: ${chalk.green(identity.fingerprint)}`);
console.log(` Public Key: ${chalk.gray(identity.publicKeyHex.slice(0, 32))}...`);
console.log(colors.cyan('Identity:'));
console.log(` Fingerprint: ${colors.success(identity.fingerprint)}`);
console.log(` Public Key: ${colors.muted(identity.publicKeyHex.slice(0, 32))}...`);
console.log(chalk.cyan('\nTrust:'));
console.log(colors.cyan('\nTrust:'));
console.log(` Trusted peers: ${trustedPeers.length}`);
console.log(` Revoked peers: ${revokedPeers.length}`);
if (this.verbose && trustedPeers.length > 0) {
console.log(chalk.cyan('\nTrusted Peers:'));
console.log(colors.cyan('\nTrusted Peers:'));
for (const peer of trustedPeers) {
console.log(` ${chalk.green('●')} ${peer.name || peer.fingerprint.slice(0, 16)}`);
console.log(` Fingerprint: ${chalk.gray(peer.fingerprint)}`);
console.log(` ${colors.success('●')} ${peer.name || peer.fingerprint.slice(0, 16)}`);
console.log(` Fingerprint: ${colors.muted(peer.fingerprint)}`);
console.log(` Added: ${new Date(peer.addedAt).toLocaleDateString()}`);
}
}
} else {
console.log(chalk.yellow('Identity: Not initialized'));
console.log(chalk.gray('Run "skillkit mesh security init" to initialize.'));
console.log(colors.warning('Identity: Not initialized'));
console.log(colors.muted('Run "skillkit mesh security init" to initialize.'));
}
const localConfig = await getLocalHostConfig();
const tlsManager = new TLSManager();
const hasCert = await tlsManager.hasCertificate(localConfig.id);
console.log(chalk.cyan('\nTLS:'));
console.log(colors.cyan('\nTLS:'));
if (hasCert) {
const certInfo = await tlsManager.loadCertificate(localConfig.id);
console.log(` Certificate: ${chalk.green('Available')}`);
console.log(` Certificate: ${colors.success('Available')}`);
if (certInfo) {
console.log(` Fingerprint: ${chalk.gray(certInfo.fingerprint.slice(0, 16))}...`);
console.log(` Fingerprint: ${colors.muted(certInfo.fingerprint.slice(0, 16))}...`);
}
} else {
console.log(` Certificate: ${chalk.yellow('Not generated')}`);
console.log(` Certificate: ${colors.warning('Not generated')}`);
}
console.log(chalk.cyan('\nConfiguration:'));
console.log(` Security level: ${chalk.cyan(describeSecurityLevel(DEFAULT_SECURITY_CONFIG))}`);
console.log(colors.cyan('\nConfiguration:'));
console.log(` Security level: ${colors.cyan(describeSecurityLevel(DEFAULT_SECURITY_CONFIG))}`);
console.log(` Discovery mode: ${DEFAULT_SECURITY_CONFIG.discovery.mode}`);
console.log(` Transport encryption: ${DEFAULT_SECURITY_CONFIG.transport.encryption}`);
console.log(` Auth required: ${DEFAULT_SECURITY_CONFIG.transport.requireAuth ? chalk.green('yes') : chalk.gray('no')}`);
console.log(` Auth required: ${DEFAULT_SECURITY_CONFIG.transport.requireAuth ? colors.success('yes') : colors.muted('no')}`);
if (this.json) {
const identity = hasIdentity ? await keystore.loadOrCreateIdentity() : null;
@@ -530,7 +530,7 @@ export class MeshCommand extends Command {
console.log();
return 0;
} catch (err: any) {
console.error(chalk.red(`Failed to get security status: ${err.message}`));
error(`Failed to get security status: ${err.message}`);
return 1;
}
}
@@ -539,8 +539,8 @@ export class MeshCommand extends Command {
const subAction = this.arg;
if (!subAction) {
console.error(chalk.red('Error: Peer action is required'));
console.log(chalk.gray('Usage: skillkit mesh peer <trust|revoke|list> [fingerprint]'));
error('Error: Peer action is required');
console.log(colors.muted('Usage: skillkit mesh peer <trust|revoke|list> [fingerprint]'));
return 1;
}
@@ -552,8 +552,8 @@ export class MeshCommand extends Command {
case 'list':
return this.listPeers();
default:
console.error(chalk.red(`Unknown peer action: ${subAction}`));
console.log(chalk.gray('Available actions: trust, revoke, list'));
error(`Unknown peer action: ${subAction}`);
console.log(colors.muted('Available actions: trust, revoke, list'));
return 1;
}
}
@@ -562,8 +562,8 @@ export class MeshCommand extends Command {
const fingerprint = this.subArg;
if (!fingerprint) {
console.error(chalk.red('Error: Fingerprint is required'));
console.log(chalk.gray('Usage: skillkit mesh peer trust <fingerprint> [--name <name>]'));
error('Error: Fingerprint is required');
console.log(colors.muted('Usage: skillkit mesh peer trust <fingerprint> [--name <name>]'));
return 1;
}
@@ -574,17 +574,17 @@ export class MeshCommand extends Command {
const isRevoked = await keystore.isRevoked(fingerprint);
if (isRevoked) {
console.log(chalk.yellow(`Peer ${fingerprint.slice(0, 8)} was previously revoked. Removing from revoked list...`));
console.log(colors.warning(`Peer ${fingerprint.slice(0, 8)} was previously revoked. Removing from revoked list...`));
}
await keystore.addTrustedPeer(fingerprint, '', this.name);
console.log(chalk.green(`✓ Trusted peer: ${this.name || fingerprint.slice(0, 16)}`));
console.log(` Fingerprint: ${chalk.gray(fingerprint)}`);
console.log(colors.success(`✓ Trusted peer: ${this.name || fingerprint.slice(0, 16)}`));
console.log(` Fingerprint: ${colors.muted(fingerprint)}`);
return 0;
} catch (err: any) {
console.error(chalk.red(`Failed to trust peer: ${err.message}`));
error(`Failed to trust peer: ${err.message}`);
return 1;
}
}
@@ -593,8 +593,8 @@ export class MeshCommand extends Command {
const fingerprint = this.subArg;
if (!fingerprint) {
console.error(chalk.red('Error: Fingerprint is required'));
console.log(chalk.gray('Usage: skillkit mesh peer revoke <fingerprint>'));
error('Error: Fingerprint is required');
console.log(colors.muted('Usage: skillkit mesh peer revoke <fingerprint>'));
return 1;
}
@@ -604,12 +604,12 @@ export class MeshCommand extends Command {
const keystore = new SecureKeystore();
await keystore.revokePeer(fingerprint);
console.log(chalk.green(`✓ Revoked peer: ${fingerprint.slice(0, 16)}`));
console.log(chalk.gray('This peer will no longer be trusted for mesh communication.'));
console.log(colors.success(`✓ Revoked peer: ${fingerprint.slice(0, 16)}`));
console.log(colors.muted('This peer will no longer be trusted for mesh communication.'));
return 0;
} catch (err: any) {
console.error(chalk.red(`Failed to revoke peer: ${err.message}`));
error(`Failed to revoke peer: ${err.message}`);
return 1;
}
}
@@ -627,34 +627,34 @@ export class MeshCommand extends Command {
return 0;
}
console.log(chalk.bold('\nPeer Trust Status\n'));
console.log(colors.bold('\nPeer Trust Status\n'));
if (this.trusted || trustedPeers.length > 0) {
console.log(chalk.cyan('Trusted Peers:'));
console.log(colors.cyan('Trusted Peers:'));
if (trustedPeers.length === 0) {
console.log(chalk.gray(' No trusted peers.'));
console.log(colors.muted(' No trusted peers.'));
} else {
for (const peer of trustedPeers) {
console.log(` ${chalk.green('●')} ${peer.name || 'Unknown'}`);
console.log(` Fingerprint: ${chalk.gray(peer.fingerprint)}`);
console.log(` ${colors.success('●')} ${peer.name || 'Unknown'}`);
console.log(` Fingerprint: ${colors.muted(peer.fingerprint)}`);
console.log(` Added: ${new Date(peer.addedAt).toLocaleDateString()}`);
}
}
}
if (!this.trusted && revokedFingerprints.length > 0) {
console.log(chalk.cyan('\nRevoked Peers:'));
console.log(colors.cyan('\nRevoked Peers:'));
for (const fp of revokedFingerprints) {
console.log(` ${chalk.red('●')} ${chalk.gray(fp)}`);
console.log(` ${colors.error('●')} ${colors.muted(fp)}`);
}
}
console.log(chalk.gray(`\nTotal: ${trustedPeers.length} trusted, ${revokedFingerprints.length} revoked`));
console.log(colors.muted(`\nTotal: ${trustedPeers.length} trusted, ${revokedFingerprints.length} revoked`));
console.log();
return 0;
} catch (err: any) {
console.error(chalk.red(`Failed to list peers: ${err.message}`));
error(`Failed to list peers: ${err.message}`);
return 1;
}
}
+68 -68
View File
@@ -1,5 +1,5 @@
import { Command, Option } from 'clipanion';
import chalk from 'chalk';
import { colors, error } from '../onboarding/index.js';
export class MessageCommand extends Command {
static override paths = [['message'], ['msg']];
@@ -66,8 +66,8 @@ export class MessageCommand extends Command {
case 'status':
return this.showStatus();
default:
console.error(chalk.red(`Unknown action: ${action}`));
console.log(chalk.gray('Available actions: send, inbox, read, reply, archive, forward, sent, status'));
error(`Unknown action: ${action}`);
console.log(colors.muted('Available actions: send, inbox, read, reply, archive, forward, sent, status'));
return 1;
}
}
@@ -79,14 +79,14 @@ export class MessageCommand extends Command {
private async sendMessage(): Promise<number> {
const to = this.arg;
if (!to) {
console.error(chalk.red('Error: Recipient is required'));
console.log(chalk.gray('Usage: skillkit message send <to> --body "..."'));
error('Error: Recipient is required');
console.log(colors.muted('Usage: skillkit message send <to> --body "..."'));
return 1;
}
if (!this.body) {
console.error(chalk.red('Error: Message body is required'));
console.log(chalk.gray('Usage: skillkit message send <to> --body "..."'));
error('Error: Message body is required');
console.log(colors.muted('Usage: skillkit message send <to> --body "..."'));
return 1;
}
@@ -105,20 +105,20 @@ export class MessageCommand extends Command {
});
if (result.delivered) {
console.log(chalk.green(`✓ Message sent to ${to}`));
console.log(` ID: ${chalk.gray(result.messageId.slice(0, 8))}`);
console.log(colors.success(`✓ Message sent to ${to}`));
console.log(` ID: ${colors.muted(result.messageId.slice(0, 8))}`);
console.log(` Via: ${result.via}`);
} else {
console.error(chalk.red(`✗ Failed to deliver message`));
error(`✗ Failed to deliver message`);
if (result.error) {
console.error(chalk.gray(` Error: ${result.error}`));
console.error(colors.muted(` Error: ${result.error}`));
}
return 1;
}
return 0;
} catch (err: any) {
console.error(chalk.red(`Failed to send message: ${err.message}`));
error(`Failed to send message: ${err.message}`);
return 1;
}
}
@@ -147,33 +147,33 @@ export class MessageCommand extends Command {
const summary = await service.getInboxSummary();
console.log(chalk.bold(`\nInbox (${summary.unread} unread / ${summary.total} total)\n`));
console.log(colors.bold(`\nInbox (${summary.unread} unread / ${summary.total} total)\n`));
if (messages.length === 0) {
console.log(chalk.gray(' No messages.'));
console.log(colors.muted(' No messages.'));
return 0;
}
for (const message of messages) {
const isUnread = message.status === 'unread';
const priorityIcon = this.getPriorityIcon(message.priority);
const statusIcon = isUnread ? chalk.cyan('●') : chalk.gray('○');
const statusIcon = isUnread ? colors.cyan('●') : colors.muted('○');
console.log(`${statusIcon} ${priorityIcon} ${isUnread ? chalk.bold(message.subject) : message.subject}`);
console.log(` ID: ${chalk.gray(message.id.slice(0, 8))} | From: ${message.from} | ${this.formatDate(message.createdAt)}`);
console.log(`${statusIcon} ${priorityIcon} ${isUnread ? colors.bold(message.subject) : message.subject}`);
console.log(` ID: ${colors.muted(message.id.slice(0, 8))} | From: ${message.from} | ${this.formatDate(message.createdAt)}`);
if (this.verbose) {
const bodyPreview = typeof message.body === 'string'
? message.body.slice(0, 80)
: JSON.stringify(message.body).slice(0, 80);
console.log(` ${chalk.gray(bodyPreview)}${bodyPreview.length >= 80 ? '...' : ''}`);
console.log(` ${colors.muted(bodyPreview)}${bodyPreview.length >= 80 ? '...' : ''}`);
}
}
console.log();
return 0;
} catch (err: any) {
console.error(chalk.red(`Failed to show inbox: ${err.message}`));
error(`Failed to show inbox: ${err.message}`);
return 1;
}
}
@@ -181,8 +181,8 @@ export class MessageCommand extends Command {
private async readMessage(): Promise<number> {
const id = this.arg;
if (!id) {
console.error(chalk.red('Error: Message ID is required'));
console.log(chalk.gray('Usage: skillkit message read <id>'));
error('Error: Message ID is required');
console.log(colors.muted('Usage: skillkit message read <id>'));
return 1;
}
@@ -205,13 +205,13 @@ export class MessageCommand extends Command {
}
}
console.error(chalk.red(`Message not found: ${id}`));
error(`Message not found: ${id}`);
return 1;
}
return this.displayMessage(message);
} catch (err: any) {
console.error(chalk.red(`Failed to read message: ${err.message}`));
error(`Failed to read message: ${err.message}`);
return 1;
}
}
@@ -222,22 +222,22 @@ export class MessageCommand extends Command {
return 0;
}
console.log(chalk.bold(`\n${message.subject}\n`));
console.log(colors.bold(`\n${message.subject}\n`));
console.log(`From: ${message.from}`);
console.log(`To: ${message.to}`);
console.log(`Date: ${new Date(message.createdAt).toLocaleString()}`);
console.log(`Priority: ${message.priority}`);
console.log(`Type: ${message.type}`);
console.log(`ID: ${chalk.gray(message.id)}`);
console.log(`ID: ${colors.muted(message.id)}`);
if (message.replyTo) {
console.log(`Reply to: ${chalk.gray(message.replyTo)}`);
console.log(`Reply to: ${colors.muted(message.replyTo)}`);
}
if (message.threadId) {
console.log(`Thread: ${chalk.gray(message.threadId)}`);
console.log(`Thread: ${colors.muted(message.threadId)}`);
}
console.log(chalk.bold('\nBody:\n'));
console.log(colors.bold('\nBody:\n'));
if (typeof message.body === 'string') {
console.log(message.body);
} else {
@@ -251,14 +251,14 @@ export class MessageCommand extends Command {
private async replyMessage(): Promise<number> {
const id = this.arg;
if (!id) {
console.error(chalk.red('Error: Message ID is required'));
console.log(chalk.gray('Usage: skillkit message reply <id> --body "..."'));
error('Error: Message ID is required');
console.log(colors.muted('Usage: skillkit message reply <id> --body "..."'));
return 1;
}
if (!this.body) {
console.error(chalk.red('Error: Reply body is required'));
console.log(chalk.gray('Usage: skillkit message reply <id> --body "..."'));
error('Error: Reply body is required');
console.log(colors.muted('Usage: skillkit message reply <id> --body "..."'));
return 1;
}
@@ -276,7 +276,7 @@ export class MessageCommand extends Command {
if (found) {
messageId = found.id;
} else {
console.error(chalk.red(`Message not found: ${id}`));
error(`Message not found: ${id}`);
return 1;
}
}
@@ -284,19 +284,19 @@ export class MessageCommand extends Command {
const result = await service.reply(messageId, this.body);
if (result.delivered) {
console.log(chalk.green('✓ Reply sent'));
console.log(` ID: ${chalk.gray(result.messageId.slice(0, 8))}`);
console.log(colors.success('✓ Reply sent'));
console.log(` ID: ${colors.muted(result.messageId.slice(0, 8))}`);
} else {
console.error(chalk.red('✗ Failed to send reply'));
error('✗ Failed to send reply');
if (result.error) {
console.error(chalk.gray(` Error: ${result.error}`));
console.error(colors.muted(` Error: ${result.error}`));
}
return 1;
}
return 0;
} catch (err: any) {
console.error(chalk.red(`Failed to reply: ${err.message}`));
error(`Failed to reply: ${err.message}`);
return 1;
}
}
@@ -304,8 +304,8 @@ export class MessageCommand extends Command {
private async archiveMessage(): Promise<number> {
const id = this.arg;
if (!id) {
console.error(chalk.red('Error: Message ID is required'));
console.log(chalk.gray('Usage: skillkit message archive <id>'));
error('Error: Message ID is required');
console.log(colors.muted('Usage: skillkit message archive <id>'));
return 1;
}
@@ -323,7 +323,7 @@ export class MessageCommand extends Command {
if (found) {
messageId = found.id;
} else {
console.error(chalk.red(`Message not found: ${id}`));
error(`Message not found: ${id}`);
return 1;
}
}
@@ -331,15 +331,15 @@ export class MessageCommand extends Command {
const archived = await service.archive(messageId);
if (archived) {
console.log(chalk.green('✓ Message archived'));
console.log(colors.success('✓ Message archived'));
} else {
console.error(chalk.red('✗ Failed to archive message'));
error('✗ Failed to archive message');
return 1;
}
return 0;
} catch (err: any) {
console.error(chalk.red(`Failed to archive: ${err.message}`));
error(`Failed to archive: ${err.message}`);
return 1;
}
}
@@ -349,14 +349,14 @@ export class MessageCommand extends Command {
const to = this.arg2;
if (!id) {
console.error(chalk.red('Error: Message ID is required'));
console.log(chalk.gray('Usage: skillkit message forward <id> <to>'));
error('Error: Message ID is required');
console.log(colors.muted('Usage: skillkit message forward <id> <to>'));
return 1;
}
if (!to) {
console.error(chalk.red('Error: Recipient is required'));
console.log(chalk.gray('Usage: skillkit message forward <id> <to>'));
error('Error: Recipient is required');
console.log(colors.muted('Usage: skillkit message forward <id> <to>'));
return 1;
}
@@ -374,7 +374,7 @@ export class MessageCommand extends Command {
if (found) {
messageId = found.id;
} else {
console.error(chalk.red(`Message not found: ${id}`));
error(`Message not found: ${id}`);
return 1;
}
}
@@ -382,19 +382,19 @@ export class MessageCommand extends Command {
const result = await service.forward(messageId, to, this.body);
if (result.delivered) {
console.log(chalk.green(`✓ Message forwarded to ${to}`));
console.log(` ID: ${chalk.gray(result.messageId.slice(0, 8))}`);
console.log(colors.success(`✓ Message forwarded to ${to}`));
console.log(` ID: ${colors.muted(result.messageId.slice(0, 8))}`);
} else {
console.error(chalk.red('✗ Failed to forward message'));
error('✗ Failed to forward message');
if (result.error) {
console.error(chalk.gray(` Error: ${result.error}`));
console.error(colors.muted(` Error: ${result.error}`));
}
return 1;
}
return 0;
} catch (err: any) {
console.error(chalk.red(`Failed to forward: ${err.message}`));
error(`Failed to forward: ${err.message}`);
return 1;
}
}
@@ -418,24 +418,24 @@ export class MessageCommand extends Command {
return 0;
}
console.log(chalk.bold(`\nSent Messages (${messages.length})\n`));
console.log(colors.bold(`\nSent Messages (${messages.length})\n`));
if (messages.length === 0) {
console.log(chalk.gray(' No sent messages.'));
console.log(colors.muted(' No sent messages.'));
return 0;
}
for (const message of messages) {
const priorityIcon = this.getPriorityIcon(message.priority);
console.log(`${chalk.gray('○')} ${priorityIcon} ${message.subject}`);
console.log(` ID: ${chalk.gray(message.id.slice(0, 8))} | To: ${message.to} | ${this.formatDate(message.createdAt)}`);
console.log(`${colors.muted('○')} ${priorityIcon} ${message.subject}`);
console.log(` ID: ${colors.muted(message.id.slice(0, 8))} | To: ${message.to} | ${this.formatDate(message.createdAt)}`);
}
console.log();
return 0;
} catch (err: any) {
console.error(chalk.red(`Failed to show sent: ${err.message}`));
error(`Failed to show sent: ${err.message}`);
return 1;
}
}
@@ -461,26 +461,26 @@ export class MessageCommand extends Command {
return 0;
}
console.log(chalk.bold('\nMessaging Status\n'));
console.log(colors.bold('\nMessaging Status\n'));
console.log(chalk.cyan('Agent:'));
console.log(colors.cyan('Agent:'));
console.log(` ID: ${agentId}`);
console.log();
console.log(chalk.cyan('Inbox:'));
console.log(colors.cyan('Inbox:'));
console.log(` Total: ${summary.total}`);
console.log(` Unread: ${summary.unread}`);
console.log(` By priority: urgent=${summary.byPriority.urgent}, high=${summary.byPriority.high}, normal=${summary.byPriority.normal}, low=${summary.byPriority.low}`);
console.log();
console.log(chalk.cyan('Storage:'));
console.log(colors.cyan('Storage:'));
console.log(` Sent: ${sent.length}`);
console.log(` Archived: ${archived.length}`);
console.log();
return 0;
} catch (err: any) {
console.error(chalk.red(`Failed to get status: ${err.message}`));
error(`Failed to get status: ${err.message}`);
return 1;
}
}
@@ -488,13 +488,13 @@ export class MessageCommand extends Command {
private getPriorityIcon(priority: string): string {
switch (priority) {
case 'urgent':
return chalk.red('!!!!');
return colors.error('!!!!');
case 'high':
return chalk.yellow('!!!');
return colors.warning('!!!');
case 'normal':
return chalk.gray('!');
return colors.muted('!');
case 'low':
return chalk.gray('·');
return colors.muted('·');
default:
return '';
}
+48 -48
View File
@@ -5,7 +5,7 @@
*/
import { Command, Option } from 'clipanion';
import chalk from 'chalk';
import { colors } from '../onboarding/index.js';
import { createMethodologyManager, createMethodologyLoader } from '@skillkit/core';
export class MethodologyCommand extends Command {
@@ -50,12 +50,12 @@ export class MethodologyCommand extends Command {
case 'installed':
return await this.listInstalled(projectPath);
default:
this.context.stderr.write(chalk.red(`Unknown action: ${this.action}\n`));
this.context.stderr.write(colors.error(`Unknown action: ${this.action}\n`));
this.context.stderr.write('Available actions: list, install, uninstall, sync, search, info, installed\n');
return 1;
}
} catch (err) {
this.context.stderr.write(chalk.red(`✗ ${err instanceof Error ? err.message : 'Unknown error'}\n`));
this.context.stderr.write(colors.error(`✗ ${err instanceof Error ? err.message : 'Unknown error'}\n`));
return 1;
}
}
@@ -69,18 +69,18 @@ export class MethodologyCommand extends Command {
return 0;
}
this.context.stdout.write(chalk.cyan('Available Methodology Packs:\n\n'));
this.context.stdout.write(colors.cyan('Available Methodology Packs:\n\n'));
for (const pack of packs) {
this.context.stdout.write(chalk.green(` ${pack.name}`) + ` v${pack.version}\n`);
this.context.stdout.write(chalk.gray(` ${pack.description}\n`));
this.context.stdout.write(colors.success(` ${pack.name}`) + ` v${pack.version}\n`);
this.context.stdout.write(colors.muted(` ${pack.description}\n`));
this.context.stdout.write(` Skills: ${pack.skills.join(', ')}\n`);
this.context.stdout.write(` Tags: ${pack.tags.join(', ')}\n`);
this.context.stdout.write('\n');
}
this.context.stdout.write(`Total: ${packs.length} packs\n`);
this.context.stdout.write(chalk.gray('\nRun `skillkit methodology install` to install all packs.\n'));
this.context.stdout.write(colors.muted('\nRun `skillkit methodology install` to install all packs.\n'));
return 0;
}
@@ -92,31 +92,31 @@ export class MethodologyCommand extends Command {
// Check if it's a skill ID (pack/skill) or pack name
if (this.target.includes('/')) {
// Install single skill
this.context.stdout.write(`Installing skill: ${chalk.cyan(this.target)}...\n`);
this.context.stdout.write(`Installing skill: ${colors.cyan(this.target)}...\n`);
if (this.dryRun) {
this.context.stdout.write(chalk.yellow('[dry-run] Would install skill.\n'));
this.context.stdout.write(colors.warning('[dry-run] Would install skill.\n'));
return 0;
}
const result = await manager.installSkill(this.target);
if (result.success) {
this.context.stdout.write(chalk.green(`✓ Skill installed: ${this.target}\n`));
this.context.stdout.write(colors.success(`✓ Skill installed: ${this.target}\n`));
} else {
for (const failed of result.failed) {
this.context.stderr.write(chalk.red(`✗ ${failed.name}: ${failed.error}\n`));
this.context.stderr.write(colors.error(`✗ ${failed.name}: ${failed.error}\n`));
}
return 1;
}
} else {
// Install single pack
this.context.stdout.write(`Installing pack: ${chalk.cyan(this.target)}...\n`);
this.context.stdout.write(`Installing pack: ${colors.cyan(this.target)}...\n`);
if (this.dryRun) {
const pack = await loader.loadPack(this.target);
if (pack) {
this.context.stdout.write(chalk.yellow(`[dry-run] Would install ${pack.skills.length} skills.\n`));
this.context.stdout.write(colors.warning(`[dry-run] Would install ${pack.skills.length} skills.\n`));
}
return 0;
}
@@ -124,15 +124,15 @@ export class MethodologyCommand extends Command {
const result = await manager.installPack(this.target);
if (result.success) {
this.context.stdout.write(chalk.green(`✓ Pack "${this.target}" installed!\n`));
this.context.stdout.write(colors.success(`✓ Pack "${this.target}" installed!\n`));
this.context.stdout.write(` Installed: ${result.installed.length} skills\n`);
if (result.skipped.length > 0) {
this.context.stdout.write(` Skipped (already installed): ${result.skipped.length}\n`);
}
} else {
this.context.stderr.write(chalk.red(`✗ Failed to install pack\n`));
this.context.stderr.write(colors.error(`✗ Failed to install pack\n`));
for (const failed of result.failed) {
this.context.stderr.write(chalk.red(` - ${failed.name}: ${failed.error}\n`));
this.context.stderr.write(colors.error(` - ${failed.name}: ${failed.error}\n`));
}
return 1;
}
@@ -145,31 +145,31 @@ export class MethodologyCommand extends Command {
const packs = await loader.loadAllPacks();
let totalSkills = 0;
for (const pack of packs) {
this.context.stdout.write(chalk.yellow(`[dry-run] Would install ${pack.name} (${pack.skills.length} skills)\n`));
this.context.stdout.write(colors.warning(`[dry-run] Would install ${pack.name} (${pack.skills.length} skills)\n`));
totalSkills += pack.skills.length;
}
this.context.stdout.write(chalk.yellow(`\n[dry-run] Would install ${totalSkills} skills total.\n`));
this.context.stdout.write(colors.warning(`\n[dry-run] Would install ${totalSkills} skills total.\n`));
return 0;
}
const result = await manager.installAllPacks();
if (result.success) {
this.context.stdout.write(chalk.green('\n✓ All methodology packs installed!\n'));
this.context.stdout.write(colors.success('\n✓ All methodology packs installed!\n'));
this.context.stdout.write(` Installed: ${result.installed.length} skills\n`);
if (result.skipped.length > 0) {
this.context.stdout.write(` Skipped (already installed): ${result.skipped.length}\n`);
}
} else {
this.context.stdout.write(chalk.yellow('\n⚠ Some skills failed to install:\n'));
this.context.stdout.write(colors.warning('\n⚠ Some skills failed to install:\n'));
for (const failed of result.failed) {
this.context.stderr.write(chalk.red(` - ${failed.name}: ${failed.error}\n`));
this.context.stderr.write(colors.error(` - ${failed.name}: ${failed.error}\n`));
}
this.context.stdout.write(`\n Installed: ${result.installed.length} skills\n`);
}
}
this.context.stdout.write(chalk.gray('\nRun `skillkit methodology sync` to sync to detected agents.\n'));
this.context.stdout.write(colors.muted('\nRun `skillkit methodology sync` to sync to detected agents.\n'));
return 0;
}
@@ -177,18 +177,18 @@ export class MethodologyCommand extends Command {
const manager = createMethodologyManager({ projectPath });
if (!this.target) {
this.context.stderr.write(chalk.red('Pack name required for uninstall.\n'));
this.context.stderr.write(colors.error('Pack name required for uninstall.\n'));
this.context.stderr.write('Usage: skillkit methodology uninstall <pack-name>\n');
return 1;
}
if (this.dryRun) {
this.context.stdout.write(chalk.yellow(`[dry-run] Would uninstall pack: ${this.target}\n`));
this.context.stdout.write(colors.warning(`[dry-run] Would uninstall pack: ${this.target}\n`));
return 0;
}
await manager.uninstallPack(this.target);
this.context.stdout.write(chalk.green(`✓ Pack "${this.target}" uninstalled.\n`));
this.context.stdout.write(colors.success(`✓ Pack "${this.target}" uninstalled.\n`));
return 0;
}
@@ -199,23 +199,23 @@ export class MethodologyCommand extends Command {
if (this.dryRun) {
const installed = manager.listInstalledSkills();
this.context.stdout.write(chalk.yellow(`[dry-run] Would sync ${installed.length} skills.\n`));
this.context.stdout.write(colors.warning(`[dry-run] Would sync ${installed.length} skills.\n`));
return 0;
}
const result = await manager.syncAll();
if (result.synced.length > 0) {
this.context.stdout.write(chalk.green('✓ Sync complete!\n'));
this.context.stdout.write(colors.success('✓ Sync complete!\n'));
for (const sync of result.synced) {
this.context.stdout.write(` ${sync.skill} → ${sync.agents.join(', ')}\n`);
}
}
if (result.failed.length > 0) {
this.context.stdout.write(chalk.yellow('\n⚠ Some syncs failed:\n'));
this.context.stdout.write(colors.warning('\n⚠ Some syncs failed:\n'));
for (const fail of result.failed) {
this.context.stderr.write(chalk.red(` ${fail.skill} (${fail.agent}): ${fail.error}\n`));
this.context.stderr.write(colors.error(` ${fail.skill} (${fail.agent}): ${fail.error}\n`));
}
}
@@ -230,7 +230,7 @@ export class MethodologyCommand extends Command {
const loader = createMethodologyLoader();
if (!this.target) {
this.context.stderr.write(chalk.red('Search query required.\n'));
this.context.stderr.write(colors.error('Search query required.\n'));
this.context.stderr.write('Usage: skillkit methodology search <query>\n');
return 1;
}
@@ -242,11 +242,11 @@ export class MethodologyCommand extends Command {
return 0;
}
this.context.stdout.write(chalk.cyan(`Found ${skills.length} skills matching "${this.target}":\n\n`));
this.context.stdout.write(colors.cyan(`Found ${skills.length} skills matching "${this.target}":\n\n`));
for (const skill of skills) {
this.context.stdout.write(chalk.green(` ${skill.id}`) + ` v${skill.version}\n`);
this.context.stdout.write(chalk.gray(` ${skill.description || 'No description'}\n`));
this.context.stdout.write(colors.success(` ${skill.id}`) + ` v${skill.version}\n`);
this.context.stdout.write(colors.muted(` ${skill.description || 'No description'}\n`));
if (skill.tags.length > 0) {
this.context.stdout.write(` Tags: ${skill.tags.join(', ')}\n`);
}
@@ -263,7 +263,7 @@ export class MethodologyCommand extends Command {
const loader = createMethodologyLoader();
if (!this.target) {
this.context.stderr.write(chalk.red('Pack name required.\n'));
this.context.stderr.write(colors.error('Pack name required.\n'));
this.context.stderr.write('Usage: skillkit methodology info <pack-name>\n');
return 1;
}
@@ -271,11 +271,11 @@ export class MethodologyCommand extends Command {
const pack = await loader.loadPack(this.target);
if (!pack) {
this.context.stderr.write(chalk.red(`Pack not found: ${this.target}\n`));
this.context.stderr.write(colors.error(`Pack not found: ${this.target}\n`));
return 1;
}
this.context.stdout.write(chalk.cyan(`\nPack: ${pack.name}\n`));
this.context.stdout.write(colors.cyan(`\nPack: ${pack.name}\n`));
this.context.stdout.write(`Version: ${pack.version}\n`);
this.context.stdout.write(`Description: ${pack.description}\n`);
this.context.stdout.write(`Tags: ${pack.tags.join(', ')}\n`);
@@ -283,12 +283,12 @@ export class MethodologyCommand extends Command {
this.context.stdout.write(`License: ${pack.license || 'Unknown'}\n`);
this.context.stdout.write(`Compatibility: ${pack.compatibility.join(', ')}\n`);
this.context.stdout.write(chalk.cyan(`\nSkills (${pack.skills.length}):\n`));
this.context.stdout.write(colors.cyan(`\nSkills (${pack.skills.length}):\n`));
const skills = await loader.loadPackSkills(this.target);
for (const skill of skills) {
this.context.stdout.write(chalk.green(` ${skill.id.split('/')[1]}\n`));
this.context.stdout.write(chalk.gray(` ${skill.description || 'No description'}\n`));
this.context.stdout.write(colors.success(` ${skill.id.split('/')[1]}\n`));
this.context.stdout.write(colors.muted(` ${skill.description || 'No description'}\n`));
if (this.verbose) {
if (skill.metadata.triggers) {
this.context.stdout.write(` Triggers: ${skill.metadata.triggers.join(', ')}\n`);
@@ -302,7 +302,7 @@ export class MethodologyCommand extends Command {
}
}
this.context.stdout.write(chalk.gray(`\nRun \`skillkit methodology install ${this.target}\` to install this pack.\n`));
this.context.stdout.write(colors.muted(`\nRun \`skillkit methodology install ${this.target}\` to install this pack.\n`));
return 0;
}
@@ -314,30 +314,30 @@ export class MethodologyCommand extends Command {
if (installedPacks.length === 0 && installedSkills.length === 0) {
this.context.stdout.write('No methodology skills installed.\n');
this.context.stdout.write(chalk.gray('Run `skillkit methodology install` to install methodology packs.\n'));
this.context.stdout.write(colors.muted('Run `skillkit methodology install` to install methodology packs.\n'));
return 0;
}
if (installedPacks.length > 0) {
this.context.stdout.write(chalk.cyan('Installed Packs:\n'));
this.context.stdout.write(colors.cyan('Installed Packs:\n'));
for (const pack of installedPacks) {
this.context.stdout.write(chalk.green(` ${pack.name}`) + ` v${pack.version}\n`);
this.context.stdout.write(colors.success(` ${pack.name}`) + ` v${pack.version}\n`);
this.context.stdout.write(` Skills: ${pack.skills.length}\n`);
}
this.context.stdout.write('\n');
}
if (installedSkills.length > 0) {
this.context.stdout.write(chalk.cyan('Installed Skills:\n'));
this.context.stdout.write(colors.cyan('Installed Skills:\n'));
for (const skill of installedSkills) {
const syncStatus = skill.syncedAgents.length > 0
? chalk.green(`synced to ${skill.syncedAgents.length} agents`)
: chalk.yellow('not synced');
this.context.stdout.write(` ${chalk.green(skill.id)} v${skill.version} [${syncStatus}]\n`);
? colors.success(`synced to ${skill.syncedAgents.length} agents`)
: colors.warning('not synced');
this.context.stdout.write(` ${colors.success(skill.id)} v${skill.version} [${syncStatus}]\n`);
}
}
this.context.stdout.write(chalk.gray(`\nTotal: ${installedSkills.length} skills installed.\n`));
this.context.stdout.write(colors.muted(`\nTotal: ${installedSkills.length} skills installed.\n`));
return 0;
}
}
+12 -12
View File
@@ -1,6 +1,6 @@
import { Command, Option } from 'clipanion';
import { resolve } from 'node:path';
import chalk from 'chalk';
import { colors, warn, success, error } from '../onboarding/index.js';
import { SessionManager } from '@skillkit/core';
/**
@@ -36,35 +36,35 @@ export class PauseCommand extends Command {
const state = manager.get();
if (!state) {
console.log(chalk.yellow('No active session found.'));
warn('No active session found.');
return 1;
}
if (!state.currentExecution) {
console.log(chalk.yellow('No skill execution in progress.'));
warn('No skill execution in progress.');
return 1;
}
if (state.currentExecution.status === 'paused') {
console.log(chalk.yellow('Execution is already paused.'));
console.log(chalk.dim('Resume with: skillkit resume'));
warn('Execution is already paused.');
console.log(colors.muted('Resume with: skillkit resume'));
return 0;
}
const success = manager.pause();
const paused = manager.pause();
if (success) {
if (paused) {
const exec = state.currentExecution;
console.log(chalk.green('✓ Execution paused'));
success('✓ Execution paused');
console.log();
console.log(` Skill: ${chalk.bold(exec.skillName)}`);
console.log(` Skill: ${colors.bold(exec.skillName)}`);
console.log(` Progress: ${exec.currentStep}/${exec.totalSteps} tasks completed`);
console.log();
console.log(chalk.dim('Resume with: skillkit resume'));
console.log(chalk.dim('View status: skillkit status'));
console.log(colors.muted('Resume with: skillkit resume'));
console.log(colors.muted('View status: skillkit status'));
return 0;
} else {
console.log(chalk.red('Failed to pause execution.'));
error('Failed to pause execution.');
return 1;
}
}
+26 -26
View File
@@ -8,7 +8,7 @@ import { Command, Option } from 'clipanion';
import { join, isAbsolute, resolve, sep } from 'node:path';
import { homedir } from 'node:os';
import { existsSync, mkdirSync, copyFileSync, cpSync, rmSync } from 'node:fs';
import chalk from 'chalk';
import { colors } from '../onboarding/index.js';
import { createPluginManager, loadPlugin, loadPluginsFromDirectory } from '@skillkit/core';
export class PluginCommand extends Command {
@@ -67,12 +67,12 @@ export class PluginCommand extends Command {
case 'info':
return this.pluginInfo(pluginManager);
default:
this.context.stderr.write(chalk.red(`Unknown action: ${this.action}\n`));
this.context.stderr.write(colors.error(`Unknown action: ${this.action}\n`));
this.context.stderr.write('Available actions: list, install, uninstall, enable, disable, info\n');
return 1;
}
} catch (err) {
this.context.stderr.write(chalk.red(`✗ ${err instanceof Error ? err.message : 'Unknown error'}\n`));
this.context.stderr.write(colors.error(`✗ ${err instanceof Error ? err.message : 'Unknown error'}\n`));
return 1;
}
}
@@ -86,17 +86,17 @@ export class PluginCommand extends Command {
return 0;
}
this.context.stdout.write(chalk.cyan(`Installed Plugins (${plugins.length}):\n\n`));
this.context.stdout.write(colors.cyan(`Installed Plugins (${plugins.length}):\n\n`));
for (const plugin of plugins) {
const enabled = pluginManager.isPluginEnabled(plugin.name);
const status = enabled
? chalk.green('enabled')
: chalk.gray('disabled');
? colors.success('enabled')
: colors.muted('disabled');
this.context.stdout.write(chalk.cyan(` ${plugin.name}`) + ` v${plugin.version} [${status}]\n`);
this.context.stdout.write(colors.cyan(` ${plugin.name}`) + ` v${plugin.version} [${status}]\n`);
if (plugin.description) {
this.context.stdout.write(chalk.gray(` ${plugin.description}\n`));
this.context.stdout.write(colors.muted(` ${plugin.description}\n`));
}
}
@@ -106,7 +106,7 @@ export class PluginCommand extends Command {
const commands = pluginManager.getAllCommands();
if (translators.size > 0 || providers.size > 0 || commands.length > 0) {
this.context.stdout.write(chalk.cyan('\nRegistered Extensions:\n'));
this.context.stdout.write(colors.cyan('\nRegistered Extensions:\n'));
if (translators.size > 0) {
this.context.stdout.write(` Translators: ${Array.from(translators.keys()).join(', ')}\n`);
}
@@ -140,7 +140,7 @@ export class PluginCommand extends Command {
private async installPlugin(pluginManager: ReturnType<typeof createPluginManager>): Promise<number> {
if (!this.source) {
this.context.stderr.write(chalk.red('--source is required for install\n'));
this.context.stderr.write(colors.error('--source is required for install\n'));
return 1;
}
@@ -156,7 +156,7 @@ export class PluginCommand extends Command {
// Validate plugin name from metadata
const pluginName = plugin.metadata.name;
if (!this.isValidPluginName(pluginName)) {
this.context.stderr.write(chalk.red(`Invalid plugin name: ${pluginName}\n`));
this.context.stderr.write(colors.error(`Invalid plugin name: ${pluginName}\n`));
return 1;
}
@@ -184,7 +184,7 @@ export class PluginCommand extends Command {
const resolvedTarget = resolve(targetDir);
const resolvedPluginsDir = resolve(pluginsDir);
if (!resolvedTarget.startsWith(resolvedPluginsDir + sep)) {
this.context.stderr.write(chalk.red('Invalid plugin name\n'));
this.context.stderr.write(colors.error('Invalid plugin name\n'));
return 1;
}
@@ -217,12 +217,12 @@ export class PluginCommand extends Command {
copyFileSync(resolvedSource, join(targetDir, destFileName));
}
this.context.stdout.write(chalk.dim(` Copied to ${targetDir}\n`));
this.context.stdout.write(colors.muted(` Copied to ${targetDir}\n`));
}
await pluginManager.register(plugin);
this.context.stdout.write(chalk.green(`✓ Plugin "${plugin.metadata.name}" installed!\n`));
this.context.stdout.write(colors.success(`✓ Plugin "${plugin.metadata.name}" installed!\n`));
this.context.stdout.write(` Version: ${plugin.metadata.version}\n`);
if (plugin.metadata.description) {
this.context.stdout.write(` ${plugin.metadata.description}\n`);
@@ -244,13 +244,13 @@ export class PluginCommand extends Command {
private async uninstallPlugin(pluginManager: ReturnType<typeof createPluginManager>): Promise<number> {
if (!this.name) {
this.context.stderr.write(chalk.red('--name is required for uninstall\n'));
this.context.stderr.write(colors.error('--name is required for uninstall\n'));
return 1;
}
// Validate plugin name to prevent path traversal attacks
if (!this.isValidPluginName(this.name)) {
this.context.stderr.write(chalk.red('Invalid plugin name\n'));
this.context.stderr.write(colors.error('Invalid plugin name\n'));
return 1;
}
@@ -269,57 +269,57 @@ export class PluginCommand extends Command {
const resolvedPluginDir = resolve(pluginDir);
const resolvedPluginsDir = resolve(pluginsDir);
if (!resolvedPluginDir.startsWith(resolvedPluginsDir + sep)) {
this.context.stderr.write(chalk.red('Invalid plugin name\n'));
this.context.stderr.write(colors.error('Invalid plugin name\n'));
return 1;
}
if (existsSync(pluginDir)) {
rmSync(pluginDir, { recursive: true, force: true });
this.context.stdout.write(chalk.dim(` Removed ${pluginDir}\n`));
this.context.stdout.write(colors.muted(` Removed ${pluginDir}\n`));
}
this.context.stdout.write(chalk.green(`✓ Plugin "${this.name}" uninstalled.\n`));
this.context.stdout.write(colors.success(`✓ Plugin "${this.name}" uninstalled.\n`));
return 0;
}
private enablePlugin(pluginManager: ReturnType<typeof createPluginManager>): number {
if (!this.name) {
this.context.stderr.write(chalk.red('--name is required for enable\n'));
this.context.stderr.write(colors.error('--name is required for enable\n'));
return 1;
}
pluginManager.enablePlugin(this.name);
this.context.stdout.write(chalk.green(`✓ Plugin "${this.name}" enabled.\n`));
this.context.stdout.write(colors.success(`✓ Plugin "${this.name}" enabled.\n`));
return 0;
}
private disablePlugin(pluginManager: ReturnType<typeof createPluginManager>): number {
if (!this.name) {
this.context.stderr.write(chalk.red('--name is required for disable\n'));
this.context.stderr.write(colors.error('--name is required for disable\n'));
return 1;
}
pluginManager.disablePlugin(this.name);
this.context.stdout.write(chalk.green(`✓ Plugin "${this.name}" disabled.\n`));
this.context.stdout.write(colors.success(`✓ Plugin "${this.name}" disabled.\n`));
return 0;
}
private pluginInfo(pluginManager: ReturnType<typeof createPluginManager>): number {
if (!this.name) {
this.context.stderr.write(chalk.red('--name is required for info\n'));
this.context.stderr.write(colors.error('--name is required for info\n'));
return 1;
}
const plugin = pluginManager.getPlugin(this.name);
if (!plugin) {
this.context.stderr.write(chalk.red(`Plugin "${this.name}" not found.\n`));
this.context.stderr.write(colors.error(`Plugin "${this.name}" not found.\n`));
return 1;
}
const { metadata } = plugin;
const enabled = pluginManager.isPluginEnabled(this.name);
this.context.stdout.write(chalk.cyan(`${metadata.name}`) + ` v${metadata.version}\n`);
this.context.stdout.write(colors.cyan(`${metadata.name}`) + ` v${metadata.version}\n`);
this.context.stdout.write(`Status: ${enabled ? 'enabled' : 'disabled'}\n`);
if (metadata.description) {
this.context.stdout.write(`Description: ${metadata.description}\n`);
+65 -65
View File
@@ -1,6 +1,6 @@
import { Command, Option } from 'clipanion';
import { resolve } from 'node:path';
import chalk from 'chalk';
import { colors, warn, error, step } from '../onboarding/index.js';
import {
type AgentType,
AgentType as AgentTypeSchema,
@@ -96,7 +96,7 @@ export class PrimerCommand extends Command {
}
private async runLearn(projectPath: string): Promise<number> {
console.log(chalk.cyan('Analyzing codebase and extracting patterns...\n'));
step('Analyzing codebase and extracting patterns...\n');
const analysis = analyzePrimer(projectPath);
if (this.verbose) {
@@ -104,7 +104,7 @@ export class PrimerCommand extends Command {
console.log();
}
console.log(chalk.bold('Analyzing git history for patterns...\n'));
console.log(colors.bold('Analyzing git history for patterns...\n'));
const gitResult = analyzeGitHistory(projectPath, {
commits: this.commits ? parseInt(this.commits) : 100,
@@ -116,35 +116,35 @@ export class PrimerCommand extends Command {
console.log();
if (gitResult.patterns.length === 0) {
console.log(chalk.yellow('No learnable patterns found.'));
warn('No learnable patterns found.');
return 0;
}
console.log(chalk.bold(`Extracted ${gitResult.patterns.length} patterns:\n`));
console.log(colors.bold(`Extracted ${gitResult.patterns.length} patterns:\n`));
for (const pattern of gitResult.patterns.slice(0, 10)) {
const confidence = chalk.blue(`${(pattern.confidence * 100).toFixed(0)}%`);
console.log(` ${chalk.dim('○')} ${pattern.title} [${pattern.category}] ${confidence}`);
const confidence = colors.info(`${(pattern.confidence * 100).toFixed(0)}%`);
console.log(` ${colors.muted('○')} ${pattern.title} [${pattern.category}] ${confidence}`);
addPattern(pattern);
}
if (gitResult.patterns.length > 10) {
console.log(chalk.dim(` ... and ${gitResult.patterns.length - 10} more saved`));
console.log(colors.muted(` ... and ${gitResult.patterns.length - 10} more saved`));
for (const pattern of gitResult.patterns.slice(10)) {
addPattern(pattern);
}
}
console.log();
console.log(chalk.green(`✓ Saved ${gitResult.patterns.length} patterns`));
console.log(chalk.dim('View with: skillkit learn --show'));
console.log(chalk.dim('Approve with: skillkit pattern approve <id>'));
console.log(colors.success(`✓ Saved ${gitResult.patterns.length} patterns`));
console.log(colors.muted('View with: skillkit learn --show'));
console.log(colors.muted('Approve with: skillkit pattern approve <id>'));
return 0;
}
private async runAnalysis(projectPath: string): Promise<number> {
console.log(chalk.cyan('Analyzing codebase...\n'));
step('Analyzing codebase...\n');
try {
const analysis = analyzePrimer(projectPath);
@@ -156,8 +156,8 @@ export class PrimerCommand extends Command {
this.printAnalysis(analysis);
return 0;
} catch (error) {
console.error(chalk.red('Analysis failed:'), error instanceof Error ? error.message : error);
} catch (err) {
error('Analysis failed: ' + (err instanceof Error ? err.message : String(err)));
return 1;
}
}
@@ -165,7 +165,7 @@ export class PrimerCommand extends Command {
private async runGenerate(projectPath: string): Promise<number> {
const agents = this.parseAgents();
console.log(chalk.cyan('Analyzing codebase and generating AI instructions...\n'));
step('Analyzing codebase and generating AI instructions...\n');
try {
const result = generatePrimer(projectPath, {
@@ -183,37 +183,37 @@ export class PrimerCommand extends Command {
}
if (result.generated.length === 0) {
console.log(chalk.yellow('No instruction files generated.'));
warn('No instruction files generated.');
if (result.errors.length > 0) {
for (const error of result.errors) {
console.log(chalk.red(` Error: ${error}`));
for (const errMsg of result.errors) {
console.log(colors.error(` Error: ${errMsg}`));
}
}
return 1;
}
console.log(chalk.bold('Generated Instruction Files:\n'));
console.log(colors.bold('Generated Instruction Files:\n'));
for (const instruction of result.generated) {
const status = this.dryRun ? chalk.yellow('(dry-run)') : chalk.green('created');
console.log(` ${chalk.green('●')} ${chalk.bold(instruction.agent)}`);
console.log(` ${chalk.gray(instruction.filepath)} ${status}`);
const status = this.dryRun ? colors.warning('(dry-run)') : colors.success('created');
console.log(` ${colors.success('●')} ${colors.bold(instruction.agent)}`);
console.log(` ${colors.muted(instruction.filepath)} ${status}`);
}
console.log();
if (result.warnings.length > 0) {
console.log(chalk.yellow('Warnings:'));
for (const warning of result.warnings) {
console.log(` ${chalk.yellow('⚠')} ${warning}`);
console.log(colors.warning('Warnings:'));
for (const warningMsg of result.warnings) {
console.log(` ${colors.warning('⚠')} ${warningMsg}`);
}
console.log();
}
if (result.errors.length > 0) {
console.log(chalk.red('Errors:'));
for (const error of result.errors) {
console.log(` ${chalk.red('✗')} ${error}`);
console.log(colors.error('Errors:'));
for (const errMsg of result.errors) {
console.log(` ${colors.error('✗')} ${errMsg}`);
}
console.log();
}
@@ -222,15 +222,15 @@ export class PrimerCommand extends Command {
? `Would generate ${result.generated.length} instruction file(s)`
: `Generated ${result.generated.length} instruction file(s)`;
console.log(chalk.bold(summary));
console.log(colors.bold(summary));
if (this.dryRun) {
console.log(chalk.gray('\n(Dry run - no files were written)'));
console.log(colors.muted('\n(Dry run - no files were written)'));
}
return result.success ? 0 : 1;
} catch (error) {
console.error(chalk.red('Generation failed:'), error instanceof Error ? error.message : error);
} catch (err) {
error('Generation failed: ' + (err instanceof Error ? err.message : String(err)));
return 1;
}
}
@@ -246,7 +246,7 @@ export class PrimerCommand extends Command {
if (result.success) {
agents.push(result.data);
} else {
console.warn(chalk.yellow(`Unknown agent: ${part}`));
warn(`Unknown agent: ${part}`);
}
}
@@ -256,8 +256,8 @@ export class PrimerCommand extends Command {
private printAnalysis(analysis: ReturnType<typeof analyzePrimer>): void {
const { project, languages, packageManagers, stack, structure, conventions, ci, docker, buildCommands, importantFiles } = analysis;
console.log(chalk.bold('Project Information'));
console.log(` Name: ${chalk.cyan(project.name)}`);
console.log(colors.bold('Project Information'));
console.log(` Name: ${colors.cyan(project.name)}`);
if (project.description) {
console.log(` Description: ${project.description}`);
}
@@ -270,67 +270,67 @@ export class PrimerCommand extends Command {
console.log();
if (languages.length > 0) {
console.log(chalk.bold('Languages'));
console.log(colors.bold('Languages'));
for (const lang of languages) {
const version = lang.version ? ` (${lang.version})` : '';
console.log(` ${chalk.green('●')} ${lang.name}${version}`);
console.log(` ${colors.success('●')} ${lang.name}${version}`);
}
console.log();
}
if (packageManagers.length > 0) {
console.log(chalk.bold('Package Managers'));
console.log(` ${chalk.cyan(packageManagers.join(', '))}`);
console.log(colors.bold('Package Managers'));
console.log(` ${colors.cyan(packageManagers.join(', '))}`);
console.log();
}
if (stack.frameworks.length > 0) {
console.log(chalk.bold('Frameworks'));
console.log(colors.bold('Frameworks'));
for (const fw of stack.frameworks) {
const version = fw.version ? ` (${fw.version})` : '';
console.log(` ${chalk.green('●')} ${fw.name}${version}`);
console.log(` ${colors.success('●')} ${fw.name}${version}`);
}
console.log();
}
if (stack.libraries.length > 0) {
console.log(chalk.bold('Libraries'));
console.log(colors.bold('Libraries'));
for (const lib of stack.libraries.slice(0, 10)) {
const version = lib.version ? ` (${lib.version})` : '';
console.log(` ${chalk.green('●')} ${lib.name}${version}`);
console.log(` ${colors.success('●')} ${lib.name}${version}`);
}
if (stack.libraries.length > 10) {
console.log(` ${chalk.gray(`...and ${stack.libraries.length - 10} more`)}`);
console.log(` ${colors.muted(`...and ${stack.libraries.length - 10} more`)}`);
}
console.log();
}
if (stack.styling.length > 0) {
console.log(chalk.bold('Styling'));
console.log(colors.bold('Styling'));
for (const style of stack.styling) {
console.log(` ${chalk.green('●')} ${style.name}`);
console.log(` ${colors.success('●')} ${style.name}`);
}
console.log();
}
if (stack.testing.length > 0) {
console.log(chalk.bold('Testing'));
console.log(colors.bold('Testing'));
for (const test of stack.testing) {
console.log(` ${chalk.green('●')} ${test.name}`);
console.log(` ${colors.success('●')} ${test.name}`);
}
console.log();
}
if (stack.databases.length > 0) {
console.log(chalk.bold('Databases'));
console.log(colors.bold('Databases'));
for (const db of stack.databases) {
console.log(` ${chalk.green('●')} ${db.name}`);
console.log(` ${colors.success('●')} ${db.name}`);
}
console.log();
}
if (structure) {
console.log(chalk.bold('Project Structure'));
console.log(colors.bold('Project Structure'));
if (structure.type) {
console.log(` Type: ${structure.type}`);
}
@@ -350,7 +350,7 @@ export class PrimerCommand extends Command {
}
if (conventions && Object.keys(conventions).some(k => conventions[k as keyof typeof conventions] !== undefined)) {
console.log(chalk.bold('Code Conventions'));
console.log(colors.bold('Code Conventions'));
if (conventions.indentation) {
console.log(` Indentation: ${conventions.indentation}`);
}
@@ -367,7 +367,7 @@ export class PrimerCommand extends Command {
}
if (ci && ci.hasCI) {
console.log(chalk.bold('CI/CD'));
console.log(colors.bold('CI/CD'));
console.log(` Provider: ${ci.provider}`);
if (ci.hasCD) {
console.log(` Deployment: Yes`);
@@ -376,7 +376,7 @@ export class PrimerCommand extends Command {
}
if (docker && (docker.hasDockerfile || docker.hasCompose)) {
console.log(chalk.bold('Docker'));
console.log(colors.bold('Docker'));
if (docker.hasDockerfile) {
console.log(` Dockerfile: Yes`);
if (docker.baseImage) {
@@ -390,35 +390,35 @@ export class PrimerCommand extends Command {
}
if (buildCommands && Object.keys(buildCommands).some(k => buildCommands[k as keyof typeof buildCommands])) {
console.log(chalk.bold('Build Commands'));
console.log(colors.bold('Build Commands'));
if (buildCommands.install) {
console.log(` Install: ${chalk.gray(buildCommands.install)}`);
console.log(` Install: ${colors.muted(buildCommands.install)}`);
}
if (buildCommands.dev) {
console.log(` Dev: ${chalk.gray(buildCommands.dev)}`);
console.log(` Dev: ${colors.muted(buildCommands.dev)}`);
}
if (buildCommands.build) {
console.log(` Build: ${chalk.gray(buildCommands.build)}`);
console.log(` Build: ${colors.muted(buildCommands.build)}`);
}
if (buildCommands.test) {
console.log(` Test: ${chalk.gray(buildCommands.test)}`);
console.log(` Test: ${colors.muted(buildCommands.test)}`);
}
console.log();
}
if (importantFiles.length > 0 && this.verbose) {
console.log(chalk.bold('Important Files'));
console.log(colors.bold('Important Files'));
for (const file of importantFiles.slice(0, 15)) {
console.log(` ${chalk.gray(file)}`);
console.log(` ${colors.muted(file)}`);
}
if (importantFiles.length > 15) {
console.log(` ${chalk.gray(`...and ${importantFiles.length - 15} more`)}`);
console.log(` ${colors.muted(`...and ${importantFiles.length - 15} more`)}`);
}
console.log();
}
console.log(chalk.bold('Available Agents'));
console.log(chalk.gray(` Use --all-agents to generate for all ${Object.keys(AGENT_CONFIG).length} agents`));
console.log(chalk.gray(` Use --agent <name> to generate for specific agents`));
console.log(colors.bold('Available Agents'));
console.log(colors.muted(` Use --all-agents to generate for all ${Object.keys(AGENT_CONFIG).length} agents`));
console.log(colors.muted(` Use --agent <name> to generate for specific agents`));
}
}
+23 -23
View File
@@ -1,5 +1,5 @@
import { Command, Option } from 'clipanion';
import chalk from 'chalk';
import { colors, warn, success, error } from '../onboarding/index.js';
import {
getActiveProfile,
setActiveProfile,
@@ -35,48 +35,48 @@ export class ProfileCommand extends Command {
const profile = getProfile(this.name as ProfileName);
if (!profile) {
console.log(chalk.red(`Profile not found: ${this.name}`));
console.log(chalk.dim('Run `skillkit profile list` to see available profiles'));
error(`Profile not found: ${this.name}`);
console.log(colors.muted('Run `skillkit profile list` to see available profiles'));
return 1;
}
setActiveProfile(this.name as ProfileName);
console.log(chalk.green(`✓ Switched to ${profile.name} mode`));
console.log(chalk.dim(` Focus: ${profile.focus}`));
success(`✓ Switched to ${profile.name} mode`);
console.log(colors.muted(` Focus: ${profile.focus}`));
return 0;
}
const active = getActiveProfile();
const profile = getProfile(active);
console.log(chalk.cyan(`Current Profile: ${active}\n`));
console.log(colors.cyan(`Current Profile: ${active}\n`));
if (profile) {
console.log(`Description: ${profile.description}`);
console.log(`Focus: ${profile.focus}`);
console.log();
console.log(chalk.bold('Behaviors:'));
console.log(colors.bold('Behaviors:'));
for (const behavior of profile.behaviors) {
console.log(` • ${behavior}`);
}
console.log();
console.log(chalk.bold('Priorities:'));
console.log(colors.bold('Priorities:'));
console.log(` ${profile.priorities.join(' > ')}`);
if (profile.preferredTools?.length) {
console.log();
console.log(chalk.bold('Preferred Tools:'));
console.log(colors.bold('Preferred Tools:'));
console.log(` ${profile.preferredTools.join(', ')}`);
}
if (profile.avoidTools?.length) {
console.log(chalk.bold('Avoid Tools:'));
console.log(colors.bold('Avoid Tools:'));
console.log(` ${profile.avoidTools.join(', ')}`);
}
}
console.log();
console.log(chalk.dim('Switch with: skillkit profile <name>'));
console.log(colors.muted('Switch with: skillkit profile <name>'));
return 0;
}
@@ -103,21 +103,21 @@ export class ProfileListCommand extends Command {
return 0;
}
console.log(chalk.cyan('Available Profiles:\n'));
console.log(colors.cyan('Available Profiles:\n'));
for (const profile of profiles) {
const isActive = profile.name === active;
const marker = isActive ? chalk.green('●') : chalk.dim('○');
const name = isActive ? chalk.bold(profile.name) : profile.name;
const type = isBuiltinProfile(profile.name) ? '' : chalk.dim(' (custom)');
const marker = isActive ? colors.success('●') : colors.muted('○');
const name = isActive ? colors.bold(profile.name) : profile.name;
const type = isBuiltinProfile(profile.name) ? '' : colors.muted(' (custom)');
console.log(` ${marker} ${name}${type}`);
console.log(` ${chalk.dim(profile.description)}`);
console.log(` ${colors.muted(profile.description)}`);
console.log(` Focus: ${profile.focus}`);
console.log();
}
console.log(chalk.dim('Switch with: skillkit profile <name>'));
console.log(colors.muted('Switch with: skillkit profile <name>'));
return 0;
}
@@ -149,7 +149,7 @@ export class ProfileCreateCommand extends Command {
async execute(): Promise<number> {
if (isBuiltinProfile(this.name as ProfileName)) {
console.log(chalk.red(`Cannot create profile: ${this.name} is a built-in profile`));
error(`Cannot create profile: ${this.name} is a built-in profile`);
return 1;
}
@@ -163,8 +163,8 @@ export class ProfileCreateCommand extends Command {
addCustomProfile(profile);
console.log(chalk.green(`✓ Created profile: ${this.name}`));
console.log(chalk.dim('Edit ~/.skillkit/profiles.yaml to customize'));
success(`✓ Created profile: ${this.name}`);
console.log(colors.muted('Edit ~/.skillkit/profiles.yaml to customize'));
return 0;
}
@@ -182,18 +182,18 @@ export class ProfileRemoveCommand extends Command {
async execute(): Promise<number> {
if (isBuiltinProfile(this.name as ProfileName)) {
console.log(chalk.red(`Cannot remove built-in profile: ${this.name}`));
error(`Cannot remove built-in profile: ${this.name}`);
return 1;
}
const removed = removeCustomProfile(this.name as ProfileName);
if (!removed) {
console.log(chalk.yellow(`Profile not found: ${this.name}`));
warn(`Profile not found: ${this.name}`);
return 1;
}
console.log(chalk.green(`✓ Removed profile: ${this.name}`));
success(`✓ Removed profile: ${this.name}`);
return 0;
}
+303 -231
View File
@@ -1,13 +1,31 @@
import { existsSync, readFileSync, mkdirSync, writeFileSync, readdirSync, statSync } from 'node:fs';
import { join, basename, dirname, resolve } from 'node:path';
import chalk from 'chalk';
import { Command, Option } from 'clipanion';
import { generateWellKnownIndex, type WellKnownSkill, SkillScanner, formatSummary, Severity } from '@skillkit/core';
import {
existsSync,
readFileSync,
mkdirSync,
writeFileSync,
readdirSync,
statSync,
} from "node:fs";
import { join, basename, dirname, resolve, sep } from "node:path";
import { colors, warn, success, error, step } from "../onboarding/index.js";
import { Command, Option } from "clipanion";
import {
generateWellKnownIndex,
type WellKnownSkill,
SkillScanner,
formatSummary,
Severity,
} from "@skillkit/core";
function sanitizeSkillName(name: string): string | null {
if (!name || typeof name !== 'string') return null;
if (!name || typeof name !== "string") return null;
const base = basename(name);
if (base !== name || name.includes('..') || name.includes('/') || name.includes('\\')) {
if (
base !== name ||
name.includes("..") ||
name.includes("/") ||
name.includes("\\")
) {
return null;
}
if (!/^[a-zA-Z0-9._-]+$/.test(name)) {
@@ -23,11 +41,64 @@ interface SkillFrontmatter {
version?: string;
}
function parseSkillFrontmatter(content: string): SkillFrontmatter {
const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
if (!match) return {};
const frontmatter: SkillFrontmatter = {};
const lines = match[1].split(/\r?\n/);
let inTagsList = false;
for (const line of lines) {
if (inTagsList) {
const tagMatch = line.match(/^\s*-\s*(.+)$/);
if (tagMatch) {
frontmatter.tags ??= [];
frontmatter.tags.push(tagMatch[1].trim().replace(/^["']|["']$/g, ""));
continue;
}
if (line.trim() === "") continue;
inTagsList = false;
}
const colonIdx = line.indexOf(":");
if (colonIdx === -1) continue;
const key = line.slice(0, colonIdx).trim();
const value = line.slice(colonIdx + 1).trim();
switch (key) {
case "name":
frontmatter.name = value.replace(/^["']|["']$/g, "");
break;
case "description":
frontmatter.description = value.replace(/^["']|["']$/g, "");
break;
case "version":
frontmatter.version = value.replace(/^["']|["']$/g, "");
break;
case "tags":
if (value.startsWith("[")) {
frontmatter.tags = value
.slice(1, -1)
.split(",")
.map((t) => t.trim().replace(/^["']|["']$/g, ""))
.filter((t) => t.length > 0);
} else if (value === "") {
inTagsList = true;
frontmatter.tags = [];
}
break;
}
}
return frontmatter;
}
export class PublishCommand extends Command {
static override paths = [['publish']];
static override paths = [["publish"]];
static override usage = Command.Usage({
description: 'Generate well-known skills structure for hosting',
description: "Generate well-known skills structure for hosting",
details: `
This command generates the RFC 8615 well-known URI structure for hosting skills.
@@ -38,59 +109,77 @@ export class PublishCommand extends Command {
Users can then install skills via: skillkit add https://your-domain.com
`,
examples: [
['Generate from current directory', '$0 publish'],
['Generate from specific path', '$0 publish ./my-skills'],
['Generate to custom output directory', '$0 publish --output ./public'],
['Preview without writing', '$0 publish --dry-run'],
["Generate from current directory", "$0 publish"],
["Generate from specific path", "$0 publish ./my-skills"],
["Generate to custom output directory", "$0 publish --output ./public"],
["Preview without writing", "$0 publish --dry-run"],
],
});
skillPath = Option.String({ required: false, name: 'path' });
skillPath = Option.String({ required: false, name: "path" });
output = Option.String('--output,-o', {
description: 'Output directory for well-known structure (default: current directory)',
output = Option.String("--output,-o", {
description:
"Output directory for well-known structure (default: current directory)",
});
dryRun = Option.Boolean('--dry-run,-n', false, {
description: 'Show what would be generated without writing files',
dryRun = Option.Boolean("--dry-run,-n", false, {
description: "Show what would be generated without writing files",
});
format = Option.String('--format', {
description: 'Output format: "standard" (default) or "mintlify" (.well-known/skills/default/skill.md)',
format = Option.String("--format", {
description:
'Output format: "standard" (default) or "mintlify" (.well-known/skills/default/skill.md)',
});
async execute(): Promise<number> {
const basePath = this.skillPath || process.cwd();
const outputDir = this.output || basePath;
console.log(chalk.cyan('Generating well-known skills structure...\n'));
step("Generating well-known skills structure...\n");
const discoveredSkills = this.discoverSkills(basePath);
if (discoveredSkills.length === 0) {
console.error(chalk.red('No skills found'));
console.error(chalk.dim('Skills must contain a SKILL.md file with frontmatter'));
error("No skills found");
console.error(
colors.muted("Skills must contain a SKILL.md file with frontmatter"),
);
return 1;
}
console.log(chalk.white(`Found ${discoveredSkills.length} skill(s):\n`));
console.log(colors.primary(`Found ${discoveredSkills.length} skill(s):\n`));
const wellKnownSkills: WellKnownSkill[] = [];
const validSkills: Array<{ name: string; safeName: string; description?: string; path: string }> = [];
const validSkills: Array<{
name: string;
safeName: string;
description?: string;
path: string;
}> = [];
for (const skill of discoveredSkills) {
const safeName = sanitizeSkillName(skill.name);
if (!safeName) {
console.log(chalk.yellow(` ${chalk.yellow('⚠')} Skipping "${skill.name}" (invalid name - must be alphanumeric with hyphens/underscores)`));
warn(
` ${colors.warning("⚠")} Skipping "${skill.name}" (invalid name - must be alphanumeric with hyphens/underscores)`,
);
continue;
}
const files = this.getSkillFiles(skill.path);
console.log(chalk.dim(` ${chalk.green('●')} ${safeName}`));
console.log(chalk.dim(` Description: ${skill.description || 'No description'}`));
console.log(chalk.dim(` Files: ${files.join(', ')}`));
console.log(colors.muted(` ${colors.success("●")} ${safeName}`));
console.log(
colors.muted(` Description: ${skill.description || "No description"}`),
);
console.log(colors.muted(` Files: ${files.join(", ")}`));
validSkills.push({ name: skill.name, safeName, description: skill.description, path: skill.path });
validSkills.push({
name: skill.name,
safeName,
description: skill.description,
path: skill.path,
});
wellKnownSkills.push({
name: safeName,
description: skill.description,
@@ -101,78 +190,111 @@ export class PublishCommand extends Command {
const scanner = new SkillScanner({ failOnSeverity: Severity.HIGH });
for (const skill of validSkills) {
const scanResult = await scanner.scan(skill.path);
if (scanResult.verdict === 'fail') {
console.error(chalk.red(`\nSecurity scan FAILED for "${skill.safeName}"`));
if (scanResult.verdict === "fail") {
error(`\nSecurity scan FAILED for "${skill.safeName}"`);
console.error(formatSummary(scanResult));
console.error(chalk.dim('Fix security issues before publishing.'));
console.error(colors.muted("Fix security issues before publishing."));
return 1;
}
if (scanResult.verdict === 'warn') {
console.log(chalk.yellow(` Security warnings for "${skill.safeName}" (${scanResult.findings.length} findings)`));
if (scanResult.verdict === "warn") {
warn(
` Security warnings for "${skill.safeName}" (${scanResult.findings.length} findings)`,
);
}
}
if (validSkills.length === 0) {
console.error(chalk.red('\nNo valid skills to publish'));
error("\nNo valid skills to publish");
return 1;
}
console.log('');
console.log("");
if (this.format === 'mintlify') {
if (this.format === "mintlify") {
if (this.dryRun) {
console.log(chalk.yellow('Dry run - not writing files\n'));
console.log(chalk.white('Would generate (Mintlify format):'));
warn("Dry run - not writing files\n");
console.log(colors.primary("Would generate (Mintlify format):"));
for (const skill of validSkills) {
console.log(chalk.dim(` ${outputDir}/.well-known/skills/${skill.safeName}/skill.md`));
console.log(
colors.muted(
` ${outputDir}/.well-known/skills/${skill.safeName}/skill.md`,
),
);
}
return 0;
}
const resolvedOutput = resolve(outputDir);
for (const skill of validSkills) {
const mintlifyDir = join(outputDir, '.well-known', 'skills', skill.safeName);
const mintlifyDir = join(
outputDir,
".well-known",
"skills",
skill.safeName,
);
const resolvedDir = resolve(mintlifyDir);
if (!resolvedDir.startsWith(resolvedOutput)) {
console.log(chalk.red(`Skipping ${skill.safeName} (path traversal detected)`));
if (!resolvedDir.startsWith(resolvedOutput + sep)) {
console.log(
colors.error(`Skipping ${skill.safeName} (path traversal detected)`),
);
continue;
}
mkdirSync(mintlifyDir, { recursive: true });
const skillMdPath = join(skill.path, 'SKILL.md');
const skillMdPath = join(skill.path, "SKILL.md");
if (existsSync(skillMdPath)) {
const content = readFileSync(skillMdPath, 'utf-8');
writeFileSync(join(mintlifyDir, 'skill.md'), content);
const content = readFileSync(skillMdPath, "utf-8");
writeFileSync(join(mintlifyDir, "skill.md"), content);
}
}
console.log(chalk.green('Generated Mintlify well-known structure:\n'));
success("Generated Mintlify well-known structure:\n");
for (const skill of validSkills) {
console.log(chalk.dim(` ${outputDir}/.well-known/skills/${skill.safeName}/skill.md`));
console.log(
colors.muted(
` ${outputDir}/.well-known/skills/${skill.safeName}/skill.md`,
),
);
}
console.log('');
console.log(chalk.cyan('Next steps:'));
console.log(chalk.dim(' 1. Deploy the .well-known directory to your web server'));
console.log(chalk.dim(' 2. Users can install via: skillkit install https://your-domain.com'));
console.log(chalk.dim(' 3. Skills auto-discovered from /.well-known/skills/{name}/skill.md'));
console.log("");
step("Next steps:");
console.log(
colors.muted(" 1. Deploy the .well-known directory to your web server"),
);
console.log(
colors.muted(
" 2. Users can install via: skillkit install https://your-domain.com",
),
);
console.log(
colors.muted(
" 3. Skills auto-discovered from /.well-known/skills/{name}/skill.md",
),
);
return 0;
}
if (this.dryRun) {
console.log(chalk.yellow('Dry run - not writing files\n'));
console.log(chalk.white('Would generate:'));
console.log(chalk.dim(` ${outputDir}/.well-known/skills/index.json`));
warn("Dry run - not writing files\n");
console.log(colors.primary("Would generate:"));
console.log(colors.muted(` ${outputDir}/.well-known/skills/index.json`));
for (const skill of wellKnownSkills) {
for (const file of skill.files) {
console.log(chalk.dim(` ${outputDir}/.well-known/skills/${skill.name}/${file}`));
console.log(
colors.muted(
` ${outputDir}/.well-known/skills/${skill.name}/${file}`,
),
);
}
}
console.log('');
console.log(chalk.white('index.json preview:'));
console.log(JSON.stringify(generateWellKnownIndex(wellKnownSkills), null, 2));
console.log("");
console.log(colors.primary("index.json preview:"));
console.log(
JSON.stringify(generateWellKnownIndex(wellKnownSkills), null, 2),
);
return 0;
}
const wellKnownDir = join(outputDir, '.well-known', 'skills');
const wellKnownDir = join(outputDir, ".well-known", "skills");
mkdirSync(wellKnownDir, { recursive: true });
for (const skill of validSkills) {
@@ -180,8 +302,8 @@ export class PublishCommand extends Command {
const resolvedSkillDir = resolve(skillDir);
const resolvedWellKnownDir = resolve(wellKnownDir);
if (!resolvedSkillDir.startsWith(resolvedWellKnownDir)) {
console.log(chalk.yellow(` Skipping "${skill.name}" (path traversal detected)`));
if (!resolvedSkillDir.startsWith(resolvedWellKnownDir + sep)) {
warn(` Skipping "${skill.name}" (path traversal detected)`);
continue;
}
@@ -192,35 +314,51 @@ export class PublishCommand extends Command {
const safeFile = basename(file);
const sourcePath = join(skill.path, file);
const destPath = join(skillDir, safeFile);
const content = readFileSync(sourcePath, 'utf-8');
const content = readFileSync(sourcePath, "utf-8");
writeFileSync(destPath, content);
}
}
const index = generateWellKnownIndex(wellKnownSkills);
writeFileSync(join(wellKnownDir, 'index.json'), JSON.stringify(index, null, 2));
writeFileSync(
join(wellKnownDir, "index.json"),
JSON.stringify(index, null, 2),
);
console.log(chalk.green('Generated well-known structure:\n'));
console.log(chalk.dim(` ${wellKnownDir}/index.json`));
success("Generated well-known structure:\n");
console.log(colors.muted(` ${wellKnownDir}/index.json`));
for (const skill of wellKnownSkills) {
console.log(chalk.dim(` ${wellKnownDir}/${skill.name}/`));
console.log(colors.muted(` ${wellKnownDir}/${skill.name}/`));
}
console.log('');
console.log(chalk.cyan('Next steps:'));
console.log(chalk.dim(' 1. Deploy the .well-known directory to your web server'));
console.log(chalk.dim(' 2. Users can install via: skillkit add https://your-domain.com'));
console.log(chalk.dim(' 3. Skills auto-discovered from /.well-known/skills/index.json'));
console.log("");
step("Next steps:");
console.log(
colors.muted(" 1. Deploy the .well-known directory to your web server"),
);
console.log(
colors.muted(
" 2. Users can install via: skillkit add https://your-domain.com",
),
);
console.log(
colors.muted(
" 3. Skills auto-discovered from /.well-known/skills/index.json",
),
);
return 0;
}
private discoverSkills(basePath: string): Array<{ name: string; description?: string; path: string }> {
const skills: Array<{ name: string; description?: string; path: string }> = [];
private discoverSkills(
basePath: string,
): Array<{ name: string; description?: string; path: string }> {
const skills: Array<{ name: string; description?: string; path: string }> =
[];
const skillMdPath = join(basePath, 'SKILL.md');
const skillMdPath = join(basePath, "SKILL.md");
if (existsSync(skillMdPath)) {
const content = readFileSync(skillMdPath, 'utf-8');
const content = readFileSync(skillMdPath, "utf-8");
const frontmatter = this.parseFrontmatter(content);
skills.push({
name: frontmatter.name || basename(basePath),
@@ -232,8 +370,8 @@ export class PublishCommand extends Command {
const searchDirs = [
basePath,
join(basePath, 'skills'),
join(basePath, '.claude', 'skills'),
join(basePath, "skills"),
join(basePath, ".claude", "skills"),
];
for (const searchDir of searchDirs) {
@@ -244,9 +382,9 @@ export class PublishCommand extends Command {
const entryPath = join(searchDir, entry);
if (!statSync(entryPath).isDirectory()) continue;
const entrySkillMd = join(entryPath, 'SKILL.md');
const entrySkillMd = join(entryPath, "SKILL.md");
if (existsSync(entrySkillMd)) {
const content = readFileSync(entrySkillMd, 'utf-8');
const content = readFileSync(entrySkillMd, "utf-8");
const frontmatter = this.parseFrontmatter(content);
skills.push({
name: frontmatter.name || entry,
@@ -267,92 +405,42 @@ export class PublishCommand extends Command {
for (const entry of entries) {
const entryPath = join(skillPath, entry);
if (statSync(entryPath).isFile()) {
if (entry.startsWith('.') || entry === '.skillkit-metadata.json') continue;
if (entry.startsWith(".")) continue;
files.push(entry);
}
}
if (!files.includes('SKILL.md')) {
files.unshift('SKILL.md');
if (!files.includes("SKILL.md")) {
files.unshift("SKILL.md");
}
return files;
}
private parseFrontmatter(content: string): SkillFrontmatter {
const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
if (!match) return {};
const frontmatter: SkillFrontmatter = {};
const lines = match[1].split(/\r?\n/);
let inTagsList = false;
for (const line of lines) {
if (inTagsList) {
const tagMatch = line.match(/^\s*-\s*(.+)$/);
if (tagMatch) {
frontmatter.tags ??= [];
frontmatter.tags.push(tagMatch[1].trim().replace(/^["']|["']$/g, ''));
continue;
}
if (line.trim() === '') continue;
inTagsList = false;
}
const colonIdx = line.indexOf(':');
if (colonIdx === -1) continue;
const key = line.slice(0, colonIdx).trim();
const value = line.slice(colonIdx + 1).trim();
switch (key) {
case 'name':
frontmatter.name = value.replace(/^["']|["']$/g, '');
break;
case 'description':
frontmatter.description = value.replace(/^["']|["']$/g, '');
break;
case 'version':
frontmatter.version = value.replace(/^["']|["']$/g, '');
break;
case 'tags':
if (value.startsWith('[')) {
frontmatter.tags = value
.slice(1, -1)
.split(',')
.map(t => t.trim().replace(/^["']|["']$/g, ''))
.filter(t => t.length > 0);
} else if (value === '') {
inTagsList = true;
frontmatter.tags = [];
}
break;
}
}
return frontmatter;
return parseSkillFrontmatter(content);
}
}
export class PublishSubmitCommand extends Command {
static override paths = [['publish', 'submit']];
static override paths = [["publish", "submit"]];
static override usage = Command.Usage({
description: 'Submit skill to SkillKit marketplace (requires review)',
description: "Submit skill to SkillKit marketplace (requires review)",
examples: [
['Submit skill from current directory', '$0 publish submit'],
['Submit with custom name', '$0 publish submit --name my-skill'],
["Submit skill from current directory", "$0 publish submit"],
["Submit with custom name", "$0 publish submit --name my-skill"],
],
});
skillPath = Option.String({ required: false, name: 'path' });
skillPath = Option.String({ required: false, name: "path" });
name = Option.String('--name,-n', {
description: 'Custom skill name',
name = Option.String("--name,-n", {
description: "Custom skill name",
});
dryRun = Option.Boolean('--dry-run', false, {
description: 'Show what would be submitted',
dryRun = Option.Boolean("--dry-run", false, {
description: "Show what would be submitted",
});
async execute(): Promise<number> {
@@ -360,49 +448,58 @@ export class PublishSubmitCommand extends Command {
const skillMdPath = this.findSkillMd(skillPath);
if (!skillMdPath) {
console.error(chalk.red('No SKILL.md found'));
console.error(chalk.dim('Run this command from a directory containing SKILL.md'));
error("No SKILL.md found");
console.error(
colors.muted("Run this command from a directory containing SKILL.md"),
);
return 1;
}
console.log(chalk.cyan('Submitting skill to SkillKit marketplace...\n'));
step("Submitting skill to SkillKit marketplace...\n");
const content = readFileSync(skillMdPath, 'utf-8');
const content = readFileSync(skillMdPath, "utf-8");
const frontmatter = this.parseFrontmatter(content);
const skillName = this.name || frontmatter.name || basename(dirname(skillMdPath));
const skillName =
this.name || frontmatter.name || basename(dirname(skillMdPath));
const repoInfo = this.getRepoInfo(dirname(skillMdPath));
const repoInfo = await this.getRepoInfo(dirname(skillMdPath));
if (!repoInfo) {
console.error(chalk.red('Not a git repository or no remote configured'));
console.error(chalk.dim('Your skill must be in a git repository with a GitHub remote'));
error("Not a git repository or no remote configured");
console.error(
colors.muted(
"Your skill must be in a git repository with a GitHub remote",
),
);
return 1;
}
const skillSlug = this.slugify(skillName);
if (!skillSlug) {
console.error(chalk.red('Skill name produces an empty slug.'));
console.error(chalk.dim('Please pass --name with letters or numbers.'));
error("Skill name produces an empty slug.");
console.error(colors.muted("Please pass --name with letters or numbers."));
return 1;
}
const skillEntry = {
id: `${repoInfo.owner}/${repoInfo.repo}/${skillSlug}`,
name: this.formatName(skillName),
description: frontmatter.description || `Best practices for ${this.formatName(skillName)}`,
description:
frontmatter.description ||
`Best practices for ${this.formatName(skillName)}`,
source: `${repoInfo.owner}/${repoInfo.repo}`,
tags: frontmatter.tags || ['general'],
tags: frontmatter.tags || ["general"],
};
console.log(chalk.white('Skill details:'));
console.log(chalk.dim(` ID: ${skillEntry.id}`));
console.log(chalk.dim(` Name: ${skillEntry.name}`));
console.log(chalk.dim(` Description: ${skillEntry.description}`));
console.log(chalk.dim(` Source: ${skillEntry.source}`));
console.log(chalk.dim(` Tags: ${skillEntry.tags.join(', ')}`));
console.log(colors.primary("Skill details:"));
console.log(colors.muted(` ID: ${skillEntry.id}`));
console.log(colors.muted(` Name: ${skillEntry.name}`));
console.log(colors.muted(` Description: ${skillEntry.description}`));
console.log(colors.muted(` Source: ${skillEntry.source}`));
console.log(colors.muted(` Tags: ${skillEntry.tags.join(", ")}`));
console.log();
if (this.dryRun) {
console.log(chalk.yellow('Dry run - not submitting'));
warn("Dry run - not submitting");
console.log(JSON.stringify(skillEntry, null, 2));
return 0;
}
@@ -412,42 +509,46 @@ export class PublishSubmitCommand extends Command {
const issueBodyEncoded = encodeURIComponent(issueBody);
const issueUrl = `https://github.com/rohitg00/skillkit/issues/new?title=${issueTitle}&body=${issueBodyEncoded}&labels=skill-submission,publish`;
console.log(chalk.green('Opening GitHub to submit your skill...\n'));
success("Opening GitHub to submit your skill...\n");
try {
const { execSync } = await import('node:child_process');
const openCmd =
process.platform === 'darwin'
? `open "${issueUrl}"`
: process.platform === 'win32'
? `cmd /c start "" "${issueUrl}"`
: `xdg-open "${issueUrl}"`;
execSync(openCmd, { stdio: 'ignore' });
const { execFileSync } = await import("node:child_process");
const cmd =
process.platform === "darwin"
? "open"
: process.platform === "win32"
? "cmd"
: "xdg-open";
const args =
process.platform === "win32"
? ["/c", "start", "", issueUrl]
: [issueUrl];
execFileSync(cmd, args, { stdio: "ignore" });
console.log(chalk.green('GitHub issue page opened!'));
console.log(chalk.dim('Review and submit the issue.'));
success("GitHub issue page opened!");
console.log(colors.muted("Review and submit the issue."));
} catch {
console.log(chalk.yellow('Could not open browser automatically.'));
console.log(chalk.dim('Please open this URL manually:\n'));
console.log(chalk.cyan(issueUrl));
warn("Could not open browser automatically.");
console.log(colors.muted("Please open this URL manually:\n"));
console.log(colors.cyan(issueUrl));
}
return 0;
}
private findSkillMd(basePath: string): string | null {
if (basePath.endsWith('SKILL.md') && existsSync(basePath)) {
if (basePath.endsWith("SKILL.md") && existsSync(basePath)) {
return basePath;
}
const direct = join(basePath, 'SKILL.md');
const direct = join(basePath, "SKILL.md");
if (existsSync(direct)) {
return direct;
}
const locations = [
join(basePath, 'skills', 'SKILL.md'),
join(basePath, '.claude', 'skills', 'SKILL.md'),
join(basePath, "skills", "SKILL.md"),
join(basePath, ".claude", "skills", "SKILL.md"),
];
for (const loc of locations) {
@@ -460,59 +561,26 @@ export class PublishSubmitCommand extends Command {
}
private parseFrontmatter(content: string): SkillFrontmatter {
const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
if (!match) return {};
const frontmatter: SkillFrontmatter = {};
const lines = match[1].split(/\r?\n/);
for (const line of lines) {
const colonIdx = line.indexOf(':');
if (colonIdx === -1) continue;
const key = line.slice(0, colonIdx).trim();
const value = line.slice(colonIdx + 1).trim();
switch (key) {
case 'name':
frontmatter.name = value.replace(/^["']|["']$/g, '');
break;
case 'description':
frontmatter.description = value.replace(/^["']|["']$/g, '');
break;
case 'version':
frontmatter.version = value.replace(/^["']|["']$/g, '');
break;
case 'tags':
if (value.startsWith('[')) {
frontmatter.tags = value
.slice(1, -1)
.split(',')
.map(t => t.trim().replace(/^["']|["']$/g, ''))
.filter(t => t.length > 0);
}
break;
}
}
return frontmatter;
return parseSkillFrontmatter(content);
}
private slugify(name: string): string {
return name
.toLowerCase()
.trim()
.replace(/[^a-z0-9]+/g, '-')
.replace(/^-+|-+$/g, '');
.replace(/[^a-z0-9]+/g, "-")
.replace(/^-+|-+$/g, "");
}
private getRepoInfo(dir: string): { owner: string; repo: string } | null {
private async getRepoInfo(
dir: string,
): Promise<{ owner: string; repo: string } | null> {
try {
const { execSync } = require('node:child_process');
const remote = execSync('git remote get-url origin', {
const { execFileSync } = await import("node:child_process");
const remote = execFileSync("git", ["remote", "get-url", "origin"], {
cwd: dir,
encoding: 'utf-8',
stdio: ['pipe', 'pipe', 'ignore'],
encoding: "utf-8",
stdio: ["pipe", "pipe", "ignore"],
}).trim();
const match = remote.match(/github\.com[:/]([^/]+)\/(.+?)(?:\.git)?$/);
@@ -529,13 +597,17 @@ export class PublishSubmitCommand extends Command {
private formatName(name: string): string {
return name
.split(/[-_]/)
.map(word => word.charAt(0).toUpperCase() + word.slice(1))
.join(' ');
.map((word) => word.charAt(0).toUpperCase() + word.slice(1))
.join(" ");
}
private createIssueBody(
skill: { id: string; name: string; description: string; source: string; tags: string[] }
): string {
private createIssueBody(skill: {
id: string;
name: string;
description: string;
source: string;
tags: string[];
}): string {
return `## Publish Skill Request
### Skill Details
@@ -543,7 +615,7 @@ export class PublishSubmitCommand extends Command {
- **Name:** ${skill.name}
- **Description:** ${skill.description}
- **Source:** [${skill.source}](https://github.com/${skill.source})
- **Tags:** ${skill.tags.map(t => `\`${t}\``).join(', ')}
- **Tags:** ${skill.tags.map((t) => `\`${t}\``).join(", ")}
### JSON Entry
\`\`\`json
+1 -1
View File
@@ -351,7 +351,7 @@ export class QuickCommand extends Command {
console.log('');
const badgeUrl = `https://img.shields.io/badge/SkillKit-${encodeURIComponent(matchedSkill.name)}-black?style=flat-square`;
console.log(colors.dim('Add to your README:'));
console.log(colors.muted(` [![SkillKit](${badgeUrl})](https://agenstskills.com)`));
console.log(colors.muted(` [![SkillKit](${badgeUrl})](https://skillkit.sh)`));
outro('Quick setup complete!');
+8 -8
View File
@@ -1,4 +1,4 @@
import chalk from 'chalk';
import { colors, warn, error } from '../onboarding/index.js';
import { Command, Option } from 'clipanion';
import { findSkill, readSkillContent } from '@skillkit/core';
import { getSearchDirs } from '../helpers.js';
@@ -30,7 +30,7 @@ export class ReadCommand extends Command {
.filter(s => s.length > 0);
if (skillNames.length === 0) {
console.error(chalk.red('No skill names provided'));
error('No skill names provided');
return 1;
}
@@ -40,16 +40,16 @@ export class ReadCommand extends Command {
const skill = findSkill(skillName, searchDirs);
if (!skill) {
console.error(chalk.red(`Skill not found: ${skillName}`));
console.error(chalk.dim('Available directories:'));
searchDirs.forEach(d => console.error(chalk.dim(` - ${d}`)));
error(`Skill not found: ${skillName}`);
console.log(colors.muted('Available directories:'));
searchDirs.forEach(d => console.log(colors.muted(` - ${d}`)));
exitCode = 1;
continue;
}
if (!skill.enabled) {
console.error(chalk.yellow(`Skill disabled: ${skillName}`));
console.error(chalk.dim('Enable with: skillkit enable ' + skillName));
warn(`Skill disabled: ${skillName}`);
console.log(colors.muted('Enable with: skillkit enable ' + skillName));
exitCode = 1;
continue;
}
@@ -57,7 +57,7 @@ export class ReadCommand extends Command {
const content = readSkillContent(skill.path);
if (!content) {
console.error(chalk.red(`Could not read SKILL.md for: ${skillName}`));
error(`Could not read SKILL.md for: ${skillName}`);
exitCode = 1;
continue;
}
+69 -24
View File
@@ -1,8 +1,8 @@
import { existsSync, rmSync, readFileSync, writeFileSync } from 'node:fs';
import { join } from 'node:path';
import chalk from 'chalk';
import { join, dirname, basename } from 'node:path';
import { colors, warn, success, error } from '../onboarding/index.js';
import { Command, Option } from 'clipanion';
import { findSkill, AgentsMdParser, AgentsMdGenerator } from '@skillkit/core';
import { findSkill, findAllSkills, loadMetadata, AgentsMdParser, AgentsMdGenerator } from '@skillkit/core';
import { getSearchDirs } from '../helpers.js';
export class RemoveCommand extends Command {
@@ -13,11 +13,21 @@ export class RemoveCommand extends Command {
examples: [
['Remove a skill', '$0 remove pdf'],
['Remove multiple skills', '$0 remove pdf xlsx docx'],
['Force removal without confirmation', '$0 remove pdf --force'],
['Remove all skills from a source', '$0 remove --source iii-hq/iii'],
['Remove all installed skills', '$0 remove --all'],
['Force removal without confirmation', '$0 remove --all --force'],
],
});
skills = Option.Rest({ required: 1 });
skills = Option.Rest({ required: 0 });
all = Option.Boolean('--all,-a', false, {
description: 'Remove all installed skills',
});
source = Option.String('--source,-s', {
description: 'Remove all skills installed from this source (e.g. iii-hq/iii)',
});
force = Option.Boolean('--force,-f', false, {
description: 'Skip confirmation',
@@ -25,29 +35,64 @@ export class RemoveCommand extends Command {
async execute(): Promise<number> {
const searchDirs = getSearchDirs();
if (!this.all && !this.source && this.skills.length === 0) {
error('Provide skill names, --source, or --all');
return 1;
}
let skillsToRemove: Array<{ name: string; path: string }> = [];
if (this.all || this.source) {
const allSkills = findAllSkills(searchDirs);
if (this.source) {
skillsToRemove = allSkills.filter((s) => {
const meta = loadMetadata(s.path);
return meta?.source?.includes(this.source!) ?? false;
}).map((s) => ({ name: s.name, path: s.path }));
if (skillsToRemove.length === 0) {
warn(`No skills found from source: ${this.source}`);
return 0;
}
} else {
skillsToRemove = allSkills.map((s) => ({ name: s.name, path: s.path }));
if (skillsToRemove.length === 0) {
warn('No installed skills found');
return 0;
}
}
console.log(colors.muted(`Found ${skillsToRemove.length} skill(s) to remove`));
} else {
for (const skillName of this.skills) {
const skill = findSkill(skillName, searchDirs);
if (!skill) {
warn(`Skill not found: ${skillName}`);
continue;
}
skillsToRemove.push({ name: skill.name, path: skill.path });
}
}
let removed = 0;
let failed = 0;
for (const skillName of this.skills) {
const skill = findSkill(skillName, searchDirs);
if (!skill) {
console.log(chalk.yellow(`Skill not found: ${skillName}`));
continue;
}
if (!existsSync(skill.path)) {
console.log(chalk.yellow(`Path not found: ${skill.path}`));
for (const { name: skillName, path: skillPath } of skillsToRemove) {
if (!existsSync(skillPath)) {
warn(`Path not found: ${skillPath}`);
continue;
}
try {
rmSync(skill.path, { recursive: true, force: true });
console.log(chalk.green(`Removed: ${skillName}`));
rmSync(skillPath, { recursive: true, force: true });
if (skillPath.endsWith('.md')) {
const metaSibling = join(dirname(skillPath), `.${basename(skillPath, '.md')}.skillkit.json`);
if (existsSync(metaSibling)) rmSync(metaSibling);
}
success(`Removed: ${skillName}`);
removed++;
} catch (error) {
console.log(chalk.red(`Failed to remove: ${skillName}`));
console.error(chalk.dim(error instanceof Error ? error.message : String(error)));
} catch (err) {
error(`Failed to remove: ${skillName}`);
console.error(colors.muted(err instanceof Error ? err.message : String(err)));
failed++;
}
}
@@ -65,11 +110,11 @@ export class RemoveCommand extends Command {
writeFileSync(agentsMdPath, updated, 'utf-8');
}
}
} catch (error) {
console.log(chalk.yellow('Warning: Failed to update AGENTS.md'));
console.error(chalk.dim(error instanceof Error ? error.message : String(error)));
} catch (err) {
warn('Warning: Failed to update AGENTS.md');
console.error(colors.muted(err instanceof Error ? err.message : String(err)));
}
console.log(chalk.dim('\nRun `skillkit sync` to update your agent config'));
console.log(colors.muted('\nRun `skillkit sync` to update your agent config'));
}
return failed > 0 ? 1 : 0;
+14 -15
View File
@@ -1,6 +1,6 @@
import { Command, Option } from 'clipanion';
import { resolve } from 'node:path';
import chalk from 'chalk';
import { colors, warn, success, error } from '../onboarding/index.js';
import { SessionManager } from '@skillkit/core';
/**
@@ -36,47 +36,46 @@ export class ResumeCommand extends Command {
const state = manager.get();
if (!state) {
console.log(chalk.yellow('No active session found.'));
warn('No active session found.');
return 1;
}
if (!state.currentExecution) {
console.log(chalk.yellow('No skill execution to resume.'));
console.log(chalk.dim('Start a new execution with: skillkit run <skill>'));
warn('No skill execution to resume.');
console.log(colors.muted('Start a new execution with: skillkit run <skill>'));
return 1;
}
if (state.currentExecution.status !== 'paused') {
if (state.currentExecution.status === 'running') {
console.log(chalk.yellow('Execution is already running.'));
warn('Execution is already running.');
} else {
console.log(chalk.yellow(`Execution is ${state.currentExecution.status}.`));
warn(`Execution is ${state.currentExecution.status}.`);
}
return 1;
}
const success = manager.resume();
const resumed = manager.resume();
if (success) {
if (resumed) {
const exec = state.currentExecution;
console.log(chalk.green('✓ Execution resumed'));
success('✓ Execution resumed');
console.log();
console.log(` Skill: ${chalk.bold(exec.skillName)}`);
console.log(` Skill: ${colors.bold(exec.skillName)}`);
console.log(` Progress: ${exec.currentStep}/${exec.totalSteps} tasks`);
console.log();
// Show next task
const nextTask = exec.tasks.find((t) => t.status === 'pending' || t.status === 'in_progress');
if (nextTask) {
console.log(` Next task: ${chalk.cyan(nextTask.name)}`);
console.log(` Next task: ${colors.cyan(nextTask.name)}`);
}
console.log();
console.log(chalk.dim('The execution will continue from where it left off.'));
console.log(chalk.dim('View status: skillkit status'));
console.log(colors.muted('The execution will continue from where it left off.'));
console.log(colors.muted('View status: skillkit status'));
return 0;
} else {
console.log(chalk.red('Failed to resume execution.'));
error('Failed to resume execution.');
return 1;
}
}

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