diff --git a/README.md b/README.md index 496728b4..7b83e1ca 100644 --- a/README.md +++ b/README.md @@ -233,11 +233,14 @@ skillkit install # Install skills (with live progress) skillkit remove # Remove skills skillkit remove --source org/repo # Remove all skills from a source skillkit remove --all # Remove all installed skills +skillkit update # Update skills (with change detection) +skillkit check # Check for updates, quality, and activity skillkit translate --to # Translate between agents skillkit sync # Deploy to agent config skillkit recommend # Smart recommendations skillkit generate # AI skill generation wizard skillkit serve # Start REST API server +skillkit publish submit # Publish to marketplace via CLI ``` ### Discovery & Security @@ -249,6 +252,14 @@ skillkit find # Quick search skillkit scan # Security scan for skills ``` +### Custom Sources + +```bash +skillkit tap add owner/repo # Add custom skill source +skillkit tap list # List custom sources +skillkit tap remove owner/repo # Remove custom source +``` + ### Issue Planner ```bash diff --git a/apps/skillkit/src/cli.ts b/apps/skillkit/src/cli.ts index 2e317931..8eba159b 100644 --- a/apps/skillkit/src/cli.ts +++ b/apps/skillkit/src/cli.ts @@ -124,6 +124,9 @@ import { TimelineCommand, SessionHandoffCommand, LineageCommand, + TapAddCommand, + TapRemoveCommand, + TapListCommand, } from '@skillkit/cli'; const __filename = fileURLToPath(import.meta.url); @@ -277,4 +280,8 @@ cli.register(TimelineCommand); cli.register(SessionHandoffCommand); cli.register(LineageCommand); +cli.register(TapAddCommand); +cli.register(TapRemoveCommand); +cli.register(TapListCommand); + cli.runExit(process.argv.slice(2)); diff --git a/docs/fumadocs/content/docs/agents.mdx b/docs/fumadocs/content/docs/agents.mdx index 31d28c5a..e0e478fb 100644 --- a/docs/fumadocs/content/docs/agents.mdx +++ b/docs/fumadocs/content/docs/agents.mdx @@ -1,11 +1,11 @@ --- title: Supported Agents -description: 44 AI coding agents supported by SkillKit +description: 45 AI coding agents supported by SkillKit --- # Supported Agents -SkillKit uses an adapter pattern to support 44 AI coding platforms. Each adapter implements `getConfigPath()` and `generateConfig()` methods. +SkillKit uses an adapter pattern to support 45 AI coding platforms. Each adapter implements `getConfigPath()` and `generateConfig()` methods. ## Agent Directory Mapping diff --git a/docs/fumadocs/content/docs/commands.mdx b/docs/fumadocs/content/docs/commands.mdx index 77e4d4c6..e17914c4 100644 --- a/docs/fumadocs/content/docs/commands.mdx +++ b/docs/fumadocs/content/docs/commands.mdx @@ -70,11 +70,24 @@ skillkit install anthropics/skills --agent claude --agent cursor skillkit remove [options] ``` -| Option | Purpose | -|--------|---------| -| `--agent` | Target specific agents (default: all) | -| `--yes` | Skip confirmation | -| `--keep-metadata` | Remove skill but preserve metadata | +| Option | Short | Purpose | +|--------|-------|---------| +| `--agent` | — | Target specific agents (default: all) | +| `--yes` | — | Skip confirmation | +| `--keep-metadata` | — | Remove skill but preserve metadata | +| `--source` | `-s` | Remove all skills installed from a specific source | +| `--all` | `-a` | Remove all installed skills | +| `--force` | `-f` | Skip confirmation prompt | + +### Bulk Removal + +```bash +skillkit remove --source iii-hq/iii +skillkit remove --all +skillkit remove --all --force +``` + +When using `--source`, SkillKit matches against the source field in each skill's metadata and removes every skill that was installed from that repository. When using `--all`, every discovered skill across all agent directories is removed. Both flags update AGENTS.md automatically if managed sections are present. ## Update Command @@ -82,11 +95,19 @@ skillkit remove [options] skillkit update [skill-names] [options] ``` -| Option | Purpose | -|--------|---------| -| `--dry-run` | Check for updates without installing | -| `--yes` | Skip confirmation prompts | -| `--agent` | Update in specific agents only | +| Option | Short | Purpose | +|--------|-------|---------| +| `--dry-run` | — | Check for updates without installing | +| `--yes` | — | Skip confirmation prompts | +| `--agent` | — | Update in specific agents only | +| `--force` | `-f` | Force update, bypass checksum and GitHub API checks | + +The update command uses a two-stage change detection pipeline: + +1. **GitHub API check** -- For remote sources, SkillKit queries the GitHub API to compare the repository's `pushed_at` timestamp against the installed metadata. If the repository has not been pushed since the last install or update, the skill is skipped without cloning. +2. **Checksum comparison** -- After cloning, a checksum of the source SKILL.md is compared against the stored checksum. If the content is identical, the update is skipped. + +Use `--force` to bypass both checks and always overwrite the installed skill. ## Enable/Disable Commands @@ -97,6 +118,26 @@ skillkit disable [options] Disabled skills are ignored by the `sync` command. No file changes occur. +## Check Command + +```bash +skillkit check [skill-names] [options] +``` + +Checks installed skills for available updates, quality scores, and GitHub activity. + +| Option | Short | Purpose | +|--------|-------|---------| +| `--verbose` | `-v` | Show detailed output including stars and push dates | +| `--quiet` | `-q` | Minimal output | + +For remote GitHub sources, the check command queries the GitHub API to compare each repository's `pushed_at` timestamp against the installed date. Each skill displays its quality score badge (A-F). In verbose mode, the output also includes the repository's star count and how recently it was pushed. + +```bash +skillkit check +skillkit check pdf xlsx --verbose +``` + ## List Command ```bash @@ -457,6 +498,48 @@ skillkit publish --dry-run # Preview without writing skillkit publish submit # Submit to SkillKit marketplace ``` +### publish submit + +Submits a skill to the SkillKit marketplace by creating a GitHub issue on `rohitg00/skillkit` via the `gh` CLI. No browser is needed. + +Before submitting, the command displays: +- Quality score and grade (A-F) from the skill evaluator +- GitHub star count and last push date from the GitHub API +- Any quality warnings (up to 3) + +If `gh` is not installed or not authenticated, the command prints a manual submission URL as a fallback. + +## Tap Command + +Manage custom skill sources (taps). Taps are user-level source repositories stored in `~/.skillkit/taps.json`. They let you add private or third-party skill repositories that are not part of the official marketplace. + +### tap add + +Add a custom skill source. + +```bash +skillkit tap add owner/repo +skillkit tap add owner/repo --name "My Skills" +``` + +### tap remove + +Remove a custom skill source. + +```bash +skillkit tap remove owner/repo +``` + +### tap list + +List all custom skill sources. + +```bash +skillkit tap list +``` + +Once a tap is added, skills from that source appear in `skillkit marketplace search` results and can be installed with the standard `skillkit install owner/repo` workflow. + ## Security Scanning ```bash diff --git a/docs/fumadocs/content/docs/configuration.mdx b/docs/fumadocs/content/docs/configuration.mdx index a0343412..4e5ee5b8 100644 --- a/docs/fumadocs/content/docs/configuration.mdx +++ b/docs/fumadocs/content/docs/configuration.mdx @@ -152,11 +152,61 @@ primer: - .next ``` +## Lock File + +SkillKit maintains a centralized lock file at `~/.skillkit/lock.json` that tracks every installed skill. The lock file is written on install, updated on update, and cleaned on remove. + +```json +{ + "version": 1, + "skills": { + "pdf": { + "source": "anthropics/skills", + "checksum": "sha256:abc123...", + "agents": ["claude-code", "cursor"], + "installedAt": "2026-04-01T12:00:00Z", + "updatedAt": "2026-04-08T09:30:00Z" + } + } +} +``` + +| Field | Description | +|-------|-------------| +| `source` | The repository or local path the skill was installed from | +| `checksum` | SHA-256 hash of the SKILL.md content at install time, used for update detection | +| `agents` | Which agents the skill is installed for | +| `installedAt` | ISO timestamp of initial installation | +| `updatedAt` | ISO timestamp of the most recent update | + +The `update` command compares the stored checksum against the source to skip unchanged skills. The `remove` command cleans up the corresponding lock entry. + +## Taps File + +Custom skill source repositories are stored in `~/.skillkit/taps.json`. Taps are managed via the `skillkit tap` commands. + +```json +{ + "version": 1, + "taps": [ + { + "source": "myorg/internal-skills", + "name": "Internal Skills", + "addedAt": "2026-04-05T10:00:00Z" + } + ] +} +``` + +Skills from tapped sources appear in marketplace search results and can be installed like any other source. See the [tap command](/docs/commands#tap-command) documentation for usage. + ## Directory Structure ``` ~/.skillkit/ ├── preferences.json # User preferences +├── lock.json # Installed skill tracking +├── taps.json # Custom skill sources ├── cache/ # Marketplace cache ├── memory/ # Learning storage │ ├── observations/ diff --git a/docs/fumadocs/content/docs/contributing.mdx b/docs/fumadocs/content/docs/contributing.mdx index 97479239..34bb8578 100644 --- a/docs/fumadocs/content/docs/contributing.mdx +++ b/docs/fumadocs/content/docs/contributing.mdx @@ -29,7 +29,7 @@ skillkit/ │ ├── core/ # Business logic │ ├── cli/ # CLI │ ├── tui/ # Terminal UI -│ └── agents/ # 44 adapters +│ └── agents/ # 45 adapters ├── marketplace/ # Skills data │ ├── skills.json │ └── sources.json diff --git a/docs/fumadocs/content/docs/index.mdx b/docs/fumadocs/content/docs/index.mdx index 9f613eb0..dc0c2791 100644 --- a/docs/fumadocs/content/docs/index.mdx +++ b/docs/fumadocs/content/docs/index.mdx @@ -7,7 +7,7 @@ description: Universal skill management for AI coding agents Skills make AI coding agents smarter. But every agent uses a different format — Claude Code wants `.claude/skills/`, Cursor uses `.mdc`, Copilot expects `.github/skills/`. You end up rewriting the same skill three times, or locking into one platform. -SkillKit fixes this. Write a skill once, deploy it to all 44 agents. +SkillKit fixes this. Write a skill once, deploy it to all 45 agents. ## Get Started @@ -95,7 +95,7 @@ SkillKit sits between your skills and your agents. It handles format translation ## Supported Agents -44 agents and counting: +45 agents and counting: **Claude Code** | **Cursor** | **Codex** | **Gemini CLI** | **OpenCode** | **GitHub Copilot** | **Windsurf** | Amp | Antigravity | Clawdbot | Cline | CodeBuddy | CommandCode | Continue | Crush | Droid | Factory | Goose | Kilo Code | Kiro CLI | MCPJam | Mux | Neovate | OpenHands | Pi | Qoder | Qwen | Roo Code | Trae | Vercel | Zencoder | Universal diff --git a/docs/fumadocs/content/docs/installation.mdx b/docs/fumadocs/content/docs/installation.mdx index 676b33b2..84c09e66 100644 --- a/docs/fumadocs/content/docs/installation.mdx +++ b/docs/fumadocs/content/docs/installation.mdx @@ -58,7 +58,7 @@ The init command: ```bash skillkit init --agent cursor -skillkit init --list # Show all 44 supported agents +skillkit init --list # Show all 45 supported agents skillkit init --quiet # Skip logo and prompts (for CI) ``` diff --git a/docs/fumadocs/content/docs/primer.mdx b/docs/fumadocs/content/docs/primer.mdx index 285d108f..df8a1207 100644 --- a/docs/fumadocs/content/docs/primer.mdx +++ b/docs/fumadocs/content/docs/primer.mdx @@ -5,7 +5,7 @@ description: Auto-generate AI agent instructions from your codebase # Primer -Primer analyzes your codebase and automatically generates optimized instructions for all 44 AI agents. No more manual configuration—let SkillKit detect your tech stack, coding patterns, and project structure. +Primer analyzes your codebase and automatically generates optimized instructions for all 45 AI agents. No more manual configuration—let SkillKit detect your tech stack, coding patterns, and project structure. ## Quick Start @@ -16,7 +16,7 @@ skillkit primer # Generate for specific agents skillkit primer --agent claude,cursor,windsurf -# Generate for all 44 agents +# Generate for all 45 agents skillkit primer --all-agents # Preview without writing files @@ -65,7 +65,7 @@ Primer creates agent-specific instructions for: └── copilot-instructions.md ``` -### All 44 Agents +### All 45 Agents Each agent gets optimized instructions in their native format. ## Example Output diff --git a/docs/fumadocs/content/docs/security.mdx b/docs/fumadocs/content/docs/security.mdx index a5e2b08d..372824f6 100644 --- a/docs/fumadocs/content/docs/security.mdx +++ b/docs/fumadocs/content/docs/security.mdx @@ -242,6 +242,28 @@ console.log(`Findings: ${result.findings.length}`); | **Low** | 1 (with `--fail-on low`) | Minor issue or best practice | | **Info** | 0 | Informational finding | +## Trust Badges + +Skills display a trust badge based on their source and quality analysis. Badges appear during installation, in `skillkit check` output, and in marketplace search results. + +| Badge | Criteria | +|-------|----------| +| **[Official]** | Published by a known official source (Anthropic, Vercel, iii-hq, etc.) | +| **[Trusted]** | TrustScorer rates the skill 8-10 based on clarity, boundaries, specificity, and safety | +| **[Review]** | TrustScorer rates the skill 5-7; the skill may need refinement | +| **[Caution]** | TrustScorer rates the skill 0-4; requires careful review before use | + +The `TrustScorer` evaluates four weighted dimensions: + +| Dimension | Weight | What it measures | +|-----------|--------|------------------| +| Clarity | 30% | How well-defined the skill's purpose and instructions are | +| Boundaries | 25% | Whether the skill stays within its declared scope | +| Specificity | 25% | How concrete and actionable the instructions are | +| Safety | 20% | Absence of dangerous patterns (injection, exfiltration, secrets) | + +Official sources are allowlisted by organization name and always receive the `[Official]` badge regardless of score. For all other sources, the badge is determined by the composite trust score. + ## False Positive Handling The scanner automatically filters: diff --git a/docs/fumadocs/content/docs/translation.mdx b/docs/fumadocs/content/docs/translation.mdx index ae434036..3b0d8432 100644 --- a/docs/fumadocs/content/docs/translation.mdx +++ b/docs/fumadocs/content/docs/translation.mdx @@ -5,7 +5,7 @@ description: Convert skills between AI agent formats # Translation -SkillKit automatically converts between all 44 agent formats using an adapter pattern. +SkillKit automatically converts between all 45 agent formats using an adapter pattern. ## Basic Translation diff --git a/docs/fumadocs/src/app/(home)/page.tsx b/docs/fumadocs/src/app/(home)/page.tsx index 3d5df115..51796755 100644 --- a/docs/fumadocs/src/app/(home)/page.tsx +++ b/docs/fumadocs/src/app/(home)/page.tsx @@ -39,8 +39,8 @@ export default function HomePage() { {/* Features Grid */}
-

44 Agents

-

Claude, Cursor, Codex, Windsurf, Copilot, and 39 more supported out of the box.

+

45 Agents

+

Claude, Cursor, Codex, Windsurf, Copilot, and 40 more supported out of the box.

400K+ Skills

diff --git a/docs/fumadocs/src/components/Documentation.tsx b/docs/fumadocs/src/components/Documentation.tsx index c4d18fcd..8ce011ff 100644 --- a/docs/fumadocs/src/components/Documentation.tsx +++ b/docs/fumadocs/src/components/Documentation.tsx @@ -44,12 +44,12 @@ const sections: DocSection[] = [ content: (

- SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 44 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures. + SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 45 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.

Core Capabilities

  • Skill Discovery - Browse 400K+ skills from registries with AI-powered recommendations
  • -
  • Cross-Agent Translation - Automatically convert skills between 44 agent-specific formats
  • +
  • Cross-Agent Translation - Automatically convert skills between 45 agent-specific formats
  • Team Collaboration - Share skills via .skills manifest files and publish to marketplace
@@ -102,7 +102,7 @@ skillkit install anthropics/skills`}
  • UI Tier - CLI commands, Terminal UI (OpenTUI-based), and documentation website
  • Core Logic Tier - @skillkit/core for business logic; @skillkit/agents for adapter implementations
  • -
  • Integration Tier - File systems, Git repositories, marketplace APIs, and 44 AI agents
  • +
  • Integration Tier - File systems, Git repositories, marketplace APIs, and 45 AI agents

Monorepo Structure

@@ -130,7 +130,7 @@ skillkit install anthropics/skills`} content: (

- SkillKit supports 44 AI coding agents with automatic format translation: + SkillKit supports 45 AI coding agents with automatic format translation:

@@ -64,7 +64,7 @@ const FEATURES: Feature[] = [ ]; const COMPARISONS = [ - ['Agents', '1', '44'], + ['Agents', '1', '45'], ['Translation', 'Manual', 'Auto'], ['Sharing', 'Copy/paste', '.skills manifest'], ['Discovery', 'Forums', 'CLI + AI'], @@ -83,7 +83,7 @@ export function Features(): React.ReactElement {

-
44
+
45
Agents
diff --git a/docs/skillkit/components/AdvancedFeatures.tsx b/docs/skillkit/components/AdvancedFeatures.tsx index 9b45bc21..831a5195 100644 --- a/docs/skillkit/components/AdvancedFeatures.tsx +++ b/docs/skillkit/components/AdvancedFeatures.tsx @@ -69,8 +69,8 @@ const ADVANCED_FEATURES: AdvancedFeature[] = [ id: 'primer', title: 'Primer', subtitle: 'Zero-Config AI Instructions', - description: 'Automatically generate CLAUDE.md, .cursorrules, and agent instructions by analyzing your codebase. Detects your tech stack, coding patterns, and project structure—then creates optimized instructions for all 44 agents.', - highlight: 'Auto-generates instructions for 44 agents', + description: 'Automatically generate CLAUDE.md, .cursorrules, and agent instructions by analyzing your codebase. Detects your tech stack, coding patterns, and project structure—then creates optimized instructions for all 45 agents.', + highlight: 'Auto-generates instructions for 45 agents', icon: ( @@ -78,7 +78,7 @@ const ADVANCED_FEATURES: AdvancedFeature[] = [ ), commands: [ { cmd: 'primer', desc: 'Analyze & generate for detected agents' }, - { cmd: 'primer --all-agents', desc: 'Generate for all 44 agents' }, + { cmd: 'primer --all-agents', desc: 'Generate for all 45 agents' }, { cmd: 'primer --analyze-only', desc: 'Preview codebase analysis' }, { cmd: 'primer --json', desc: 'Machine-readable output' }, ], diff --git a/docs/skillkit/components/Agents.tsx b/docs/skillkit/components/Agents.tsx index e218df15..11edf276 100644 --- a/docs/skillkit/components/Agents.tsx +++ b/docs/skillkit/components/Agents.tsx @@ -429,7 +429,7 @@ export function Agents(): React.ReactElement {

- Works with 44 AI Agents + Works with 45 AI Agents

diff --git a/docs/skillkit/components/Commands.tsx b/docs/skillkit/components/Commands.tsx index 2bf377f1..dd499cb3 100644 --- a/docs/skillkit/components/Commands.tsx +++ b/docs/skillkit/components/Commands.tsx @@ -23,9 +23,19 @@ const COMMAND_GROUPS: CommandGroup[] = [ { cmd: 'list', desc: 'View installed skills' }, { cmd: 'sync', desc: 'Deploy to all agents' }, { cmd: 'translate --to ', desc: 'Convert formats' }, - { cmd: 'update', desc: 'Update all skills' }, + { cmd: 'update', desc: 'Update with change detection' }, { cmd: 'remove ', desc: 'Remove a skill' }, - { cmd: 'status', desc: 'Show skill status' }, + { cmd: 'remove --source org/repo', desc: 'Bulk remove by repo' }, + { cmd: 'remove --all', desc: 'Remove all skills' }, + { cmd: 'check', desc: 'Quality scores & activity' }, + ], + }, + { + name: 'Sources', + commands: [ + { cmd: 'tap add owner/repo', desc: 'Add custom source' }, + { cmd: 'tap list', desc: 'List custom sources' }, + { cmd: 'tap remove owner/repo', desc: 'Remove custom source' }, ], }, { @@ -67,7 +77,7 @@ const COMMAND_GROUPS: CommandGroup[] = [ { cmd: 'manifest init', desc: 'Create .skills file' }, { cmd: 'team init', desc: 'Initialize team' }, { cmd: 'team share', desc: 'Share via Git' }, - { cmd: 'publish', desc: 'Submit to marketplace' }, + { cmd: 'publish submit', desc: 'Submit via CLI' }, { cmd: 'cicd init', desc: 'CI/CD templates' }, { cmd: 'team sync', desc: 'Sync team skills' }, ], diff --git a/docs/skillkit/components/CompatibilityMatrix.tsx b/docs/skillkit/components/CompatibilityMatrix.tsx index e1055d83..6e549ad7 100644 --- a/docs/skillkit/components/CompatibilityMatrix.tsx +++ b/docs/skillkit/components/CompatibilityMatrix.tsx @@ -246,7 +246,7 @@ export function CompatibilityMatrix(): React.ReactElement {

Compatibility Matrix

- Skill support across all 44 agents and {CATEGORIES.length} categories. + Skill support across all 45 agents and {CATEGORIES.length} categories.

diff --git a/docs/skillkit/components/Documentation.tsx b/docs/skillkit/components/Documentation.tsx index c88de408..8c89ff08 100644 --- a/docs/skillkit/components/Documentation.tsx +++ b/docs/skillkit/components/Documentation.tsx @@ -42,13 +42,13 @@ const sections: DocSection[] = [ content: (

- SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 44 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures. + SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 45 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.

Core Capabilities

    -
  • AI Instruction Generation (Primer) - Analyze your codebase and generate customized instruction files for all 44 agents
  • +
  • AI Instruction Generation (Primer) - Analyze your codebase and generate customized instruction files for all 45 agents
  • Skill Discovery - Browse 400K+ skills from registries with AI-powered recommendations
  • -
  • Cross-Agent Translation - Automatically convert skills between 44 agent-specific formats
  • +
  • Cross-Agent Translation - Automatically convert skills between 45 agent-specific formats
  • Team Collaboration - Share skills via .skills manifest files and publish to marketplace
@@ -101,7 +101,7 @@ skillkit install anthropics/skills`}
  • UI Tier - CLI commands, Terminal UI (OpenTUI-based), and documentation website
  • Core Logic Tier - @skillkit/core for business logic; @skillkit/agents for adapter implementations
  • -
  • Integration Tier - File systems, Git repositories, marketplace APIs, and 44 AI agents
  • +
  • Integration Tier - File systems, Git repositories, marketplace APIs, and 45 AI agents

Monorepo Structure

@@ -129,7 +129,7 @@ skillkit install anthropics/skills`} content: (

- SkillKit supports 44 AI coding agents with automatic format translation: + SkillKit supports 45 AI coding agents with automatic format translation:

AI Instruction Generation (Primer)

{`skillkit primer # Analyze codebase, generate for detected agents -skillkit primer --all-agents # Generate for all 44 agents +skillkit primer --all-agents # Generate for all 45 agents skillkit primer --agent claude-code,cursor # Specific agents only skillkit primer --analyze-only # Only show codebase analysis skillkit primer --dry-run # Preview without writing files diff --git a/docs/skillkit/components/Features.tsx b/docs/skillkit/components/Features.tsx index ce957822..8cfde615 100644 --- a/docs/skillkit/components/Features.tsx +++ b/docs/skillkit/components/Features.tsx @@ -18,7 +18,7 @@ const FEATURES: Feature[] = [ }, { title: 'Auto Translation', - description: 'The npm for agent skills. Write once, auto-translate to 44 formats.', + description: 'The npm for agent skills. Write once, auto-translate to 45 formats.', icon: ( @@ -36,7 +36,7 @@ const FEATURES: Feature[] = [ }, { title: 'Primer', - description: 'Auto-generate agent instructions for all 44 agents from your codebase.', + description: 'Auto-generate agent instructions for all 45 agents from your codebase.', icon: ( @@ -109,9 +109,9 @@ const FEATURES: Feature[] = [ ]; const COMPARISONS = [ - ['Agent Support', '1-17 agents', '44 agents'], + ['Agent Support', '1-17 agents', '45 agents'], ['Sources', 'Single registry', '34+ aggregated'], - ['Translation', 'None or limited', 'All 44 formats'], + ['Translation', 'None or limited', 'All 45 formats'], ['Memory', 'None', 'Persistent learning'], ['Security', 'None', '46-rule scanner'], ['Team Sync', 'None', '.skills manifest'], @@ -131,7 +131,7 @@ export function Features(): React.ReactElement {

-
44
+
45
Agents
diff --git a/docs/skillkit/components/Hero.tsx b/docs/skillkit/components/Hero.tsx index ec8b7b69..430fcc95 100644 --- a/docs/skillkit/components/Hero.tsx +++ b/docs/skillkit/components/Hero.tsx @@ -22,7 +22,7 @@ interface TerminalLine { const TERMINAL_LINES: TerminalLine[] = [ { type: 'cmd', text: 'skillkit install anthropics/skills' }, { type: 'out', text: '→ Fetched from github.com/anthropics/skills' }, - { type: 'out', text: '→ Translated to 44 agent formats' }, + { type: 'out', text: '→ Translated to 45 agent formats' }, { type: 'out', text: '→ Scanned: 0 issues found' }, { type: 'cmd', text: 'skillkit install skills.sh/vercel/agent-skills' }, { type: 'out', text: '→ Installed 12 skills from skills.sh' }, @@ -149,7 +149,7 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {

The open source package manager that aggregates 34+ skill sources, - scans 400K+ skills from registries, auto-translates to 44 agent formats, + scans 400K+ skills from registries, auto-translates to 45 agent formats, and adds memory, security scanning, and team workflows. Everything runs locally.

diff --git a/docs/skillkit/components/UseCases.tsx b/docs/skillkit/components/UseCases.tsx index 1265c424..a1b570dc 100644 --- a/docs/skillkit/components/UseCases.tsx +++ b/docs/skillkit/components/UseCases.tsx @@ -13,7 +13,7 @@ const USE_CASES: UseCase[] = [ { persona: 'Multi-Agent Developer', problem: 'You\'ve built skills for Claude Code. Now your team wants Cursor, and you want to try Windsurf.', - solution: 'SkillKit translates skills between all 44 agents. Write once, deploy everywhere.', + solution: 'SkillKit translates skills between all 45 agents. Write once, deploy everywhere.', command: 'skillkit translate --to cursor,windsurf', gradient: 'from-violet-500/10 to-purple-500/10', icon: ( diff --git a/docs/skillkit/components/WhySkillKit.tsx b/docs/skillkit/components/WhySkillKit.tsx index 607a47db..e6369dc4 100644 --- a/docs/skillkit/components/WhySkillKit.tsx +++ b/docs/skillkit/components/WhySkillKit.tsx @@ -18,7 +18,7 @@ const COMPETITORS: Competitor[] = [ { name: 'Askill', type: 'Installer', agents: '~40', translate: false, memory: false, security: true, team: false, tui: false, api: false }, { name: 'Skild', type: 'Installer', agents: '~7', translate: false, memory: false, security: false, team: false, tui: false, api: false }, { name: 'Paks', type: 'Installer', agents: '~6', translate: false, memory: false, security: false, team: false, tui: false, api: false }, - { name: 'SkillKit', type: 'Platform', agents: '44', translate: true, memory: true, security: true, team: true, tui: true, api: true }, + { name: 'SkillKit', type: 'Platform', agents: '45', translate: true, memory: true, security: true, team: true, tui: true, api: true }, ]; const SOURCES = [ diff --git a/docs/skillkit/index.html b/docs/skillkit/index.html index 8604df6e..4adee76c 100644 --- a/docs/skillkit/index.html +++ b/docs/skillkit/index.html @@ -4,13 +4,13 @@ SkillKit - Universal Skills for AI Coding Agents - + - + @@ -20,7 +20,7 @@ - + diff --git a/docs/skillkit/metadata.json b/docs/skillkit/metadata.json index a0884046..e4674bef 100644 --- a/docs/skillkit/metadata.json +++ b/docs/skillkit/metadata.json @@ -1,5 +1,5 @@ { "name": "SkillKit", - "description": "Supercharge Every AI Coding Agent. Translate, manage, and sync skills across Claude, Cursor, Windsurf, and 44 agents.", + "description": "Supercharge Every AI Coding Agent. Translate, manage, and sync skills across Claude, Cursor, Windsurf, and 45 agents.", "requestFramePermissions": [] } \ No newline at end of file diff --git a/docs/skillkit/public/openapi.json b/docs/skillkit/public/openapi.json index 882a7c3c..e35d47bd 100644 --- a/docs/skillkit/public/openapi.json +++ b/docs/skillkit/public/openapi.json @@ -3,7 +3,7 @@ "info": { "title": "SkillKit", "version": "1.12.0", - "description": "Skills shouldn't require pre-installation. This API lets any agent, framework, or tool discover and retrieve skills on demand.\n\n400K+ skills across 44 AI coding agents. Results ranked by a multi-signal scoring system (content 40pts, query match 30pts, popularity 15pts, references 15pts).\n\n## Quick Start\n\n```bash\nnpx skillkit serve\n```\n\nThe API is now running at http://localhost:3737\n\n## MCP Server\n\nFor agent-native discovery (Claude Desktop, Cursor):\n\n```json\n{\n \"mcpServers\": {\n \"skillkit\": { \"command\": \"npx\", \"args\": [\"@skillkit/mcp\"] }\n }\n}\n```\n\n## Python Client\n\n```bash\npip install skillkit-client\n```", + "description": "Skills shouldn't require pre-installation. This API lets any agent, framework, or tool discover and retrieve skills on demand.\n\n400K+ skills across 45 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" diff --git a/e2e/onboarding-ui.e2e.test.ts b/e2e/onboarding-ui.e2e.test.ts index 53638aee..ad1aca45 100644 --- a/e2e/onboarding-ui.e2e.test.ts +++ b/e2e/onboarding-ui.e2e.test.ts @@ -44,7 +44,7 @@ describe('E2E: Onboarding UI', () => { expect(result.success).toBe(true); }); - it('should display all 44 agents', async () => { + it('should display all 45 agents', async () => { const result = await runCli(['init', '--list']); const output = result.stdout + result.stderr; diff --git a/e2e/skill-translator.e2e.test.ts b/e2e/skill-translator.e2e.test.ts index 41f0bb28..bd82f76f 100644 --- a/e2e/skill-translator.e2e.test.ts +++ b/e2e/skill-translator.e2e.test.ts @@ -28,7 +28,7 @@ import { type CrossAgentSkill, } from '@skillkit/core'; -// All 44 supported agents +// All 45 supported agents const SUPPORTED_AGENTS = [ 'claude-code', 'cursor', diff --git a/e2e/translation.e2e.test.ts b/e2e/translation.e2e.test.ts index 5fb5793d..fef2ee59 100644 --- a/e2e/translation.e2e.test.ts +++ b/e2e/translation.e2e.test.ts @@ -2,7 +2,7 @@ * E2E Tests: Skill Translation Commands * * Tests for: translate, context, recommend - * Validates translation to all 44 supported agents + * Validates translation to all 45 supported agents */ import { describe, it, expect, beforeEach, afterEach } from 'vitest'; @@ -16,7 +16,7 @@ import { testFileExists, } from './helpers/cli-runner.js'; -// All 44 supported agents +// All 45 supported agents const SUPPORTED_AGENTS = [ 'claude-code', 'cursor', diff --git a/package.json b/package.json index af804ae2..6e5c2a2b 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "skillkit-monorepo", "version": "1.20.0", "private": true, - "description": "The package manager for AI agent skills — install, translate, share across 44 coding agents", + "description": "The package manager for AI agent skills — install, translate, share across 45 coding agents", "type": "module", "scripts": { "build": "turbo run build", diff --git a/packages/api/src/routes/docs.ts b/packages/api/src/routes/docs.ts index 41b2abc2..0bf2558d 100644 --- a/packages/api/src/routes/docs.ts +++ b/packages/api/src/routes/docs.ts @@ -5,7 +5,7 @@ const OPENAPI_SPEC = { info: { title: 'SkillKit', version: '1.12.0', - description: 'Skill Discovery API for AI coding agents. Search, browse, and retrieve skills from the SkillKit marketplace (400K+ skills across 44 agents).', + description: 'Skill Discovery API for AI coding agents. Search, browse, and retrieve skills from the SkillKit marketplace (400K+ skills across 45 agents).', license: { name: 'Apache-2.0', url: 'https://opensource.org/licenses/Apache-2.0' }, contact: { name: 'SkillKit', url: 'https://github.com/rohitg00/skillkit' }, }, diff --git a/packages/cli/src/__tests__/onboarding.test.ts b/packages/cli/src/__tests__/onboarding.test.ts index 9378430f..636f362c 100644 --- a/packages/cli/src/__tests__/onboarding.test.ts +++ b/packages/cli/src/__tests__/onboarding.test.ts @@ -96,10 +96,10 @@ describe('Onboarding Module', () => { it('should generate full logo with version', async () => { const { getFullLogo } = await import('../onboarding/logo.js'); - const logo = getFullLogo('1.7.2', 44); + const logo = getFullLogo('1.7.2', 45); expect(logo).toContain('\u2588'); expect(logo).toContain('v1.7.2'); - expect(logo).toContain('44 agents'); + expect(logo).toContain('45 agents'); }); it('should generate compact logo', async () => { diff --git a/packages/cli/src/commands/find.ts b/packages/cli/src/commands/find.ts index 52c1ba46..03efd937 100644 --- a/packages/cli/src/commands/find.ts +++ b/packages/cli/src/commands/find.ts @@ -13,7 +13,7 @@ import { GitHubSkillRegistry, SkillsShRegistry, } from "@skillkit/core"; -import { formatCount } from "../helpers.js"; +import { formatCount, loadTaps } from "../helpers.js"; interface SkillResult { name: string; @@ -60,8 +60,9 @@ export class FindCommand extends Command { description: "Minimal output (just list skills)", }); - federated = Option.Boolean("--federated,-f", false, { - description: "Search external registries (GitHub SKILL.md files)", + federated = Option.Boolean("--federated,-f", true, { + description: "Search external registries (enabled by default)", + hidden: true, }); async execute(): Promise { @@ -86,6 +87,20 @@ export class FindCommand extends Command { }), ); + const taps = loadTaps(); + for (const tap of taps.taps) { + const tapLabel = tap.name || tap.source; + const exists = allSkills.some((s) => s.source === tap.source); + if (!exists) { + allSkills.push({ + name: tapLabel, + description: `Custom tap: ${tap.source}`, + source: tap.source, + repoName: tap.source.split("/").pop() || "", + }); + } + } + let results: SkillResult[]; let searchTerm: string | undefined; @@ -246,7 +261,7 @@ export class FindCommand extends Command { ); console.log( colors.muted( - " skillkit find -f # Also search GitHub SKILL.md files", + " skillkit find # Search marketplace + GitHub", ), ); console.log(colors.muted(" skillkit ui # Browse in TUI")); diff --git a/packages/cli/src/commands/index.ts b/packages/cli/src/commands/index.ts index 1382a92a..8baa283b 100644 --- a/packages/cli/src/commands/index.ts +++ b/packages/cli/src/commands/index.ts @@ -132,6 +132,7 @@ export { TimelineCommand } from './timeline.js'; export { SessionHandoffCommand } from './handoff.js'; export { LineageCommand } from './lineage.js'; export { SaveCommand } from './save.js'; +export { TapAddCommand, TapRemoveCommand, TapListCommand } from './tap.js'; export { AgentsMdCommand, AgentsMdInitCommand, diff --git a/packages/cli/src/commands/install.ts b/packages/cli/src/commands/install.ts index 595c6fdc..e317e2d6 100644 --- a/packages/cli/src/commands/install.ts +++ b/packages/cli/src/commands/install.ts @@ -26,6 +26,10 @@ import { AgentsMdParser, AgentsMdGenerator, SkillsShRegistry, + TrustScorer, + readSkillContent, + computeSkillChecksum, + addSkillToLock, } from "@skillkit/core"; import type { SkillsShStats } from "@skillkit/core"; import type { SkillMetadata, GitProvider, AgentType } from "@skillkit/core"; @@ -56,6 +60,7 @@ import { getLastAgents, formatQualityBadge, getQualityGradeFromScore, + formatTrustBadge, type InstallResult, } from "../onboarding/index.js"; @@ -132,14 +137,17 @@ export class InstallCommand extends Command { const isInteractive = process.stdin.isTTY && !this.skills && !this.all && !this.yes; const s = spinner(); + let cloneResult: Awaited>["cloneResult"] = null; try { if (process.stdin.isTTY && !this.quiet) { welcome(); } - const { providerAdapter, cloneResult } = await this.resolveSource(s); - if (!providerAdapter || !cloneResult) return 1; + const resolved = await this.resolveSource(s); + if (!resolved.providerAdapter || !resolved.cloneResult) return 1; + const providerAdapter = resolved.providerAdapter; + cloneResult = resolved.cloneResult; const discoveredSkills = cloneResult.discoveredSkills || []; @@ -169,7 +177,6 @@ export class InstallCommand extends Command { skillsToInstall, targetAgents, installMethod, providerAdapter, cloneResult, s, ); - this.cleanupTemp(cloneResult); this.updateAgentsMd(installResults.length); await this.showResults(installResults, targetAgents, providerAdapter, isInteractive); @@ -178,6 +185,8 @@ export class InstallCommand extends Command { s.stop(colors.error("Installation failed")); console.log(colors.muted(err instanceof Error ? err.message : String(err))); return 1; + } finally { + if (cloneResult) this.cleanupTemp(cloneResult); } } @@ -431,6 +440,36 @@ export class InstallCommand extends Command { console.log(""); } + const officialSources = [ + "anthropics/skills", + "vercel-labs/agent-skills", + "expo/skills", + "remotion-dev/skills", + "supabase/agent-skills", + "stripe/ai", + ]; + const sourceProvider = detectProvider(this.source); + const parsedSource = sourceProvider?.parseSource(this.source); + const normalizedSource = parsedSource ? `${parsedSource.owner}/${parsedSource.repo}` : this.source; + const isOfficial = sourceProvider?.type === "github" && officialSources.includes(normalizedSource); + + const scorer = new TrustScorer(); + for (const skill of skillsToInstall) { + const content = readSkillContent(skill.path); + if (content) { + const result = scorer.score(content); + const badge = formatTrustBadge({ + isOfficial, + officialSource: isOfficial ? this.source : undefined, + grade: result.grade, + score: result.score, + source: this.source, + }); + console.log(` ${colors.primary(skill.name)}: ${badge}`); + } + } + console.log(""); + const agentDisplay = targetAgents.length <= 3 ? targetAgents.map(formatAgent).join(", ") @@ -546,6 +585,7 @@ export class InstallCommand extends Command { installedAt: new Date().toISOString(), enabled: true, }; + metadata.checksum = computeSkillChecksum(targetPath); saveSkillMetadata(targetPath, metadata); installedAgents.push(agentType); @@ -557,11 +597,24 @@ export class InstallCommand extends Command { } if (installedAgents.length > 0) { + const firstAgentInstallDir = getInstallDir(this.global, installedAgents[0] as AgentType); + const isStandalone = existsSync(join(firstAgentInstallDir, skillName.endsWith(".md") ? skillName : `${skillName}.md`)); + const actualPath = isStandalone + ? join(firstAgentInstallDir, skillName.endsWith(".md") ? skillName : `${skillName}.md`) + : join(firstAgentInstallDir, skillName); + addSkillToLock(skillName, { + source: this.source, + sourceType: providerAdapter!.type, + installedAt: new Date().toISOString(), + checksum: computeSkillChecksum(actualPath), + agents: installedAgents, + path: actualPath, + }); installResults.push({ skillName, method: installMethod, agents: installedAgents, - path: join(getInstallDir(this.global, installedAgents[0] as AgentType), skillName), + path: actualPath, }); } } diff --git a/packages/cli/src/commands/primer.ts b/packages/cli/src/commands/primer.ts index e1d6516a..caa3affe 100644 --- a/packages/cli/src/commands/primer.ts +++ b/packages/cli/src/commands/primer.ts @@ -22,13 +22,13 @@ export class PrimerCommand extends Command { for AI coding agents. By default, it generates instructions for detected agents in your project. - Use --all-agents to generate for all 44 supported agents. + Use --all-agents to generate for all 45 supported agents. Inspired by github.com/pierceboggan/primer but extended for all SkillKit agents. `, examples: [ ['Generate for detected agents', '$0 primer'], - ['Generate for all 44 agents', '$0 primer --all-agents'], + ['Generate for all 45 agents', '$0 primer --all-agents'], ['Generate for specific agents', '$0 primer --agent claude-code,cursor,github-copilot'], ['Custom output directory', '$0 primer --output ./instructions'], ['Preview without writing files', '$0 primer --dry-run'], @@ -42,7 +42,7 @@ export class PrimerCommand extends Command { }); allAgents = Option.Boolean('--all-agents,-A', false, { - description: 'Generate for all 44 supported agents', + description: 'Generate for all 45 supported agents', }); output = Option.String('--output,-o', { diff --git a/packages/cli/src/commands/remove.ts b/packages/cli/src/commands/remove.ts index 8e061dd1..e67062d8 100644 --- a/packages/cli/src/commands/remove.ts +++ b/packages/cli/src/commands/remove.ts @@ -2,7 +2,7 @@ import { existsSync, rmSync, readFileSync, writeFileSync } from 'node:fs'; import { join, dirname, basename } from 'node:path'; import { colors, warn, success, error } from '../onboarding/index.js'; import { Command, Option } from 'clipanion'; -import { findSkill, findAllSkills, loadMetadata, AgentsMdParser, AgentsMdGenerator } from '@skillkit/core'; +import { findSkill, findAllSkills, loadMetadata, AgentsMdParser, AgentsMdGenerator, removeSkillFromLock } from '@skillkit/core'; import { getSearchDirs } from '../helpers.js'; export class RemoveCommand extends Command { @@ -88,6 +88,7 @@ export class RemoveCommand extends Command { const metaSibling = join(dirname(skillPath), `.${basename(skillPath, '.md')}.skillkit.json`); if (existsSync(metaSibling)) rmSync(metaSibling); } + removeSkillFromLock(skillName); success(`Removed: ${skillName}`); removed++; } catch (err) { diff --git a/packages/cli/src/commands/tap.ts b/packages/cli/src/commands/tap.ts new file mode 100644 index 00000000..0b2ee32a --- /dev/null +++ b/packages/cli/src/commands/tap.ts @@ -0,0 +1,106 @@ +import { Command, Option } from 'clipanion'; +import { colors, symbols, step, success, warn } from '../onboarding/index.js'; +import { loadTaps, saveTaps } from '../helpers.js'; + +export class TapAddCommand extends Command { + static override paths = [['tap', 'add']]; + + static override usage = Command.Usage({ + description: 'Add a custom skill source (tap)', + examples: [ + ['Add a GitHub source', '$0 tap add myorg/skills'], + ['Add with a display name', '$0 tap add myorg/skills --name "My Org Skills"'], + ], + }); + + source = Option.String({ required: true }); + + name = Option.String('--name,-n', { + description: 'Display name for the tap', + }); + + async execute(): Promise { + const taps = loadTaps(); + + const exists = taps.taps.some((t) => t.source === this.source); + if (exists) { + warn(`Tap already exists: ${this.source}`); + return 0; + } + + taps.taps.push({ + source: this.source, + name: this.name, + addedAt: new Date().toISOString(), + }); + saveTaps(taps); + + success(`Added tap: ${this.source}${this.name ? ` (${this.name})` : ''}`); + console.log(colors.muted('Skills from this source will appear in search results')); + return 0; + } +} + +export class TapRemoveCommand extends Command { + static override paths = [['tap', 'remove'], ['tap', 'rm']]; + + static override usage = Command.Usage({ + description: 'Remove a custom skill source (tap)', + examples: [ + ['Remove a tap', '$0 tap remove myorg/skills'], + ], + }); + + source = Option.String({ required: true }); + + async execute(): Promise { + const taps = loadTaps(); + + const idx = taps.taps.findIndex((t) => t.source === this.source); + if (idx === -1) { + warn(`Tap not found: ${this.source}`); + return 0; + } + + taps.taps.splice(idx, 1); + saveTaps(taps); + + success(`Removed tap: ${this.source}`); + return 0; + } +} + +export class TapListCommand extends Command { + static override paths = [['tap', 'list'], ['tap', 'ls'], ['tap']]; + + static override usage = Command.Usage({ + description: 'List all custom skill sources (taps)', + examples: [ + ['List taps', '$0 tap list'], + ], + }); + + async execute(): Promise { + const taps = loadTaps(); + + if (taps.taps.length === 0) { + step('No custom taps configured'); + console.log(colors.muted('Add one with: skillkit tap add owner/repo')); + return 0; + } + + step(`${taps.taps.length} tap(s) configured`); + console.log(''); + + for (const tap of taps.taps) { + const label = tap.name ? `${tap.name} (${tap.source})` : tap.source; + console.log(` ${colors.success(symbols.bullet)} ${colors.primary(label)}`); + if (tap.addedAt) { + console.log(` ${colors.muted(`Added: ${tap.addedAt}`)}`); + } + } + + console.log(''); + return 0; + } +} diff --git a/packages/cli/src/commands/update.ts b/packages/cli/src/commands/update.ts index da096114..a8eaf27c 100644 --- a/packages/cli/src/commands/update.ts +++ b/packages/cli/src/commands/update.ts @@ -1,8 +1,8 @@ import { existsSync, rmSync, cpSync } from 'node:fs'; import { join } from 'node:path'; import { Command, Option } from 'clipanion'; -import { findAllSkills, findSkill, detectProvider, isLocalPath } from '@skillkit/core'; -import { getSearchDirs, loadSkillMetadata, saveSkillMetadata } from '../helpers.js'; +import { findAllSkills, findSkill, detectProvider, isLocalPath, computeSkillChecksum, addSkillToLock } from '@skillkit/core'; +import { getSearchDirs, loadSkillMetadata, saveSkillMetadata, fetchGitHubActivity } from '../helpers.js'; import { colors, spinner, warn, step } from '../onboarding/index.js'; export class UpdateCommand extends Command { @@ -86,8 +86,18 @@ export class UpdateCommand extends Command { rmSync(skill.path, { recursive: true, force: true }); cpSync(localPath, skill.path, { recursive: true, dereference: true }); + metadata.checksum = computeSkillChecksum(skill.path); metadata.updatedAt = new Date().toISOString(); saveSkillMetadata(skill.path, metadata); + addSkillToLock(skill.name, { + source: metadata.source, + sourceType: metadata.sourceType, + installedAt: metadata.installedAt, + updatedAt: metadata.updatedAt, + checksum: metadata.checksum, + agents: [], + path: skill.path, + }); s.stop(`Updated ${skill.name}`); updated++; @@ -100,6 +110,17 @@ export class UpdateCommand extends Command { continue; } + const parsed = provider.parseSource?.(metadata.source); + if (!this.force && parsed && 'owner' in parsed && 'repo' in parsed && (provider.type === 'github' || provider.type === 'skills-sh')) { + const activity = await fetchGitHubActivity(parsed.owner, parsed.repo); + const localDate = metadata.updatedAt ?? metadata.installedAt; + if (activity?.pushedAt && localDate && activity.pushedAt <= localDate) { + s.stop(`${skill.name}: no changes detected`); + skipped++; + continue; + } + } + const result = await provider.clone(metadata.source, '', { depth: 1 }); if (!result.success || !result.path) { @@ -120,13 +141,31 @@ export class UpdateCommand extends Command { continue; } + const newChecksum = computeSkillChecksum(sourcePath); + if (!this.force && newChecksum && metadata.checksum && newChecksum === metadata.checksum) { + s.stop(`${skill.name}: already up to date`); + rmSync(result.path, { recursive: true, force: true }); + skipped++; + continue; + } + rmSync(skill.path, { recursive: true, force: true }); cpSync(sourcePath, skill.path, { recursive: true, dereference: true }); rmSync(result.path, { recursive: true, force: true }); + metadata.checksum = computeSkillChecksum(skill.path); metadata.updatedAt = new Date().toISOString(); saveSkillMetadata(skill.path, metadata); + addSkillToLock(skill.name, { + source: metadata.source, + sourceType: metadata.sourceType, + installedAt: metadata.installedAt, + updatedAt: metadata.updatedAt, + checksum: metadata.checksum, + agents: [], + path: skill.path, + }); s.stop(`Updated ${skill.name}`); updated++; diff --git a/packages/cli/src/helpers.ts b/packages/cli/src/helpers.ts index 00c5155e..f661d9aa 100644 --- a/packages/cli/src/helpers.ts +++ b/packages/cli/src/helpers.ts @@ -1,3 +1,6 @@ +import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs'; +import { join, dirname } from 'node:path'; +import { homedir } from 'node:os'; import { loadConfig, getSearchDirs as coreGetSearchDirs, @@ -61,6 +64,38 @@ export function timeAgo(dateStr: string): string { return `${Math.floor(days / 365)}y ago`; } +export interface TapEntry { + source: string; + name?: string; + addedAt: string; +} + +export interface TapsFile { + version: 1; + taps: TapEntry[]; +} + +const TAPS_FILE = join(homedir(), '.skillkit', 'taps.json'); + +export function loadTaps(): TapsFile { + if (!existsSync(TAPS_FILE)) return { version: 1, taps: [] }; + try { + const data = JSON.parse(readFileSync(TAPS_FILE, 'utf-8')); + if (data && data.version === 1 && Array.isArray(data.taps)) { + return data as TapsFile; + } + return { version: 1, taps: [] }; + } catch { + return { version: 1, taps: [] }; + } +} + +export function saveTaps(taps: TapsFile): void { + const dir = dirname(TAPS_FILE); + if (!existsSync(dir)) mkdirSync(dir, { recursive: true }); + writeFileSync(TAPS_FILE, JSON.stringify(taps, null, 2), 'utf-8'); +} + export async function fetchGitHubActivity( owner: string, repo: string, diff --git a/packages/cli/src/onboarding/index.ts b/packages/cli/src/onboarding/index.ts index 79158e4c..5d3730d9 100644 --- a/packages/cli/src/onboarding/index.ts +++ b/packages/cli/src/onboarding/index.ts @@ -12,6 +12,7 @@ export { formatQualityBadge, formatQualityBadgeCompact, getQualityGradeFromScore, + formatTrustBadge, } from './theme.js'; export { diff --git a/packages/cli/src/onboarding/theme.ts b/packages/cli/src/onboarding/theme.ts index e81378bf..2a60ff23 100644 --- a/packages/cli/src/onboarding/theme.ts +++ b/packages/cli/src/onboarding/theme.ts @@ -178,3 +178,25 @@ export function formatQualityBadgeCompact(score: number): string { if (score >= 60) return colors.warning(grade); return colors.error(grade); } + +export function formatTrustBadge(options: { + isOfficial: boolean; + officialSource?: string; + grade?: 'trusted' | 'review' | 'caution'; + score?: number; + source?: string; +}): string { + if (options.isOfficial) { + const label = options.officialSource || options.source || ''; + return `${colors.success('[Official]')} ${label}`; + } + const label = options.source || ''; + const scoreText = typeof options.score === 'number' ? ` (score: ${options.score}/10)` : ''; + if (options.grade === 'trusted') { + return `${colors.success('[Trusted]')} ${label}${scoreText}`; + } + if (options.grade === 'caution') { + return `${colors.error('[Caution]')} ${label}${scoreText}`; + } + return `${colors.warning('[Review]')} ${label}${scoreText}`; +} diff --git a/packages/core/README.md b/packages/core/README.md index 5bcd7e3c..aec475d5 100644 --- a/packages/core/README.md +++ b/packages/core/README.md @@ -14,7 +14,7 @@ npm install @skillkit/core ## Key Features - **Skill Discovery**: Find and parse SKILL.md files from any source -- **Cross-Agent Translation**: Convert skills between 44 agent formats (Claude Code, Cursor, Windsurf, etc.) +- **Cross-Agent Translation**: Convert skills between 45 agent formats (Claude Code, Cursor, Windsurf, etc.) - **Project Context Detection**: Analyze project stack, dependencies, and configurations - **Smart Recommendations**: AI-powered skill suggestions based on project profile - **Session Memory**: Capture and persist learnings across AI coding sessions diff --git a/packages/core/src/config.ts b/packages/core/src/config.ts index ceb12852..3ba97802 100644 --- a/packages/core/src/config.ts +++ b/packages/core/src/config.ts @@ -1,8 +1,9 @@ -import { existsSync, readFileSync, writeFileSync, mkdirSync, statSync } from 'node:fs'; +import { existsSync, readFileSync, writeFileSync, mkdirSync, statSync, renameSync } from 'node:fs'; import { join, dirname, basename } from 'node:path'; import { homedir } from 'node:os'; +import { createHash } from 'node:crypto'; import { parse as parseYaml, stringify as stringifyYaml } from 'yaml'; -import { SkillkitConfig, type AgentType, type SkillMetadata, type AgentAdapterInfo } from './types.js'; +import { SkillkitConfig, LockFile, type AgentType, type SkillMetadata, type AgentAdapterInfo, type LockEntry } from './types.js'; const CONFIG_FILE = 'skillkit.yaml'; const METADATA_FILE = '.skillkit.json'; @@ -150,6 +151,58 @@ export function setSkillEnabled(skillPath: string, enabled: boolean): boolean { return true; } +export function computeSkillChecksum(skillPath: string): string { + const mdPath = skillPath.endsWith('.md') ? skillPath : join(skillPath, 'SKILL.md'); + if (!existsSync(mdPath)) return ''; + return createHash('sha256').update(readFileSync(mdPath)).digest('hex').slice(0, 16); +} + +const LOCK_FILE = join(homedir(), '.skillkit', 'lock.json'); + +export function loadLockFile(): LockFile { + if (!existsSync(LOCK_FILE)) return { version: 1, skills: {} }; + try { + return LockFile.parse(JSON.parse(readFileSync(LOCK_FILE, 'utf-8'))); + } catch { + return { version: 1, skills: {} }; + } +} + +export function saveLockFile(lock: LockFile): void { + const dir = dirname(LOCK_FILE); + if (!existsSync(dir)) mkdirSync(dir, { recursive: true }); + const tmpFile = `${LOCK_FILE}.${process.pid}.tmp`; + writeFileSync(tmpFile, JSON.stringify(lock, null, 2), 'utf-8'); + renameSync(tmpFile, LOCK_FILE); +} + +export function addSkillToLock(name: string, entry: LockEntry): void { + const lock = loadLockFile(); + const key = `${entry.source}:${name}`; + const existing = lock.skills[key]; + if (existing) { + const mergedAgents = [...new Set([...existing.agents, ...entry.agents])]; + lock.skills[key] = { ...entry, agents: mergedAgents }; + } else { + lock.skills[key] = entry; + } + saveLockFile(lock); +} + +export function removeSkillFromLock(name: string, source?: string): void { + const lock = loadLockFile(); + if (source) { + delete lock.skills[`${source}:${name}`]; + } else { + for (const key of Object.keys(lock.skills)) { + if (key === name || key.endsWith(`:${name}`)) { + delete lock.skills[key]; + } + } + } + saveLockFile(lock); +} + export async function initProject( type: AgentType, adapter: AgentAdapterInfo diff --git a/packages/core/src/orchestrator/index.ts b/packages/core/src/orchestrator/index.ts index bad54cd2..74fdcfc0 100644 --- a/packages/core/src/orchestrator/index.ts +++ b/packages/core/src/orchestrator/index.ts @@ -10,7 +10,7 @@ * - Plan approval workflow * - Review stages (spec-compliance, code-quality) * - Inter-agent messaging (direct + broadcast) - * - Universal agent support (44 agents) + * - Universal agent support (45 agents) */ // Team Orchestrator diff --git a/packages/core/src/translator/__tests__/registry.test.ts b/packages/core/src/translator/__tests__/registry.test.ts index 7da6f4d7..37aa94a0 100644 --- a/packages/core/src/translator/__tests__/registry.test.ts +++ b/packages/core/src/translator/__tests__/registry.test.ts @@ -329,7 +329,7 @@ Follow these guidelines`; }); describe('supported agents', () => { - it('should support all 44 agents', () => { + it('should support all 45 agents', () => { const allAgents = [ 'claude-code', 'cursor', diff --git a/packages/core/src/types.ts b/packages/core/src/types.ts index d5c04586..e288c99c 100644 --- a/packages/core/src/types.ts +++ b/packages/core/src/types.ts @@ -94,6 +94,23 @@ export const SkillMetadata = z.object({ }); export type SkillMetadata = z.infer; +export const LockEntry = z.object({ + source: z.string(), + sourceType: GitProvider, + installedAt: z.string().datetime(), + updatedAt: z.string().datetime().optional(), + checksum: z.string().optional(), + agents: z.array(z.string()), + path: z.string(), +}); +export type LockEntry = z.infer; + +export const LockFile = z.object({ + version: z.literal(1), + skills: z.record(z.string(), LockEntry), +}); +export type LockFile = z.infer; + export const SkillLocation = z.enum(["project", "global"]); export type SkillLocation = z.infer; diff --git a/packages/extension/README.md b/packages/extension/README.md index 312e5f31..e5e24d1a 100644 --- a/packages/extension/README.md +++ b/packages/extension/README.md @@ -23,7 +23,7 @@ Then in Chrome: Skills download to `Downloads/skillkit-skills/{name}/SKILL.md`. -To make available to all 44 agents: +To make available to all 45 agents: ```bash skillkit install ~/Downloads/skillkit-skills/my-skill diff --git a/packages/extension/src/manifest.json b/packages/extension/src/manifest.json index cea24b03..fb3e4217 100644 --- a/packages/extension/src/manifest.json +++ b/packages/extension/src/manifest.json @@ -2,7 +2,7 @@ "manifest_version": 3, "name": "SkillKit - Save as Skill", "version": "1.20.0", - "description": "Save any webpage as an AI agent skill — instantly available across 44 agents", + "description": "Save any webpage as an AI agent skill — instantly available across 45 agents", "permissions": ["contextMenus", "activeTab", "downloads", "scripting"], "background": { "service_worker": "background.global.js" diff --git a/packages/extension/store-assets/STORE_LISTING.md b/packages/extension/store-assets/STORE_LISTING.md index 4af8b016..27d687ab 100644 --- a/packages/extension/store-assets/STORE_LISTING.md +++ b/packages/extension/store-assets/STORE_LISTING.md @@ -4,10 +4,10 @@ SkillKit - Save as Skill ## Summary (132 chars max) -Save any webpage as an AI agent skill file. One click, works across 44 coding agents. +Save any webpage as an AI agent skill file. One click, works across 45 coding agents. ## Description -SkillKit lets you save any webpage as a reusable AI agent skill with one click. The extension extracts page content directly in your browser and generates a SKILL.md file that works instantly across 44 coding agents including Claude Code, Cursor, Codex, Gemini CLI, Windsurf, and more. +SkillKit lets you save any webpage as a reusable AI agent skill with one click. The extension extracts page content directly in your browser and generates a SKILL.md file that works instantly across 45 coding agents including Claude Code, Cursor, Codex, Gemini CLI, Windsurf, and more. How it works: - Click the extension icon to save the current page as a skill diff --git a/packages/tui/README.md b/packages/tui/README.md index 738ba5c0..932e9223 100644 --- a/packages/tui/README.md +++ b/packages/tui/README.md @@ -34,7 +34,7 @@ pnpm ui - **Animated UI** - Smooth entrance animations and transitions - **Browse Skills** - Explore skill repositories with search and filtering - **Smart Recommendations** - AI-powered skill suggestions with match scores -- **Cross-Agent Translation** - Convert skills between 44 agent formats +- **Cross-Agent Translation** - Convert skills between 45 agent formats - **Team Collaboration** - Share and sync skills across teams - **Responsive Design** - Adapts to any terminal size