Compare commits

...
Author SHA1 Message Date
Rohit Ghumare b2f52f5086 fix: address CodeRabbit PR review issues
- Add noopener to rel="noreferrer" for tabnabbing protection
- Fix standalone skill path handling in readSkillContent and validateSkill
- Derive TOTAL_AGENTS from adapters instead of hardcoded value
- Fix duplicate discovery path for droid/factory agents
- Create dedicated FactoryAdapter instead of using UniversalAdapter
2026-01-29 11:09:14 +00:00
Rohit Ghumare 4c1d9ceea7 fix: simplify vercel config to avoid turbo/pnpm workspace detection 2026-01-28 18:30:42 +00:00
Rohit Ghumare b9672931b0 fix: address CodeRabbit security and code quality suggestions
- Add rate limiting to API route (10 requests/min per IP)
- Add proper type validation for topic parameter
- Move API key check after input validation
- Add 'use client' directive to SkillGenerator
- Add YAML escape helper to prevent frontmatter injection
- Change vercel.json to use pnpm instead of npm
2026-01-28 18:26:36 +00:00
Rohit Ghumare 58d3f96d40 fix: improve mobile responsiveness for tabs and header buttons 2026-01-28 18:23:52 +00:00
Rohit Ghumare de313ee9ee fix: sync ASCII logo and code block contrast fixes to old Vite components 2026-01-28 18:21:11 +00:00
Rohit Ghumare 93140cd5ba fix: improve code block contrast in SkillGenerator 2026-01-28 18:19:39 +00:00
Rohit Ghumare 074aa51d03 fix: clean up ASCII logo for better rendering 2026-01-28 18:17:36 +00:00
Rohit Ghumare a211ff8194 fix: disable turbo detection in Vercel deployment 2026-01-28 18:15:40 +00:00
Rohit Ghumare 95867edca9 fix: add vercel.json for fumadocs deployment 2026-01-28 18:11:53 +00:00
Rohit Ghumare c3fb888e57 fix: add noopener to external links and improve nav accessibility
- Add noopener to rel attributes on external links for tabnabbing protection
- Add aria-label to nav element for screen readers
- Add type="button" and aria-current to nav buttons
2026-01-28 17:51:56 +00:00
Rohit Ghumare 12253f4b51 fix: address CodeRabbit review suggestions
- Move Gemini API key to server-side route (security)
- Add default type='button' to Button component
- Use dynamic agent count instead of hardcoded 32
- Add 'use client' directive to Documentation
- Fix stale closure in SkillSubmitForm with useCallback
- Add URL validation for external references
- Add noopener to external links for security
- Fix Clawdbot path in agents.mdx
- Update cicd.mdx with correct CLI commands
- Capitalize proper nouns (Markdown, provider names)
- Add text language to README code block
- Update date example in quickstart.mdx
2026-01-28 17:44:29 +00:00
Rohit Ghumare 58bd0bbdd4 fix: resolve /docs 404 and show docs link on mobile
- Handle undefined slug by defaulting to empty array for index page
- Remove hidden class from Docs link so it shows on mobile
2026-01-28 17:36:06 +00:00
Rohit Ghumare f0b59b3e39 fix: resolve TypeScript build errors in fumadocs
- Remove createRelativeLink from docs page (not compatible with current fumadocs)
- Remove redundant isLoading prop in SkillGenerator (status already narrowed)
- Fix lucide-react icon type casting in Card component
- Fix MDXComponents return type in mdx-components
2026-01-28 17:32:22 +00:00
Rohit Ghumare a0b4ee77b4 feat(docs): add Fumadocs documentation site and update website
- Add Fumadocs-based documentation site at /docs
  - Complete MDX documentation for all features
  - TUI section with keyboard navigation
  - Installation, quickstart, commands reference
  - API reference and configuration guides

- Update SkillKit website (agentskills.com)
  - Add 15 new agents (32 total): CodeBuddy, Continue, Crush,
    Factory, MCPJam, Mux, Neovate, OpenHands, Pi, Qoder, Qwen,
    Vercel, Zencoder, CommandCode
  - Update agent count from 17 to 32 across all components
  - Update command count from 30+ to 40+
  - Remove inline Documentation section (now in Fumadocs)
  - Link Docs to /docs route

- Add 15 new agent adapters to @skillkit/agents
  - All use UniversalAdapter as base
  - Added to detection order and adapter registry

- Configure Vercel rewrites for /docs proxy to Fumadocs
2026-01-28 17:23:30 +00:00
Rohit Ghumare d671b5795f docs: add comprehensive documentation section to website
- Create Documentation.tsx component with DeepWiki-sourced content
- Add sections: Overview, Installation, Architecture, Agents, Commands
- Add sections: Configuration, API Reference, Skill Format, Tech Stack
- Include interactive sidebar navigation
- Add Docs link to navbar
- Reference DeepWiki as documentation source

Source: https://deepwiki.com/rohitg00/skillkit
2026-01-28 15:41:26 +00:00
Rohit Ghumare b3f561dbc9 feat(quality): Quality Evaluation System Enhancements (#21)
* feat(quality): add skill quality evaluation system

- Add quality scoring module with structure, clarity, and specificity metrics
- Evaluate skills for metadata, triggers, boundaries, code examples
- Detect vague terms and penalize overly long skills
- Update validate command to include quality reports
- Add --verbose, --quality, --issues, --json flags
- Quality scores: A (90+), B (80+), C (70+), D (60+), F (<60)

* fix: address CodeRabbit and Devin review suggestions

- Fix JSON output to return exit code 1 on validation failures
- Add --min-score NaN validation with warning message
- Add directory guard for --all flag with .mdc file support
- Fix CRLF handling in frontmatter extraction
- Fix code blocks double-counting in specificity evaluation
- Fix warning message inconsistency for code examples
- Add try/catch error handling in evaluateSkillFile
- Fix isHighQuality threshold to match UI display (80)

* feat(quality): extend quality evaluation system with badges, deeper analysis, and fix command

- Phase 2: Add quality badges to CLI commands (list, recommend, install)
  - formatQualityBadge() helper for color-coded grade badges
  - --quality flag for list command
  - Low-quality skill warnings during install

- Phase 3: Add TUI quality badges
  - Extended SkillItem with quality, grade, warnings fields
  - Quality evaluation in loadSkills()
  - Grade badges in Installed and Recommend screens

- Phase 4: Deeper quality analysis
  - Deprecated pattern detection (CommonJS, class components, var)
  - Security pattern detection (hardcoded credentials, eval, innerHTML)
  - Conflicting instruction detection
  - Completeness assessment (TODOs, empty sections, example coverage)
  - New weight distribution: Structure 35%, Clarity 25%, Specificity 25%, Advanced 15%

- Phase 1: Pre-compute marketplace quality scores
  - Updated schema.json with quality field (0-100)
  - Created scripts/compute-quality.ts for batch computation

- Phase 5: Benchmark against category leaders
  - New benchmark.ts module with category detection
  - Percentile calculation and comparison notes
  - --benchmark flag for validate command

- Phase 6: Fix command for automated quality fixes
  - skillkit fix command with --dry-run and --interactive modes
  - Auto-generates frontmatter, "When to Use", "Boundaries" sections
  - --fix flag alias on validate command

* fix: address CodeRabbit and Devin review suggestions

- Fix .mdc file name extraction in fix.ts (handles both .md and .mdc)
- Add missing advanced field to test fixtures in quality.test.ts
- Fix duplicate header detection in assessCompleteness using regex.exec
- Fix ESM compatibility in compute-quality.ts using import.meta.url
- Add trailing newline to skills.json output

* fix: address remaining CodeRabbit review suggestions

- Escape regex metacharacters in vague term patterns (fix.ts)
- Improve diff algorithm using set-based comparison (fix.ts)
- Fix validateSkill receiving file path instead of directory (validate.ts)
- Check final section in completeness assessment (index.ts)
- Add error handling and empty skills guard (compute-quality.ts)

* fix: address additional review feedback

- validate.ts: Add error when --fix is passed without targets
- index.ts: Skip headers inside fenced code blocks during completeness check
- compute-quality.ts: Use nullish coalescing (??) to preserve zero quality scores
2026-01-28 14:18:42 +00:00
Rohit Ghumare 0a59bcf314 feat(quality): add skill quality evaluation system (#20)
* feat(quality): add skill quality evaluation system

- Add quality scoring module with structure, clarity, and specificity metrics
- Evaluate skills for metadata, triggers, boundaries, code examples
- Detect vague terms and penalize overly long skills
- Update validate command to include quality reports
- Add --verbose, --quality, --issues, --json flags
- Quality scores: A (90+), B (80+), C (70+), D (60+), F (<60)

* fix: address CodeRabbit and Devin review suggestions

- Fix JSON output to return exit code 1 on validation failures
- Add --min-score NaN validation with warning message
- Add directory guard for --all flag with .mdc file support
- Fix CRLF handling in frontmatter extraction
- Fix code blocks double-counting in specificity evaluation
- Fix warning message inconsistency for code examples
- Add try/catch error handling in evaluateSkillFile
- Fix isHighQuality threshold to match UI display (80)
2026-01-28 12:01:32 +00:00
Rohit Ghumare b9a724012a Merge feat/dx-improvements into main 2026-01-28 10:50:47 +00:00
Rohit Ghumare b559a2acbf feat: DX improvements - new CLI commands, simplified onboarding, and website updates (#19)
* feat(cli): add check, find, manifest commands and simplified onboarding

New commands:
- skillkit check - Check for available skill updates (dry-run)
- skillkit find - Quick CLI marketplace search with interactive mode
- skillkit manifest - Manage .skills manifest file for declarative skills

Manifest subcommands:
- manifest init - Create new .skills file
- manifest add - Add skill source to manifest
- manifest remove - Remove skill source from manifest
- manifest install - Install all skills from manifest
- manifest generate - Generate manifest from installed skills

Onboarding improvements:
- Add quickAgentSelect() for simplified agent selection
- Same as last time (Recommended) option for returning users
- All detected agents quick option
- Select specific agents for manual selection
- Streamlined install flow with fewer prompts

Other changes:
- Add bullet, arrowUp, arrowDown symbols to theme
- Update version to 1.7.6

* feat(website): showcase full CLI power with Commands section

- Add Commands.tsx with tabbed command showcase (Core, Discovery, Team, Advanced)
- Update Hero terminal demo with new commands (find, ui, check, manifest)
- Update Features section with TUI, Plugins, Manifest, CI/CD, Slash Commands
- Update stats to show 17 agents, 30+ commands, 15K skills
- Update comparison table with .skills manifest and CI/CD
- Bump version display to v1.7.5

* fix: address CodeRabbit review suggestions

- Security: Use execFileSync instead of execSync to prevent command injection in manifest install
- Fix: Remove false positive hasUpdate for remote skills in check command
- Fix: Add missing repoName filter in interactive find search
- Fix: Remove incorrect sourceType→agents mapping in manifest generate
- Perf: Eliminate duplicate findSkill calls in check command

* docs: add demo video and update README

- Add skillkit-demo.mp4 video to README
- Update website badge to agenstskills.com
- Remove old GIF reference
2026-01-28 10:47:02 +00:00
101 changed files with 16936 additions and 158 deletions
+3 -3
View File
@@ -16,7 +16,7 @@
## Supercharge Every AI Coding Agent
**Give your AI agents new abilities with portable, reusable skills.** Install from a curated marketplace, create your own, and use them across Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and 12 more agents.
**Give your AI agents new abilities with portable, reusable skills.** Install from a curated marketplace, create your own, and use them across Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and 27 more agents.
> **What are AI Agent Skills?** Skills are instruction files that teach AI coding agents how to handle specific tasks - like processing PDFs, following React best practices, or enforcing security patterns. Think of them as plugins for your AI assistant.
@@ -28,7 +28,7 @@ npm install -g skillkit
**The problem:** You've built amazing skills for Claude Code. Now you want to try Cursor. Or your team uses different agents. Each agent has different formats and directories. Without SkillKit, you either rewrite everything, lock yourself into one agent, or give up on skills entirely.
**The solution:** SkillKit translates skills between all 17 agents automatically. Write once, use everywhere.
**The solution:** SkillKit translates skills between all 32 agents automatically. Write once, use everywhere.
## See It In Action
@@ -69,7 +69,7 @@ SkillKit features a polished, interactive CLI with visual feedback:
| **Multi-Agent Support** | Manual rewrite for each agent | One command, all agents |
| **Team Collaboration** | Email skills back and forth | Git-based bundles, remote sync |
| **Skill Discovery** | Search GitHub manually | Smart recommendations for your stack |
| **Format Translation** | Learn each agent's format | Automatic conversion (17 formats) |
| **Format Translation** | Learn each agent's format | Automatic conversion (32 formats) |
| **Context Sync** | Configure each agent separately | One config, synced everywhere |
| **Session Memory** | Knowledge dies with each session | Persistent learning across agents |
| **Skill Testing** | Hope it works | Test framework with assertions |
+2
View File
@@ -14,6 +14,7 @@ import {
RemoveCommand,
InitCommand,
ValidateCommand,
FixCommand,
CreateCommand,
UICommand,
TranslateCommand,
@@ -83,6 +84,7 @@ cli.register(UpdateCommand);
cli.register(RemoveCommand);
cli.register(InitCommand);
cli.register(ValidateCommand);
cli.register(FixCommand);
cli.register(CreateCommand);
cli.register(UICommand);
cli.register(TranslateCommand);
+6
View File
@@ -0,0 +1,6 @@
node_modules/
.next/
.source/
out/
.turbo/
*.tsbuildinfo
+2
View File
@@ -0,0 +1,2 @@
../../turbo.json
../../pnpm-workspace.yaml
+43
View File
@@ -0,0 +1,43 @@
# SkillKit Documentation
Fumadocs-based documentation for SkillKit.
## Development
```bash
cd docs/fumadocs
pnpm install
pnpm dev
```
Open [http://localhost:3000](http://localhost:3000).
## Build
```bash
pnpm build
```
## Structure
```text
docs/fumadocs/
├── content/docs/ # MDX documentation files
├── src/
│ ├── app/ # Next.js app router
│ ├── lib/ # Components and utilities
│ └── mdx-components.tsx
├── package.json
└── source.config.ts
```
## Adding Pages
1. Create `.mdx` file in `content/docs/`
2. Add frontmatter with `title` and `description`
3. Add page to `content/docs/meta.json`
## Custom Components
- `<Card>` - Link cards with icons
- `<Columns>` - Grid layout (2-4 columns)
+71
View File
@@ -0,0 +1,71 @@
---
title: Supported Agents
description: 32 AI coding agents supported by SkillKit
---
# Supported Agents
SkillKit uses an adapter pattern to support 32 AI coding platforms. Each adapter implements `getConfigPath()` and `generateConfig()` methods.
## Agent Directory Mapping
| Agent | Directory | Format |
|-------|-----------|--------|
| Claude Code | `.claude/skills/` | SKILL.md |
| Cursor | `.cursor/skills/` | .mdc |
| Codex | `.codex/skills/` | SKILL.md |
| Gemini CLI | `.gemini/skills/` | SKILL.md |
| OpenCode | `.opencode/skills/` | SKILL.md |
| GitHub Copilot | `.github/skills/` | Markdown |
| Windsurf | `.windsurf/skills/` | Markdown |
| Antigravity | `.antigravity/skills/` | SKILL.md |
| Amp | `.amp/skills/` | SKILL.md |
| Clawdbot | `.clawdbot/skills/` (alt: `skills/`) | SKILL.md |
| Droid (Factory) | `.factory/skills/` | SKILL.md |
| Goose | `.goose/skills/` | SKILL.md |
| Kilo Code | `.kilocode/skills/` | SKILL.md |
| Kiro CLI | `.kiro/skills/` | SKILL.md |
| Roo Code | `.roo/skills/` | SKILL.md |
| Trae | `.trae/skills/` | SKILL.md |
| Cline | `.cline/skills/` | SKILL.md |
| CodeBuddy | `.codebuddy/skills/` | SKILL.md |
| CommandCode | `.commandcode/skills/` | SKILL.md |
| Continue | `.continue/skills/` | SKILL.md |
| Crush | `.crush/skills/` | SKILL.md |
| Factory | `.factory/skills/` | SKILL.md |
| MCPJam | `.mcpjam/skills/` | SKILL.md |
| Mux | `.mux/skills/` | SKILL.md |
| Neovate | `.neovate/skills/` | SKILL.md |
| OpenHands | `.openhands/skills/` | SKILL.md |
| Pi | `.pi/skills/` | SKILL.md |
| Qoder | `.qoder/skills/` | SKILL.md |
| Qwen | `.qwen/skills/` | SKILL.md |
| Vercel | `.vercel/skills/` | SKILL.md |
| Zencoder | `.zencoder/skills/` | SKILL.md |
| Universal | `skills/` | SKILL.md |
## Translation System
```
Universal Format (SKILL.md)
↓
Adapter Interface
↓
Agent-Specific Formats (.mdc, JSON, Markdown)
```
## Agent Commands
```bash
skillkit agent list # List installed agents
skillkit agent show <name> # Show agent details
skillkit agent translate --to cursor # Translate to format
skillkit agent sync # Sync to target agent
```
## Multi-Agent Installation
```bash
# Install for multiple agents
skillkit install anthropics/skills --agent claude-code,cursor,windsurf
```
@@ -0,0 +1,117 @@
---
title: API Reference
description: Core package API for programmatic skill management
---
# API Reference
The `@skillkit/core` package provides the foundational business logic with zero internal dependencies.
## Installation
```bash
npm install @skillkit/core
```
## Module Exports
| Entry Point | Purpose |
|-------------|---------|
| `@skillkit/core` | Main exports |
| `@skillkit/core/types` | Type definitions |
| `@skillkit/core/discovery` | Skill discovery |
| `@skillkit/core/parser` | SKILL.md parsing |
| `@skillkit/core/translator` | Format translation |
| `@skillkit/core/context` | Project context |
| `@skillkit/core/recommend` | Recommendation engine |
## Skill Discovery
```typescript
import { findAllSkills, findSkill } from '@skillkit/core/discovery'
// Find all skills in directory
const skills = await findAllSkills('./my-project')
// Find specific skill
const skill = await findSkill('react-patterns')
```
## Quality Evaluation
```typescript
import { evaluateSkillContent, getQualityGrade } from '@skillkit/core'
const score = evaluateSkillContent(skillContent)
// { total: 85, structure: 22, clarity: 25, specificity: 28, advanced: 10 }
const grade = getQualityGrade(score.total)
// 'B'
```
**Dimensions (weights out of 100):**
- Structure (25): Frontmatter, sections
- Clarity (30): Descriptions, examples
- Specificity (30): Actionable steps
- Advanced (15): Tests, versioning
## Translation
```typescript
import { translateSkill } from '@skillkit/core/translator'
const result = await translateSkill(skillContent, 'cursor')
// { content: '...', filename: 'skill.mdc' }
```
## Memory System
```typescript
import { MemoryCompressor, LearningStore } from '@skillkit/core'
// Compress observations
const compressor = new MemoryCompressor()
const learning = await compressor.compress(observations)
// Store and search
const store = new LearningStore()
await store.add(learning)
const results = await store.search('authentication')
```
## Recommendation Engine
```typescript
import { RecommendationEngine, analyzeProject } from '@skillkit/core/recommend'
const engine = new RecommendationEngine()
const profile = await analyzeProject('./my-project')
const recommendations = engine.recommend(profile)
```
## Types
```typescript
interface Skill {
name: string
description: string
path: string
content: string
metadata: SkillMetadata
enabled: boolean
}
interface QualityScore {
total: number // 0-100
structure: number // 0-25
clarity: number // 0-30
specificity: number // 0-30
advanced: number // 0-15
}
interface Recommendation {
skill: Skill
score: number
reasons: string[]
}
```
+65
View File
@@ -0,0 +1,65 @@
---
title: CI/CD
description: Integrate SkillKit into CI/CD pipelines
---
# CI/CD Integration
Generate templates for automated skill management.
## Generate Templates
```bash
skillkit cicd init --provider github
skillkit cicd init --provider gitlab
skillkit cicd init --provider circleci
```
## GitHub Actions
```yaml
name: SkillKit
on: [push, pull_request]
jobs:
validate:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: '20'
- run: npm install -g skillkit
- run: skillkit validate
- run: skillkit test --json > results.json
```
## GitLab CI
```yaml
validate-skills:
image: node:20
script:
- npm install -g skillkit
- skillkit validate
- skillkit test
```
## Pre-commit
```yaml
repos:
- repo: local
hooks:
- id: skillkit-validate
name: Validate Skills
entry: skillkit validate
language: system
```
## Best Practices
- Validate on PR
- Test in CI with `--json`
- Sync only on main branch
- Cache npm packages
+285
View File
@@ -0,0 +1,285 @@
---
title: CLI Commands
description: Complete reference for all SkillKit CLI commands
---
# CLI Commands
SkillKit provides 40+ commands organized into functional categories. Built on Clipanion v4 with interactive prompts via @clack/prompts.
## Global Options
| Option | Short | Purpose |
|--------|-------|---------|
| `--help` | `-h` | Display command help |
| `--version` | `-v` | Show version info |
| `--quiet` | `-q` | Minimal output, no logo |
## Install Command
Install skills from GitHub, GitLab, Bitbucket, or local paths.
```bash
skillkit install <source> [options]
```
### Source Formats
| Format | Example |
|--------|---------|
| GitHub | `owner/repo` or full URL |
| GitLab | `gitlab:owner/repo` |
| Bitbucket | `bitbucket:owner/repo` |
| Local Path | `./path` or `~/path` |
### Install Options
| Option | Short | Type | Purpose |
|--------|-------|------|---------|
| `--skills` | `-s` | string | Comma-separated skill names |
| `--all` | `-a` | boolean | Install all discovered skills |
| `--yes` | `-y` | boolean | Skip confirmation prompts |
| `--global` | `-g` | boolean | Install to global directory |
| `--force` | `-f` | boolean | Overwrite existing skills |
| `--provider` | `-p` | string | Force provider: GitHub, GitLab, Bitbucket |
| `--list` | `-l` | boolean | List available skills without installing |
| `--agent` | — | array | Target specific agents (repeatable) |
### Examples
```bash
# Interactive installation
skillkit install anthropics/skills
# CI/CD installation (no prompts)
skillkit install anthropics/skills --skills=pdf,xlsx --agent claude --yes
# List available skills
skillkit install anthropics/skills --list
# Force overwrite
skillkit install anthropics/skills --skills=pdf --force
# Install for multiple agents
skillkit install anthropics/skills --agent claude --agent cursor
```
## Remove Command
```bash
skillkit remove <skill-names> [options]
```
| Option | Purpose |
|--------|---------|
| `--agent` | Target specific agents (default: all) |
| `--yes` | Skip confirmation |
| `--keep-metadata` | Remove skill but preserve metadata |
## Update Command
```bash
skillkit update [skill-names] [options]
```
| Option | Purpose |
|--------|---------|
| `--dry-run` | Check for updates without installing |
| `--yes` | Skip confirmation prompts |
| `--agent` | Update in specific agents only |
## Enable/Disable Commands
```bash
skillkit enable <skill-names> [options]
skillkit disable <skill-names> [options]
```
Disabled skills are ignored by the `sync` command. No file changes occur.
## List Command
```bash
skillkit list [options]
```
Lists installed skills with quality grades.
## Sync Command
```bash
skillkit sync [options]
```
Synchronizes enabled skills to agent configuration files.
## Recommend Command
```bash
skillkit recommend [options]
```
AI-powered recommendations based on project analysis.
| Option | Purpose |
|--------|---------|
| `--search` | Task-based search |
| `--category` | Filter by category |
| `--min-score` | Quality threshold |
## Marketplace Command
```bash
skillkit marketplace [options]
skillkit marketplace search <query>
```
Browse 15,000+ indexed skills from the aggregated catalog.
| Option | Purpose |
|--------|---------|
| `--tags` | Filter by tags |
| `--refresh` | Force refresh index |
## Manifest Commands
Team collaboration via Git-committable `.skills` file.
```bash
skillkit manifest init # Create .skills file
skillkit manifest add <source> # Add skill source
skillkit manifest install # Install from manifest
```
### Manifest File Format
```text
# GitHub skills
anthropics/skills
vercel-labs/agent-skills
# Local skills
./local-skills
# Specific versions
owner/repo@v1.2.3
```
## Memory Commands
```bash
skillkit memory status # View memory status
skillkit memory search <query> # Search learnings
skillkit memory compress # Compress observations
skillkit memory export <name> # Export as skill
skillkit memory --global # Use global memory
```
## Translation Commands
```bash
skillkit translate <skill> --to <agent>
skillkit translate --all --to <agent>
skillkit translate <skill> --to <agent> --dry-run
```
## Agent Commands
```bash
skillkit agent list # List agents
skillkit agent show <name> # Show details
skillkit agent create <name> # Create agent
skillkit agent translate --source ./path --to cursor
skillkit agent translate --source ./path --to cursor --recursive
skillkit agent sync # Sync to target
skillkit agent validate # Validate definitions
```
## Context Commands
```bash
skillkit context init # Initialize project context
skillkit context sync # Sync context to agents
```
## Test Command
```bash
skillkit test [path] # Run skill tests
skillkit test --tags unit # Filter by tags
skillkit test --json # JSON output for CI
```
## Workflow Commands
```bash
skillkit workflow list # List workflows
skillkit workflow run <name> # Execute workflow
skillkit workflow create <name> # Create workflow
```
## CI/CD Commands
```bash
skillkit cicd github-action # Generate GitHub Actions
skillkit cicd gitlab-ci # Generate GitLab CI
skillkit cicd pre-commit # Generate pre-commit hooks
```
## Utility Commands
```bash
skillkit init # Initialize project
skillkit create <name> # Create new skill
skillkit validate [path] # Validate skill format
skillkit read <skills> # Read skill content
skillkit publish # Publish to marketplace
skillkit settings --set key=value # Configure settings
```
## Interactive TUI
```bash
skillkit ui # Launch terminal UI
skillkit # Same as above
```
**Navigation Keys:**
| Key | Action |
|-----|--------|
| `h` | Home |
| `b` | Browse |
| `m` | Marketplace |
| `r` | Recommend |
| `t` | Translate |
| `c` | Context |
| `i` | Installed |
| `s` | Sync |
| `/` | Help |
| `q` | Quit |
## Exit Codes
| Code | Meaning |
|------|---------|
| 0 | Success |
| 1 | General error |
| 2 | Invalid arguments |
| 3 | Configuration issue |
| 4 | Network problem |
| 5 | Filesystem error |
## Quality Grades
Skills receive automatic quality scores mapped to grades:
| Grade | Score Range |
|-------|-------------|
| A | 90-100 |
| B | 80-89 |
| C | 70-79 |
| D | 60-69 |
| F | Below 60 |
Skills with score below 60 trigger warning displays before installation.
@@ -0,0 +1,104 @@
---
title: Configuration
description: Configure SkillKit at project and user levels
---
# Configuration
SkillKit uses a layered configuration system with five priority levels (lowest to highest):
1. Default values in code
2. Global user preferences (`~/.skillkit/preferences.json`)
3. Project settings (`skillkit.yaml`)
4. Environment variables
5. CLI flags
## Project Configuration
Create `skillkit.yaml` in your project root:
```yaml
version: 1
agent: cursor # Override auto-detection
autoSync: true # Sync on changes
enabledSkills:
- pdf
- xlsx
- react-patterns
disabledSkills:
- deprecated-skill
skillsDir: ./custom-skills # Custom directory
sources: # Default sources
- anthropics/skills
- vercel-labs/agent-skills
```
## Manifest File
The `.skills` file enables Git-based team sharing:
```yaml
version: 1
skills:
- source: anthropics/skills
skills: [pdf, xlsx]
- source: vercel-labs/agent-skills
skills: [react-patterns]
```
Commands:
```bash
skillkit manifest init # Create .skills
skillkit manifest add <skill> # Add skill
skillkit manifest install # Install all
```
## User Preferences
Global preferences in `~/.skillkit/preferences.json`:
```json
{
"lastAgents": ["claude-code", "cursor"],
"defaultAgent": "claude-code",
"theme": "dark"
}
```
## Environment Variables
| Variable | Purpose |
|----------|---------|
| `SKILLKIT_AGENT` | Override default agent |
| `SKILLKIT_DIR` | Custom SkillKit directory |
| `SKILLKIT_DEBUG` | Enable debug logging |
## CLI Settings
```bash
skillkit settings --set agent=cursor
skillkit settings --set autoSync=true
skillkit settings --get agent
```
## Directory Structure
```
~/.skillkit/
├── preferences.json # User preferences
├── cache/ # Marketplace cache
└── memory/ # Learning storage
├── observations/
├── learnings/
└── index.json
./project/
├── skillkit.yaml # Project config
├── .skills # Team manifest
└── skills/ # Local skills
```
@@ -0,0 +1,68 @@
---
title: Contributing
description: Contribute to SkillKit development
---
# Contributing
## Setup
```bash
git clone https://github.com/rohitg00/skillkit.git
cd skillkit
pnpm install
pnpm build
pnpm test
```
## Requirements
- Node.js 18+
- pnpm 8+
- Bun 1.2+ (TUI)
## Project Structure
```
skillkit/
├── packages/
│ ├── core/ # Business logic
│ ├── cli/ # CLI
│ ├── tui/ # Terminal UI
│ └── agents/ # 32 adapters
├── marketplace/ # Skills data
│ ├── skills.json
│ └── sources.json
└── docs/
```
## Development
```bash
git checkout -b feat/my-feature
pnpm test
pnpm lint
pnpm build
```
## Code Style
- ES modules
- `function` keyword
- Explicit return types
- No unnecessary comments
- No nested ternaries
## Commits
```
feat: add feature
fix: resolve bug
docs: update docs
test: add tests
```
## Links
- [GitHub Issues](https://github.com/rohitg00/skillkit/issues)
- [GitHub Discussions](https://github.com/rohitg00/skillkit/discussions)
@@ -0,0 +1,59 @@
---
title: Custom Agents
description: Create custom AI sub-agent definitions
---
# Custom Agents
Create and manage custom AI sub-agents.
## Commands
```bash
skillkit agent list # List agents
skillkit agent show <name> # Show details
skillkit agent create <name> # Create agent
skillkit agent translate # Translate format
skillkit agent sync # Sync to target
skillkit agent validate # Validate
```
## Agent Definition
```yaml
name: my-agent
description: Custom agent for tasks
format: skill.md
skillsDir: .my-agent/skills/
capabilities:
- code-generation
- code-review
triggers:
- pattern: "create component"
action: generate-component
```
## Structure
```
.my-agent/
├── agent.yaml # Definition
├── skills/ # Agent skills
└── config/ # Settings
```
## Translation
```bash
skillkit agent translate --source ./my-agent --to cursor
skillkit agent translate --source ./agents --to cursor --recursive
```
## Validation
```bash
skillkit agent validate
skillkit agent validate ./my-agent
```
+69
View File
@@ -0,0 +1,69 @@
---
title: SkillKit Documentation
description: Universal CLI for managing AI agent skills across 32 coding platforms
---
# SkillKit
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across **32 AI coding platforms**.
**Current Version:** v1.7.5
## The Problem
Each AI coding agent uses different skill formats and directory structures:
- Claude Code uses `.claude/skills/` with SKILL.md
- Cursor uses `.cursor/skills/` with .mdc format
- GitHub Copilot uses `.github/skills/`
Without SkillKit, you either rewrite skills for each agent, lock into one platform, or abandon skills entirely.
## The Solution
SkillKit provides a **"write once, deploy everywhere"** platform. Maintain a single skill definition that automatically translates across all 32 platforms.
## Quick Install
```bash
npm install -g skillkit
skillkit init
skillkit install anthropics/skills
skillkit sync
```
## Key Features
| Feature | Description |
|---------|-------------|
| **Cross-Platform Translation** | Automatic conversion between 32 agent formats |
| **Skill Discovery** | 15,000+ marketplace skills with AI recommendations |
| **Team Collaboration** | Git-based `.skills` manifest for sharing |
| **Quality Evaluation** | 0-100 scoring with A-F grades |
| **Interactive TUI** | Beautiful terminal interface |
| **Memory System** | Persistent learning across sessions |
## Architecture
| Tier | Components |
|------|------------|
| **User Interfaces** | CLI (Clipanion v4), TUI (OpenTUI/React), Documentation |
| **Business Logic** | @skillkit/core, @skillkit/agents (32 adapters) |
| **External Systems** | GitHub/GitLab, Marketplace (15,000+ skills) |
## Supported Agents
Claude Code, Cursor, Codex, Gemini CLI, OpenCode, GitHub Copilot, Windsurf, Antigravity, Amp, Clawdbot, Droid, Goose, Kilo Code, Kiro CLI, Roo Code, Trae, Cline, CodeBuddy, Continue, Crush, Factory, MCPJam, Mux, Neovate, OpenHands, Pi, Qoder, Qwen, Vercel, Zencoder, CommandCode, Universal
## Popular Sources
| Repository | Skills |
|------------|--------|
| anthropics/skills | PDF, XLSX, DOCX processing |
| vercel-labs/agent-skills | React/Next.js best practices |
## Get Started
1. [Installation](/docs/installation) - Install and initialize
2. [Quick Start](/docs/quickstart) - 5-minute guide
3. [Commands](/docs/commands) - Full CLI reference
4. [Skills](/docs/skills) - Skill format and lifecycle
+132
View File
@@ -0,0 +1,132 @@
---
title: Installation
description: Install SkillKit and set up your first project
---
# Installation
SkillKit is distributed as an npm package. Current version: **v1.7.5**
## Install Globally
```bash
npm install -g skillkit
```
The CLI provides two command aliases: `skillkit` and `sk` (shorthand).
## Alternative Methods
```bash
# pnpm
pnpm add -g skillkit
# yarn
yarn global add skillkit
# bun
bun add -g skillkit
# npx (no install required)
npx skillkit <command>
```
## GitHub Packages
```bash
npm install -g @rohitg00/skillkit --registry=https://npm.pkg.github.com
```
## Verify Installation
```bash
skillkit --version
# or
sk --version
```
## Requirements
- **Node.js** 18.0.0 or higher
- **Bun** 1.2.0 or higher (for TUI only)
## First Run Experience
When you run SkillKit for the first time, it initiates an interactive onboarding that:
1. Detects your current AI agent automatically
2. Creates necessary project directories
3. Gathers user preferences for future sessions
4. Displays contextual guidance
Preferences are stored in `~/.skillkit/preferences.json`.
## Initialize a Project
```bash
skillkit init
```
### Init Command Options
| Flag | Short | Purpose |
|------|-------|---------|
| `--agent` | `-a` | Specify target agent (auto-detected if omitted) |
| `--list` | `-l` | Display all supported agents |
| `--quiet` | `-q` | Suppress welcome logo and confirmations |
### What Init Creates
| Agent | Skills Directory | Config File |
|-------|-----------------|-------------|
| Claude Code | `.claude/skills/` | `.claude/config.json` |
| Cursor | `.cursor/skills/` | `.cursor/config.mdc` |
| Codex | `.codex/skills/` | `AGENTS.md` |
| GitHub Copilot | `.github/skills/` | — |
| Universal | `skills/` | `AGENTS.md` |
## Visual Theme
The CLI adapts its logo based on terminal width:
- **≥70 columns** - Full ASCII art with block characters
- **50-69 columns** - Spaced text display
- **less than 50 columns** - Minimal format with symbols
## Agent Icons
| Agent | Icon |
|-------|------|
| Claude Code | ⟁ |
| Cursor | ◫ |
| Codex | ◎ |
| Gemini CLI | ✦ |
| OpenCode | ⬡ |
## Non-Interactive Mode
For CI/CD or piped input environments:
```bash
skillkit init --quiet
```
This skips the welcome logo, runs agent detection automatically, and produces minimal output.
## Next Steps
After installation, continue with:
```bash
# Install skills from GitHub
skillkit install anthropics/skills
# Browse marketplace
skillkit marketplace
# Synchronize to agent directories
skillkit sync
# Launch interactive terminal UI
skillkit ui
```
@@ -0,0 +1,55 @@
---
title: Marketplace
description: Browse and install from 15,000+ curated skills
---
# Marketplace
The SkillKit marketplace indexes 15,000+ skills from curated sources.
## Browse
```bash
skillkit marketplace
```
## Search
```bash
skillkit marketplace search "react hooks"
```
## Filter by Tags
```bash
skillkit marketplace --tags typescript,testing
```
## Refresh Index
```bash
skillkit marketplace refresh
```
## Popular Sources
| Repository | Description |
|------------|-------------|
| [anthropics/skills](https://github.com/anthropics/skills) | PDF, XLSX, DOCX processing |
| [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | React/Next.js best practices |
## Install from Marketplace
```bash
skillkit install anthropics/skills
skillkit install anthropics/skills --skills pdf,xlsx
skillkit install anthropics/skills --agent claude-code,cursor
```
## Publish Skills
```bash
skillkit create my-skill
skillkit validate my-skill
skillkit publish
```
+47
View File
@@ -0,0 +1,47 @@
---
title: Memory System
description: Persistent learning across AI agent sessions
---
# Memory System
Capture learnings from AI sessions and convert them into reusable skills.
## Commands
```bash
skillkit memory status # View status
skillkit memory search <q> # Search learnings
skillkit memory compress # Compress observations
skillkit memory export <name> # Export as skill
skillkit memory --global # Global memory
```
## How It Works
1. **Observations** - Track patterns during sessions
2. **Compression** - Distill into reusable knowledge
3. **Injection** - Load into new sessions
4. **Export** - Convert to shareable skills
## Storage
```
~/.skillkit/memory/
├── observations/ # Raw session data
├── learnings/ # Compressed knowledge
└── index.json # Memory index
```
## Programmatic API
```typescript
import { MemoryCompressor, LearningStore } from '@skillkit/core'
const compressor = new MemoryCompressor()
const learning = await compressor.compress(observations)
const store = new LearningStore()
await store.add(learning)
const results = await store.search('authentication')
```
+23
View File
@@ -0,0 +1,23 @@
{
"title": "SkillKit",
"pages": [
"index",
"installation",
"quickstart",
"tui",
"skills",
"agents",
"translation",
"marketplace",
"recommendations",
"memory",
"workflows",
"testing",
"commands",
"configuration",
"api-reference",
"cicd",
"custom-agents",
"contributing"
]
}
+173
View File
@@ -0,0 +1,173 @@
---
title: Quick Start
description: Get up and running with SkillKit in 5 minutes
---
# Quick Start
This guide walks you through installing SkillKit, setting up your first project, and installing skills.
## 1. Install SkillKit
```bash
npm install -g skillkit
```
Verify installation:
```bash
skillkit --version
```
## 2. Initialize Your Project
Navigate to your project directory and run:
```bash
skillkit init
```
This starts an interactive onboarding that:
1. **Detects your AI agent** - Scans for `.claude/`, `.cursor/`, `.github/` directories
2. **Creates directories** - Sets up the skills folder for your agent
3. **Saves preferences** - Remembers your choices for future commands
### Quick Agent Selection
Three options appear for faster interaction:
- **"Same as last time"** - Reuse previous agent choices
- **"All detected agents"** - Select every agent found
- **"Select specific agents"** - Open full selection menu
## 3. Get Recommendations
SkillKit analyzes your project and suggests relevant skills:
```bash
skillkit recommend
```
Example output:
```
Project: my-app (Next.js + TypeScript + Tailwind)
Recommended Skills:
92% vercel-react-best-practices
87% tailwind-v4-patterns
85% nextjs-app-router
78% typescript-strict-mode
```
## 4. Install Skills
### Interactive Installation
```bash
skillkit install anthropics/skills
```
This prompts you to:
- Select which skills to install
- Choose target agents
- Pick installation method (symlink or copy)
### Non-Interactive Installation
For CI/CD or scripting:
```bash
skillkit install anthropics/skills --skills=pdf,xlsx --agent claude --yes
```
### List Available Skills
Preview without installing:
```bash
skillkit install anthropics/skills --list
```
## 5. Sync to Your Agent
Deploy installed skills to your agent's configuration:
```bash
skillkit sync
```
## 6. Launch the TUI
For a visual interface:
```bash
skillkit ui
# or just
skillkit
```
**Navigation:** `h` Home | `m` Marketplace | `r` Recommend | `i` Installed | `s` Sync | `q` Quit
## Complete Example
```bash
# Install SkillKit
npm install -g skillkit
# Initialize in your project
cd my-project
skillkit init
# Get recommendations
skillkit recommend
# Install from official marketplace
skillkit install anthropics/skills
# Install for multiple agents
skillkit install vercel-labs/agent-skills --agent claude,cursor,windsurf
# Sync to agents
skillkit sync
```
## Team Collaboration
Share skills with your team using manifest files:
```bash
# Create manifest
skillkit manifest init
# Add skill sources
skillkit manifest add anthropics/skills
skillkit manifest add ./local-skills
# Team members install from manifest
skillkit manifest install
```
The `.skills` file can be committed to Git for team-wide consistency.
## User Preferences
Your choices are saved to `~/.skillkit/preferences.json`:
```json
{
"lastSelectedAgents": ["claude", "cursor"],
"autoSync": true,
"marketplace": {
"lastRefresh": "2025-01-01T00:00:00Z"
}
}
```
## Next Steps
- **Browse Marketplace** - `skillkit marketplace`
- **Create Custom Skills** - `skillkit create my-skill`
- **Translate Between Agents** - `skillkit translate skill --to cursor`
- **View All Commands** - `skillkit --help`
@@ -0,0 +1,58 @@
---
title: Recommendations
description: Get smart skill suggestions for your project
---
# Recommendations
SkillKit analyzes your project and suggests relevant skills.
## Get Recommendations
```bash
skillkit recommend
```
Output:
```
Project: my-app (Next.js + TypeScript + Tailwind)
Recommended Skills:
92% vercel-react-best-practices
87% tailwind-v4-patterns
85% nextjs-app-router
```
## Filters
```bash
skillkit recommend --search "auth"
skillkit recommend --category security
skillkit recommend --min-score 80
```
## How It Works
The engine analyzes:
- **Project structure** - Frameworks, languages, tools
- **Dependencies** - package.json, requirements.txt
- **File patterns** - Code patterns in your codebase
## Scoring
Scores based on:
- Stack match
- Quality score (0-100)
- Popularity
- Task relevance
## Programmatic API
```typescript
import { RecommendationEngine, analyzeProject } from '@skillkit/core'
const engine = new RecommendationEngine()
const profile = await analyzeProject('./my-project')
const recs = engine.recommend(profile)
```
+99
View File
@@ -0,0 +1,99 @@
---
title: Skills
description: Understanding AI agent skills - format, lifecycle, and quality
---
# Skills
A skill is an instruction file that teaches AI coding agents how to handle specific tasks. Each skill uses a universal Markdown format (SKILL.md) with YAML frontmatter.
## Skills vs Context vs Commands
| Type | Purpose | Format |
|------|---------|--------|
| **Skills** | Task-specific reusable instructions | SKILL.md |
| **Context** | Project-wide environment info | JSON/YAML |
| **Commands** | Quick-action slash commands | Various |
## Skill Format
```markdown
---
name: my-skill
description: What this skill does
license: MIT
metadata:
author: your-name
version: "1.0"
tags:
- react
- typescript
---
# My Skill
Instructions for the AI agent.
## When to Use
- Scenario 1
- Scenario 2
## Steps
1. First step
2. Second step
```
## Skill Lifecycle
Skills progress through six stages:
1. **Discovery** - `findAllSkills()` scans directories for SKILL.md files
2. **Quality Evaluation** - `evaluateSkillContent()` produces 0-100 scores (grades A-F)
3. **Parsing** - `parseSkillFile()` extracts YAML frontmatter and markdown content
4. **Translation** - `translateSkill()` converts to agent-specific formats
5. **Installation** - Skills deployed to agent directories with metadata tracking
6. **Testing** - Test suites with 14+ assertion types validate skills
## Quality Evaluation
Skills receive scores across four weighted dimensions:
- **Structure** - 25 points: Frontmatter completeness, markdown sections
- **Clarity** - 30 points: Description quality, instruction precision
- **Specificity** - 30 points: Concrete examples, actionable steps
- **Advanced** - 15 points: Test coverage, version info, examples
**Grades:**
- A: 90 to 100
- B: 80 to 89
- C: 70 to 79
- D: 60 to 69
- F: below 60
## Skill Sources
| Source | Description |
|--------|-------------|
| **GitHub/GitLab** | Remote repository collections |
| **Local filesystem** | Project-specific skills |
| **Marketplace** | 15,000+ curated skills with search |
## Creating Skills
```bash
skillkit create my-skill
```
Or manually create a `SKILL.md` file following the format above.
## Publishing Skills
```bash
# Test locally
skillkit validate ./my-skill
# Publish to marketplace
skillkit publish
```
+66
View File
@@ -0,0 +1,66 @@
---
title: Testing
description: Test skills with multiple assertion types
---
# Testing
SkillKit includes a testing framework with multiple assertion types.
## Run Tests
```bash
skillkit test # All tests
skillkit test ./my-skill # Specific skill
skillkit test --tags unit # By tag
skillkit test --json # CI output
```
## Test File
Create `test.yaml` alongside your skill:
```yaml
name: my-skill-tests
skill: my-skill
tests:
- name: validates input
input: |
Process this file
assertions:
- contains: "processed"
- not_contains: "error"
```
## Assertion Types
| Assertion | Description |
|-----------|-------------|
| `contains` | Text present |
| `not_contains` | Text absent |
| `matches` | Regex match |
| `starts_with` | Prefix check |
| `ends_with` | Suffix check |
| `has_section` | Markdown section |
| `has_code_block` | Code block with lang |
| `word_count_min` | Minimum words |
| `word_count_max` | Maximum words |
| `no_todos` | No TODO comments |
| `has_frontmatter` | YAML present |
## CI Integration
```yaml
- name: Test Skills
run: skillkit test --json > results.json
```
## Programmatic API
```typescript
import { SkillTestRunner } from '@skillkit/core'
const runner = new SkillTestRunner()
const results = await runner.run('./my-skill')
```
@@ -0,0 +1,55 @@
---
title: Translation
description: Convert skills between AI agent formats
---
# Translation
SkillKit automatically converts between all 32 agent formats using an adapter pattern.
## Basic Translation
```bash
skillkit translate react-patterns --to cursor
```
## Translate All
```bash
skillkit translate --all --to windsurf
```
## Preview Mode
```bash
skillkit translate my-skill --to codex --dry-run
```
## Batch Translation
```bash
skillkit agent translate --source ./my-skills --to cursor
skillkit agent translate --source ./skills --to cursor --recursive
```
## Format Mapping
| Source | Target | Notes |
|--------|--------|-------|
| SKILL.md | .mdc | Cursor format |
| SKILL.md | Markdown | GitHub Copilot |
| .mdc | SKILL.md | Reverse conversion |
## How It Works
```
Universal Format (SKILL.md)
↓
Adapter Interface
↓
Agent-Specific Formats
```
Each adapter implements:
- `getConfigPath()` - Returns skill directory
- `generateConfig()` - Converts content to target format
+193
View File
@@ -0,0 +1,193 @@
---
title: Terminal UI
description: Interactive keyboard-driven interface for managing skills
---
# Terminal UI
The TUI provides an interactive, keyboard-driven interface for managing skills with visual browsing, searching, and installation capabilities.
## Launch
```bash
skillkit ui
# or just
skillkit
```
## Framework
Built on modern technologies:
- **@opentui/react** - Terminal rendering
- **React 19.0.0** - Component architecture
- **Bun 1.2.0+** - Runtime requirement
## Screens
| Screen | Key | Purpose |
|--------|-----|---------|
| **Home** | `h` | Entry point dashboard with quick navigation |
| **Browse** | `b` | Skill repository browser with search |
| **Marketplace** | `m` | 15,000+ skills with categories |
| **Installed** | `i` | Local skill management |
| **Recommend** | `r` | AI-powered suggestions |
| **Translate** | `t` | Format conversion |
| **Context** | `c` | Project context management |
| **Sync** | `s` | Synchronize to agents |
## Keyboard Navigation
### Global Shortcuts
| Key | Action |
|-----|--------|
| `h` | Go to Home |
| `b` | Go to Browse |
| `m` | Go to Marketplace |
| `i` | Go to Installed |
| `r` | Go to Recommend |
| `t` | Go to Translate |
| `c` | Go to Context |
| `s` | Go to Sync |
| `/` | Open Help |
| `q` | Quit TUI |
### List Navigation
| Key | Action |
|-----|--------|
| `j` or `↓` | Move down |
| `k` or `↑` | Move up |
| `Enter` | Select/activate |
| `Esc` | Go back |
| `/` | Enter search mode |
### Search Mode
| Key | Action |
|-----|--------|
| `/` | Enter search mode |
| Type | Filter list |
| `Enter` | Confirm search |
| `Esc` | Exit search |
## Screen Details
### Home Screen
Dashboard with:
- Quick navigation shortcuts
- Recent activity
- System status
### Browse Screen
Repository browser with:
- Search functionality
- Pagination
- Quality indicators
- Animation phases for smooth loading
### Installed Screen
Manage local skills:
- Enable/disable skills
- Quality grades (A-F)
- Live search filtering
- Status icons: `●` enabled, `○` disabled
### Marketplace Screen
Browse 15,000+ skills:
- Category filtering
- Featured skills
- 3-phase animation loading
- Quality scoring
### Recommend Screen
AI-powered suggestions:
- Project analysis
- Confidence scoring
- Progress tracking
- Match percentages
## Visual Indicators
### Quality Grades
| Grade | Score | Color |
|-------|-------|-------|
| A | 90-100 | Green |
| B | 80-89 | Green |
| C | 70-79 | Yellow |
| D | 60-69 | Red |
| F | Below 60 | Red |
### Status Icons
| Icon | Meaning |
|------|---------|
| `●` | Enabled |
| `○` | Disabled |
| `⟁` | Claude Code |
| `◫` | Cursor |
| `◎` | Codex |
| `✦` | Gemini |
| `⬡` | OpenCode |
## Theme System
The TUI uses a monochromatic design with:
- Consistent color coding
- Terminal-compatible colors
- Visual accents for selection
- Muted states for disabled items
## Architecture
### State Management
```
loadSkills()
→ getSearchDirs(agentType)
→ findAllSkills(searchDirs)
→ evaluateSkillDirectory() for each
→ getQualityGrade(quality.overall)
→ SkillsState
```
### Performance Optimizations
- `useMemo` for filtered lists
- `useCallback` for event handlers
- Pagination limits rendered items
- Progressive animation with phases
### Animation Timing
| Animation | Delay |
|-----------|-------|
| Entrance | 100ms between phases |
| Spinner | 80ms interval |
| Progress | 200ms interval |
## Integration
The TUI integrates with @skillkit/core:
```typescript
findAllSkills(searchDirs) // Returns skill metadata
evaluateSkillDirectory(path) // Quality metrics
getQualityGrade(score) // 0-100 to A-F
```
## Graceful Exit
The TUI handles shutdown gracefully:
1. Unmounts React components
2. Restores terminal state
3. Cleans up signal handlers
4. Exits process cleanly
Press `q` from Home screen or `Ctrl+C` to exit.
+67
View File
@@ -0,0 +1,67 @@
---
title: Workflows
description: Compose skills into multi-step orchestrations
---
# Workflows
Compose skills into multi-step processes.
## Commands
```bash
skillkit workflow list # List workflows
skillkit workflow run <name> # Run workflow
skillkit workflow create <name> # Create workflow
```
## Workflow File
```yaml
name: feature-development
description: Complete feature workflow
steps:
- name: plan
skill: planning
- name: implement
skill: coding-standards
- name: test
skill: testing-patterns
- name: review
skill: code-review
```
## Features
### Conditional Steps
```yaml
steps:
- name: security
skill: security-audit
condition: "files.any('**/*.ts')"
```
### Parallel Execution
```yaml
steps:
- name: checks
parallel:
- skill: linting
- skill: testing
```
## Programmatic API
```typescript
import { WorkflowOrchestrator } from '@skillkit/core'
const orchestrator = new WorkflowOrchestrator()
const workflow = await orchestrator.load('./workflow.yaml')
await orchestrator.run(workflow)
```
+6
View File
@@ -0,0 +1,6 @@
/// <reference types="next" />
/// <reference types="next/image-types/global" />
import "./.next/types/routes.d.ts";
// NOTE: This file should not be edited
// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.
+10
View File
@@ -0,0 +1,10 @@
import { createMDX } from 'fumadocs-mdx/next';
const withMDX = createMDX();
/** @type {import('next').NextConfig} */
const config = {
reactStrictMode: true,
};
export default withMDX(config);
+36
View File
@@ -0,0 +1,36 @@
{
"name": "skillkit-docs",
"version": "1.0.0",
"private": true,
"scripts": {
"build": "next build",
"dev": "next dev",
"start": "next start",
"types:check": "fumadocs-mdx && next typegen && tsc --noEmit",
"postinstall": "fumadocs-mdx",
"lint": "next lint"
},
"dependencies": {
"@google/genai": "^1.38.0",
"clsx": "^2.1.1",
"fumadocs-core": "16.3.2",
"fumadocs-mdx": "14.2.2",
"fumadocs-ui": "16.3.2",
"lucide-react": "^0.561.0",
"next": "16.0.10",
"next-themes": "^0.4.6",
"react": "^19.2.3",
"react-dom": "^19.2.3",
"tailwind-merge": "^3.4.0"
},
"devDependencies": {
"@tailwindcss/postcss": "^4.1.18",
"@types/mdx": "^2.0.13",
"@types/node": "^24.10.2",
"@types/react": "^19.2.7",
"@types/react-dom": "^19.2.3",
"postcss": "^8.5.6",
"tailwindcss": "^4.1.18",
"typescript": "^5.9.3"
}
}
+3912
View File
File diff suppressed because it is too large Load Diff
+5
View File
@@ -0,0 +1,5 @@
export default {
plugins: {
'@tailwindcss/postcss': {},
},
};
+21
View File
@@ -0,0 +1,21 @@
import {
defineConfig,
defineDocs,
frontmatterSchema,
metaSchema,
} from 'fumadocs-mdx/config';
export const docs = defineDocs({
dir: 'content/docs',
docs: {
schema: frontmatterSchema,
postprocess: {
includeProcessedMarkdown: true,
},
},
meta: {
schema: metaSchema,
},
});
export default defineConfig({});
+63
View File
@@ -0,0 +1,63 @@
import Link from 'next/link'
const GITHUB_ICON = (
<svg className="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
<path fillRule="evenodd" d="M12 2C6.477 2 2 6.484 2 12.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.531 1.032 1.531 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0112 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.202 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.943.359.309.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482A10.019 10.019 0 0022 12.017C22 6.484 17.522 2 12 2z" clipRule="evenodd" />
</svg>
)
const NPM_ICON = (
<svg className="w-5 h-5" viewBox="0 0 24 24" fill="currentColor">
<path d="M0 7.334v8h6.666v1.332H12v-1.332h12v-8H0zm6.666 6.664H5.334v-4H3.999v4H1.335V8.667h5.331v5.331zm4 0v1.336H8.001V8.667h5.334v5.332h-2.669v-.001zm12.001 0h-1.33v-4h-1.336v4h-1.335v-4h-1.33v4h-2.671V8.667h8.002v5.331zM10.665 10H12v2.667h-1.335V10z" />
</svg>
)
export default function HomeLayout({
children,
}: {
children: React.ReactNode
}) {
return (
<>
<nav className="fixed top-0 left-0 right-0 z-50 border-b border-zinc-800 bg-black/90 backdrop-blur-md">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="flex h-14 items-center justify-between">
<Link href="/" className="flex items-center gap-2 cursor-pointer">
<div className="w-4 h-4 bg-white"></div>
<span className="text-base font-bold tracking-tight text-white font-mono">SKILLKIT</span>
</Link>
<div className="flex items-center gap-2 sm:gap-4">
<Link
href="/docs"
className="text-zinc-400 hover:text-white transition-colors text-sm font-mono"
>
Docs
</Link>
<a
href="https://www.npmjs.com/package/skillkit"
target="_blank"
rel="noreferrer noopener"
className="text-zinc-400 hover:text-red-500 transition-colors p-2"
aria-label="npm"
>
{NPM_ICON}
</a>
<a
href="https://github.com/rohitg00/skillkit"
target="_blank"
rel="noreferrer noopener"
className="text-zinc-400 hover:text-white transition-colors p-2"
aria-label="GitHub"
>
{GITHUB_ICON}
</a>
</div>
</div>
</div>
</nav>
<div className="pt-14">
{children}
</div>
</>
)
}
+40
View File
@@ -0,0 +1,40 @@
'use client'
import { Hero } from '@/components/Hero'
import { Agents } from '@/components/Agents'
import { Features } from '@/components/Features'
import { Commands } from '@/components/Commands'
import { SkillGenerator } from '@/components/SkillGenerator'
import { SkillSubmitForm } from '@/components/SkillSubmitForm'
import { Footer } from '@/components/Footer'
export default function HomePage() {
return (
<div className="min-h-screen bg-black text-zinc-100 font-sans selection:bg-white selection:text-black">
<main>
<Hero />
<Agents />
<Features />
<Commands />
<section id="skills" className="py-12 border-b border-zinc-800">
<SkillGenerator />
</section>
<section id="submit" className="py-12 border-b border-zinc-800 bg-zinc-900/50">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="text-center mb-8">
<h2 className="text-2xl font-bold text-white mb-2 font-mono">Submit Your Skill</h2>
<p className="text-zinc-400 font-mono text-sm">
Share your AI agent skills with the community.
</p>
</div>
<SkillSubmitForm />
</div>
</section>
</main>
<Footer />
</div>
)
}
@@ -0,0 +1,190 @@
import { GoogleGenAI, Type, Schema } from "@google/genai";
import { NextRequest, NextResponse } from "next/server";
const rateLimitMap = new Map<string, { count: number; resetTime: number }>();
const RATE_LIMIT_WINDOW_MS = 60 * 1000;
const RATE_LIMIT_MAX_REQUESTS = 10;
function getRateLimitKey(request: NextRequest): string {
const forwarded = request.headers.get("x-forwarded-for");
const ip = forwarded ? forwarded.split(",")[0].trim() : "unknown";
return ip;
}
function checkRateLimit(key: string): { allowed: boolean; remaining: number } {
const now = Date.now();
const entry = rateLimitMap.get(key);
if (!entry || now > entry.resetTime) {
rateLimitMap.set(key, { count: 1, resetTime: now + RATE_LIMIT_WINDOW_MS });
return { allowed: true, remaining: RATE_LIMIT_MAX_REQUESTS - 1 };
}
if (entry.count >= RATE_LIMIT_MAX_REQUESTS) {
return { allowed: false, remaining: 0 };
}
entry.count++;
return { allowed: true, remaining: RATE_LIMIT_MAX_REQUESTS - entry.count };
}
const agentSkillSchema: Schema = {
type: Type.OBJECT,
properties: {
name: { type: Type.STRING, description: "Skill name in slug format (e.g., 'react-best-practices')" },
title: { type: Type.STRING, description: "Human readable title" },
description: { type: Type.STRING, description: "Brief description of what this skill teaches AI agents" },
version: { type: Type.STRING, description: "Semantic version (e.g., '1.0.0')" },
tags: {
type: Type.ARRAY,
items: { type: Type.STRING },
description: "Tags for categorization"
},
applicability: { type: Type.STRING, description: "When the AI agent should apply this skill (e.g., 'Apply when working with React components')" },
principles: {
type: Type.ARRAY,
items: {
type: Type.OBJECT,
properties: {
title: { type: Type.STRING },
description: { type: Type.STRING, description: "Detailed instruction for the AI agent" },
priority: { type: Type.STRING, description: "must, should, or may" }
},
required: ["title", "description", "priority"]
},
description: "Core principles and guidelines (5-8 items)"
},
patterns: {
type: Type.ARRAY,
items: {
type: Type.OBJECT,
properties: {
name: { type: Type.STRING },
description: { type: Type.STRING },
example: { type: Type.STRING, description: "Code example demonstrating the pattern" },
language: { type: Type.STRING, description: "Programming language for syntax highlighting" }
},
required: ["name", "description", "example"]
},
description: "Code patterns with examples (3-5 items)"
},
antiPatterns: {
type: Type.ARRAY,
items: {
type: Type.OBJECT,
properties: {
name: { type: Type.STRING },
description: { type: Type.STRING },
badExample: { type: Type.STRING, description: "Code showing what NOT to do" },
goodExample: { type: Type.STRING, description: "Code showing the correct approach" }
},
required: ["name", "description"]
},
description: "Anti-patterns to avoid (2-4 items)"
},
filePatterns: {
type: Type.ARRAY,
items: { type: Type.STRING },
description: "Glob patterns for files this skill applies to (e.g., '*.tsx', 'src/components/**')"
},
references: {
type: Type.ARRAY,
items: { type: Type.STRING },
description: "Links to official documentation or resources"
}
},
required: ["name", "title", "description", "version", "tags", "applicability", "principles", "patterns", "antiPatterns"]
};
export async function POST(request: NextRequest): Promise<NextResponse> {
const rateLimitKey = getRateLimitKey(request);
const { allowed, remaining } = checkRateLimit(rateLimitKey);
if (!allowed) {
return NextResponse.json(
{ error: "Rate limit exceeded. Please try again later." },
{
status: 429,
headers: {
"X-RateLimit-Remaining": "0",
"Retry-After": "60",
},
}
);
}
let body: unknown;
try {
body = await request.json();
} catch {
return NextResponse.json({ error: "Invalid JSON body" }, { status: 400 });
}
if (typeof body !== "object" || body === null) {
return NextResponse.json({ error: "Invalid request body" }, { status: 400 });
}
const { topic } = body as { topic?: unknown };
if (typeof topic !== "string") {
return NextResponse.json({ error: "Topic is required and must be a string" }, { status: 400 });
}
const sanitizedTopic = topic.trim().slice(0, 500);
if (!sanitizedTopic) {
return NextResponse.json({ error: "Topic cannot be empty" }, { status: 400 });
}
const apiKey = process.env.GEMINI_API_KEY;
if (!apiKey) {
return NextResponse.json({ error: "Gemini API key not configured" }, { status: 500 });
}
try {
const ai = new GoogleGenAI({ apiKey });
const response = await ai.models.generateContent({
model: "gemini-2.0-flash",
contents: `Create a comprehensive AI coding agent skill for: "${sanitizedTopic}"
This skill will be used by AI coding assistants (like Claude Code, Cursor, GitHub Copilot) to provide better code suggestions and follow best practices.
The skill should include:
1. Clear principles that tell the AI WHAT to do and WHEN
2. Code patterns with REAL, WORKING examples (not pseudocode)
3. Anti-patterns showing common mistakes and how to fix them
4. Specific file patterns where this skill applies
Make the instructions actionable and specific. The AI agent should be able to directly apply these guidelines when writing code.
Focus on practical, production-ready patterns used in modern development.`,
config: {
responseMimeType: "application/json",
responseSchema: agentSkillSchema,
systemInstruction: `You are an expert software architect creating AI agent skills.
Your skills are used by AI coding assistants to write better code.
Guidelines:
- Write instructions as commands to the AI (e.g., "Always use...", "Never...", "Prefer...")
- Include REAL code examples, not pseudocode
- Be specific and actionable
- Focus on modern best practices (2024+)
- Include edge cases and error handling patterns
- Make principles enforceable and testable`
}
});
if (!response.text) {
return NextResponse.json({ error: "No response from Gemini" }, { status: 500 });
}
const data = JSON.parse(response.text);
return NextResponse.json(data, {
headers: {
"X-RateLimit-Remaining": String(remaining),
},
});
} catch (error) {
console.error("Gemini API Error:", error);
return NextResponse.json({ error: "Failed to generate skill" }, { status: 500 });
}
}
@@ -0,0 +1,42 @@
import { source } from '@/lib/source'
import { DocsBody, DocsDescription, DocsPage, DocsTitle } from 'fumadocs-ui/layouts/docs/page'
import { notFound } from 'next/navigation'
import { getMDXComponents } from '@/mdx-components'
import type { Metadata } from 'next'
interface PageProps {
params: Promise<{ slug?: string[] }>
}
export default async function Page(props: PageProps) {
const params = await props.params
const page = source.getPage(params.slug ?? [])
if (!page) notFound()
const MDX = page.data.body
return (
<DocsPage toc={page.data.toc} full={page.data.full} tableOfContent={{ style: 'clerk' }}>
<DocsTitle>{page.data.title}</DocsTitle>
<DocsDescription>{page.data.description}</DocsDescription>
<DocsBody>
<MDX components={getMDXComponents({})} />
</DocsBody>
</DocsPage>
)
}
export async function generateStaticParams() {
return source.generateParams()
}
export async function generateMetadata(props: PageProps): Promise<Metadata> {
const params = await props.params
const page = source.getPage(params.slug ?? [])
if (!page) notFound()
return {
title: page.data.title,
description: page.data.description,
}
}
+17
View File
@@ -0,0 +1,17 @@
import { baseOptions } from '@/lib/layout.shared'
import { source } from '@/lib/source'
import { DocsLayout } from 'fumadocs-ui/layouts/docs'
export default function Layout({ children }: { children: React.ReactNode }) {
return (
<DocsLayout
tree={source.pageTree}
{...baseOptions()}
sidebar={{
collapsible: true,
}}
>
{children}
</DocsLayout>
)
}
+160
View File
@@ -0,0 +1,160 @@
@import 'tailwindcss';
@import 'fumadocs-ui/css/neutral.css';
@import 'fumadocs-ui/css/preset.css';
@theme {
--font-sans: "Inter", ui-sans-serif, system-ui, sans-serif;
--color-skillkit-black: #000000;
--color-skillkit-dark: #18181b;
--color-skillkit-medium: #71717a;
--color-skillkit-light: #fafafa;
--color-skillkit-blue: #3b82f6;
/* Light mode defaults */
--color-fd-background: #ffffff;
--color-fd-foreground: var(--color-skillkit-black);
--color-fd-muted: #f4f4f5;
--color-fd-muted-foreground: var(--color-skillkit-medium);
--color-fd-popover: #ffffff;
--color-fd-popover-foreground: var(--color-skillkit-black);
--color-fd-card: #ffffff;
--color-fd-card-foreground: var(--color-skillkit-black);
--color-fd-border: #e4e4e7;
--color-fd-primary: var(--color-skillkit-blue);
--color-fd-primary-foreground: #ffffff;
--color-fd-secondary: #f4f4f5;
--color-fd-secondary-foreground: var(--color-skillkit-black);
--color-fd-accent: #f4f4f5;
--color-fd-accent-foreground: var(--color-skillkit-black);
--color-fd-ring: var(--color-skillkit-blue);
}
/* Dark mode */
:root.dark {
--color-fd-background: var(--color-skillkit-black);
--color-fd-foreground: var(--color-skillkit-light);
--color-fd-muted: var(--color-skillkit-dark);
--color-fd-muted-foreground: #a1a1aa;
--color-fd-popover: var(--color-skillkit-dark);
--color-fd-popover-foreground: var(--color-skillkit-light);
--color-fd-card: var(--color-skillkit-dark);
--color-fd-card-foreground: var(--color-skillkit-light);
--color-fd-border: #27272a;
--color-fd-primary: var(--color-skillkit-blue);
--color-fd-primary-foreground: #ffffff;
--color-fd-secondary: var(--color-skillkit-dark);
--color-fd-secondary-foreground: var(--color-skillkit-light);
--color-fd-accent: var(--color-skillkit-dark);
--color-fd-accent-foreground: var(--color-skillkit-light);
--color-fd-ring: var(--color-skillkit-blue);
}
body {
background-color: var(--color-fd-background);
color: var(--color-fd-foreground);
}
::selection {
background-color: var(--color-skillkit-blue);
color: #ffffff;
}
/* Light mode code blocks */
pre {
background-color: #f8f8f8 !important;
border: 1px solid #e4e4e7;
}
code {
background-color: #f4f4f5;
color: var(--color-skillkit-black);
padding: 0.2em 0.4em;
border-radius: 4px;
font-size: 0.875em;
}
pre code {
background-color: transparent;
color: inherit;
padding: 0;
}
/* Dark mode code blocks */
:root.dark pre {
background-color: #0d0d0d !important;
border: 1px solid #27272a;
}
:root.dark code {
background-color: #27272a;
color: #e4e4e7;
}
:root.dark pre code {
background-color: transparent;
}
/* Inline code in paragraphs */
p code, li code, td code {
font-weight: 500;
}
/* Tables */
table {
width: 100%;
border-collapse: collapse;
}
th, td {
padding: 0.75rem 1rem;
text-align: left;
border-bottom: 1px solid var(--color-fd-border);
}
th {
font-weight: 600;
background-color: var(--color-fd-muted);
}
/* Lists */
ul, ol {
padding-left: 1.5rem;
}
li {
margin: 0.5rem 0;
}
/* Landing page animations */
@keyframes scroll {
0% { transform: translateX(0); }
100% { transform: translateX(-50%); }
}
.animate-scroll {
animation: scroll 35s linear infinite;
}
@keyframes fade-in {
from { opacity: 0; transform: translateY(10px); }
to { opacity: 1; transform: translateY(0); }
}
.animate-fade-in {
animation: fade-in 0.6s ease-out forwards;
}
.animate-fade-in-delay {
animation: fade-in 0.6s ease-out 0.2s forwards;
opacity: 0;
}
/* Landing page specific styles */
.bg-background {
background-color: #000000;
}
.bg-surface {
background-color: rgba(24, 24, 27, 0.5);
}
+18
View File
@@ -0,0 +1,18 @@
import { RootProvider } from 'fumadocs-ui/provider/next'
import './global.css'
import { Inter } from 'next/font/google'
const inter = Inter({
subsets: ['latin'],
weight: ['400', '500', '600', '700'],
})
export default function Layout({ children }: { children: React.ReactNode }) {
return (
<html lang="en" className={inter.className} suppressHydrationWarning>
<body className="flex flex-col min-h-screen">
<RootProvider>{children}</RootProvider>
</body>
</html>
)
}
File diff suppressed because one or more lines are too long
+55
View File
@@ -0,0 +1,55 @@
import React from 'react';
interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
variant?: 'primary' | 'secondary' | 'outline' | 'ghost';
fullWidth?: boolean;
isLoading?: boolean;
}
const BASE_STYLES = "inline-flex items-center justify-center px-6 py-3 text-sm font-medium transition-all duration-200 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-offset-black disabled:opacity-50 font-mono tracking-tight";
const VARIANT_STYLES = {
primary: "bg-white text-black hover:bg-zinc-200 border border-white",
secondary: "bg-zinc-900 text-zinc-100 hover:bg-zinc-800 border border-zinc-800",
outline: "bg-transparent text-zinc-300 border border-zinc-700 hover:border-zinc-500 hover:text-white",
ghost: "bg-transparent text-zinc-400 hover:text-white hover:bg-zinc-900"
} as const;
export function Button({
children,
variant = 'primary',
className = '',
fullWidth = false,
isLoading = false,
disabled,
type = 'button',
...props
}: ButtonProps): React.ReactElement {
const widthClass = fullWidth ? 'w-full' : '';
const classes = [
BASE_STYLES,
VARIANT_STYLES[variant],
widthClass,
className,
].filter(Boolean).join(' ');
return (
<button
className={classes}
type={type}
disabled={disabled || isLoading}
{...props}
>
{isLoading ? (
<>
<svg className="animate-spin -ml-1 mr-2 h-4 w-4" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24">
<circle className="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" strokeWidth="4"></circle>
<path className="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z"></path>
</svg>
PROCESSING
</>
) : children}
</button>
);
}
+49
View File
@@ -0,0 +1,49 @@
import React from 'react';
interface CardProps {
children: React.ReactNode;
className?: string;
noPadding?: boolean;
onClick?: () => void;
onDragOver?: (e: React.DragEvent) => void;
onDragLeave?: (e: React.DragEvent) => void;
onDrop?: (e: React.DragEvent) => void;
}
export function Card({
children,
className = '',
noPadding = false,
onClick,
onDragOver,
onDragLeave,
onDrop
}: CardProps): React.ReactElement {
const paddingClass = noPadding ? '' : 'p-6';
const clickableClass = onClick ? 'cursor-pointer' : '';
function handleKeyDown(e: React.KeyboardEvent): void {
if (!onClick) return;
if (e.key === 'Enter' || e.key === ' ') {
if (e.key === ' ') {
e.preventDefault();
}
onClick();
}
}
return (
<div
className={`relative bg-black border border-zinc-800 transition-colors duration-300 ${paddingClass} ${clickableClass} ${className}`}
onClick={onClick}
role={onClick ? 'button' : undefined}
tabIndex={onClick ? 0 : undefined}
onKeyDown={onClick ? handleKeyDown : undefined}
onDragOver={onDragOver}
onDragLeave={onDragLeave}
onDrop={onDrop}
>
{children}
</div>
);
}
+103
View File
@@ -0,0 +1,103 @@
import React, { useState } from 'react';
interface CommandGroup {
name: string;
commands: Array<{ cmd: string; desc: string }>;
}
const COMMAND_GROUPS: CommandGroup[] = [
{
name: 'Core',
commands: [
{ cmd: 'install', desc: 'Install from GitHub/GitLab/local' },
{ cmd: 'sync', desc: 'Sync skills across agents' },
{ cmd: 'translate', desc: 'Convert between agent formats' },
{ cmd: 'update', desc: 'Update installed skills' },
],
},
{
name: 'Discovery',
commands: [
{ cmd: 'find', desc: 'Search marketplace (15K+ skills)' },
{ cmd: 'recommend', desc: 'AI-powered suggestions' },
{ cmd: 'check', desc: 'Dry-run update check' },
{ cmd: 'list', desc: 'View installed skills' },
],
},
{
name: 'Team',
commands: [
{ cmd: 'manifest init', desc: 'Create .skills file' },
{ cmd: 'manifest install', desc: 'Install from manifest' },
{ cmd: 'team share', desc: 'Share skills via Git' },
{ cmd: 'publish', desc: 'Submit to marketplace' },
],
},
{
name: 'Advanced',
commands: [
{ cmd: 'ui', desc: 'Launch terminal UI' },
{ cmd: 'workflow run', desc: 'Execute skill pipelines' },
{ cmd: 'command generate', desc: 'Create /slash commands' },
{ cmd: 'cicd init', desc: 'Generate CI templates' },
],
},
];
export function Commands(): React.ReactElement {
const [activeGroup, setActiveGroup] = useState(0);
const group = COMMAND_GROUPS[activeGroup];
return (
<section className="py-12 border-b border-zinc-800">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="text-center mb-8">
<h2 className="text-xl font-bold text-white mb-2 font-mono">40+ Commands</h2>
<p className="text-zinc-500 font-mono text-sm">
Everything you need from the terminal.
</p>
</div>
<div className="flex justify-center gap-2 mb-6">
{COMMAND_GROUPS.map((g, i) => {
const isActive = i === activeGroup;
const buttonClass = isActive
? 'border-white text-white bg-zinc-900'
: 'border-zinc-800 text-zinc-500 hover:border-zinc-600 hover:text-zinc-300';
return (
<button
key={g.name}
onClick={() => setActiveGroup(i)}
className={`px-3 py-1.5 text-xs font-mono border transition-colors ${buttonClass}`}
>
{g.name}
</button>
);
})}
</div>
<div className="border border-zinc-800 bg-black/50 p-4 font-mono text-xs">
<div className="grid grid-cols-1 sm:grid-cols-2 gap-2">
{group.commands.map((c) => (
<div
key={c.cmd}
className="flex items-center gap-3 p-2 hover:bg-zinc-900/50 transition-colors rounded"
>
<span className="text-zinc-600">$</span>
<span className="text-white">skillkit {c.cmd}</span>
<span className="text-zinc-600 hidden sm:inline">→</span>
<span className="text-zinc-500 hidden sm:inline truncate">{c.desc}</span>
</div>
))}
</div>
</div>
<div className="mt-4 text-center">
<span className="text-zinc-600 text-xs font-mono">
Run <span className="text-zinc-400">skillkit --help</span> for all commands
</span>
</div>
</div>
</section>
);
}
@@ -0,0 +1,498 @@
'use client'
import React, { useState } from 'react';
interface DocSection {
id: string;
title: string;
content: React.ReactNode;
}
const CodeBlock = ({ children, language = 'bash' }: { children: string; language?: string }) => (
<pre className="bg-zinc-900 border border-zinc-800 rounded-lg p-4 overflow-x-auto text-sm font-mono">
<code className="text-zinc-300">{children}</code>
</pre>
);
const Table = ({ headers, rows }: { headers: string[]; rows: string[][] }) => (
<div className="overflow-x-auto">
<table className="w-full text-sm border-collapse">
<thead>
<tr className="border-b border-zinc-700">
{headers.map((h, i) => (
<th key={i} className="text-left py-2 px-3 text-zinc-300 font-mono font-semibold">{h}</th>
))}
</tr>
</thead>
<tbody>
{rows.map((row, i) => (
<tr key={i} className="border-b border-zinc-800 hover:bg-zinc-900/50">
{row.map((cell, j) => (
<td key={j} className="py-2 px-3 text-zinc-400 font-mono">{cell}</td>
))}
</tr>
))}
</tbody>
</table>
</div>
);
const sections: DocSection[] = [
{
id: 'overview',
title: 'Overview',
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.
</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">Team Collaboration</span> - Share skills via .skills manifest files and publish to marketplace</li>
</ul>
</div>
),
},
{
id: 'installation',
title: 'Installation',
content: (
<div className="space-y-4">
<h3 className="text-lg font-semibold text-white">Quick Start</h3>
<CodeBlock>{`# Install globally via npm
npm install -g skillkit
# Or use npx directly
npx skillkit --help
# Or install via pnpm
pnpm add -g skillkit`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Verify Installation</h3>
<CodeBlock>{`skillkit --version
skillkit --help`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">First Steps</h3>
<CodeBlock>{`# Initialize SkillKit in your project
skillkit init
# Browse available skills
skillkit marketplace
# Get AI-powered recommendations
skillkit recommend
# Install skills from a source
skillkit install anthropics/skills`}</CodeBlock>
</div>
),
},
{
id: 'architecture',
title: 'Architecture',
content: (
<div className="space-y-4">
<p className="text-zinc-300">
SkillKit employs a three-tier design with clean separation of concerns:
</p>
<h3 className="text-lg font-semibold text-white mt-6">System Tiers</h3>
<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>
</ul>
<h3 className="text-lg font-semibold text-white mt-6">Monorepo Structure</h3>
<CodeBlock language="text">{`skillkit-monorepo (pnpm workspace + Turbo)
├── apps/skillkit/ → Main CLI application (bin: skillkit, sk)
├── packages/core/ → Core business logic (no internal dependencies)
├── packages/agents/ → Agent adapters (depends on core)
├── packages/cli/ → Command implementations (depends on core, agents, tui)
├── packages/tui/ → Terminal UI (depends on core, agents)
└── docs/skillkit/ → Documentation website`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Dependency Hierarchy</h3>
<ul className="list-disc list-inside space-y-2 text-zinc-400">
<li><code className="text-emerald-400">@skillkit/core</code> → Foundation (no SkillKit dependencies)</li>
<li><code className="text-emerald-400">@skillkit/agents</code> → Adapters (depends on core)</li>
<li><code className="text-emerald-400">@skillkit/cli</code>, <code className="text-emerald-400">@skillkit/tui</code> → UIs (depend on core and agents)</li>
<li><code className="text-emerald-400">skillkit</code> app → Orchestrates all packages</li>
</ul>
</div>
),
},
{
id: 'agents',
title: 'Supported Agents',
content: (
<div className="space-y-4">
<p className="text-zinc-300">
SkillKit supports 32 AI coding agents with automatic format translation:
</p>
<Table
headers={['Agent', 'Directory', 'Format']}
rows={[
['Claude Code', '.claude/skills/', 'SKILL.md'],
['Cursor', '.cursor/skills/', '.mdc'],
['GitHub Copilot', '.github/skills/', 'Markdown'],
['Gemini CLI', '.gemini/skills/', 'SKILL.md'],
['Windsurf', '.windsurf/skills/', 'Markdown'],
['Codex', '.codex/skills/', 'SKILL.md'],
['OpenCode', '.opencode/skills/', 'SKILL.md'],
['Antigravity', '.antigravity/skills/', 'SKILL.md'],
['Amp', '.amp/skills/', 'SKILL.md'],
['Clawdbot', '.clawdbot/skills/', 'SKILL.md'],
['Cline', '.cline/skills/', 'SKILL.md'],
['CodeBuddy', '.codebuddy/skills/', 'SKILL.md'],
['CommandCode', '.commandcode/skills/', 'SKILL.md'],
['Continue', '.continue/skills/', 'SKILL.md'],
['Crush', '.crush/skills/', 'SKILL.md'],
['Droid', '.factory/skills/', 'SKILL.md'],
['Factory', '.factory/skills/', 'SKILL.md'],
['Goose', '.goose/skills/', 'SKILL.md'],
['Kilo', '.kilocode/skills/', 'SKILL.md'],
['Kiro CLI', '.kiro/skills/', 'SKILL.md'],
['MCPJam', '.mcpjam/skills/', 'SKILL.md'],
['Mux', '.mux/skills/', 'SKILL.md'],
['Neovate', '.neovate/skills/', 'SKILL.md'],
['OpenHands', '.openhands/skills/', 'SKILL.md'],
['Pi', '.pi/skills/', 'SKILL.md'],
['Qoder', '.qoder/skills/', 'SKILL.md'],
['Qwen', '.qwen/skills/', 'SKILL.md'],
['Roo', '.roo/skills/', 'SKILL.md'],
['Trae', '.trae/skills/', 'SKILL.md'],
['Vercel', '.vercel/skills/', 'SKILL.md'],
['Zencoder', '.zencoder/skills/', 'SKILL.md'],
['Universal', 'skills/', 'SKILL.md'],
]}
/>
</div>
),
},
{
id: 'commands',
title: 'CLI Commands',
content: (
<div className="space-y-4">
<h3 className="text-lg font-semibold text-white">Skill Management</h3>
<CodeBlock>{`skillkit install <source> # Install skills from source
skillkit remove <skill> # Remove installed skill
skillkit update [skill] # Update skills
skillkit list # List installed skills
skillkit sync # Sync skills across agents
skillkit enable <skill> # Enable a skill
skillkit disable <skill> # Disable a skill`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Discovery</h3>
<CodeBlock>{`skillkit recommend # AI-powered skill recommendations
skillkit marketplace # Browse marketplace skills
skillkit find <query> # Search for skills
skillkit search <term> # Search skill content`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Translation</h3>
<CodeBlock>{`skillkit translate --from claude --to cursor <skill>
skillkit agent translate <skill> --target cursor
skillkit context sync # Sync context across agents`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Team Collaboration</h3>
<CodeBlock>{`skillkit manifest init # Initialize .skills manifest
skillkit manifest add <source> # Add source to manifest
skillkit manifest install # Install from manifest
skillkit publish # Publish skill to marketplace
skillkit cicd init # Setup CI/CD integration`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Advanced</h3>
<CodeBlock>{`skillkit ui # Launch Terminal UI
skillkit workflow # Manage workflows
skillkit memory compress # Compress memory
skillkit memory export # Export memory
skillkit test # Run skill tests
skillkit validate # Validate skill format & quality`}</CodeBlock>
</div>
),
},
{
id: 'configuration',
title: 'Configuration',
content: (
<div className="space-y-4">
<h3 className="text-lg font-semibold text-white">Project Configuration (skillkit.yaml)</h3>
<CodeBlock language="yaml">{`version: 1
agent: cursor
autoSync: true
enabledSkills:
- pdf
- xlsx
disabledSkills:
- deprecated-skill`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Team Manifest (.skills)</h3>
<CodeBlock>{`# Team-wide skill sources
anthropics/skills
vercel-labs/agent-skills
./local-skills
owner/repo@v1.2.3`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">User Preferences (~/.skillkit/preferences.json)</h3>
<CodeBlock language="json">{`{
"lastSelectedAgents": ["claude", "cursor"],
"autoSync": true,
"marketplace": {
"lastRefresh": "2024-01-01T00:00:00Z"
}
}`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">File System Layout</h3>
<CodeBlock language="text">{`project/
├── .skillkit/ # Project config & memory
├── .claude/skills/ # Claude Code skills
├── .cursor/skills/ # Cursor AI skills
├── .github/skills/ # GitHub Copilot skills
├── skills/ # Universal format
└── .skills # Team manifest file
~/.skillkit/ # Global user config
├── preferences.json
├── memory/
└── cache/`}</CodeBlock>
</div>
),
},
{
id: 'api',
title: 'API Reference',
content: (
<div className="space-y-4">
<h3 className="text-lg font-semibold text-white">Package Exports</h3>
<p className="text-zinc-300">@skillkit/core provides multiple entry points for programmatic use:</p>
<CodeBlock language="typescript">{`import { findAllSkills, findSkill } from '@skillkit/core/discovery';
import { parseSkillFile } from '@skillkit/core/parser';
import { translateSkill } from '@skillkit/core/translator';
import { syncContext } from '@skillkit/core/context';
import { getRecommendations } from '@skillkit/core/recommend';
import { evaluateSkillContent, getQualityGrade } from '@skillkit/core/quality';`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Core Functions</h3>
<CodeBlock language="typescript">{`// Discovery
findAllSkills(searchDirs: string[]): SkillInfo[]
findSkill(name: string, searchDirs: string[]): SkillInfo | null
// Parsing
parseSkillFile(filePath: string): ParsedSkill
parseSkillContent(content: string): ParsedSkill
// Translation
translateSkill(skill: ParsedSkill, targetAgent: AgentType): string
getAgentAdapter(agent: AgentType): AgentAdapter
// Quality Evaluation
evaluateSkillContent(content: string): QualityScore
evaluateSkillFile(filePath: string): QualityScore
getQualityGrade(score: number): 'A' | 'B' | 'C' | 'D' | 'F'
isHighQuality(score: QualityScore): boolean
// Recommendations
getRecommendations(context: ProjectContext): Recommendation[]`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Type Definitions</h3>
<CodeBlock language="typescript">{`interface SkillInfo {
name: string;
path: string;
agent: AgentType;
enabled: boolean;
}
interface ParsedSkill {
name: string;
description?: string;
globs?: string[];
triggers?: string[];
content: string;
frontmatter: Record<string, unknown>;
}
interface QualityScore {
overall: number;
structure: StructureScore;
clarity: ClarityScore;
specificity: SpecificityScore;
advanced: AdvancedScore;
warnings: string[];
suggestions: string[];
}
type AgentType =
| 'claude-code' | 'cursor' | 'codex' | 'gemini-cli'
| 'opencode' | 'antigravity' | 'amp' | 'clawdbot'
| 'droid' | 'github-copilot' | 'goose' | 'kilo'
| 'kiro-cli' | 'roo' | 'trae' | 'windsurf' | 'universal';`}</CodeBlock>
</div>
),
},
{
id: 'skill-format',
title: 'Skill Format',
content: (
<div className="space-y-4">
<h3 className="text-lg font-semibold text-white">SKILL.md Structure</h3>
<p className="text-zinc-300">Skills use YAML frontmatter followed by markdown content:</p>
<CodeBlock language="markdown">{`---
name: my-skill
description: A helpful skill for coding tasks
globs:
- "**/*.ts"
- "**/*.tsx"
triggers:
- "when working with TypeScript"
- "when creating React components"
---
# My Skill
## When to Use
Use this skill when:
- Working with TypeScript files
- Creating React components
## Instructions
Follow these guidelines:
1. Always use TypeScript strict mode
2. Prefer functional components
\`\`\`typescript
function Example(): JSX.Element {
return <div>Hello</div>;
}
\`\`\`
## Boundaries
This skill should NOT:
- Modify configuration files without asking
- Delete existing code without confirmation`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Quality Scoring</h3>
<p className="text-zinc-300">Skills are evaluated on four dimensions:</p>
<Table
headers={['Dimension', 'Weight', 'Criteria']}
rows={[
['Structure', '35%', 'Metadata, description, triggers, examples, boundaries'],
['Clarity', '25%', 'Line count, token count, headers, readability'],
['Specificity', '25%', 'Concrete commands, file patterns, code examples'],
['Advanced', '15%', 'No deprecated patterns, security issues, completeness'],
]}
/>
<h3 className="text-lg font-semibold text-white mt-6">Grade Scale</h3>
<Table
headers={['Grade', 'Score Range', 'Description']}
rows={[
['A', '90-100', 'Excellent - Production ready'],
['B', '80-89', 'Good - Minor improvements possible'],
['C', '70-79', 'Acceptable - Some issues to address'],
['D', '60-69', 'Poor - Significant improvements needed'],
['F', '0-59', 'Failing - Major revision required'],
]}
/>
</div>
),
},
{
id: 'tech-stack',
title: 'Technology Stack',
content: (
<div className="space-y-4">
<Table
headers={['Layer', 'Technology']}
rows={[
['CLI Framework', 'Clipanion v4'],
['TUI Framework', '@opentui/react v0.1.75'],
['Validation', 'Zod v3.24'],
['YAML Parsing', 'yaml v2.6'],
['Git Operations', 'isomorphic-git v1.27'],
['HTTP Client', 'got v14.4'],
['Build System', 'Turbo v2.3, tsup v8.3, pnpm v9.0'],
['Testing', 'Vitest v2.1'],
['Runtime', 'Node.js 18+, Bun 1.2+ (for TUI)'],
]}
/>
<h3 className="text-lg font-semibold text-white mt-6">Build Commands</h3>
<CodeBlock>{`pnpm build # Build all packages via Turbo
pnpm dev # Watch mode development
pnpm test # Unit tests via Vitest
pnpm test:e2e # End-to-end tests
pnpm typecheck # Type checking
pnpm clean # Remove build artifacts`}</CodeBlock>
</div>
),
},
];
export function Documentation(): React.ReactElement {
const [activeSection, setActiveSection] = useState('overview');
const currentSection = sections.find(s => s.id === activeSection) || sections[0];
return (
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="text-center mb-8">
<h2 className="text-2xl font-bold text-white mb-2 font-mono">Documentation</h2>
<p className="text-zinc-400 font-mono text-sm">
Complete guide to using SkillKit
</p>
<a
href="https://deepwiki.com/rohitg00/skillkit"
target="_blank"
rel="noreferrer noopener"
className="inline-flex items-center gap-2 mt-2 text-xs text-zinc-500 hover:text-zinc-300 transition-colors"
>
<span>Powered by DeepWiki</span>
<svg className="w-3 h-3" fill="none" stroke="currentColor" viewBox="0 0 24 24">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M10 6H6a2 2 0 00-2 2v10a2 2 0 002 2h10a2 2 0 002-2v-4M14 4h6m0 0v6m0-6L10 14" />
</svg>
</a>
</div>
<div className="flex flex-col lg:flex-row gap-8">
<nav className="lg:w-48 flex-shrink-0" aria-label="Documentation sections">
<div className="sticky top-20 space-y-1">
{sections.map(section => (
<button
key={section.id}
type="button"
aria-current={activeSection === section.id ? 'page' : undefined}
onClick={() => setActiveSection(section.id)}
className={`w-full text-left px-3 py-2 text-sm font-mono rounded transition-colors ${
activeSection === section.id
? 'bg-white text-black'
: 'text-zinc-400 hover:text-white hover:bg-zinc-800'
}`}
>
{section.title}
</button>
))}
</div>
</nav>
<div className="flex-1 min-w-0">
<div className="bg-surface border border-zinc-800 rounded-lg p-6">
<h2 className="text-xl font-bold text-white mb-6 font-mono">{currentSection.title}</h2>
<div className="prose prose-invert prose-zinc max-w-none">
{currentSection.content}
</div>
</div>
</div>
</div>
</div>
);
}
+145
View File
@@ -0,0 +1,145 @@
import React from 'react';
interface Feature {
title: string;
description: string;
icon: React.ReactNode;
}
const FEATURES: Feature[] = [
{
title: 'Multi-Agent',
description: 'Deploy to 32 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" />
</svg>
)
},
{
title: 'Terminal UI',
description: 'Beautiful interactive TUI for browsing & installing.',
icon: (
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M8 9l3 3-3 3m5 0h3M5 20h14a2 2 0 002-2V6a2 2 0 00-2-2H5a2 2 0 00-2 2v12a2 2 0 002 2z" />
</svg>
)
},
{
title: 'Plugins',
description: 'Extend with custom plugins & hooks.',
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="M17 14v6m-3-3h6M6 10h2a2 2 0 002-2V6a2 2 0 00-2-2H6a2 2 0 00-2 2v2a2 2 0 002 2zm10 0h2a2 2 0 002-2V6a2 2 0 00-2-2h-2a2 2 0 00-2 2v2a2 2 0 002 2zM6 20h2a2 2 0 002-2v-2a2 2 0 00-2-2H6a2 2 0 00-2 2v2a2 2 0 002 2z" />
</svg>
)
},
{
title: 'Manifest',
description: '.skills file for team-wide consistency.',
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 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z" />
</svg>
)
},
{
title: 'CI/CD',
description: 'GitHub, GitLab, CircleCI templates included.',
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="M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15" />
</svg>
)
},
{
title: 'Slash Commands',
description: 'Generate /commands for Claude, Cursor & more.',
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="M7 20l4-16m2 16l4-16M6 9h14M4 15h14" />
</svg>
)
}
];
const COMPARISONS = [
['Agents', '1', '32'],
['Translation', 'Manual', 'Auto'],
['Sharing', 'Copy/paste', '.skills manifest'],
['Discovery', 'Forums', 'CLI + AI'],
['CI/CD', 'Custom', 'Templates'],
] as const;
export function Features(): React.ReactElement {
return (
<section id="features" className="py-12 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="lg:col-span-2">
<h2 className="text-xl font-bold text-white mb-2 font-mono">Why SkillKit?</h2>
<p className="text-zinc-500 font-mono text-sm mb-6">
Universal bridge for AI coding agents.
</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-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">40+</div>
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Commands</div>
</div>
<div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">15K</div>
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Skills</div>
</div>
</div>
</div>
<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 className="text-right">SkillKit</div>
</div>
<div className="space-y-1">
{COMPARISONS.map(([feature, without, withSkillKit], index) => (
<div
key={feature}
className="grid grid-cols-3 gap-2 items-center py-1.5 hover:bg-zinc-900/50 transition-colors -mx-2 px-2 rounded"
style={{ animationDelay: `${index * 100}ms` }}
>
<div className="text-zinc-300">{feature}</div>
<div className="text-center text-zinc-600">{without}</div>
<div className="text-right text-white font-medium">{withSkillKit}</div>
</div>
))}
</div>
</div>
</div>
<div className="grid grid-cols-1 xs:grid-cols-2 md:grid-cols-3 lg:grid-cols-6 gap-3">
{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"
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">
{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">
{feature.description}
</p>
</div>
</div>
))}
</div>
</div>
</section>
);
}
+41
View File
@@ -0,0 +1,41 @@
import React from 'react';
const GITHUB_ICON = (
<svg className="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
<path fillRule="evenodd" d="M12 2C6.477 2 2 6.484 2 12.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.531 1.032 1.531 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0112 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.202 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.943.359.309.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482A10.019 10.019 0 0022 12.017C22 6.484 17.522 2 12 2z" clipRule="evenodd" />
</svg>
);
export function Footer(): React.ReactElement {
const currentYear = new Date().getFullYear();
return (
<footer className="border-t border-border py-6 bg-black">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8 flex flex-col sm:flex-row justify-between items-center gap-3">
<div className="flex flex-col sm:flex-row items-center gap-2 sm:gap-4 text-center sm:text-left">
<p className="text-zinc-500 text-xs font-mono">
&copy; {currentYear} SKILLKIT
</p>
<span className="hidden sm:inline text-zinc-700">•</span>
<a
href="https://agentskills.io"
target="_blank"
rel="noopener noreferrer"
className="text-zinc-600 hover:text-zinc-400 text-xs font-mono transition-colors"
>
Agent Skills standard
</a>
</div>
<a
href="https://github.com/rohitg00/skillkit"
target="_blank"
rel="noopener noreferrer"
aria-label="SkillKit on GitHub"
className="text-zinc-500 hover:text-white transition-colors"
>
{GITHUB_ICON}
</a>
</div>
</footer>
);
}
+212
View File
@@ -0,0 +1,212 @@
import React, { useState, useEffect } from 'react';
import { Button } from './Button';
const ASCII_LOGO = `
███████ ██ ██ ██ ██ ██ ██ ██ ██ ████████
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
███████ █████ ██ ██ ██ █████ ██ ██
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
███████ ██ ██ ██ ███████ ███████ ██ ██ ██ ██
`.trim();
interface TerminalLine {
type: 'cmd' | 'out';
text: string;
}
const TERMINAL_LINES: TerminalLine[] = [
{ type: 'cmd', text: 'skillkit find react' },
{ type: 'out', text: ' ■ react-patterns ★★★★★' },
{ type: 'out', text: ' ■ react-testing ★★★★☆' },
{ type: 'cmd', text: 'skillkit install anthropics/skills' },
{ type: 'out', text: '→ 3 skills → 5 agents' },
{ type: 'cmd', text: 'skillkit ui' },
{ type: 'out', text: '→ Launching TUI...' },
{ type: 'cmd', text: 'skillkit check' },
{ type: 'out', text: ' ✓ All skills up to date' },
{ type: 'cmd', text: 'skillkit manifest install' },
{ type: 'out', text: '→ 12 skills from .skills' },
];
const FADE_ANIMATION_STYLES = `
@keyframes fade-in {
from { opacity: 0; transform: translateY(10px); }
to { opacity: 1; transform: translateY(0); }
}
.animate-fade-in {
animation: fade-in 0.6s ease-out forwards;
}
.animate-fade-in-delay {
animation: fade-in 0.6s ease-out 0.2s forwards;
opacity: 0;
}
`;
const CHECK_ICON = (
<svg className="w-4 h-4 text-white" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M5 13l4 4L19 7" />
</svg>
);
const COPY_ICON = (
<svg className="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M8 5H6a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2v-1M8 5a2 2 0 002 2h2a2 2 0 002-2M8 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4" />
</svg>
);
export function Hero(): React.ReactElement {
const [copied, setCopied] = useState(false);
const [visibleLines, setVisibleLines] = useState(0);
const [typingIndex, setTypingIndex] = useState(0);
const [currentText, setCurrentText] = useState('');
useEffect(() => {
if (visibleLines >= TERMINAL_LINES.length) {
const resetTimer = setTimeout(() => {
setVisibleLines(0);
setTypingIndex(0);
setCurrentText('');
}, 3000);
return () => clearTimeout(resetTimer);
}
const line = TERMINAL_LINES[visibleLines];
if (line.type === 'cmd') {
if (typingIndex < line.text.length) {
const timer = setTimeout(() => {
setCurrentText(line.text.slice(0, typingIndex + 1));
setTypingIndex(typingIndex + 1);
}, 40);
return () => clearTimeout(timer);
}
const timer = setTimeout(() => {
setVisibleLines(visibleLines + 1);
setTypingIndex(0);
setCurrentText('');
}, 200);
return () => clearTimeout(timer);
}
const timer = setTimeout(() => {
setVisibleLines(visibleLines + 1);
}, 150);
return () => clearTimeout(timer);
}, [visibleLines, typingIndex]);
async function copyInstall(): Promise<void> {
try {
await navigator.clipboard.writeText('npx skillkit@latest');
setCopied(true);
setTimeout(() => setCopied(false), 2000);
} catch {
// Clipboard API failed, silently ignore
}
}
function openGitHub(): void {
window.open('https://github.com/rohitg00/skillkit', '_blank', 'noopener,noreferrer');
}
const isTyping = visibleLines < TERMINAL_LINES.length && TERMINAL_LINES[visibleLines].type === 'cmd';
const isComplete = visibleLines >= TERMINAL_LINES.length;
return (
<div className="relative border-b border-zinc-800 overflow-hidden">
<div className="absolute inset-0 bg-gradient-to-b from-zinc-900/50 to-transparent pointer-events-none"></div>
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8 pt-8 pb-10 relative">
<div className="hidden lg:block mb-6 overflow-hidden">
<pre className="text-zinc-700 text-[10px] leading-tight font-mono select-none whitespace-pre">
{ASCII_LOGO}
</pre>
</div>
<div className="grid grid-cols-1 lg:grid-cols-2 gap-6 lg:gap-8 items-start">
<div className="animate-fade-in">
<div className="inline-flex items-center space-x-2 border border-zinc-800 bg-zinc-900/50 px-2 py-0.5 mb-3 backdrop-blur-sm">
<span className="flex h-1.5 w-1.5 bg-white rounded-full"></span>
<span className="text-xs font-mono text-zinc-400">v1.7.5</span>
</div>
<h1 className="text-2xl sm:text-3xl lg:text-4xl font-bold tracking-tight text-white mb-3 font-mono">
Universal Skills for<br />
<span className="text-zinc-500">AI Coding Agents</span>
</h1>
<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.
</p>
<div className="flex flex-wrap items-center gap-3 mb-4">
<button
onClick={copyInstall}
className="inline-flex items-center bg-black border border-zinc-700 px-3 py-2 hover:border-zinc-500 transition-colors"
>
<span className="text-zinc-500 mr-2 select-none">$</span>
<span className="font-mono text-zinc-100 text-sm">npx skillkit@latest</span>
<span className="ml-2 text-zinc-500 hover:text-white transition-colors flex items-center gap-1">
{copied ? (
<>
{CHECK_ICON}
<span className="text-xs text-green-400">Copied!</span>
</>
) : (
COPY_ICON
)}
</span>
</button>
<Button variant="outline" onClick={openGitHub}>
GITHUB
</Button>
</div>
</div>
<div className="hidden lg:block relative animate-fade-in-delay w-full">
<div className="absolute -inset-1 bg-gradient-to-r from-zinc-800 via-zinc-700 to-zinc-800 rounded-lg opacity-20 blur-lg"></div>
<div className="relative border border-zinc-800 bg-black rounded-lg overflow-hidden">
<div className="flex items-center gap-1.5 px-3 py-2 border-b border-zinc-800 bg-zinc-900/50">
<div className="w-2.5 h-2.5 rounded-full bg-zinc-700"></div>
<div className="w-2.5 h-2.5 rounded-full bg-zinc-700"></div>
<div className="w-2.5 h-2.5 rounded-full bg-zinc-700"></div>
<span className="ml-2 text-zinc-500 text-xs font-mono">skillkit</span>
</div>
<div className="p-4 font-mono text-xs min-h-[200px] max-h-[280px]">
{TERMINAL_LINES.slice(0, visibleLines).map((line, index) => (
<div key={index} className="mb-1">
{line.type === 'cmd' ? (
<div className="flex items-center">
<span className="text-zinc-600 mr-2">$</span>
<span className="text-zinc-100">{line.text}</span>
</div>
) : (
<div className="pl-4 text-zinc-500">
<span className="text-zinc-400">{line.text.slice(0, 1)}</span>
{line.text.slice(1)}
</div>
)}
</div>
))}
{isTyping && (
<div className="flex items-center">
<span className="text-zinc-600 mr-2">$</span>
<span className="text-zinc-100">{currentText}</span>
<span className="w-2 h-4 bg-zinc-400 ml-0.5 animate-pulse"></span>
</div>
)}
{isComplete && (
<div className="flex items-center mt-1">
<span className="text-zinc-600 mr-2">$</span>
<span className="w-2 h-4 bg-zinc-600 animate-pulse"></span>
</div>
)}
</div>
</div>
</div>
</div>
</div>
<style>{FADE_ANIMATION_STYLES}</style>
</div>
);
}
@@ -0,0 +1,687 @@
'use client';
import React, { useState, useRef, useEffect } from 'react';
import { Button } from './Button';
import { Card } from './Card';
import { generateAgentSkill } from '../services/geminiService';
import { searchSkills, IndexedSkill } from '../data/skills-index';
import { AgentSkill, LoadingState } from '../types';
interface PriorityBadgeProps {
priority: string;
}
type ViewMode = 'search' | 'marketplace' | 'generated' | 'content';
const PRIORITY_COLORS = {
must: 'bg-red-900/50 text-red-300 border-red-800',
should: 'bg-yellow-900/50 text-yellow-300 border-yellow-800',
may: 'bg-blue-900/50 text-blue-300 border-blue-800',
} as const;
function escapeYamlString(str: string): string {
if (!str) return '';
return str
.replace(/\\/g, '\\\\')
.replace(/"/g, '\\"')
.replace(/\n/g, '\\n')
.replace(/\r/g, '\\r')
.replace(/\t/g, '\\t');
}
function PriorityBadge({ priority }: PriorityBadgeProps): React.ReactElement {
const colorClass = PRIORITY_COLORS[priority as keyof typeof PRIORITY_COLORS] || PRIORITY_COLORS.may;
return (
<span className={`text-xs px-2 py-0.5 border font-mono uppercase ${colorClass}`}>
{priority}
</span>
);
}
function generateSkillMd(skill: AgentSkill): string {
const escapedTags = skill.tags.length > 0
? skill.tags.map(t => `"${escapeYamlString(t)}"`).join(', ')
: '';
const escapedGlobs = skill.filePatterns?.length
? skill.filePatterns.map(p => `"${escapeYamlString(p)}"`).join(', ')
: '';
const frontmatter = `---
name: "${escapeYamlString(skill.name)}"
description: "${escapeYamlString(skill.description)}"
version: "${escapeYamlString(skill.version)}"
tags: [${escapedTags}]
${escapedGlobs ? `globs: [${escapedGlobs}]` : ''}
---`;
const principlesSection = skill.principles.map(p =>
`### ${p.priority.toUpperCase()}: ${p.title}\n\n${p.description}`
).join('\n\n');
const patternsSection = skill.patterns.map(p =>
`### ${p.name}\n\n${p.description}\n\n\`\`\`${p.language || 'typescript'}\n${p.example}\n\`\`\``
).join('\n\n');
const antiPatternsSection = skill.antiPatterns.map(ap => {
let content = `### ${ap.name}\n\n${ap.description}`;
if (ap.badExample) {
content += `\n\n**Bad:**\n\`\`\`typescript\n${ap.badExample}\n\`\`\``;
}
if (ap.goodExample) {
content += `\n\n**Good:**\n\`\`\`typescript\n${ap.goodExample}\n\`\`\``;
}
return content;
}).join('\n\n');
const content = `# ${skill.title}
${skill.description}
## When to Apply
${skill.applicability}
${skill.filePatterns?.length ? `**File patterns:** ${skill.filePatterns.map(p => `\`${p}\``).join(', ')}` : ''}
## Principles
${principlesSection}
## Patterns
${patternsSection}
## Anti-Patterns
${antiPatternsSection}
${skill.references?.length ? `## References\n\n${skill.references.map(r => `- ${r}`).join('\n')}` : ''}
`;
return `${frontmatter}\n\n${content}`;
}
function downloadContent(content: string, filename: string): void {
const blob = new Blob([content], { type: 'text/markdown' });
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = filename;
document.body.appendChild(a);
a.click();
document.body.removeChild(a);
URL.revokeObjectURL(url);
}
function isValidUrl(str: string): boolean {
try {
new URL(str);
return true;
} catch {
return false;
}
}
// localStorage cache for AI-generated skills
const CACHE_KEY = 'skillkit_ai_cache';
const CACHE_VERSION = 1;
const MAX_CACHE_ENTRIES = 50;
const CACHE_TTL_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
interface CachedSkill {
skill: AgentSkill;
query: string;
timestamp: number;
}
interface SkillCache {
version: number;
skills: Record<string, CachedSkill>;
}
function normalizeQuery(query: string): string {
return query.toLowerCase().trim().replace(/\s+/g, ' ');
}
function getSkillCache(): SkillCache {
try {
const cached = localStorage.getItem(CACHE_KEY);
if (cached) {
const parsed = JSON.parse(cached) as SkillCache;
if (parsed.version === CACHE_VERSION) {
// Prune expired entries
const now = Date.now();
let mutated = false;
for (const [key, value] of Object.entries(parsed.skills)) {
if (!value?.timestamp || now - value.timestamp >= CACHE_TTL_MS) {
delete parsed.skills[key];
mutated = true;
}
}
if (mutated) {
localStorage.setItem(CACHE_KEY, JSON.stringify(parsed));
}
return parsed;
}
}
} catch {
// Ignore parse errors
}
return { version: CACHE_VERSION, skills: {} };
}
function getCachedSkill(query: string): AgentSkill | null {
const cache = getSkillCache();
const key = normalizeQuery(query);
const cached = cache.skills[key];
if (cached && Date.now() - cached.timestamp < CACHE_TTL_MS) {
return cached.skill;
}
return null;
}
function setCachedSkill(query: string, skill: AgentSkill): void {
try {
const cache = getSkillCache();
const key = normalizeQuery(query);
cache.skills[key] = {
skill,
query: key,
timestamp: Date.now(),
};
// Enforce max entries limit
const entries = Object.entries(cache.skills);
if (entries.length > MAX_CACHE_ENTRIES) {
entries
.sort((a, b) => a[1].timestamp - b[1].timestamp)
.slice(0, entries.length - MAX_CACHE_ENTRIES)
.forEach(([k]) => delete cache.skills[k]);
}
localStorage.setItem(CACHE_KEY, JSON.stringify(cache));
} catch {
// Ignore storage errors (quota exceeded, etc.)
}
}
export function SkillGenerator(): React.ReactElement {
const [input, setInput] = useState('');
const [status, setStatus] = useState<LoadingState>(LoadingState.IDLE);
const [viewMode, setViewMode] = useState<ViewMode>('search');
const [marketplaceResults, setMarketplaceResults] = useState<IndexedSkill[]>([]);
const [selectedSkill, setSelectedSkill] = useState<IndexedSkill | null>(null);
const [skillContent, setSkillContent] = useState<string | null>(null);
const [generatedSkill, setGeneratedSkill] = useState<AgentSkill | null>(null);
const [isFromCache, setIsFromCache] = useState(false);
const [activeTab, setActiveTab] = useState<'principles' | 'patterns' | 'antipatterns'>('principles');
const [error, setError] = useState<string | null>(null);
const inputRef = useRef<HTMLInputElement>(null);
function handleSearch(e: React.FormEvent): void {
e.preventDefault();
if (!input.trim()) return;
setError(null);
setSelectedSkill(null);
setSkillContent(null);
setGeneratedSkill(null);
const results = searchSkills(input);
setMarketplaceResults(results);
setViewMode(results.length > 0 ? 'marketplace' : 'search');
setStatus(LoadingState.SUCCESS);
}
async function handleViewSkill(skill: IndexedSkill): Promise<void> {
setSelectedSkill(skill);
setSkillContent(null);
setViewMode('content');
if (skill.rawUrl) {
setStatus(LoadingState.LOADING);
try {
const response = await fetch(skill.rawUrl);
if (response.ok) {
const content = await response.text();
setSkillContent(content);
}
} catch {
// Silently handle fetch errors
}
setStatus(LoadingState.SUCCESS);
}
}
async function handleGenerateWithAI(): Promise<void> {
setError(null);
// Check cache first
const cached = getCachedSkill(input);
if (cached) {
setGeneratedSkill(cached);
setIsFromCache(true);
setViewMode('generated');
setStatus(LoadingState.SUCCESS);
return;
}
setStatus(LoadingState.LOADING);
setIsFromCache(false);
try {
const result = await generateAgentSkill(input);
setGeneratedSkill(result);
setCachedSkill(input, result); // Cache the result
setViewMode('generated');
setStatus(LoadingState.SUCCESS);
} catch {
setError("Failed to generate skill. Please try again.");
setStatus(LoadingState.ERROR);
}
}
function submitToMarketplace(): void {
if (!generatedSkill) return;
const slug = generatedSkill.name.toLowerCase().replace(/\s+/g, '-').replace(/[^a-z0-9-]/g, '');
const skillContent = generateSkillMd(generatedSkill);
const body = `## 📤 AI-Generated Skill: ${generatedSkill.title}
### Skill Details
- **Name:** ${generatedSkill.name}
- **Description:** ${generatedSkill.description}
- **Tags:** ${generatedSkill.tags.join(', ')}
- **Version:** ${generatedSkill.version}
### SKILL.md Content
<details>
<summary>Click to expand</summary>
\`\`\`markdown
${skillContent.slice(0, 4000)}${skillContent.length > 4000 ? '\n...(truncated)' : ''}
\`\`\`
</details>
### Checklist for Maintainer
- [ ] Review skill content for quality
- [ ] Add to \`marketplace/skills.json\`
---
**Generated via:** AI Skill Generator
**Search query:** "${input}"`;
const title = encodeURIComponent(`[AI Skill] ${generatedSkill.title}`);
const encodedBody = encodeURIComponent(body);
const url = `https://github.com/rohitg00/skillkit/issues/new?title=${title}&body=${encodedBody}&labels=ai-generated,skill-submission`;
window.open(url, '_blank', 'noopener,noreferrer');
}
function handleBack(): void {
switch (viewMode) {
case 'content':
setViewMode('marketplace');
setSelectedSkill(null);
setSkillContent(null);
break;
case 'generated':
setViewMode(marketplaceResults.length > 0 ? 'marketplace' : 'search');
setGeneratedSkill(null);
break;
default:
setViewMode('search');
setMarketplaceResults([]);
}
}
function downloadSkillMd(): void {
if (skillContent) {
downloadContent(skillContent, 'SKILL.md');
}
}
function downloadGeneratedSkillMd(): void {
if (generatedSkill) {
downloadContent(generateSkillMd(generatedSkill), 'SKILL.md');
}
}
// Focus input only after user interaction, not on initial page load
useEffect(() => {
if (status === LoadingState.SUCCESS && inputRef.current) {
inputRef.current.focus({ preventScroll: true });
}
}, [status]);
return (
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8 py-8">
<div className="mb-6">
<h2 className="text-xl font-bold text-white mb-1 font-sans">Skill Finder</h2>
<p className="text-zinc-400 font-mono text-xs">
Search the marketplace or generate new skills with AI.
</p>
</div>
<form onSubmit={handleSearch} className="mb-6">
<div className="flex flex-col sm:flex-row gap-3">
<input
ref={inputRef}
type="text"
value={input}
onChange={(e) => setInput(e.target.value)}
placeholder="e.g., React hooks, TypeScript, Next.js..."
className="flex-1 bg-surface border border-zinc-700 text-white px-4 py-3 focus:ring-2 focus:ring-white focus:border-transparent outline-none font-mono text-sm placeholder-zinc-600"
disabled={status === LoadingState.LOADING}
/>
<Button type="submit" isLoading={status === LoadingState.LOADING} className="sm:w-auto w-full">
SEARCH
</Button>
</div>
{error && <p className="mt-2 text-red-400 font-mono text-xs">{error}</p>}
</form>
{viewMode !== 'search' && status !== LoadingState.LOADING && (
<button
onClick={handleBack}
className="mb-6 text-zinc-400 hover:text-white font-mono text-sm flex items-center gap-2 transition-colors"
>
<svg xmlns="http://www.w3.org/2000/svg" className="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M15 19l-7-7 7-7" />
</svg>
Back
</button>
)}
{viewMode === 'marketplace' && status === LoadingState.SUCCESS && (
<div className="animate-fade-in-up">
<div className="flex items-center justify-between mb-6">
<h3 className="text-lg font-mono text-zinc-300">
Found {marketplaceResults.length} skill{marketplaceResults.length !== 1 ? 's' : ''} in marketplace
</h3>
</div>
<div className="space-y-3 mb-8">
{marketplaceResults.map((skill) => (
<Card
key={skill.id}
className="hover:border-zinc-500 cursor-pointer transition-all"
onClick={() => handleViewSkill(skill)}
>
<div className="flex items-start justify-between">
<div className="flex-1">
<h4 className="text-lg font-semibold text-white mb-1">{skill.name}</h4>
<p className="text-zinc-400 text-sm mb-2">{skill.description || 'No description'}</p>
<div className="flex items-center gap-2 text-xs text-zinc-500 font-mono">
<span>{skill.source}</span>
</div>
</div>
<svg xmlns="http://www.w3.org/2000/svg" className="h-5 w-5 text-zinc-600" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5l7 7-7 7" />
</svg>
</div>
{skill.tags.length > 0 && (
<div className="flex flex-wrap gap-1 mt-3">
{skill.tags.slice(0, 5).map((tag, idx) => (
<span key={idx} className="text-xs bg-zinc-900 text-zinc-500 px-2 py-0.5 border border-zinc-800">
{tag}
</span>
))}
</div>
)}
</Card>
))}
</div>
<div className="border-t border-zinc-800 pt-6">
<p className="text-zinc-500 font-mono text-sm mb-4">
Don't see what you need? Generate a custom skill with AI.
</p>
<Button onClick={handleGenerateWithAI}>
GENERATE WITH AI
</Button>
</div>
</div>
)}
{viewMode === 'search' && status === LoadingState.SUCCESS && marketplaceResults.length === 0 && input && (
<div className="animate-fade-in-up text-center py-4">
<div className="text-zinc-500 font-mono text-sm mb-4">
No skills found for "{input}" in the marketplace.
</div>
<Button onClick={handleGenerateWithAI}>
GENERATE WITH AI
</Button>
</div>
)}
{viewMode === 'content' && selectedSkill && (
<div className="animate-fade-in-up">
<div className="flex items-start justify-between mb-6 border-b border-zinc-800 pb-6">
<div>
<h3 className="text-2xl font-bold text-white mb-2">{selectedSkill.name}</h3>
<p className="text-zinc-400 font-mono text-sm mb-2">{selectedSkill.description}</p>
<div className="flex items-center gap-2 text-xs text-zinc-500 font-mono">
<span>{selectedSkill.source}</span>
{selectedSkill.sourceUrl && (
<>
<span>•</span>
<a href={selectedSkill.sourceUrl} target="_blank" rel="noopener noreferrer" className="hover:text-white">
View on GitHub
</a>
</>
)}
</div>
</div>
{skillContent && (
<button
onClick={downloadSkillMd}
className="flex items-center gap-2 bg-white text-black px-4 py-2 font-mono text-sm hover:bg-zinc-200 transition-colors shrink-0 ml-4"
>
<svg xmlns="http://www.w3.org/2000/svg" className="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-4l-4 4m0 0l-4-4m4 4V4" />
</svg>
DOWNLOAD
</button>
)}
</div>
{status === LoadingState.LOADING ? (
<div className="text-zinc-500 font-mono text-sm">Loading content...</div>
) : skillContent ? (
<pre className="bg-zinc-900 border border-zinc-700 p-6 overflow-x-auto text-sm max-h-[600px] overflow-y-auto">
<code className="text-zinc-100 font-mono whitespace-pre-wrap">{skillContent}</code>
</pre>
) : (
<div className="bg-zinc-950 border border-zinc-800 p-6">
<p className="text-zinc-400 font-mono text-sm mb-4">
Skill content not available for direct preview.
</p>
<a
href={selectedSkill.sourceUrl}
target="_blank"
rel="noopener noreferrer"
className="inline-flex items-center gap-2 bg-zinc-800 text-white px-4 py-2 font-mono text-sm hover:bg-zinc-700 transition-colors"
>
View on GitHub
<svg xmlns="http://www.w3.org/2000/svg" className="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M10 6H6a2 2 0 00-2 2v10a2 2 0 002 2h10a2 2 0 002-2v-4M14 4h6m0 0v6m0-6L10 14" />
</svg>
</a>
</div>
)}
<div className="mt-6 pt-6 border-t border-zinc-800">
<p className="text-zinc-500 font-mono text-sm mb-3">Install with SkillKit:</p>
<pre className="bg-zinc-950 border border-zinc-800 p-4 text-sm overflow-x-auto">
<code className="text-zinc-300 font-mono text-xs sm:text-sm whitespace-nowrap">
npx skillkit install {selectedSkill.id.split('/').slice(0, 2).join('/')}
</code>
</pre>
</div>
</div>
)}
{viewMode === 'generated' && generatedSkill && (
<div className="animate-fade-in-up">
<div className="mb-8 border-b border-zinc-800 pb-6">
<div className="flex flex-col sm:flex-row sm:items-start sm:justify-between gap-4">
<div className="flex-1 min-w-0">
<div className="flex flex-wrap items-center gap-2 mb-2">
<h3 className="text-lg sm:text-xl md:text-2xl font-bold text-white">{generatedSkill.title}</h3>
<span className="text-xs font-mono text-zinc-500 bg-zinc-900 px-2 py-1 border border-zinc-800">
v{generatedSkill.version}
</span>
<span className="text-xs font-mono text-purple-400 bg-purple-900/30 px-2 py-1 border border-purple-800/50">
AI Generated
</span>
{isFromCache && (
<span className="text-xs font-mono text-green-400 bg-green-900/30 px-2 py-1 border border-green-800/50">
Cached
</span>
)}
</div>
<p className="text-zinc-400 font-mono text-xs sm:text-sm mb-4">{generatedSkill.description}</p>
<div className="flex flex-wrap gap-2">
{generatedSkill.tags.map((tag, idx) => (
<span key={idx} className="text-xs bg-zinc-900 text-zinc-400 px-2 py-1 border border-zinc-800">
{tag}
</span>
))}
</div>
</div>
<div className="flex flex-row gap-2 shrink-0">
<button
type="button"
onClick={downloadGeneratedSkillMd}
className="flex items-center justify-center gap-2 bg-white text-black px-3 sm:px-4 py-2 font-mono text-xs sm:text-sm hover:bg-zinc-200 transition-colors"
>
<svg xmlns="http://www.w3.org/2000/svg" className="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-4l-4 4m0 0l-4-4m4 4V4" />
</svg>
<span className="hidden sm:inline">DOWNLOAD</span>
</button>
<button
type="button"
onClick={submitToMarketplace}
className="flex items-center justify-center gap-2 bg-purple-600 text-white px-3 sm:px-4 py-2 font-mono text-xs sm:text-sm hover:bg-purple-500 transition-colors"
>
<svg xmlns="http://www.w3.org/2000/svg" className="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M7 16a4 4 0 01-.88-7.903A5 5 0 1115.9 6L16 6a5 5 0 011 9.9M15 13l-3-3m0 0l-3 3m3-3v12" />
</svg>
<span className="hidden sm:inline">SUBMIT</span>
</button>
</div>
</div>
</div>
<Card className="mb-6">
<h4 className="text-sm font-mono text-zinc-500 uppercase tracking-wider mb-2">When to Apply</h4>
<p className="text-zinc-300">{generatedSkill.applicability}</p>
{generatedSkill.filePatterns && generatedSkill.filePatterns.length > 0 && (
<div className="mt-3 flex flex-wrap gap-2">
{generatedSkill.filePatterns.map((pattern, idx) => (
<code key={idx} className="text-xs bg-zinc-900 text-zinc-300 px-2 py-1 border border-zinc-800">
{pattern}
</code>
))}
</div>
)}
</Card>
<div className="flex overflow-x-auto border-b border-zinc-800 mb-6 -mx-4 px-4 sm:mx-0 sm:px-0">
{(['principles', 'patterns', 'antipatterns'] as const).map((tab) => (
<button
key={tab}
type="button"
onClick={() => setActiveTab(tab)}
className={`px-3 sm:px-6 py-3 font-mono text-xs sm:text-sm uppercase tracking-wider transition-colors whitespace-nowrap flex-shrink-0 ${
activeTab === tab
? 'text-white border-b-2 border-white -mb-px'
: 'text-zinc-500 hover:text-zinc-300'
}`}
>
{tab === 'antipatterns' ? 'Anti-Patterns' : tab}
<span className="ml-1 sm:ml-2 text-xs text-zinc-600">
({tab === 'principles' ? generatedSkill.principles.length : tab === 'patterns' ? generatedSkill.patterns.length : generatedSkill.antiPatterns.length})
</span>
</button>
))}
</div>
<div className="space-y-4">
{activeTab === 'principles' && generatedSkill.principles.map((principle, idx) => (
<Card key={idx} className="hover:border-zinc-600 transition-colors">
<div className="flex items-start justify-between gap-4 mb-2">
<h4 className="text-lg font-semibold text-white">{principle.title}</h4>
<PriorityBadge priority={principle.priority} />
</div>
<p className="text-zinc-400 leading-relaxed">{principle.description}</p>
</Card>
))}
{activeTab === 'patterns' && generatedSkill.patterns.map((pattern, idx) => (
<Card key={idx} className="hover:border-zinc-600 transition-colors">
<h4 className="text-lg font-semibold text-white mb-2">{pattern.name}</h4>
<p className="text-zinc-400 mb-4">{pattern.description}</p>
<pre className="bg-zinc-900 border border-zinc-700 p-4 overflow-x-auto text-sm">
<code className="text-zinc-100 font-mono">{pattern.example}</code>
</pre>
</Card>
))}
{activeTab === 'antipatterns' && generatedSkill.antiPatterns.map((ap, idx) => (
<Card key={idx} className="hover:border-zinc-600 transition-colors border-red-900/30">
<h4 className="text-lg font-semibold text-white mb-2">{ap.name}</h4>
<p className="text-zinc-400 mb-4">{ap.description}</p>
{ap.badExample && (
<div className="mb-4">
<div className="text-xs font-mono text-red-400 mb-1 uppercase">Bad</div>
<pre className="bg-red-950/50 border border-red-800/50 p-4 overflow-x-auto text-sm">
<code className="text-red-100 font-mono">{ap.badExample}</code>
</pre>
</div>
)}
{ap.goodExample && (
<div>
<div className="text-xs font-mono text-green-400 mb-1 uppercase">Good</div>
<pre className="bg-green-950/30 border border-green-800/50 p-4 overflow-x-auto text-sm">
<code className="text-green-100 font-mono">{ap.goodExample}</code>
</pre>
</div>
)}
</Card>
))}
</div>
{generatedSkill.references && generatedSkill.references.length > 0 && (
<div className="mt-8 pt-6 border-t border-zinc-800">
<h4 className="text-sm font-mono text-zinc-500 uppercase tracking-wider mb-3">References</h4>
<ul className="space-y-1">
{generatedSkill.references.map((ref, idx) => (
<li key={idx}>
{isValidUrl(ref) ? (
<a
href={ref}
target="_blank"
rel="noopener noreferrer"
className="text-zinc-400 hover:text-white font-mono text-sm transition-colors"
>
{ref}
</a>
) : (
<span className="text-zinc-400 font-mono text-sm">{ref}</span>
)}
</li>
))}
</ul>
</div>
)}
</div>
)}
</div>
);
}
@@ -0,0 +1,554 @@
import React, { useState, useCallback } from 'react';
import { Card } from './Card';
type Mode = 'upload' | 'import';
interface SkillFormData {
slug: string;
displayName: string;
description: string;
version: string;
tags: string;
repoOwner: string;
repoName: string;
skillPath: string;
authorGithub: string;
skillContent: string;
}
const INITIAL_FORM: SkillFormData = {
slug: '',
displayName: '',
description: '',
version: '1.0.0',
tags: '',
repoOwner: '',
repoName: '',
skillPath: '',
authorGithub: '',
skillContent: '',
};
const TAG_SUGGESTIONS = [
'react', 'typescript', 'nextjs', 'python', 'rust', 'go',
'testing', 'api', 'database', 'devops', 'security', 'mobile',
] as const;
const GITHUB_ICON = (
<svg className="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
<path fillRule="evenodd" d="M12 2C6.477 2 2 6.484 2 12.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.531 1.032 1.531 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0112 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.202 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.943.359.309.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482A10.019 10.019 0 0022 12.017C22 6.484 17.522 2 12 2z" clipRule="evenodd" />
</svg>
);
export function SkillSubmitForm(): React.ReactElement {
const [mode, setMode] = useState<Mode>('import');
const [form, setForm] = useState<SkillFormData>(INITIAL_FORM);
const [isDragging, setIsDragging] = useState(false);
const [fileName, setFileName] = useState<string | null>(null);
const [githubUrl, setGithubUrl] = useState('');
const [isDetecting, setIsDetecting] = useState(false);
const [detectError, setDetectError] = useState<string | null>(null);
function updateField(field: keyof SkillFormData, value: string): void {
setForm(prev => {
const updated = { ...prev, [field]: value };
if (field === 'displayName' && !prev.slug) {
updated.slug = value.toLowerCase().replace(/\s+/g, '-').replace(/[^a-z0-9-]/g, '');
}
return updated;
});
}
function addTag(tag: string): void {
const currentTags = form.tags.split(',').map(t => t.trim()).filter(Boolean);
if (!currentTags.includes(tag)) {
updateField('tags', [...currentTags, tag].join(', '));
}
}
const parseSkillContent = useCallback(function(content: string): void {
const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
if (frontmatterMatch) {
const fm = frontmatterMatch[1];
const nameMatch = fm.match(/name:\s*["']?([^"'\n]+)["']?/);
const descMatch = fm.match(/description:\s*["']?([^"'\n]+)["']?/);
const tagsMatch = fm.match(/tags:\s*\[([^\]]+)\]/);
const versionMatch = fm.match(/version:\s*["']?([^"'\n]+)["']?/);
if (nameMatch) updateField('displayName', nameMatch[1].trim());
if (descMatch) updateField('description', descMatch[1].trim());
if (versionMatch) updateField('version', versionMatch[1].trim());
if (tagsMatch) {
const tags = tagsMatch[1].replace(/["']/g, '').split(',').map(t => t.trim()).join(', ');
updateField('tags', tags);
}
}
updateField('skillContent', content);
}, []);
async function handleDetect(): Promise<void> {
if (!githubUrl) return;
setIsDetecting(true);
setDetectError(null);
try {
const urlMatch = githubUrl.match(/github\.com\/([^\/]+)\/([^\/]+)(?:\/(?:tree|blob)\/[^\/]+\/(.+))?/);
if (!urlMatch) {
throw new Error('Invalid GitHub URL');
}
const [, owner, repo, path = ''] = urlMatch;
const apiUrl = `https://api.github.com/repos/${owner}/${repo}`;
const response = await fetch(apiUrl);
if (!response.ok) {
throw new Error('Repository not found or not public');
}
const repoData = await response.json();
updateField('repoOwner', owner);
updateField('repoName', repo);
updateField('authorGithub', owner);
updateField('displayName', repoData.name.replace(/-/g, ' ').replace(/\b\w/g, (c: string) => c.toUpperCase()));
updateField('description', repoData.description || '');
const slug = path ? path.split('/').filter(Boolean).pop() || repo : repo;
updateField('slug', slug.toLowerCase().replace(/[^a-z0-9-]/g, '-'));
if (repoData.topics && repoData.topics.length > 0) {
updateField('tags', repoData.topics.slice(0, 5).join(', '));
} else {
const inferredTags: string[] = [];
const nameLC = (repo + ' ' + (repoData.description || '')).toLowerCase();
if (nameLC.includes('react')) inferredTags.push('react');
if (nameLC.includes('typescript') || nameLC.includes('ts')) inferredTags.push('typescript');
if (nameLC.includes('python')) inferredTags.push('python');
if (nameLC.includes('skill')) inferredTags.push('skills');
if (inferredTags.length > 0) {
updateField('tags', inferredTags.join(', '));
}
}
updateField('skillContent', `[Linked from GitHub: ${owner}/${repo}]`);
updateField('skillPath', path || '/');
} catch (err) {
setDetectError(err instanceof Error ? err.message : 'Detection failed');
} finally {
setIsDetecting(false);
}
}
const handleDragOver = useCallback(function(e: React.DragEvent): void {
e.preventDefault();
setIsDragging(true);
}, []);
const handleDragLeave = useCallback(function(e: React.DragEvent): void {
e.preventDefault();
setIsDragging(false);
}, []);
const processMarkdownFile = useCallback(function(file: File): void {
setFileName(file.name);
const reader = new FileReader();
reader.onload = (event) => {
const content = event.target?.result;
if (typeof content === 'string') {
parseSkillContent(content);
}
};
reader.readAsText(file);
}, [parseSkillContent]);
const handleDrop = useCallback(function(e: React.DragEvent): void {
e.preventDefault();
setIsDragging(false);
const files = Array.from(e.dataTransfer.files);
const mdFile = files.find(f => f.name.endsWith('.md'));
if (mdFile) {
processMarkdownFile(mdFile);
}
}, [processMarkdownFile]);
function handleFileSelect(e: React.ChangeEvent<HTMLInputElement>): void {
const file = e.target.files?.[0];
if (file && file.name.endsWith('.md')) {
processMarkdownFile(file);
}
}
const validation = {
slug: !form.slug ? 'Slug is required.' : null,
displayName: !form.displayName ? 'Display name is required.' : null,
content: mode === 'upload' && !form.skillContent ? 'Upload a SKILL.md file.' : null,
repo: mode === 'import' && (!form.repoOwner || !form.repoName) ? 'Click Detect to import repo.' : null,
tags: !form.tags ? 'Add at least one tag.' : null,
};
const isImported = mode === 'import' && form.repoOwner && form.repoName;
const errors = Object.values(validation).filter(Boolean);
const isValid = errors.length === 0;
const tagsArray = form.tags.split(',').map(t => t.trim()).filter(Boolean);
function generateIssueUrl(): string {
const skillId = form.repoOwner && form.repoName
? `${form.repoOwner}/${form.repoName}/${form.slug}`
: `community/${form.authorGithub || 'anonymous'}/${form.slug}`;
const jsonEntry = JSON.stringify({
id: skillId,
name: form.displayName,
description: form.description || '',
source: `${form.repoOwner}/${form.repoName}`,
tags: tagsArray,
author: form.authorGithub || form.repoOwner
}, null, 2);
const title = isImported
? encodeURIComponent(`[Import] ${form.repoOwner}/${form.repoName}`)
: encodeURIComponent(`[Skill] ${form.displayName}`);
const bodyContent = isImported
? `## 📦 Import Request: ${form.repoOwner}/${form.repoName}
### Repository
🔗 https://github.com/${form.repoOwner}/${form.repoName}
### Add to \`marketplace/skills.json\`
\`\`\`json
${jsonEntry}
\`\`\`
### Checklist for Maintainer
- [ ] Verify repository is public
- [ ] Add JSON entry to \`marketplace/skills.json\`
---
**Submitted by:** @${form.authorGithub || 'anonymous'}
**Owner:** @${form.repoOwner} (retains all rights)`
: `## 📤 Skill Upload: ${form.displayName}
### Add to \`marketplace/skills.json\`
\`\`\`json
${jsonEntry}
\`\`\`
### SKILL.md Content
<details>
<summary>Click to expand</summary>
\`\`\`markdown
${form.skillContent.slice(0, 4000)}${form.skillContent.length > 4000 ? '\n...(truncated)' : ''}
\`\`\`
</details>
### Checklist for Maintainer
- [ ] Review SKILL.md content
- [ ] Add JSON entry to \`marketplace/skills.json\`
---
**Author:** @${form.authorGithub || 'anonymous'}`;
const body = encodeURIComponent(bodyContent);
const labels = isImported ? 'skill-import' : 'skill-submission';
return `https://github.com/rohitg00/skillkit/issues/new?title=${title}&body=${body}&labels=${labels}`;
}
function handleSubmitClick(e: React.MouseEvent): void {
e.preventDefault();
if (isValid) {
const url = generateIssueUrl();
window.open(url, '_blank', 'noopener,noreferrer');
}
}
return (
<div className="space-y-6">
<div className="flex border-b border-zinc-800">
<button
onClick={() => setMode('import')}
className={`px-6 py-3 font-mono text-sm transition-colors ${
mode === 'import'
? 'text-white border-b-2 border-white -mb-px'
: 'text-zinc-500 hover:text-zinc-300'
}`}
>
Import from GitHub
</button>
<button
onClick={() => setMode('upload')}
className={`px-6 py-3 font-mono text-sm transition-colors ${
mode === 'upload'
? 'text-white border-b-2 border-white -mb-px'
: 'text-zinc-500 hover:text-zinc-300'
}`}
>
Upload File
</button>
</div>
<div className="grid grid-cols-1 lg:grid-cols-2 gap-6">
<div className="space-y-6">
{mode === 'import' && (
<Card>
<div className="flex items-center justify-between mb-1">
<label className="text-sm text-zinc-400">GitHub URL</label>
<span className="text-xs text-zinc-600">Repo, tree path, or blob</span>
</div>
<div className="flex gap-3 mt-2">
<input
type="text"
value={githubUrl}
onChange={(e) => setGithubUrl(e.target.value)}
placeholder="https://github.com/owner/repo"
className="flex-1 bg-zinc-900 border border-zinc-700 text-white px-4 py-2.5 font-mono text-sm focus:ring-1 focus:ring-white focus:border-white outline-none placeholder-zinc-600"
/>
<button
onClick={handleDetect}
disabled={isDetecting || !githubUrl}
className={`px-5 py-2.5 font-mono text-sm transition-colors ${
isDetecting || !githubUrl
? 'bg-zinc-800 text-zinc-600 cursor-not-allowed'
: 'bg-white text-black hover:bg-zinc-200'
}`}
>
{isDetecting ? 'Detecting...' : 'Detect'}
</button>
</div>
{detectError && (
<p className="text-red-400 text-xs mt-2 font-mono">{detectError}</p>
)}
{isImported && (
<p className="text-zinc-300 text-xs mt-2 font-mono flex items-center gap-1">
<svg className="w-3 h-3" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M5 13l4 4L19 7" />
</svg>
Repository detected - {form.repoOwner}/{form.repoName}
</p>
)}
<p className="text-zinc-600 text-xs mt-3">
Public repos only. We link to the original - owner retains all rights.
</p>
</Card>
)}
{mode === 'upload' && (
<Card
className={`transition-colors ${isDragging ? 'border-white bg-zinc-900' : ''}`}
onDragOver={handleDragOver}
onDragLeave={handleDragLeave}
onDrop={handleDrop}
>
<div className="text-center py-6">
<div className="mb-3">
<svg className="w-8 h-8 mx-auto text-zinc-600" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M7 16a4 4 0 01-.88-7.903A5 5 0 1115.9 6L16 6a5 5 0 011 9.9M15 13l-3-3m0 0l-3 3m3-3v12" />
</svg>
</div>
<p className="text-zinc-400 text-sm mb-1">
{fileName ? (
<span className="text-white">{fileName}</span>
) : (
'Drop SKILL.md here'
)}
</p>
<p className="text-zinc-600 text-xs mb-3">or</p>
<label className="inline-block cursor-pointer">
<span className="bg-zinc-800 hover:bg-zinc-700 text-white px-4 py-2 text-sm font-mono transition-colors">
Choose file
</span>
<input
type="file"
accept=".md"
onChange={handleFileSelect}
className="hidden"
/>
</label>
</div>
</Card>
)}
<Card>
<div className="space-y-4">
<div className="grid grid-cols-2 gap-4">
<div>
<label className="block text-sm text-zinc-400 mb-1.5">Slug</label>
<input
type="text"
value={form.slug}
onChange={(e) => updateField('slug', e.target.value.toLowerCase().replace(/[^a-z0-9-]/g, ''))}
placeholder="my-skill"
className="w-full bg-zinc-900 border border-zinc-700 text-white px-3 py-2 font-mono text-sm focus:ring-1 focus:ring-white focus:border-white outline-none placeholder-zinc-600"
/>
</div>
<div>
<label className="block text-sm text-zinc-400 mb-1.5">Display name</label>
<input
type="text"
value={form.displayName}
onChange={(e) => updateField('displayName', e.target.value)}
placeholder="My Skill"
className="w-full bg-zinc-900 border border-zinc-700 text-white px-3 py-2 font-mono text-sm focus:ring-1 focus:ring-white focus:border-white outline-none placeholder-zinc-600"
/>
</div>
</div>
<div className="grid grid-cols-2 gap-4">
<div>
<label className="block text-sm text-zinc-400 mb-1.5">Version</label>
<input
type="text"
value={form.version}
onChange={(e) => updateField('version', e.target.value)}
placeholder="1.0.0"
className="w-full bg-zinc-900 border border-zinc-700 text-white px-3 py-2 font-mono text-sm focus:ring-1 focus:ring-white focus:border-white outline-none placeholder-zinc-600"
/>
</div>
<div>
<label className="block text-sm text-zinc-400 mb-1.5">Tags</label>
<input
type="text"
value={form.tags}
onChange={(e) => updateField('tags', e.target.value)}
placeholder="react, typescript"
className="w-full bg-zinc-900 border border-zinc-700 text-white px-3 py-2 font-mono text-sm focus:ring-1 focus:ring-white focus:border-white outline-none placeholder-zinc-600"
/>
</div>
</div>
<div className="flex flex-wrap gap-1.5">
{TAG_SUGGESTIONS.map((tag) => (
<button
key={tag}
type="button"
onClick={() => addTag(tag)}
className="text-xs text-zinc-500 hover:text-zinc-300 hover:bg-zinc-800 px-2 py-0.5 border border-zinc-800 transition-colors"
>
+{tag}
</button>
))}
</div>
</div>
</Card>
</div>
<div className="space-y-6">
<Card>
<h4 className="text-sm text-zinc-400 mb-4">Preview</h4>
<div className="bg-zinc-950 border border-zinc-800 p-4">
<div className="flex items-start justify-between mb-3">
<div>
<h5 className="text-white font-semibold">
{form.displayName || 'Skill Name'}
</h5>
<p className="text-zinc-500 text-sm mt-1">
{form.description || 'No description'}
</p>
</div>
<span className="text-xs font-mono text-zinc-600 bg-zinc-900 px-2 py-1">
v{form.version}
</span>
</div>
{(form.repoOwner || form.authorGithub) && (
<div className="flex items-center gap-2 text-xs text-zinc-600 font-mono mb-3">
{form.repoOwner && form.repoName && <span>{form.repoOwner}/{form.repoName}</span>}
{form.authorGithub && (
<>
{form.repoOwner && <span>•</span>}
<span>@{form.authorGithub}</span>
</>
)}
</div>
)}
{tagsArray.length > 0 && (
<div className="flex flex-wrap gap-1.5">
{tagsArray.map((tag, i) => (
<span key={i} className="text-xs bg-zinc-900 text-zinc-500 px-2 py-0.5 border border-zinc-800">
{tag}
</span>
))}
</div>
)}
</div>
</Card>
{isImported ? (
<Card className="border-blue-900/50">
<div className="flex items-center gap-3 mb-3">
<div className="w-8 h-8 bg-blue-900/30 border border-blue-800 flex items-center justify-center">
<svg className="w-4 h-4 text-blue-400" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M13.828 10.172a4 4 0 00-5.656 0l-4 4a4 4 0 105.656 5.656l1.102-1.101m-.758-4.899a4 4 0 005.656 0l4-4a4 4 0 00-5.656-5.656l-1.1 1.1" />
</svg>
</div>
<div>
<h4 className="text-sm text-white font-medium">Linked Repository</h4>
<p className="text-xs text-zinc-500">Skills hosted by @{form.repoOwner}</p>
</div>
</div>
<a
href={`https://github.com/${form.repoOwner}/${form.repoName}`}
target="_blank"
rel="noopener noreferrer"
className="text-sm text-blue-400 hover:text-blue-300 font-mono flex items-center gap-2"
>
github.com/{form.repoOwner}/{form.repoName}
<svg className="w-3 h-3" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M10 6H6a2 2 0 00-2 2v10a2 2 0 002 2h10a2 2 0 002-2v-4M14 4h6m0 0v6m0-6L10 14" />
</svg>
</a>
</Card>
) : form.skillContent && !form.skillContent.startsWith('[Linked') ? (
<Card>
<h4 className="text-sm text-zinc-400 mb-3">SKILL.md</h4>
<pre className="bg-zinc-950 border border-zinc-800 p-3 text-xs font-mono text-zinc-400 max-h-48 overflow-auto">
{form.skillContent.slice(0, 1000)}
{form.skillContent.length > 1000 && '\n...'}
</pre>
</Card>
) : null}
{errors.length > 0 && (
<div className="space-y-1 text-xs font-mono text-yellow-500">
{errors.map((error, i) => (
<div key={i} className="flex items-center gap-1">
<span className="text-yellow-600">•</span> {error}
</div>
))}
</div>
)}
<button
type="button"
onClick={handleSubmitClick}
disabled={!isValid}
className={`flex items-center justify-center gap-3 w-full py-4 font-mono text-sm transition-all ${
isValid
? 'bg-white text-black hover:bg-zinc-200'
: 'bg-zinc-800 text-zinc-600 cursor-not-allowed'
}`}
>
{GITHUB_ICON}
{isImported ? 'Import to marketplace' : 'Publish skill'}
</button>
<p className="text-xs text-zinc-600 text-center font-mono">
{isImported
? 'Links to original repo → Owner retains rights'
: 'Opens GitHub issue → We review → Added to marketplace'}
</p>
</div>
</div>
</div>
);
}
+56
View File
@@ -0,0 +1,56 @@
import React from 'react';
interface TerminalProps {
title?: string;
children: React.ReactNode;
className?: string;
}
interface CodeBlockProps {
code: string;
language?: string;
}
interface CommandProps {
cmd: string;
comment?: string;
}
export function Terminal({ title = 'bash', children, className = '' }: TerminalProps): React.ReactElement {
return (
<div className={`rounded-lg overflow-hidden border border-zinc-800 bg-[#09090b] shadow-2xl ${className}`}>
<div className="flex items-center justify-between px-4 py-2 border-b border-zinc-800 bg-zinc-900/50">
<div className="flex space-x-2">
<div className="w-3 h-3 rounded-full bg-zinc-700"></div>
<div className="w-3 h-3 rounded-full bg-zinc-700"></div>
<div className="w-3 h-3 rounded-full bg-zinc-700"></div>
</div>
<div className="text-xs text-zinc-500 font-mono">{title}</div>
<div className="w-10"></div>
</div>
<div className="p-4 font-mono text-sm overflow-x-auto">
{children}
</div>
</div>
);
}
export function CodeBlock({ code }: CodeBlockProps): React.ReactElement {
return (
<pre className="text-zinc-300 font-mono text-sm leading-relaxed whitespace-pre-wrap">
{code}
</pre>
);
}
export function Command({ cmd, comment }: CommandProps): React.ReactElement {
return (
<div className="mb-2">
<div className="flex text-zinc-100">
<span className="text-zinc-500 mr-2">$</span>
<span>{cmd}</span>
</div>
{comment && <div className="text-zinc-500 text-xs mt-1 ml-4"># {comment}</div>}
</div>
);
}
+99
View File
@@ -0,0 +1,99 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "SkillKit Marketplace",
"description": "Schema for SkillKit marketplace skills index",
"type": "object",
"required": ["version", "skills"],
"properties": {
"version": {
"type": "integer",
"description": "Schema version number"
},
"updatedAt": {
"type": "string",
"format": "date",
"description": "Last update date (YYYY-MM-DD)"
},
"skills": {
"type": "array",
"description": "List of skills in the marketplace",
"items": {
"$ref": "#/definitions/Skill"
}
}
},
"definitions": {
"Skill": {
"type": "object",
"required": ["id", "name", "source", "tags"],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+/[a-zA-Z0-9_.-]+/[a-zA-Z0-9_-]+$",
"description": "Unique identifier: owner/repo/skill-name"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Human-readable skill name"
},
"description": {
"type": "string",
"maxLength": 500,
"description": "Brief description of the skill"
},
"source": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+/[a-zA-Z0-9_.-]+$",
"description": "GitHub repository: owner/repo"
},
"tags": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9-]+$"
},
"minItems": 1,
"maxItems": 10,
"description": "Tags for categorization (lowercase, hyphenated)"
},
"author": {
"type": "string",
"description": "Skill author name or GitHub username"
},
"version": {
"type": "string",
"pattern": "^\\d+\\.\\d+\\.\\d+$",
"description": "Semantic version (e.g., 1.0.0)"
},
"agents": {
"type": "array",
"items": {
"type": "string",
"enum": [
"claude-code",
"cursor",
"codex",
"gemini-cli",
"opencode",
"antigravity",
"amp",
"clawdbot",
"droid",
"github-copilot",
"goose",
"kilo",
"kiro-cli",
"roo",
"trae",
"windsurf",
"universal"
]
},
"description": "Compatible AI agents (omit for universal compatibility)"
}
}
}
}
}
+58
View File
@@ -0,0 +1,58 @@
// Single source of truth: marketplace/skills.json
import skillsData from '../../../../marketplace/skills.json';
export interface IndexedSkill {
id: string;
name: string;
description: string;
source: string;
sourceUrl: string;
rawUrl: string;
tags: string[];
}
function buildSkillIndex(): IndexedSkill[] {
return skillsData.skills.map(skill => {
const sourceParts = skill.source?.split('/') || [];
const owner = sourceParts[0] || 'unknown';
const repo = sourceParts[1] || 'unknown';
const skillSlug = skill.id.split('/').pop() || skill.name.toLowerCase().replace(/\s+/g, '-');
return {
id: skill.id,
name: skill.name,
description: skill.description || '',
source: skill.source || '',
sourceUrl: owner !== 'unknown' ? `https://github.com/${skill.source}` : '',
rawUrl: owner !== 'unknown' && repo !== 'unknown'
? `https://raw.githubusercontent.com/${owner}/${repo}/main/skills/${skillSlug}/SKILL.md`
: '',
tags: skill.tags || [],
};
});
}
export const SKILLS_INDEX: IndexedSkill[] = buildSkillIndex();
export function searchSkills(query: string): IndexedSkill[] {
const q = query.toLowerCase().trim();
if (!q) return [];
return SKILLS_INDEX.filter(skill =>
skill.name.toLowerCase().includes(q) ||
skill.description.toLowerCase().includes(q) ||
skill.tags.some(tag => tag.toLowerCase().includes(q))
).slice(0, 20);
}
export function getSkillsByTag(tag: string): IndexedSkill[] {
return SKILLS_INDEX.filter(skill =>
skill.tags.some(t => t.toLowerCase() === tag.toLowerCase())
);
}
export function getAllTags(): string[] {
const tags = new Set<string>();
SKILLS_INDEX.forEach(skill => skill.tags.forEach(tag => tags.add(tag)));
return Array.from(tags).sort();
}
+35
View File
@@ -0,0 +1,35 @@
import Link from 'next/link'
import React, { type PropsWithChildren } from 'react'
import { cn } from '../utils'
import * as Icons from 'lucide-react'
import type { LucideIcon } from 'lucide-react'
type CardProps = PropsWithChildren<{
title: string
description: string
href: string
icon?: string
horizontal?: boolean
}>
export const Card: React.FC<CardProps> = ({ title, description, href, icon, children, horizontal = false }) => {
const IconComponent = icon ? (Icons as unknown as Record<string, LucideIcon>)[icon] : null
return (
<Link href={href} className="no-underline flex">
<div
className={cn(
'flex w-full flex-1 border border-border hover:border-foreground bg-muted-background rounded-lg p-4 hover:bg-muted-foreground/10 transition-colors',
horizontal ? 'flex-row gap-4 items-center' : 'flex-col gap-1',
)}
>
{IconComponent && <IconComponent className={cn('size-6', horizontal ? 'mt-1' : 'mb-2')} />}
<div className="flex flex-col gap-1">
<h3 className="text-lg m-0! font-semibold">{title}</h3>
{description && <div className="text-sm text-muted-foreground">{description}</div>}
{children}
</div>
</div>
</Link>
)
}
@@ -0,0 +1,23 @@
import React, { type PropsWithChildren } from 'react'
import { cn } from '../utils'
type ColumnsProps = PropsWithChildren<{
cols?: number
className?: string
}>
export const Columns: React.FC<ColumnsProps> = ({ cols = 2, className = '', children }) => {
return (
<div
className={cn(
'grid gap-4 md:gap-6 grid-cols-1 auto-rows-min md:auto-cols-min',
cols === 2 && 'md:grid-cols-2',
cols === 3 && 'md:grid-cols-3',
cols === 4 && 'md:grid-cols-4',
className,
)}
>
{children}
</div>
)
}
+26
View File
@@ -0,0 +1,26 @@
import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared'
export function baseOptions(): BaseLayoutProps {
return {
nav: {
title: 'SkillKit',
},
links: [
{
text: 'DeepWiki',
url: 'https://deepwiki.com/rohitg00/skillkit',
external: true,
},
{
text: 'GitHub',
url: 'https://github.com/rohitg00/skillkit',
external: true,
},
{
text: 'npm',
url: 'https://www.npmjs.com/package/skillkit',
external: true,
},
],
}
}
+26
View File
@@ -0,0 +1,26 @@
import { docs } from 'fumadocs-mdx:collections/server'
import { type InferPageType, loader } from 'fumadocs-core/source'
import { lucideIconsPlugin } from 'fumadocs-core/source/lucide-icons'
export const source = loader({
baseUrl: '/docs',
source: docs.toFumadocsSource(),
plugins: [lucideIconsPlugin()],
})
export function getPageImage(page: InferPageType<typeof source>) {
const segments = [...page.slugs, 'image.png']
return {
segments,
url: `/og/docs/${segments.join('/')}`,
}
}
export async function getLLMText(page: InferPageType<typeof source>) {
const processed = await page.data.getText('processed')
return `# ${page.data.title}
${processed}`
}
+6
View File
@@ -0,0 +1,6 @@
import { type ClassValue, clsx } from 'clsx'
import { twMerge } from 'tailwind-merge'
export function cn(...inputs: ClassValue[]) {
return twMerge(clsx(inputs))
}
+14
View File
@@ -0,0 +1,14 @@
import defaultMdxComponents from 'fumadocs-ui/mdx'
import type { MDXComponents } from 'mdx/types'
import { Card } from '@/lib/components/Card'
import { Columns } from './lib/components/Columns'
// eslint-disable-next-line @typescript-eslint/no-explicit-any
export function getMDXComponents(components?: MDXComponents): any {
return {
...defaultMdxComponents,
...components,
Card,
Columns,
}
}
@@ -0,0 +1,23 @@
import { AgentSkill } from "../types";
export async function generateAgentSkill(topic: string): Promise<AgentSkill> {
const sanitizedTopic = topic?.trim().slice(0, 500) || '';
if (!sanitizedTopic) {
throw new Error("Topic is required");
}
const response = await fetch('/api/generate-skill', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ topic: sanitizedTopic }),
});
if (!response.ok) {
const error = await response.json().catch(() => ({ error: 'Unknown error' }));
throw new Error(error.error || 'Failed to generate skill');
}
return response.json();
}
export const generateLearningPath: (topic: string) => Promise<AgentSkill> = generateAgentSkill;
+57
View File
@@ -0,0 +1,57 @@
export interface LearningStep {
title: string;
description: string;
duration: string;
keyConcepts: string[];
}
export interface LearningPath {
skill: string;
description: string;
steps: LearningStep[];
}
export interface GenerateSkillResponse {
learningPath: LearningPath;
}
export enum LoadingState {
IDLE = 'IDLE',
LOADING = 'LOADING',
SUCCESS = 'SUCCESS',
ERROR = 'ERROR'
}
export interface AgentSkill {
name: string;
title: string;
description: string;
version: string;
tags: string[];
applicability: string;
principles: SkillPrinciple[];
patterns: SkillPattern[];
antiPatterns: SkillAntiPattern[];
filePatterns?: string[];
references?: string[];
}
export interface SkillPrinciple {
title: string;
description: string;
priority: 'must' | 'should' | 'may';
}
export interface SkillPattern {
name: string;
description: string;
example: string;
language?: string;
}
export interface SkillAntiPattern {
name: string;
description: string;
badExample?: string;
goodExample?: string;
}
+46
View File
@@ -0,0 +1,46 @@
{
"compilerOptions": {
"target": "ES2017",
"lib": [
"dom",
"dom.iterable",
"esnext"
],
"allowJs": true,
"skipLibCheck": true,
"strict": true,
"noEmit": true,
"esModuleInterop": true,
"module": "esnext",
"moduleResolution": "bundler",
"resolveJsonModule": true,
"isolatedModules": true,
"jsx": "react-jsx",
"incremental": true,
"plugins": [
{
"name": "next"
}
],
"baseUrl": ".",
"paths": {
"@/*": [
"./src/*"
],
"fumadocs-mdx:collections/*": [
".source/*"
]
}
},
"include": [
"next-env.d.ts",
"**/*.ts",
"**/*.tsx",
".next/types/**/*.ts",
".source/**/*.ts",
".next/dev/types/**/*.ts"
],
"exclude": [
"node_modules"
]
}
+13
View File
@@ -0,0 +1,13 @@
{
"$schema": "https://turbo.build/schema.json",
"extends": [],
"tasks": {
"build": {
"outputs": [".next/**", "!.next/cache/**"]
},
"dev": {
"cache": false,
"persistent": true
}
}
}
+7
View File
@@ -0,0 +1,7 @@
{
"$schema": "https://openapi.vercel.sh/vercel.json",
"buildCommand": "next build",
"installCommand": "npm install",
"outputDirectory": ".next",
"framework": "nextjs"
}
Binary file not shown.

After

Width:  |  Height:  |  Size: 46 KiB

+8 -2
View File
@@ -35,10 +35,16 @@ export default function App(): React.ReactElement {
<span className="text-base font-bold tracking-tight text-white font-mono">SKILLKIT</span>
</a>
<div className="flex items-center gap-2 sm:gap-4">
<a
href="https://agentskills.com/docs"
className="text-zinc-400 hover:text-white transition-colors text-sm font-mono hidden sm:block"
>
Docs
</a>
<a
href="https://www.npmjs.com/package/skillkit"
target="_blank"
rel="noreferrer"
rel="noopener noreferrer"
className="text-zinc-400 hover:text-red-500 transition-colors p-2"
aria-label="npm"
>
@@ -47,7 +53,7 @@ export default function App(): React.ReactElement {
<a
href="https://github.com/rohitg00/skillkit"
target="_blank"
rel="noreferrer"
rel="noopener noreferrer"
className="text-zinc-400 hover:text-white transition-colors p-2"
aria-label="GitHub"
>
+127 -1
View File
@@ -167,6 +167,132 @@ const AGENTS: Agent[] = [
</svg>
)
},
{
name: "CodeBuddy",
url: "https://codebuddy.ai",
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 28c-6.075 0-11-4.925-11-11s4.925-11 11-11 11 4.925 11 11-4.925 11-11 11zm-4-13a2 2 0 1 0 0 4 2 2 0 0 0 0-4zm8 0a2 2 0 1 0 0 4 2 2 0 0 0 0-4z"/>
</svg>
)
},
{
name: "Continue",
url: "https://continue.dev",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M35 33v34l30-17-30-17zm6 10.39L55.28 50 41 56.61V43.39z"/>
</svg>
)
},
{
name: "Crush",
url: "https://crush.ai",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M50 35c-8.284 0-15 6.716-15 15 0 8.284 6.716 15 15 15 8.284 0 15-6.716 15-15 0-8.284-6.716-15-15-15zm-5 20l3-8 4 5 5-10 3 13H45z"/>
</svg>
)
},
{
name: "Factory",
url: "https://factory.ai",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M33 40v27h34V40l-11 8V40l-11 8V40L33 48zm6 12h6v9h-6v-9zm10 0h6v9h-6v-9zm10 0h6v9h-6v-9z"/>
</svg>
)
},
{
name: "MCPJam",
url: "https://mcpjam.com",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M40 35v30h6V47l4 10h4l4-10v18h6V35h-7l-5 14-5-14h-7z"/>
</svg>
)
},
{
name: "Mux",
url: "https://mux.com",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M35 40l7.5 10L35 60h8l4-5.5 4 5.5h8l-7.5-10L59 40h-8l-4 5.5L43 40h-8zm22 0v20h6V40h-6z"/>
</svg>
)
},
{
name: "Neovate",
url: "https://neovate.ai",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M35 35v30h6V47l14 18h6V35h-6v18L41 35h-6z"/>
</svg>
)
},
{
name: "OpenHands",
url: "https://openhands.ai",
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 11h-22c0-6.075 4.925-11 11-11zm-8 15h16v3c0 4.418-3.582 8-8 8s-8-3.582-8-8v-3z"/>
</svg>
)
},
{
name: "Pi",
url: "https://pi.ai",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M38 35v6h9v24h6V41h9v-6H38z"/>
</svg>
)
},
{
name: "Qoder",
url: "https://qoder.ai",
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 0 0 67 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: "Qwen",
url: "https://qwen.ai",
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 0 0 67 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-11zm-3 6v4h-4v4h4v-4h4v-4h-4z"/>
</svg>
)
},
{
name: "Vercel",
url: "https://vercel.com",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M50 33L33 67h34L50 33z"/>
</svg>
)
},
{
name: "Zencoder",
url: "https://zencoder.ai",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M35 35v6h18.17L35 59v6h30v-6H46.83L65 41v-6H35z"/>
</svg>
)
},
{
name: "CommandCode",
url: "https://commandcode.ai",
icon: (
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
<path d="M33 40v20h8v-6h4c5.523 0 10-4.477 10-10s-4.477-10-10-10h-12v6zm8 0h4c2.209 0 4 1.791 4 4s-1.791 4-4 4h-4v-8zm14 0l7 10-7 10h7l7-10-7-10h-7z"/>
</svg>
)
},
];
const SCROLL_ANIMATION_STYLES = `
@@ -186,7 +312,7 @@ export function Agents(): React.ReactElement {
<section className="py-6 border-b border-zinc-800 overflow-hidden">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<p className="text-zinc-500 font-mono text-[11px] uppercase tracking-widest mb-6 text-center">
Works with 17+ AI Agents
Works with 32 AI Agents
</p>
</div>
+1 -1
View File
@@ -52,7 +52,7 @@ export function Commands(): React.ReactElement {
<section className="py-12 border-b border-zinc-800">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="text-center mb-8">
<h2 className="text-xl font-bold text-white mb-2 font-mono">30+ Commands</h2>
<h2 className="text-xl font-bold text-white mb-2 font-mono">40+ Commands</h2>
<p className="text-zinc-500 font-mono text-sm">
Everything you need from the terminal.
</p>
+494
View File
@@ -0,0 +1,494 @@
import React, { useState } from 'react';
interface DocSection {
id: string;
title: string;
content: React.ReactNode;
}
const CodeBlock = ({ children, language = 'bash' }: { children: string; language?: string }) => (
<pre className="bg-zinc-900 border border-zinc-800 rounded-lg p-4 overflow-x-auto text-sm font-mono">
<code className="text-zinc-300">{children}</code>
</pre>
);
const Table = ({ headers, rows }: { headers: string[]; rows: string[][] }) => (
<div className="overflow-x-auto">
<table className="w-full text-sm border-collapse">
<thead>
<tr className="border-b border-zinc-700">
{headers.map((h, i) => (
<th key={i} className="text-left py-2 px-3 text-zinc-300 font-mono font-semibold">{h}</th>
))}
</tr>
</thead>
<tbody>
{rows.map((row, i) => (
<tr key={i} className="border-b border-zinc-800 hover:bg-zinc-900/50">
{row.map((cell, j) => (
<td key={j} className="py-2 px-3 text-zinc-400 font-mono">{cell}</td>
))}
</tr>
))}
</tbody>
</table>
</div>
);
const sections: DocSection[] = [
{
id: 'overview',
title: 'Overview',
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.
</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">Team Collaboration</span> - Share skills via .skills manifest files and publish to marketplace</li>
</ul>
</div>
),
},
{
id: 'installation',
title: 'Installation',
content: (
<div className="space-y-4">
<h3 className="text-lg font-semibold text-white">Quick Start</h3>
<CodeBlock>{`# Install globally via npm
npm install -g skillkit
# Or use npx directly
npx skillkit --help
# Or install via pnpm
pnpm add -g skillkit`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Verify Installation</h3>
<CodeBlock>{`skillkit --version
skillkit --help`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">First Steps</h3>
<CodeBlock>{`# Initialize SkillKit in your project
skillkit init
# Browse available skills
skillkit marketplace
# Get AI-powered recommendations
skillkit recommend
# Install skills from a source
skillkit install anthropics/skills`}</CodeBlock>
</div>
),
},
{
id: 'architecture',
title: 'Architecture',
content: (
<div className="space-y-4">
<p className="text-zinc-300">
SkillKit employs a three-tier design with clean separation of concerns:
</p>
<h3 className="text-lg font-semibold text-white mt-6">System Tiers</h3>
<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>
</ul>
<h3 className="text-lg font-semibold text-white mt-6">Monorepo Structure</h3>
<CodeBlock language="text">{`skillkit-monorepo (pnpm workspace + Turbo)
├── apps/skillkit/ → Main CLI application (bin: skillkit, sk)
├── packages/core/ → Core business logic (no internal dependencies)
├── packages/agents/ → Agent adapters (depends on core)
├── packages/cli/ → Command implementations (depends on core, agents, tui)
├── packages/tui/ → Terminal UI (depends on core, agents)
└── docs/skillkit/ → Documentation website`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Dependency Hierarchy</h3>
<ul className="list-disc list-inside space-y-2 text-zinc-400">
<li><code className="text-emerald-400">@skillkit/core</code> → Foundation (no SkillKit dependencies)</li>
<li><code className="text-emerald-400">@skillkit/agents</code> → Adapters (depends on core)</li>
<li><code className="text-emerald-400">@skillkit/cli</code>, <code className="text-emerald-400">@skillkit/tui</code> → UIs (depend on core and agents)</li>
<li><code className="text-emerald-400">skillkit</code> app → Orchestrates all packages</li>
</ul>
</div>
),
},
{
id: 'agents',
title: 'Supported Agents',
content: (
<div className="space-y-4">
<p className="text-zinc-300">
SkillKit supports 32 AI coding agents with automatic format translation:
</p>
<Table
headers={['Agent', 'Directory', 'Format']}
rows={[
['Claude Code', '.claude/skills/', 'SKILL.md'],
['Cursor', '.cursor/skills/', '.mdc'],
['GitHub Copilot', '.github/skills/', 'Markdown'],
['Gemini CLI', '.gemini/skills/', 'SKILL.md'],
['Windsurf', '.windsurf/skills/', 'Markdown'],
['Codex', '.codex/skills/', 'SKILL.md'],
['OpenCode', '.opencode/skills/', 'SKILL.md'],
['Antigravity', '.antigravity/skills/', 'SKILL.md'],
['Amp', '.amp/skills/', 'SKILL.md'],
['Clawdbot', '.clawdbot/skills/', 'SKILL.md'],
['Cline', '.cline/skills/', 'SKILL.md'],
['CodeBuddy', '.codebuddy/skills/', 'SKILL.md'],
['CommandCode', '.commandcode/skills/', 'SKILL.md'],
['Continue', '.continue/skills/', 'SKILL.md'],
['Crush', '.crush/skills/', 'SKILL.md'],
['Droid', '.factory/skills/', 'SKILL.md'],
['Factory', '.factory/skills/', 'SKILL.md'],
['Goose', '.goose/skills/', 'SKILL.md'],
['Kilo', '.kilocode/skills/', 'SKILL.md'],
['Kiro CLI', '.kiro/skills/', 'SKILL.md'],
['MCPJam', '.mcpjam/skills/', 'SKILL.md'],
['Mux', '.mux/skills/', 'SKILL.md'],
['Neovate', '.neovate/skills/', 'SKILL.md'],
['OpenHands', '.openhands/skills/', 'SKILL.md'],
['Pi', '.pi/skills/', 'SKILL.md'],
['Qoder', '.qoder/skills/', 'SKILL.md'],
['Qwen', '.qwen/skills/', 'SKILL.md'],
['Roo', '.roo/skills/', 'SKILL.md'],
['Trae', '.trae/skills/', 'SKILL.md'],
['Vercel', '.vercel/skills/', 'SKILL.md'],
['Zencoder', '.zencoder/skills/', 'SKILL.md'],
['Universal', 'skills/', 'SKILL.md'],
]}
/>
</div>
),
},
{
id: 'commands',
title: 'CLI Commands',
content: (
<div className="space-y-4">
<h3 className="text-lg font-semibold text-white">Skill Management</h3>
<CodeBlock>{`skillkit install <source> # Install skills from source
skillkit remove <skill> # Remove installed skill
skillkit update [skill] # Update skills
skillkit list # List installed skills
skillkit sync # Sync skills across agents
skillkit enable <skill> # Enable a skill
skillkit disable <skill> # Disable a skill`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Discovery</h3>
<CodeBlock>{`skillkit recommend # AI-powered skill recommendations
skillkit marketplace # Browse marketplace skills
skillkit find <query> # Search for skills
skillkit search <term> # Search skill content`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Translation</h3>
<CodeBlock>{`skillkit translate --from claude --to cursor <skill>
skillkit agent translate <skill> --target cursor
skillkit context sync # Sync context across agents`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Team Collaboration</h3>
<CodeBlock>{`skillkit manifest init # Initialize .skills manifest
skillkit manifest add <source> # Add source to manifest
skillkit manifest install # Install from manifest
skillkit publish # Publish skill to marketplace
skillkit cicd init # Setup CI/CD integration`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Advanced</h3>
<CodeBlock>{`skillkit ui # Launch Terminal UI
skillkit workflow # Manage workflows
skillkit memory compress # Compress memory
skillkit memory export # Export memory
skillkit test # Run skill tests
skillkit validate # Validate skill format & quality`}</CodeBlock>
</div>
),
},
{
id: 'configuration',
title: 'Configuration',
content: (
<div className="space-y-4">
<h3 className="text-lg font-semibold text-white">Project Configuration (skillkit.yaml)</h3>
<CodeBlock language="yaml">{`version: 1
agent: cursor
autoSync: true
enabledSkills:
- pdf
- xlsx
disabledSkills:
- deprecated-skill`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Team Manifest (.skills)</h3>
<CodeBlock>{`# Team-wide skill sources
anthropics/skills
vercel-labs/agent-skills
./local-skills
owner/repo@v1.2.3`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">User Preferences (~/.skillkit/preferences.json)</h3>
<CodeBlock language="json">{`{
"lastSelectedAgents": ["claude", "cursor"],
"autoSync": true,
"marketplace": {
"lastRefresh": "2024-01-01T00:00:00Z"
}
}`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">File System Layout</h3>
<CodeBlock language="text">{`project/
├── .skillkit/ # Project config & memory
├── .claude/skills/ # Claude Code skills
├── .cursor/skills/ # Cursor AI skills
├── .github/skills/ # GitHub Copilot skills
├── skills/ # Universal format
└── .skills # Team manifest file
~/.skillkit/ # Global user config
├── preferences.json
├── memory/
└── cache/`}</CodeBlock>
</div>
),
},
{
id: 'api',
title: 'API Reference',
content: (
<div className="space-y-4">
<h3 className="text-lg font-semibold text-white">Package Exports</h3>
<p className="text-zinc-300">@skillkit/core provides multiple entry points for programmatic use:</p>
<CodeBlock language="typescript">{`import { findAllSkills, findSkill } from '@skillkit/core/discovery';
import { parseSkillFile } from '@skillkit/core/parser';
import { translateSkill } from '@skillkit/core/translator';
import { syncContext } from '@skillkit/core/context';
import { getRecommendations } from '@skillkit/core/recommend';
import { evaluateSkillContent, getQualityGrade } from '@skillkit/core/quality';`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Core Functions</h3>
<CodeBlock language="typescript">{`// Discovery
findAllSkills(searchDirs: string[]): SkillInfo[]
findSkill(name: string, searchDirs: string[]): SkillInfo | null
// Parsing
parseSkillFile(filePath: string): ParsedSkill
parseSkillContent(content: string): ParsedSkill
// Translation
translateSkill(skill: ParsedSkill, targetAgent: AgentType): string
getAgentAdapter(agent: AgentType): AgentAdapter
// Quality Evaluation
evaluateSkillContent(content: string): QualityScore
evaluateSkillFile(filePath: string): QualityScore
getQualityGrade(score: number): 'A' | 'B' | 'C' | 'D' | 'F'
isHighQuality(score: QualityScore): boolean
// Recommendations
getRecommendations(context: ProjectContext): Recommendation[]`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Type Definitions</h3>
<CodeBlock language="typescript">{`interface SkillInfo {
name: string;
path: string;
agent: AgentType;
enabled: boolean;
}
interface ParsedSkill {
name: string;
description?: string;
globs?: string[];
triggers?: string[];
content: string;
frontmatter: Record<string, unknown>;
}
interface QualityScore {
overall: number;
structure: StructureScore;
clarity: ClarityScore;
specificity: SpecificityScore;
advanced: AdvancedScore;
warnings: string[];
suggestions: string[];
}
type AgentType =
| 'claude-code' | 'cursor' | 'codex' | 'gemini-cli'
| 'opencode' | 'antigravity' | 'amp' | 'clawdbot'
| 'droid' | 'github-copilot' | 'goose' | 'kilo'
| 'kiro-cli' | 'roo' | 'trae' | 'windsurf' | 'universal';`}</CodeBlock>
</div>
),
},
{
id: 'skill-format',
title: 'Skill Format',
content: (
<div className="space-y-4">
<h3 className="text-lg font-semibold text-white">SKILL.md Structure</h3>
<p className="text-zinc-300">Skills use YAML frontmatter followed by markdown content:</p>
<CodeBlock language="markdown">{`---
name: my-skill
description: A helpful skill for coding tasks
globs:
- "**/*.ts"
- "**/*.tsx"
triggers:
- "when working with TypeScript"
- "when creating React components"
---
# My Skill
## When to Use
Use this skill when:
- Working with TypeScript files
- Creating React components
## Instructions
Follow these guidelines:
1. Always use TypeScript strict mode
2. Prefer functional components
\`\`\`typescript
function Example(): JSX.Element {
return <div>Hello</div>;
}
\`\`\`
## Boundaries
This skill should NOT:
- Modify configuration files without asking
- Delete existing code without confirmation`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Quality Scoring</h3>
<p className="text-zinc-300">Skills are evaluated on four dimensions:</p>
<Table
headers={['Dimension', 'Weight', 'Criteria']}
rows={[
['Structure', '35%', 'Metadata, description, triggers, examples, boundaries'],
['Clarity', '25%', 'Line count, token count, headers, readability'],
['Specificity', '25%', 'Concrete commands, file patterns, code examples'],
['Advanced', '15%', 'No deprecated patterns, security issues, completeness'],
]}
/>
<h3 className="text-lg font-semibold text-white mt-6">Grade Scale</h3>
<Table
headers={['Grade', 'Score Range', 'Description']}
rows={[
['A', '90-100', 'Excellent - Production ready'],
['B', '80-89', 'Good - Minor improvements possible'],
['C', '70-79', 'Acceptable - Some issues to address'],
['D', '60-69', 'Poor - Significant improvements needed'],
['F', '0-59', 'Failing - Major revision required'],
]}
/>
</div>
),
},
{
id: 'tech-stack',
title: 'Technology Stack',
content: (
<div className="space-y-4">
<Table
headers={['Layer', 'Technology']}
rows={[
['CLI Framework', 'Clipanion v4'],
['TUI Framework', '@opentui/react v0.1.75'],
['Validation', 'Zod v3.24'],
['YAML Parsing', 'yaml v2.6'],
['Git Operations', 'isomorphic-git v1.27'],
['HTTP Client', 'got v14.4'],
['Build System', 'Turbo v2.3, tsup v8.3, pnpm v9.0'],
['Testing', 'Vitest v2.1'],
['Runtime', 'Node.js 18+, Bun 1.2+ (for TUI)'],
]}
/>
<h3 className="text-lg font-semibold text-white mt-6">Build Commands</h3>
<CodeBlock>{`pnpm build # Build all packages via Turbo
pnpm dev # Watch mode development
pnpm test # Unit tests via Vitest
pnpm test:e2e # End-to-end tests
pnpm typecheck # Type checking
pnpm clean # Remove build artifacts`}</CodeBlock>
</div>
),
},
];
export function Documentation(): React.ReactElement {
const [activeSection, setActiveSection] = useState('overview');
const currentSection = sections.find(s => s.id === activeSection) || sections[0];
return (
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="text-center mb-8">
<h2 className="text-2xl font-bold text-white mb-2 font-mono">Documentation</h2>
<p className="text-zinc-400 font-mono text-sm">
Complete guide to using SkillKit
</p>
<a
href="https://deepwiki.com/rohitg00/skillkit"
target="_blank"
rel="noopener noreferrer"
className="inline-flex items-center gap-2 mt-2 text-xs text-zinc-500 hover:text-zinc-300 transition-colors"
>
<span>Powered by DeepWiki</span>
<svg className="w-3 h-3" fill="none" stroke="currentColor" viewBox="0 0 24 24">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M10 6H6a2 2 0 00-2 2v10a2 2 0 002 2h10a2 2 0 002-2v-4M14 4h6m0 0v6m0-6L10 14" />
</svg>
</a>
</div>
<div className="flex flex-col lg:flex-row gap-8">
<nav className="lg:w-48 flex-shrink-0">
<div className="sticky top-20 space-y-1">
{sections.map(section => (
<button
key={section.id}
onClick={() => setActiveSection(section.id)}
className={`w-full text-left px-3 py-2 text-sm font-mono rounded transition-colors ${
activeSection === section.id
? 'bg-white text-black'
: 'text-zinc-400 hover:text-white hover:bg-zinc-800'
}`}
>
{section.title}
</button>
))}
</div>
</nav>
<div className="flex-1 min-w-0">
<div className="bg-surface border border-zinc-800 rounded-lg p-6">
<h2 className="text-xl font-bold text-white mb-6 font-mono">{currentSection.title}</h2>
<div className="prose prose-invert prose-zinc max-w-none">
{currentSection.content}
</div>
</div>
</div>
</div>
</div>
);
}
+4 -4
View File
@@ -9,7 +9,7 @@ interface Feature {
const FEATURES: Feature[] = [
{
title: 'Multi-Agent',
description: 'Deploy to 17 AI coding agents with one command.',
description: 'Deploy to 32 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', '17'],
['Agents', '1', '32'],
['Translation', 'Manual', 'Auto'],
['Sharing', 'Copy/paste', '.skills manifest'],
['Discovery', 'Forums', 'CLI + AI'],
@@ -83,11 +83,11 @@ 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">17</div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">32</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">30+</div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">40+</div>
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Commands</div>
</div>
<div>
+1 -1
View File
@@ -20,7 +20,7 @@ export function Footer(): React.ReactElement {
<a
href="https://agentskills.io"
target="_blank"
rel="noreferrer"
rel="noopener noreferrer"
className="text-zinc-600 hover:text-zinc-400 text-xs font-mono transition-colors"
>
Agent Skills standard
+8 -7
View File
@@ -1,12 +1,13 @@
import React, { useState, useEffect } from 'react';
import { Button } from './Button';
const ASCII_LOGO = `███████╗██╗ ██╗██╗██╗ ██╗ ██╗ ██╗██╗████████╗
██╔════╝██║ ██╔╝██║██║ ██║ ██║ ██╔╝██║╚══██╔══╝
███████╗█████╔╝ ██║██║ ██║ █████╔╝ ██║ ██║
╚════██║██╔═██╗ ██║██║ ██║ ██╔═██╗ ██║ ██║
███████║██║ ██╗██║███████╗███████╗██║ ██╗██║ ██║
╚══════╝╚═╝ ╚═╝╚═╝╚══════╝╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝`;
const ASCII_LOGO = `
███████ ██ ██ ██ ██ ██ ██ ██ ██ ████████
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
███████ █████ ██ ██ ██ █████ ██ ██
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
███████ ██ ██ ██ ███████ ███████ ██ ██ ██ ██
`.trim();
interface TerminalLine {
type: 'cmd' | 'out';
@@ -134,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 13 more agents. 15,000+ skills ready to use.
Windsurf, Copilot, and 28 more agents. 15,000+ skills ready to use.
</p>
<div className="flex flex-wrap items-center gap-3 mb-4">
+16 -15
View File
@@ -441,7 +441,7 @@ ${skillContent.slice(0, 4000)}${skillContent.length > 4000 ? '\n...(truncated)'
{selectedSkill.sourceUrl && (
<>
<span>•</span>
<a href={selectedSkill.sourceUrl} target="_blank" rel="noreferrer" className="hover:text-white">
<a href={selectedSkill.sourceUrl} target="_blank" rel="noopener noreferrer" className="hover:text-white">
View on GitHub
</a>
</>
@@ -464,8 +464,8 @@ ${skillContent.slice(0, 4000)}${skillContent.length > 4000 ? '\n...(truncated)'
{status === LoadingState.LOADING ? (
<div className="text-zinc-500 font-mono text-sm">Loading content...</div>
) : skillContent ? (
<pre className="bg-zinc-950 border border-zinc-800 p-6 overflow-x-auto text-sm max-h-[600px] overflow-y-auto">
<code className="text-zinc-300 font-mono whitespace-pre-wrap">{skillContent}</code>
<pre className="bg-zinc-900 border border-zinc-700 p-6 overflow-x-auto text-sm max-h-[600px] overflow-y-auto">
<code className="text-zinc-100 font-mono whitespace-pre-wrap">{skillContent}</code>
</pre>
) : (
<div className="bg-zinc-950 border border-zinc-800 p-6">
@@ -475,7 +475,7 @@ ${skillContent.slice(0, 4000)}${skillContent.length > 4000 ? '\n...(truncated)'
<a
href={selectedSkill.sourceUrl}
target="_blank"
rel="noreferrer"
rel="noopener noreferrer"
className="inline-flex items-center gap-2 bg-zinc-800 text-white px-4 py-2 font-mono text-sm hover:bg-zinc-700 transition-colors"
>
View on GitHub
@@ -560,19 +560,20 @@ ${skillContent.slice(0, 4000)}${skillContent.length > 4000 ? '\n...(truncated)'
)}
</Card>
<div className="flex border-b border-zinc-800 mb-6">
<div className="flex overflow-x-auto border-b border-zinc-800 mb-6 -mx-4 px-4 sm:mx-0 sm:px-0">
{(['principles', 'patterns', 'antipatterns'] as const).map((tab) => (
<button
key={tab}
type="button"
onClick={() => setActiveTab(tab)}
className={`px-6 py-3 font-mono text-sm uppercase tracking-wider transition-colors ${
className={`px-3 sm:px-6 py-3 font-mono text-xs sm:text-sm uppercase tracking-wider transition-colors whitespace-nowrap flex-shrink-0 ${
activeTab === tab
? 'text-white border-b-2 border-white -mb-px'
: 'text-zinc-500 hover:text-zinc-300'
}`}
>
{tab === 'antipatterns' ? 'Anti-Patterns' : tab}
<span className="ml-2 text-xs text-zinc-600">
<span className="ml-1 sm:ml-2 text-xs text-zinc-600">
({tab === 'principles' ? generatedSkill.principles.length : tab === 'patterns' ? generatedSkill.patterns.length : generatedSkill.antiPatterns.length})
</span>
</button>
@@ -594,8 +595,8 @@ ${skillContent.slice(0, 4000)}${skillContent.length > 4000 ? '\n...(truncated)'
<Card key={idx} className="hover:border-zinc-600 transition-colors">
<h4 className="text-lg font-semibold text-white mb-2">{pattern.name}</h4>
<p className="text-zinc-400 mb-4">{pattern.description}</p>
<pre className="bg-zinc-950 border border-zinc-800 p-4 overflow-x-auto text-sm">
<code className="text-zinc-300 font-mono">{pattern.example}</code>
<pre className="bg-zinc-900 border border-zinc-700 p-4 overflow-x-auto text-sm">
<code className="text-zinc-100 font-mono">{pattern.example}</code>
</pre>
</Card>
))}
@@ -607,16 +608,16 @@ ${skillContent.slice(0, 4000)}${skillContent.length > 4000 ? '\n...(truncated)'
{ap.badExample && (
<div className="mb-4">
<div className="text-xs font-mono text-red-400 mb-1 uppercase">Bad</div>
<pre className="bg-red-950/20 border border-red-900/30 p-4 overflow-x-auto text-sm">
<code className="text-red-300 font-mono">{ap.badExample}</code>
<pre className="bg-red-950/50 border border-red-800/50 p-4 overflow-x-auto text-sm">
<code className="text-red-100 font-mono">{ap.badExample}</code>
</pre>
</div>
)}
{ap.goodExample && (
<div>
<div className="text-xs font-mono text-zinc-300 mb-1 uppercase">Good</div>
<pre className="bg-zinc-900/50 border border-zinc-700 p-4 overflow-x-auto text-sm">
<code className="text-zinc-200 font-mono">{ap.goodExample}</code>
<div className="text-xs font-mono text-green-400 mb-1 uppercase">Good</div>
<pre className="bg-green-950/30 border border-green-800/50 p-4 overflow-x-auto text-sm">
<code className="text-green-100 font-mono">{ap.goodExample}</code>
</pre>
</div>
)}
@@ -633,7 +634,7 @@ ${skillContent.slice(0, 4000)}${skillContent.length > 4000 ? '\n...(truncated)'
<a
href={ref}
target="_blank"
rel="noreferrer"
rel="noopener noreferrer"
className="text-zinc-400 hover:text-white font-mono text-sm transition-colors"
>
{ref}
+11 -1
View File
@@ -2,5 +2,15 @@
"buildCommand": "npm run build",
"outputDirectory": "dist",
"installCommand": "npm install",
"framework": "vite"
"framework": "vite",
"rewrites": [
{
"source": "/docs/:path*",
"destination": "https://skillkit-docs.vercel.app/docs/:path*"
},
{
"source": "/docs",
"destination": "https://skillkit-docs.vercel.app/docs"
}
]
}
+6
View File
@@ -92,6 +92,12 @@
]
},
"description": "Compatible AI agents (omit for universal compatibility)"
},
"quality": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"description": "Pre-computed quality score (0-100). Verified sources default to 85."
}
}
}
+40 -10
View File
@@ -3,7 +3,7 @@
[![npm version](https://img.shields.io/npm/v/@skillkit/agents.svg)](https://www.npmjs.com/package/@skillkit/agents)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
**Agent adapters for SkillKit** - configuration and detection for 17 AI coding agents.
**Agent adapters for SkillKit** - configuration and detection for 32 AI coding agents.
## Installation
@@ -11,7 +11,7 @@
npm install @skillkit/agents
```
## Supported Agents (17)
## Supported Agents (32)
| Agent | Config Format | Project Skills | Global Skills |
|-------|--------------|----------------|---------------|
@@ -20,18 +20,33 @@ npm install @skillkit/agents
| Codex | SKILL.md | `.codex/skills/` | `~/.codex/skills/` |
| Gemini CLI | SKILL.md | `.gemini/skills/` | `~/.gemini/skills/` |
| OpenCode | SKILL.md | `.opencode/skills/` | `~/.config/opencode/skills/` |
| Antigravity | SKILL.md | `.antigravity/skills/` | `~/.gemini/antigravity/skills/` |
| Amp | SKILL.md | `.agents/skills/` | `~/.config/agents/skills/` |
| Clawdbot | SKILL.md | `skills/` | `~/.clawdbot/skills/` |
| Droid (Factory) | SKILL.md | `.factory/skills/` | `~/.factory/skills/` |
| GitHub Copilot | Markdown | `.github/skills/` | `~/.copilot/skills/` |
| Goose | SKILL.md | `.goose/skills/` | `~/.config/goose/skills/` |
| Antigravity | SKILL.md | `.antigravity/skills/` | - |
| Amp | SKILL.md | `.amp/skills/` | - |
| Clawdbot | SKILL.md | `.clawdbot/skills/` | - |
| Cline | SKILL.md | `.cline/skills/` | - |
| CodeBuddy | SKILL.md | `.codebuddy/skills/` | - |
| CommandCode | SKILL.md | `.commandcode/skills/` | - |
| Continue | SKILL.md | `.continue/skills/` | `~/.continue/skills/` |
| Crush | SKILL.md | `.crush/skills/` | - |
| Droid (Factory) | SKILL.md | `.factory/skills/` | - |
| Factory | SKILL.md | `.factory/skills/` | - |
| GitHub Copilot | Markdown | `.github/skills/` | - |
| Goose | SKILL.md | `.goose/skills/` | `~/.goose/skills/` |
| Kilo Code | SKILL.md | `.kilocode/skills/` | `~/.kilocode/skills/` |
| Kiro CLI | SKILL.md | `.kiro/skills/` | `~/.kiro/skills/` |
| MCPJam | SKILL.md | `.mcpjam/skills/` | - |
| Mux | SKILL.md | `.mux/skills/` | - |
| Neovate | SKILL.md | `.neovate/skills/` | - |
| OpenHands | SKILL.md | `.openhands/skills/` | - |
| Pi | SKILL.md | `.pi/skills/` | - |
| Qoder | SKILL.md | `.qoder/skills/` | - |
| Qwen | SKILL.md | `.qwen/skills/` | - |
| Roo Code | SKILL.md | `.roo/skills/` | `~/.roo/skills/` |
| Trae | SKILL.md | `.trae/skills/` | `~/.trae/skills/` |
| Trae | SKILL.md | `.trae/skills/` | - |
| Vercel | SKILL.md | `.vercel/skills/` | - |
| Windsurf | Markdown | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
| Universal | SKILL.md | `skills/` | `~/.agent/skills/` |
| Zencoder | SKILL.md | `.zencoder/skills/` | - |
| Universal | SKILL.md | `skills/` | - |
## Usage
@@ -155,14 +170,29 @@ type AgentType =
| 'antigravity'
| 'amp'
| 'clawdbot'
| 'cline'
| 'codebuddy'
| 'commandcode'
| 'continue'
| 'crush'
| 'droid'
| 'factory'
| 'github-copilot'
| 'goose'
| 'kilo'
| 'kiro-cli'
| 'mcpjam'
| 'mux'
| 'neovate'
| 'openhands'
| 'pi'
| 'qoder'
| 'qwen'
| 'roo'
| 'trae'
| 'vercel'
| 'windsurf'
| 'zencoder'
| 'universal';
```
+77
View File
@@ -0,0 +1,77 @@
import { existsSync } from 'node:fs';
import { join } from 'node:path';
import { homedir } from 'node:os';
import type { AgentAdapter } from './base.js';
import { createSkillXml } from './base.js';
import type { Skill, AgentType } from '@skillkit/core';
import { AGENT_CONFIG } from '@skillkit/core';
const config = AGENT_CONFIG.factory;
export class FactoryAdapter implements AgentAdapter {
readonly type: AgentType = 'factory';
readonly name = 'Factory';
readonly skillsDir = config.skillsDir;
readonly configFile = config.configFile;
generateConfig(skills: Skill[]): string {
const enabledSkills = skills.filter(s => s.enabled);
if (enabledSkills.length === 0) {
return '';
}
const skillsXml = enabledSkills.map(createSkillXml).join('\n\n');
return `<skills_system priority="1">
## Available Skills
<!-- SKILLS_TABLE_START -->
<usage>
When users ask you to perform tasks, check if any of the available skills below can help complete the task more effectively. Skills provide specialized capabilities and domain knowledge.
How to use skills:
- Invoke: \`skillkit read <skill-name>\` or \`npx skillkit read <skill-name>\`
- The skill content will load with detailed instructions on how to complete the task
- Base directory provided in output for resolving bundled resources (references/, scripts/, assets/)
Usage notes:
- Only use skills listed in <available_skills> below
- Do not invoke a skill that is already loaded in your context
- Each skill invocation is stateless
</usage>
<available_skills>
${skillsXml}
</available_skills>
<!-- SKILLS_TABLE_END -->
</skills_system>`;
}
parseConfig(content: string): string[] {
const skillNames: string[] = [];
const skillRegex = /<name>([^<]+)<\/name>/g;
let match;
while ((match = skillRegex.exec(content)) !== null) {
skillNames.push(match[1].trim());
}
return skillNames;
}
getInvokeCommand(skillName: string): string {
return `skillkit read ${skillName}`;
}
async isDetected(): Promise<boolean> {
const projectFactory = join(process.cwd(), '.factory');
const globalFactory = join(homedir(), '.factory');
return existsSync(projectFactory) || existsSync(globalFactory);
}
}
+32
View File
@@ -9,6 +9,7 @@ import { AntigravityAdapter } from './antigravity.js';
import { AmpAdapter } from './amp.js';
import { ClawdbotAdapter } from './clawdbot.js';
import { DroidAdapter } from './droid.js';
import { FactoryAdapter } from './factory.js';
import { GitHubCopilotAdapter } from './github-copilot.js';
import { GooseAdapter } from './goose.js';
import { KiloAdapter } from './kilo.js';
@@ -28,6 +29,7 @@ export * from './antigravity.js';
export * from './amp.js';
export * from './clawdbot.js';
export * from './droid.js';
export * from './factory.js';
export * from './github-copilot.js';
export * from './goose.js';
export * from './kilo.js';
@@ -58,6 +60,21 @@ const adapters: Record<AgentType, AgentAdapter> = {
trae: new TraeAdapter(),
windsurf: new WindsurfAdapter(),
universal: new UniversalAdapter(),
cline: new UniversalAdapter(),
codebuddy: new UniversalAdapter(),
commandcode: new UniversalAdapter(),
continue: new UniversalAdapter(),
crush: new UniversalAdapter(),
factory: new FactoryAdapter(),
mcpjam: new UniversalAdapter(),
mux: new UniversalAdapter(),
neovate: new UniversalAdapter(),
openhands: new UniversalAdapter(),
pi: new UniversalAdapter(),
qoder: new UniversalAdapter(),
qwen: new UniversalAdapter(),
vercel: new UniversalAdapter(),
zencoder: new UniversalAdapter(),
};
export function getAdapter(type: AgentType): AgentAdapter {
@@ -86,6 +103,21 @@ export async function detectAgent(): Promise<AgentType> {
'roo',
'trae',
'windsurf',
'cline',
'codebuddy',
'commandcode',
'continue',
'crush',
'factory',
'mcpjam',
'mux',
'neovate',
'openhands',
'pi',
'qoder',
'qwen',
'vercel',
'zencoder',
'universal',
];
+384
View File
@@ -0,0 +1,384 @@
import { existsSync, readFileSync, writeFileSync } from 'node:fs';
import { join, resolve, basename } from 'node:path';
import { Command, Option } from 'clipanion';
import {
evaluateSkillFile,
findAllSkills,
type QualityScore,
} from '@skillkit/core';
import { getSearchDirs } from '../helpers.js';
import {
colors,
symbols,
success,
warn,
error,
header,
confirm,
} from '../onboarding/index.js';
interface FixSuggestion {
type: 'add' | 'replace' | 'format';
description: string;
original?: string;
replacement: string;
line?: number;
automatic: boolean;
}
const FRONTMATTER_TEMPLATE = `---
name: {{NAME}}
description: {{DESCRIPTION}}
globs:
- "**/*"
---
`;
const WHEN_TO_USE_TEMPLATE = `
## When to Use
Use this skill when:
- [Add specific trigger conditions]
- [Add relevant patterns to detect]
`;
const BOUNDARIES_TEMPLATE = `
## Boundaries
This skill should NOT:
- [Add constraints and limitations]
- [Specify what the agent should never do]
`;
const VAGUE_TERM_REPLACEMENTS: Record<string, string> = {
'be helpful': 'follow the specific instructions below',
'assist the user': 'complete the requested task',
'help with': 'handle',
'try to': '',
'attempt to': '',
'do your best': 'follow these guidelines',
'as needed': 'when the following conditions are met',
'when appropriate': 'when',
'if necessary': 'when required',
'general purpose': 'designed for',
'various tasks': 'the following tasks',
'many things': 'the following',
'etc.': '',
'and so on': '',
'stuff like that': '',
};
function generateFixes(content: string, quality: QualityScore, skillName: string): FixSuggestion[] {
const fixes: FixSuggestion[] = [];
if (!quality.structure.hasMetadata) {
const template = FRONTMATTER_TEMPLATE
.replace('{{NAME}}', skillName)
.replace('{{DESCRIPTION}}', 'Add a description for this skill');
fixes.push({
type: 'add',
description: 'Add YAML frontmatter template',
replacement: template,
automatic: true,
});
}
if (!quality.structure.hasTriggers && !quality.structure.hasWhenToUse) {
fixes.push({
type: 'add',
description: 'Add "When to Use" section scaffold',
replacement: WHEN_TO_USE_TEMPLATE,
automatic: true,
});
}
if (!quality.structure.hasBoundaries) {
fixes.push({
type: 'add',
description: 'Add "Boundaries" section scaffold',
replacement: BOUNDARIES_TEMPLATE,
automatic: true,
});
}
for (const [vague, replacement] of Object.entries(VAGUE_TERM_REPLACEMENTS)) {
const escaped = vague.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
const regex = new RegExp(escaped, 'gi');
if (regex.test(content)) {
fixes.push({
type: 'replace',
description: `Replace vague term "${vague}"`,
original: vague,
replacement: replacement || '[be specific]',
automatic: false,
});
}
}
const codeBlockPattern = /```(\s*\n[\s\S]*?```)/g;
let match;
while ((match = codeBlockPattern.exec(content)) !== null) {
if (match[1].startsWith('\n') && !content.slice(match.index, match.index + 10).match(/```\w/)) {
fixes.push({
type: 'format',
description: 'Add language tag to code block',
original: '```',
replacement: '```typescript',
automatic: false,
});
break;
}
}
return fixes;
}
function applyFixes(content: string, fixes: FixSuggestion[]): string {
let result = content;
const hasFrontmatter = /^---\s*\n/.test(content);
for (const fix of fixes) {
if (fix.type === 'add') {
if (fix.description.includes('frontmatter') && !hasFrontmatter) {
result = fix.replacement + result;
} else if (fix.description.includes('When to Use') || fix.description.includes('Boundaries')) {
result = result.trimEnd() + '\n' + fix.replacement;
}
} else if (fix.type === 'replace' && fix.original && fix.automatic) {
const escaped = fix.original.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
const regex = new RegExp(escaped, 'gi');
result = result.replace(regex, fix.replacement);
}
}
return result;
}
export class FixCommand extends Command {
static override paths = [['fix']];
static override usage = Command.Usage({
description: 'Automatically fix common skill quality issues',
details: `
The fix command analyzes skills and applies automatic fixes for common quality issues.
Fixes that can be automated:
- Add missing YAML frontmatter template
- Add "When to Use" section scaffold
- Add "Boundaries" section scaffold
- Format code blocks with language tags
Interactive mode prompts before each fix.
`,
examples: [
['Fix a specific skill', '$0 fix my-skill'],
['Fix skill file', '$0 fix ./path/to/SKILL.md'],
['Preview fixes without applying', '$0 fix my-skill --dry-run'],
['Apply all fixes without prompts', '$0 fix my-skill --yes'],
],
});
targets = Option.Rest();
dryRun = Option.Boolean('--dry-run,-d', false, {
description: 'Show proposed changes without applying',
});
yes = Option.Boolean('--yes,-y', false, {
description: 'Apply all automatic fixes without prompting',
});
interactive = Option.Boolean('--interactive,-i', {
description: 'Prompt for each fix (default when not using --yes)',
});
async execute(): Promise<number> {
const isInteractive = this.interactive !== false && !this.yes && !this.dryRun && process.stdin.isTTY;
if (this.targets.length === 0) {
error('Please specify a skill to fix');
console.log(colors.muted('Usage: skillkit fix <skill-name> or skillkit fix ./path/to/SKILL.md'));
return 1;
}
header('Skill Quality Fixer');
let totalFixes = 0;
let filesFixed = 0;
for (const target of this.targets) {
const resolved = resolve(target);
let filePath: string | null = null;
let skillName = basename(target);
if (existsSync(resolved)) {
if (resolved.endsWith('.md') || resolved.endsWith('.mdc')) {
filePath = resolved;
const fileName = basename(resolved);
if (fileName.endsWith('.mdc')) {
skillName = fileName.slice(0, -4);
} else if (fileName.endsWith('.md')) {
skillName = fileName.slice(0, -3);
} else {
skillName = fileName;
}
} else {
const skillMd = join(resolved, 'SKILL.md');
const indexMdc = join(resolved, 'index.mdc');
if (existsSync(skillMd)) {
filePath = skillMd;
} else if (existsSync(indexMdc)) {
filePath = indexMdc;
}
}
} else {
const searchDirs = getSearchDirs();
const skills = findAllSkills(searchDirs);
const found = skills.find(s => s.name === target);
if (found) {
const skillMd = join(found.path, 'SKILL.md');
const indexMdc = join(found.path, 'index.mdc');
if (existsSync(skillMd)) {
filePath = skillMd;
} else if (existsSync(indexMdc)) {
filePath = indexMdc;
}
skillName = found.name;
}
}
if (!filePath || !existsSync(filePath)) {
warn(`Skill not found: ${target}`);
continue;
}
const content = readFileSync(filePath, 'utf-8');
const quality = evaluateSkillFile(filePath);
if (!quality) {
warn(`Could not evaluate: ${target}`);
continue;
}
console.log('');
console.log(colors.bold(skillName));
console.log(colors.muted(`Score: ${quality.overall}/100`));
const fixes = generateFixes(content, quality, skillName);
const automaticFixes = fixes.filter(f => f.automatic);
const manualFixes = fixes.filter(f => !f.automatic);
if (fixes.length === 0) {
console.log(colors.success(`${symbols.success} No automatic fixes needed`));
continue;
}
console.log('');
console.log(colors.muted(`Found ${fixes.length} potential fix(es):`));
for (const fix of automaticFixes) {
console.log(` ${colors.success(symbols.success)} ${fix.description} ${colors.muted('(automatic)')}`);
}
for (const fix of manualFixes) {
console.log(` ${colors.warning(symbols.warning)} ${fix.description} ${colors.muted('(manual review)')}`);
}
if (this.dryRun) {
console.log('');
console.log(colors.muted('Dry run - no changes applied'));
if (automaticFixes.length > 0) {
console.log('');
console.log(colors.muted('Preview of automatic fixes:'));
const preview = applyFixes(content, automaticFixes);
const diff = generateDiff(content, preview);
console.log(diff);
}
continue;
}
if (automaticFixes.length > 0) {
let shouldApply = this.yes;
if (isInteractive && !this.yes) {
console.log('');
const confirmResult = await confirm({
message: `Apply ${automaticFixes.length} automatic fix(es)?`,
initialValue: true,
});
shouldApply = confirmResult === true;
}
if (shouldApply) {
const fixed = applyFixes(content, automaticFixes);
writeFileSync(filePath, fixed, 'utf-8');
totalFixes += automaticFixes.length;
filesFixed++;
console.log(colors.success(`${symbols.success} Applied ${automaticFixes.length} fix(es)`));
} else {
console.log(colors.muted('Skipped'));
}
}
if (manualFixes.length > 0) {
console.log('');
console.log(colors.muted('Manual fixes required:'));
for (const fix of manualFixes) {
if (fix.original) {
console.log(` ${colors.warning(symbols.bullet)} Replace "${fix.original}" with "${fix.replacement}"`);
} else {
console.log(` ${colors.warning(symbols.bullet)} ${fix.description}`);
}
}
}
}
console.log('');
if (totalFixes > 0) {
success(`Fixed ${totalFixes} issue(s) in ${filesFixed} file(s)`);
console.log(colors.muted('Run "skillkit validate" to verify improvements'));
} else if (!this.dryRun) {
console.log(colors.muted('No fixes applied'));
}
return 0;
}
}
function generateDiff(original: string, modified: string): string {
const originalLines = original.split('\n');
const modifiedLines = modified.split('\n');
const originalSet = new Set(originalLines);
const modifiedSet = new Set(modifiedLines);
const added = modifiedLines.filter(line => !originalSet.has(line));
const removed = originalLines.filter(line => !modifiedSet.has(line));
const diff: string[] = [];
for (const line of removed.slice(0, 5)) {
diff.push(colors.error(`- ${line}`));
}
if (removed.length > 5) {
diff.push(colors.muted(` ... and ${removed.length - 5} more removed`));
}
for (const line of added.slice(0, 10)) {
diff.push(colors.success(`+ ${line}`));
}
if (added.length > 10) {
diff.push(colors.muted(` ... and ${added.length - 10} more added`));
}
if (diff.length === 0) {
diff.push(colors.muted(' (no visible changes)'));
}
return diff.join('\n');
}
+1
View File
@@ -8,6 +8,7 @@ export { RemoveCommand } from './remove.js';
export { InstallCommand } from './install.js';
export { UpdateCommand } from './update.js';
export { ValidateCommand } from './validate.js';
export { FixCommand } from './fix.js';
export { CreateCommand } from './create.js';
export { UICommand } from './ui.js';
export { TranslateCommand } from './translate.js';
+31 -2
View File
@@ -1,7 +1,7 @@
import { existsSync, mkdirSync, cpSync, rmSync, symlinkSync } from 'node:fs';
import { join } from 'node:path';
import { Command, Option } from 'clipanion';
import { detectProvider, isLocalPath, getProvider } from '@skillkit/core';
import { detectProvider, isLocalPath, getProvider, evaluateSkillDirectory } from '@skillkit/core';
import type { SkillMetadata, GitProvider, AgentType } from '@skillkit/core';
import { isPathInside } from '@skillkit/core';
import { getAdapter, detectAgent, getAllAdapters } from '@skillkit/agents';
@@ -28,6 +28,8 @@ import {
showNextSteps,
saveLastAgents,
getLastAgents,
formatQualityBadge,
getQualityGradeFromScore,
type InstallResult,
} from '../onboarding/index.js';
@@ -135,7 +137,9 @@ export class InstallCommand extends Command {
console.log(colors.bold('Available skills:'));
console.log('');
for (const skill of discoveredSkills) {
console.log(` ${colors.success(symbols.stepActive)} ${colors.primary(skill.name)}`);
const quality = evaluateSkillDirectory(skill.path);
const qualityBadge = quality ? ` ${formatQualityBadge(quality.overall)}` : '';
console.log(` ${colors.success(symbols.stepActive)} ${colors.primary(skill.name)}${qualityBadge}`);
}
console.log('');
console.log(colors.muted(`Total: ${discoveredSkills.length} skill(s)`));
@@ -237,9 +241,34 @@ export class InstallCommand extends Command {
installMethod = methodResult as 'symlink' | 'copy';
}
// Check for low-quality skills and warn
const lowQualitySkills: Array<{ name: string; score: number; warnings: string[] }> = [];
for (const skill of skillsToInstall) {
const quality = evaluateSkillDirectory(skill.path);
if (quality && quality.overall < 60) {
lowQualitySkills.push({
name: skill.name,
score: quality.overall,
warnings: quality.warnings.slice(0, 2),
});
}
}
// Confirm installation
if (isInteractive && !this.yes) {
console.log('');
// Show low-quality warning if any
if (lowQualitySkills.length > 0) {
console.log(colors.warning(`${symbols.warning} Warning: ${lowQualitySkills.length} skill(s) have low quality scores (< 60)`));
for (const lq of lowQualitySkills) {
const grade = getQualityGradeFromScore(lq.score);
const warningText = lq.warnings.length > 0 ? ` - ${lq.warnings.join(', ')}` : '';
console.log(colors.muted(` - ${lq.name} [${grade}]${warningText}`));
}
console.log('');
}
const agentDisplay = targetAgents.length <= 3
? targetAgents.map(formatAgent).join(', ')
: `${targetAgents.slice(0, 2).map(formatAgent).join(', ')} +${targetAgents.length - 2} more`;
+35 -8
View File
@@ -1,7 +1,8 @@
import chalk from 'chalk';
import { Command, Option } from 'clipanion';
import { findAllSkills } from '@skillkit/core';
import { findAllSkills, evaluateSkillDirectory } from '@skillkit/core';
import { getSearchDirs } from '../helpers.js';
import { formatQualityBadge, colors } from '../onboarding/index.js';
export class ListCommand extends Command {
static override paths = [['list'], ['ls'], ['l']];
@@ -23,6 +24,10 @@ export class ListCommand extends Command {
description: 'Show only disabled skills',
});
quality = Option.Boolean('--quality,-q', false, {
description: 'Show quality scores and grades',
});
json = Option.Boolean('--json,-j', false, {
description: 'Output as JSON',
});
@@ -44,8 +49,18 @@ export class ListCommand extends Command {
return a.name.localeCompare(b.name);
});
const skillsWithQuality = this.quality || this.json
? skills.map(s => {
const quality = evaluateSkillDirectory(s.path);
return {
...s,
quality: quality?.overall ?? null,
};
})
: skills.map(s => ({ ...s, quality: null as number | null }));
if (this.json) {
console.log(JSON.stringify(skills, null, 2));
console.log(JSON.stringify(skillsWithQuality, null, 2));
return 0;
}
@@ -57,13 +72,13 @@ export class ListCommand extends Command {
console.log(chalk.cyan(`Installed skills (${skills.length}):\n`));
const projectSkills = skills.filter(s => s.location === 'project');
const globalSkills = skills.filter(s => s.location === 'global');
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:'));
for (const skill of projectSkills) {
printSkill(skill);
printSkill(skill, this.quality);
}
console.log();
}
@@ -71,7 +86,7 @@ export class ListCommand extends Command {
if (globalSkills.length > 0) {
console.log(chalk.dim('Global skills:'));
for (const skill of globalSkills) {
printSkill(skill);
printSkill(skill, this.quality);
}
console.log();
}
@@ -86,16 +101,28 @@ export class ListCommand extends Command {
)
);
if (this.quality) {
const qualityScores = skillsWithQuality.filter(s => s.quality !== null).map(s => s.quality!);
if (qualityScores.length > 0) {
const avgQuality = Math.round(qualityScores.reduce((a, b) => a + b, 0) / qualityScores.length);
console.log(colors.muted(`Average quality: ${avgQuality}/100`));
}
}
return 0;
}
}
function printSkill(skill: { name: string; description: string; enabled: boolean; location: string }) {
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 qualityBadge = showQuality && skill.quality !== null ? ` ${formatQualityBadge(skill.quality)}` : '';
console.log(` ${status} ${name}`);
console.log(` ${status} ${name}${qualityBadge}`);
if (skill.description) {
console.log(` ${desc}`);
}
+11 -1
View File
@@ -20,6 +20,8 @@ import {
warn,
showProjectSummary,
progressBar,
formatQualityBadge,
getQualityGradeFromScore,
} from '../onboarding/index.js';
export class RecommendCommand extends Command {
@@ -236,8 +238,12 @@ export class RecommendCommand extends Command {
scoreColor = colors.muted;
}
const scoreBar = progressBar(rec.score, 100, 10);
const qualityScore = rec.skill.quality ?? null;
const qualityDisplay = qualityScore !== null && qualityScore !== undefined
? ` ${formatQualityBadge(qualityScore)}`
: '';
console.log(` ${scoreColor(`${rec.score}%`)} ${colors.dim(scoreBar)} ${colors.bold(rec.skill.name)}`);
console.log(` ${scoreColor(`${rec.score}%`)} ${colors.dim(scoreBar)} ${colors.bold(rec.skill.name)}${qualityDisplay}`);
if (rec.skill.description) {
console.log(` ${colors.muted(truncate(rec.skill.description, 70))}`);
@@ -252,6 +258,10 @@ export class RecommendCommand extends Command {
for (const reason of rec.reasons.filter(r => r.weight > 0)) {
console.log(` ${colors.muted(symbols.stepActive)} ${reason.description} (+${reason.weight})`);
}
if (qualityScore !== null && qualityScore !== undefined) {
const grade = getQualityGradeFromScore(qualityScore);
console.log(` ${colors.muted(symbols.stepActive)} Quality: ${qualityScore}/100 (${grade})`);
}
}
if (rec.warnings.length > 0) {
+408 -54
View File
@@ -1,87 +1,441 @@
import { existsSync, readdirSync } from 'node:fs';
import { join, basename } from 'node:path';
import chalk from 'chalk';
import { existsSync, readdirSync, statSync } from 'node:fs';
import { join, basename, resolve, dirname } from 'node:path';
import { Command, Option } from 'clipanion';
import { validateSkill } from '@skillkit/core';
import {
validateSkill,
evaluateSkillFile,
evaluateSkillDirectory,
getQualityGrade,
isHighQuality,
findAllSkills,
benchmarkSkill,
type QualityScore,
type BenchmarkResult,
} from '@skillkit/core';
import { getSearchDirs } from '../helpers.js';
import {
colors,
symbols,
spinner,
success,
warn,
error,
header,
} from '../onboarding/index.js';
function formatScore(score: number): string {
if (score >= 80) return colors.success(`${score}`);
if (score >= 60) return colors.warning(`${score}`);
return colors.error(`${score}`);
}
function formatGrade(grade: string): string {
switch (grade) {
case 'A':
case 'B':
return colors.success(grade);
case 'C':
case 'D':
return colors.warning(grade);
default:
return colors.error(grade);
}
}
function printQualityReport(name: string, quality: QualityScore, verbose: boolean): void {
const grade = getQualityGrade(quality.overall);
const gradeDisplay = formatGrade(grade);
const scoreDisplay = formatScore(quality.overall);
console.log(`\n${colors.primary(name)}`);
console.log(` Grade: ${gradeDisplay} Score: ${scoreDisplay}/100`);
if (verbose) {
console.log('');
console.log(` ${colors.muted('Structure:')} ${formatScore(quality.structure.score)}/100`);
console.log(` ${quality.structure.hasMetadata ? colors.success(symbols.success) : colors.error(symbols.error)} Metadata`);
console.log(` ${quality.structure.hasDescription ? colors.success(symbols.success) : colors.error(symbols.error)} Description`);
console.log(` ${quality.structure.hasTriggers ? colors.success(symbols.success) : colors.error(symbols.error)} Trigger conditions`);
console.log(` ${quality.structure.hasExamples ? colors.success(symbols.success) : colors.error(symbols.error)} Code examples`);
console.log(` ${quality.structure.hasBoundaries ? colors.success(symbols.success) : colors.error(symbols.error)} Boundaries defined`);
console.log('');
console.log(` ${colors.muted('Clarity:')} ${formatScore(quality.clarity.score)}/100`);
console.log(` Lines: ${quality.clarity.lineCount}${quality.clarity.lineCount > 300 ? colors.warning(' (consider splitting)') : ''}`);
console.log(` Tokens: ${quality.clarity.tokenCount}${quality.clarity.tokenCount > 2000 ? colors.warning(' (high)') : ''}`);
console.log(` ${quality.clarity.hasHeaders ? colors.success(symbols.success) : colors.error(symbols.error)} Uses headers`);
console.log('');
console.log(` ${colors.muted('Specificity:')} ${formatScore(quality.specificity.score)}/100`);
console.log(` ${quality.specificity.hasConcreteCommands ? colors.success(symbols.success) : colors.error(symbols.error)} Concrete commands`);
console.log(` ${quality.specificity.hasFilePatterns ? colors.success(symbols.success) : colors.error(symbols.error)} File patterns`);
console.log(` ${quality.specificity.hasCodeExamples ? colors.success(symbols.success) : colors.error(symbols.error)} Multiple code examples`);
if (quality.specificity.vagueTermCount > 0) {
console.log(` ${colors.warning(symbols.warning)} ${quality.specificity.vagueTermCount} vague term(s)`);
}
console.log('');
console.log(` ${colors.muted('Advanced:')} ${formatScore(quality.advanced.score)}/100`);
if (quality.advanced.deprecatedPatterns.length > 0) {
console.log(` ${colors.warning(symbols.warning)} ${quality.advanced.deprecatedPatterns.length} deprecated pattern(s)`);
for (const pattern of quality.advanced.deprecatedPatterns) {
console.log(` ${colors.muted(symbols.bullet)} ${pattern}`);
}
}
if (quality.advanced.securityIssues.length > 0) {
console.log(` ${colors.error(symbols.error)} ${quality.advanced.securityIssues.length} security issue(s)`);
for (const issue of quality.advanced.securityIssues) {
console.log(` ${colors.muted(symbols.bullet)} ${issue}`);
}
}
if (quality.advanced.conflictingInstructions.length > 0) {
console.log(` ${colors.warning(symbols.warning)} ${quality.advanced.conflictingInstructions.length} conflicting instruction(s)`);
}
console.log(` Completeness: ${quality.advanced.completeness.score}/100`);
console.log(` Example coverage: ${quality.advanced.completeness.exampleCoverage}%`);
if (quality.advanced.completeness.hasTodos) {
console.log(` ${colors.warning(symbols.warning)} ${quality.advanced.completeness.todoCount} TODO/FIXME comment(s)`);
}
}
if (quality.warnings.length > 0) {
console.log('');
console.log(` ${colors.warning('Warnings:')}`);
for (const w of quality.warnings) {
console.log(` ${colors.warning(symbols.warning)} ${w}`);
}
}
if (quality.suggestions.length > 0 && verbose) {
console.log('');
console.log(` ${colors.muted('Suggestions:')}`);
for (const s of quality.suggestions) {
console.log(` ${colors.muted(symbols.bullet)} ${s}`);
}
}
}
function printBenchmarkReport(benchmark: BenchmarkResult): void {
console.log('');
console.log(colors.bold('Benchmark Comparison'));
console.log('');
console.log(` ${colors.muted('Your Score:')} ${formatScore(benchmark.score)}/100 ${formatGrade(benchmark.grade)}`);
console.log(` ${colors.muted('Category Average:')} ${benchmark.categoryAvg}/100`);
console.log(` ${colors.muted('Top Skill Score:')} ${benchmark.topSkillScore}/100`);
console.log(` ${colors.muted('Percentile:')} ${benchmark.percentile}${getOrdinal(benchmark.percentile)}`);
if (benchmark.comparisonNotes.length > 0) {
console.log('');
console.log(` ${colors.muted('Comparison:')}`);
for (const note of benchmark.comparisonNotes) {
console.log(` ${colors.muted(symbols.bullet)} ${note}`);
}
}
if (benchmark.recommendations.length > 0) {
console.log('');
console.log(` ${colors.muted('To Improve:')}`);
for (const rec of benchmark.recommendations) {
console.log(` ${colors.info(symbols.info)} ${rec}`);
}
}
}
function getOrdinal(n: number): string {
const s = ['th', 'st', 'nd', 'rd'];
const v = n % 100;
return s[(v - 20) % 10] || s[v] || s[0];
}
export class ValidateCommand extends Command {
static override paths = [['validate'], ['v']];
static override paths = [['validate']];
static override usage = Command.Usage({
description: 'Validate skill(s) against the Agent Skills specification (agentskills.io)',
description: 'Validate skill format and quality',
details: `
Validates skills against the specification and evaluates quality.
Quality scores are based on structure, clarity, and specificity.
`,
examples: [
['Validate a skill directory', '$0 validate ./my-skill'],
['Validate all skills in a directory', '$0 validate ./skills --all'],
['Validate all installed skills', '$0 validate'],
['Validate specific skill', '$0 validate my-skill'],
['Validate skill file', '$0 validate ./path/to/SKILL.md'],
['Detailed quality report', '$0 validate --verbose'],
['Only show issues', '$0 validate --issues'],
['Quality check only', '$0 validate --quality'],
['JSON output', '$0 validate --json'],
],
});
skillPath = Option.String({ required: true });
targets = Option.Rest();
verbose = Option.Boolean('--verbose,-v', false, {
description: 'Show detailed quality breakdown',
});
quality = Option.Boolean('--quality,-q', false, {
description: 'Only check quality (skip format validation)',
});
issues = Option.Boolean('--issues,-i', false, {
description: 'Only show skills with issues',
});
minScore = Option.String('--min-score,-m', {
description: 'Minimum acceptable score (default: 60)',
});
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
all = Option.Boolean('--all,-a', false, {
description: 'Validate all skills in the directory',
description: 'Validate all skills in directory',
});
benchmark = Option.Boolean('--benchmark,-b', false, {
description: 'Compare skill against category leaders',
});
fix = Option.Boolean('--fix', false, {
description: 'Automatically fix common quality issues (runs fix command)',
});
async execute(): Promise<number> {
const targetPath = this.skillPath;
if (!existsSync(targetPath)) {
console.error(chalk.red(`Path does not exist: ${targetPath}`));
return 1;
if (this.fix) {
if (this.targets.length === 0) {
error('--fix requires at least one target');
console.log(colors.muted('Usage: skillkit validate --fix <skill-name>'));
return 1;
}
const { FixCommand } = await import('./fix.js');
const fixCmd = new FixCommand();
fixCmd.targets = this.targets;
fixCmd.yes = false;
return fixCmd.execute();
}
const skillPaths: string[] = [];
let minScore = 60;
if (this.minScore) {
const parsed = parseInt(this.minScore, 10);
if (Number.isNaN(parsed) || parsed < 0 || parsed > 100) {
if (!this.json) {
warn(`Invalid --min-score value "${this.minScore}", using default: 60`);
}
} else {
minScore = parsed;
}
}
const results: Array<{ name: string; quality: QualityScore | null; formatValid: boolean; formatErrors: string[]; path?: string }> = [];
if (this.all) {
const entries = readdirSync(targetPath, { withFileTypes: true });
for (const entry of entries) {
if (entry.isDirectory()) {
const skillPath = join(targetPath, entry.name);
if (existsSync(join(skillPath, 'SKILL.md'))) {
skillPaths.push(skillPath);
if (this.targets.length > 0) {
for (const target of this.targets) {
const resolved = resolve(target);
if (existsSync(resolved)) {
const isDirectory = statSync(resolved).isDirectory();
if (this.all) {
if (!isDirectory) {
if (!this.json) {
warn(`--all requires a directory, but "${target}" is a file`);
}
continue;
}
const entries = readdirSync(resolved, { withFileTypes: true });
for (const entry of entries) {
if (entry.isDirectory()) {
const skillPath = join(resolved, entry.name);
const hasSkillMd = existsSync(join(skillPath, 'SKILL.md'));
const hasIndexMdc = existsSync(join(skillPath, 'index.mdc'));
const hasNamedMdc = existsSync(join(skillPath, `${entry.name}.mdc`));
if (hasSkillMd || hasIndexMdc || hasNamedMdc) {
const formatResult = this.quality ? { valid: true, errors: [] } : validateSkill(skillPath);
const quality = evaluateSkillDirectory(skillPath);
results.push({
name: entry.name,
quality,
formatValid: formatResult.valid,
formatErrors: formatResult.errors || [],
path: skillPath,
});
}
}
}
} else {
const isFile = resolved.endsWith('.md') || resolved.endsWith('.mdc');
const skillDir = isFile ? dirname(resolved) : resolved;
const formatResult = this.quality ? { valid: true, errors: [] } : validateSkill(skillDir);
const quality = isFile ? evaluateSkillFile(resolved) : evaluateSkillDirectory(resolved);
results.push({
name: basename(target),
quality,
formatValid: formatResult.valid,
formatErrors: formatResult.errors || [],
path: resolved,
});
}
} else {
const searchDirs = getSearchDirs();
const skills = findAllSkills(searchDirs);
const found = skills.find(s => s.name === target);
if (found) {
const formatResult = this.quality ? { valid: true, errors: [] } : validateSkill(found.path);
const quality = evaluateSkillDirectory(found.path);
results.push({
name: found.name,
quality,
formatValid: formatResult.valid,
formatErrors: formatResult.errors || [],
path: found.path,
});
} else {
if (!this.json) {
warn(`Skill not found: ${target}`);
}
}
}
}
if (skillPaths.length === 0) {
console.error(chalk.yellow('No skills found in directory'));
return 1;
}
} else {
skillPaths.push(targetPath);
}
const searchDirs = getSearchDirs();
const skills = findAllSkills(searchDirs);
let hasErrors = false;
for (const skillPath of skillPaths) {
const skillName = basename(skillPath);
const result = validateSkill(skillPath);
if (result.valid) {
console.log(chalk.green(`✓ ${skillName}`));
if (result.warnings && result.warnings.length > 0) {
result.warnings.forEach(w => {
console.log(chalk.yellow(` ⚠ ${w}`));
});
if (skills.length === 0) {
if (!this.json) {
warn('No installed skills found');
}
} else {
console.log(chalk.red(`✗ ${skillName}`));
result.errors.forEach(e => {
console.log(chalk.red(` • ${e}`));
return 0;
}
const s = spinner();
if (!this.json) {
s.start(`Evaluating ${skills.length} skill(s)...`);
}
for (const skill of skills) {
const formatResult = this.quality ? { valid: true, errors: [] } : validateSkill(skill.path);
const quality = evaluateSkillDirectory(skill.path);
results.push({
name: skill.name,
quality,
formatValid: formatResult.valid,
formatErrors: formatResult.errors || [],
path: skill.path,
});
hasErrors = true;
}
if (!this.json) {
s.stop(`Evaluated ${results.length} skill(s)`);
}
}
console.log();
if (hasErrors) {
console.log(chalk.red('Validation failed'));
console.log(chalk.dim('See https://agentskills.io/specification for the complete format'));
if (results.length === 0) {
if (!this.json) {
error('No skills to validate');
}
return 1;
}
console.log(chalk.green(`Validated ${skillPaths.length} skill(s) successfully`));
if (this.json) {
const output = results.map(r => {
const result: Record<string, unknown> = {
name: r.name,
path: r.path,
formatValid: r.formatValid,
formatErrors: r.formatErrors,
score: r.quality?.overall ?? null,
grade: r.quality ? getQualityGrade(r.quality.overall) : null,
highQuality: r.quality ? isHighQuality(r.quality) : false,
structure: r.quality?.structure ?? null,
clarity: r.quality?.clarity ?? null,
specificity: r.quality?.specificity ?? null,
advanced: r.quality?.advanced ?? null,
warnings: r.quality?.warnings ?? [],
suggestions: r.quality?.suggestions ?? [],
};
if (this.benchmark && r.quality) {
result.benchmark = benchmarkSkill(r.name, r.quality);
}
return result;
});
console.log(JSON.stringify(output, null, 2));
const hasFormatFailures = results.some(r => !r.formatValid);
const hasBelowThreshold = results.some(r => r.quality && r.quality.overall < minScore);
return hasFormatFailures || hasBelowThreshold ? 1 : 0;
}
header('Skill Validation Report');
let filteredResults = results;
if (this.issues) {
filteredResults = results.filter(r =>
!r.formatValid ||
(r.quality && r.quality.overall < minScore) ||
(r.quality && r.quality.warnings.length > 0)
);
}
filteredResults.sort((a, b) => (b.quality?.overall ?? 0) - (a.quality?.overall ?? 0));
for (const { name, quality, formatValid, formatErrors } of filteredResults) {
if (!formatValid) {
console.log(`\n${colors.error(symbols.error)} ${colors.primary(name)}`);
console.log(` ${colors.error('Format validation failed:')}`);
for (const err of formatErrors) {
console.log(` ${colors.error(symbols.bullet)} ${err}`);
}
}
if (quality) {
printQualityReport(name, quality, this.verbose);
if (this.benchmark) {
const benchmark = benchmarkSkill(name, quality);
printBenchmarkReport(benchmark);
}
}
}
console.log('');
const formatFailed = results.filter(r => !r.formatValid).length;
const withQuality = results.filter(r => r.quality !== null);
const highQuality = withQuality.filter(r => r.quality!.overall >= 80).length;
const passing = withQuality.filter(r => r.quality!.overall >= minScore).length;
const failing = withQuality.filter(r => r.quality!.overall < minScore).length;
console.log(colors.muted('Summary:'));
if (!this.quality) {
console.log(` ${formatFailed === 0 ? colors.success(symbols.success) : colors.error(symbols.error)} Format valid: ${results.length - formatFailed}/${results.length}`);
}
console.log(` ${colors.success(symbols.success)} High quality (80+): ${highQuality}`);
console.log(` ${colors.primary(symbols.bullet)} Passing (${minScore}+): ${passing}`);
if (failing > 0) {
console.log(` ${colors.error(symbols.error)} Below threshold: ${failing}`);
}
if (withQuality.length > 0) {
const avgScore = Math.round(withQuality.reduce((sum, r) => sum + r.quality!.overall, 0) / withQuality.length);
console.log(` ${colors.muted('Average score:')} ${formatScore(avgScore)}/100`);
}
if (formatFailed > 0 || failing > 0) {
console.log('');
if (formatFailed > 0) {
warn(`${formatFailed} skill(s) failed format validation`);
}
if (failing > 0) {
warn(`${failing} skill(s) below quality threshold`);
}
return 1;
}
console.log('');
success('All skills validated successfully');
return 0;
}
}
+3
View File
@@ -9,6 +9,9 @@ export {
formatAgentIconsInline,
progressBar,
formatScore,
formatQualityBadge,
formatQualityBadgeCompact,
getQualityGradeFromScore,
} from './theme.js';
export {
+22
View File
@@ -132,3 +132,25 @@ export function formatScore(score: number): string {
}
return `${scoreColor(`${score}%`)} ${colors.dim(bar)}`;
}
export function getQualityGradeFromScore(score: number): string {
if (score >= 90) return 'A';
if (score >= 80) return 'B';
if (score >= 70) return 'C';
if (score >= 60) return 'D';
return 'F';
}
export function formatQualityBadge(score: number): string {
const grade = getQualityGradeFromScore(score);
if (score >= 80) return colors.success(`[${grade}]`);
if (score >= 60) return colors.warning(`[${grade}]`);
return colors.error(`[${grade}]`);
}
export function formatQualityBadgeCompact(score: number): string {
const grade = getQualityGradeFromScore(score);
if (score >= 80) return colors.success(grade);
if (score >= 60) return colors.warning(grade);
return colors.error(grade);
}
+136
View File
@@ -212,6 +212,142 @@ export const AGENT_CONFIG: Record<AgentType, AgentDirectoryConfig> = {
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Cline
cline: {
skillsDir: '.cline/skills',
configFile: 'AGENTS.md',
configFormat: 'xml',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Codebuddy
codebuddy: {
skillsDir: '.codebuddy/skills',
configFile: 'AGENTS.md',
configFormat: 'xml',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Commandcode
commandcode: {
skillsDir: '.commandcode/skills',
configFile: 'AGENTS.md',
configFormat: 'xml',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Continue
continue: {
skillsDir: '.continue/skills',
configFile: 'AGENTS.md',
globalSkillsDir: '~/.continue/skills',
configFormat: 'xml',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Crush
crush: {
skillsDir: '.crush/skills',
configFile: 'AGENTS.md',
configFormat: 'xml',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Factory
factory: {
skillsDir: '.factory/skills',
configFile: 'AGENTS.md',
configFormat: 'xml',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// MCPJam
mcpjam: {
skillsDir: '.mcpjam/skills',
configFile: 'AGENTS.md',
configFormat: 'xml',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Mux
mux: {
skillsDir: '.mux/skills',
configFile: 'AGENTS.md',
configFormat: 'xml',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Neovate
neovate: {
skillsDir: '.neovate/skills',
configFile: 'AGENTS.md',
configFormat: 'xml',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// OpenHands
openhands: {
skillsDir: '.openhands/skills',
configFile: 'AGENTS.md',
configFormat: 'xml',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Pi
pi: {
skillsDir: '.pi/skills',
configFile: 'AGENTS.md',
configFormat: 'xml',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Qoder
qoder: {
skillsDir: '.qoder/skills',
configFile: 'AGENTS.md',
configFormat: 'xml',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Qwen
qwen: {
skillsDir: '.qwen/skills',
configFile: 'AGENTS.md',
configFormat: 'xml',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Vercel
vercel: {
skillsDir: '.vercel/skills',
configFile: 'AGENTS.md',
configFormat: 'xml',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Zencoder
zencoder: {
skillsDir: '.zencoder/skills',
configFile: 'AGENTS.md',
configFormat: 'xml',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
};
/**
+53 -8
View File
@@ -222,7 +222,7 @@ export const AGENT_DISCOVERY_PATHS: Record<AgentType, string[]> = {
'antigravity': ['.antigravity/agents'],
'amp': ['.amp/agents'],
'clawdbot': ['.clawdbot/agents', 'agents'],
'droid': ['.factory/agents'],
'droid': ['.droid/agents'],
'github-copilot': ['.github/agents', '.github/instructions', '.github/custom-agents'],
'goose': ['.goose/agents'],
'kilo': ['.kilocode/agents', '.kilocode/modes'],
@@ -231,6 +231,21 @@ export const AGENT_DISCOVERY_PATHS: Record<AgentType, string[]> = {
'trae': ['.trae/agents', '.trae/agent'],
'windsurf': ['.windsurf/agents', '.windsurf/workflows'],
'universal': ['agents', '.agents'],
'cline': ['.cline/agents'],
'codebuddy': ['.codebuddy/agents'],
'commandcode': ['.commandcode/agents'],
'continue': ['.continue/agents'],
'crush': ['.crush/agents'],
'factory': ['.factory/agents'],
'mcpjam': ['.mcpjam/agents'],
'mux': ['.mux/agents'],
'neovate': ['.neovate/agents'],
'openhands': ['.openhands/agents'],
'pi': ['.pi/agents'],
'qoder': ['.qoder/agents'],
'qwen': ['.qwen/agents'],
'vercel': ['.vercel/agents'],
'zencoder': ['.zencoder/agents'],
};
/**
@@ -239,17 +254,21 @@ export const AGENT_DISCOVERY_PATHS: Record<AgentType, string[]> = {
export const ALL_AGENT_DISCOVERY_PATHS = [
'agents',
'.agents',
'.amp/agents',
'.antigravity/agents',
'.claude/agents',
'.cline/agents',
'.clawdbot/agents',
'.codebuddy/agents',
'.codex/agents',
'.commandcode/agents',
'.continue/agents',
'.crush/agents',
'.cursor/agents',
'.cursor/commands',
'.codex/agents',
'.gemini/agents',
'.opencode/agents',
'.opencode/agent',
'.antigravity/agents',
'.amp/agents',
'.clawdbot/agents',
'.droid/agents',
'.factory/agents',
'.gemini/agents',
'.github/agents',
'.github/instructions',
'.github/custom-agents',
@@ -257,12 +276,23 @@ export const ALL_AGENT_DISCOVERY_PATHS = [
'.kilocode/agents',
'.kilocode/modes',
'.kiro/agents',
'.mcpjam/agents',
'.mux/agents',
'.neovate/agents',
'.opencode/agents',
'.opencode/agent',
'.openhands/agents',
'.pi/agents',
'.qoder/agents',
'.qwen/agents',
'.roo/agents',
'.roo/modes',
'.trae/agents',
'.trae/agent',
'.vercel/agents',
'.windsurf/agents',
'.windsurf/workflows',
'.zencoder/agents',
];
/**
@@ -286,4 +316,19 @@ export const CUSTOM_AGENT_FORMAT_MAP: Record<AgentType, AgentFormatCategory> = {
'trae': 'claude-agent',
'windsurf': 'universal',
'universal': 'universal',
'cline': 'claude-agent',
'codebuddy': 'claude-agent',
'commandcode': 'claude-agent',
'continue': 'claude-agent',
'crush': 'claude-agent',
'factory': 'claude-agent',
'mcpjam': 'claude-agent',
'mux': 'claude-agent',
'neovate': 'claude-agent',
'openhands': 'claude-agent',
'pi': 'claude-agent',
'qoder': 'claude-agent',
'qwen': 'claude-agent',
'vercel': 'claude-agent',
'zencoder': 'claude-agent',
};
+105
View File
@@ -136,6 +136,111 @@ const AGENT_FORMATS: Record<AgentType, AgentCommandFormat> = {
supportsSlashCommands: true,
supportsCommandFiles: true,
},
cline: {
agent: 'cline',
extension: '.md',
directory: '.cline/commands',
supportsSlashCommands: true,
supportsCommandFiles: true,
},
codebuddy: {
agent: 'codebuddy',
extension: '.md',
directory: '.codebuddy/commands',
supportsSlashCommands: true,
supportsCommandFiles: true,
},
commandcode: {
agent: 'commandcode',
extension: '.md',
directory: '.commandcode/commands',
supportsSlashCommands: true,
supportsCommandFiles: true,
},
continue: {
agent: 'continue',
extension: '.md',
directory: '.continue/commands',
supportsSlashCommands: true,
supportsCommandFiles: true,
},
crush: {
agent: 'crush',
extension: '.md',
directory: '.crush/commands',
supportsSlashCommands: true,
supportsCommandFiles: true,
},
factory: {
agent: 'factory',
extension: '.md',
directory: '.factory/commands',
supportsSlashCommands: true,
supportsCommandFiles: true,
},
mcpjam: {
agent: 'mcpjam',
extension: '.md',
directory: '.mcpjam/commands',
supportsSlashCommands: true,
supportsCommandFiles: true,
},
mux: {
agent: 'mux',
extension: '.md',
directory: '.mux/commands',
supportsSlashCommands: true,
supportsCommandFiles: true,
},
neovate: {
agent: 'neovate',
extension: '.md',
directory: '.neovate/commands',
supportsSlashCommands: true,
supportsCommandFiles: true,
},
openhands: {
agent: 'openhands',
extension: '.md',
directory: '.openhands/commands',
supportsSlashCommands: true,
supportsCommandFiles: true,
},
pi: {
agent: 'pi',
extension: '.md',
directory: '.pi/commands',
supportsSlashCommands: true,
supportsCommandFiles: true,
},
qoder: {
agent: 'qoder',
extension: '.md',
directory: '.qoder/commands',
supportsSlashCommands: true,
supportsCommandFiles: true,
},
qwen: {
agent: 'qwen',
extension: '.md',
directory: '.qwen/commands',
supportsSlashCommands: true,
supportsCommandFiles: true,
},
vercel: {
agent: 'vercel',
extension: '.md',
directory: '.vercel/commands',
supportsSlashCommands: true,
supportsCommandFiles: true,
},
zencoder: {
agent: 'zencoder',
extension: '.md',
directory: '.zencoder/commands',
supportsSlashCommands: true,
supportsCommandFiles: true,
},
};
/**
+2
View File
@@ -75,3 +75,5 @@ export * from './agents/index.js';
export * from './skill-translator.js';
export * from './manifest/index.js';
export * from './quality/index.js';
@@ -0,0 +1,214 @@
import { describe, it, expect } from 'vitest';
import {
evaluateSkillContent,
getQualityGrade,
isHighQuality,
} from '../index.js';
describe('Quality Evaluation', () => {
describe('evaluateSkillContent', () => {
it('should score a well-structured skill highly', () => {
const content = `---
name: test-skill
description: A test skill for validation
globs: ["**/*.ts"]
---
# Test Skill
## When to Use
Use this skill when working with TypeScript files.
## Instructions
Always follow these patterns:
\`\`\`typescript
function example(): void {
console.log('example');
}
\`\`\`
## Commands
Run tests with:
\`\`\`bash
npm test
\`\`\`
## Boundaries
Never commit secrets to the repository.
Always run linting before commits.
`;
const result = evaluateSkillContent(content);
expect(result.overall).toBeGreaterThanOrEqual(70);
expect(result.structure.hasMetadata).toBe(true);
expect(result.structure.hasTriggers).toBe(true);
expect(result.structure.hasExamples).toBe(true);
expect(result.structure.hasBoundaries).toBe(true);
expect(result.clarity.hasHeaders).toBe(true);
expect(result.specificity.hasConcreteCommands).toBe(true);
});
it('should score a minimal skill lower', () => {
const content = `# My Skill
Be helpful and assist the user with various tasks.
Try to do your best.
`;
const result = evaluateSkillContent(content);
expect(result.overall).toBeLessThan(50);
expect(result.structure.hasMetadata).toBe(false);
expect(result.structure.hasTriggers).toBe(false);
expect(result.specificity.vagueTermCount).toBeGreaterThan(0);
expect(result.warnings.length).toBeGreaterThan(0);
});
it('should penalize overly long skills', () => {
const longContent = '# Skill\n' + 'Some content.\n'.repeat(600);
const result = evaluateSkillContent(longContent);
expect(result.clarity.lineCount).toBeGreaterThan(500);
expect(result.clarity.score).toBeLessThan(70);
});
it('should detect vague terms', () => {
const content = `# Skill
Be helpful and assist the user.
Try to do your best when appropriate.
Help with various tasks as needed.
`;
const result = evaluateSkillContent(content);
expect(result.specificity.vagueTermCount).toBeGreaterThan(3);
});
it('should detect code examples', () => {
const content = `# Skill
\`\`\`typescript
const x = 1;
\`\`\`
\`\`\`javascript
const y = 2;
\`\`\`
`;
const result = evaluateSkillContent(content);
expect(result.structure.hasExamples).toBe(true);
expect(result.specificity.hasCodeExamples).toBe(true);
});
it('should detect boundary patterns', () => {
const content = `# Skill
## Boundaries
- Never commit secrets
- Always run tests
- Don't modify node_modules
- Avoid using deprecated APIs
`;
const result = evaluateSkillContent(content);
expect(result.structure.hasBoundaries).toBe(true);
});
it('should detect trigger conditions', () => {
const content = `# Skill
## When to Use
Use this skill when:
- Working with React components
- Building forms
`;
const result = evaluateSkillContent(content);
expect(result.structure.hasTriggers).toBe(true);
expect(result.structure.hasWhenToUse).toBe(true);
});
});
describe('getQualityGrade', () => {
it('should return A for scores >= 90', () => {
expect(getQualityGrade(90)).toBe('A');
expect(getQualityGrade(100)).toBe('A');
});
it('should return B for scores >= 80', () => {
expect(getQualityGrade(80)).toBe('B');
expect(getQualityGrade(89)).toBe('B');
});
it('should return C for scores >= 70', () => {
expect(getQualityGrade(70)).toBe('C');
expect(getQualityGrade(79)).toBe('C');
});
it('should return D for scores >= 60', () => {
expect(getQualityGrade(60)).toBe('D');
expect(getQualityGrade(69)).toBe('D');
});
it('should return F for scores < 60', () => {
expect(getQualityGrade(59)).toBe('F');
expect(getQualityGrade(0)).toBe('F');
});
});
describe('isHighQuality', () => {
const defaultAdvanced = {
score: 100,
deprecatedPatterns: [],
conflictingInstructions: [],
securityIssues: [],
completeness: { score: 100, hasTodos: false, todoCount: 0, emptySections: [], exampleCoverage: 100 },
};
it('should return true for high scoring skills with few warnings', () => {
const score = {
overall: 80,
structure: { score: 80, hasMetadata: true, hasDescription: true, hasTriggers: true, hasExamples: true, hasBoundaries: true, hasWhenToUse: true },
clarity: { score: 80, lineCount: 100, tokenCount: 500, avgSentenceLength: 15, hasHeaders: true },
specificity: { score: 80, hasConcreteCommands: true, hasFilePatterns: true, hasCodeExamples: true, vagueTermCount: 0 },
advanced: defaultAdvanced,
warnings: [],
suggestions: [],
};
expect(isHighQuality(score)).toBe(true);
});
it('should return false for low scoring skills', () => {
const score = {
overall: 50,
structure: { score: 50, hasMetadata: false, hasDescription: false, hasTriggers: false, hasExamples: false, hasBoundaries: false, hasWhenToUse: false },
clarity: { score: 50, lineCount: 100, tokenCount: 500, avgSentenceLength: 15, hasHeaders: true },
specificity: { score: 50, hasConcreteCommands: false, hasFilePatterns: false, hasCodeExamples: false, vagueTermCount: 5 },
advanced: { ...defaultAdvanced, score: 50 },
warnings: ['Missing triggers', 'No examples'],
suggestions: [],
};
expect(isHighQuality(score)).toBe(false);
});
it('should return false for skills with many warnings', () => {
const score = {
overall: 75,
structure: { score: 75, hasMetadata: true, hasDescription: true, hasTriggers: false, hasExamples: false, hasBoundaries: false, hasWhenToUse: false },
clarity: { score: 75, lineCount: 100, tokenCount: 500, avgSentenceLength: 15, hasHeaders: true },
specificity: { score: 75, hasConcreteCommands: true, hasFilePatterns: true, hasCodeExamples: false, vagueTermCount: 0 },
advanced: { ...defaultAdvanced, score: 75 },
warnings: ['Warning 1', 'Warning 2', 'Warning 3'],
suggestions: [],
};
expect(isHighQuality(score)).toBe(false);
});
});
});
+262
View File
@@ -0,0 +1,262 @@
/**
* Benchmark quality scores against category leaders
*/
import type { QualityScore } from './index.js';
export interface BenchmarkResult {
skill: string;
score: number;
grade: string;
categoryAvg: number;
topSkillScore: number;
percentile: number;
comparisonNotes: string[];
recommendations: string[];
}
export interface CategoryStats {
category: string;
avgScore: number;
topScore: number;
topSkills: string[];
count: number;
distribution: {
A: number;
B: number;
C: number;
D: number;
F: number;
};
}
const CATEGORY_BENCHMARKS: Record<string, CategoryStats> = {
react: {
category: 'react',
avgScore: 78,
topScore: 95,
topSkills: ['react-patterns', 'react-hooks-best-practices'],
count: 150,
distribution: { A: 15, B: 35, C: 30, D: 15, F: 5 },
},
typescript: {
category: 'typescript',
avgScore: 75,
topScore: 92,
topSkills: ['typescript-strict', 'type-safety-patterns'],
count: 120,
distribution: { A: 12, B: 30, C: 35, D: 18, F: 5 },
},
testing: {
category: 'testing',
avgScore: 72,
topScore: 90,
topSkills: ['tdd-workflow', 'testing-best-practices'],
count: 80,
distribution: { A: 10, B: 28, C: 38, D: 19, F: 5 },
},
git: {
category: 'git',
avgScore: 80,
topScore: 94,
topSkills: ['git-workflow', 'conventional-commits'],
count: 60,
distribution: { A: 18, B: 40, C: 28, D: 12, F: 2 },
},
security: {
category: 'security',
avgScore: 76,
topScore: 93,
topSkills: ['security-review', 'owasp-patterns'],
count: 45,
distribution: { A: 14, B: 32, C: 34, D: 16, F: 4 },
},
api: {
category: 'api',
avgScore: 74,
topScore: 91,
topSkills: ['api-design', 'rest-best-practices'],
count: 55,
distribution: { A: 11, B: 30, C: 36, D: 18, F: 5 },
},
general: {
category: 'general',
avgScore: 70,
topScore: 88,
topSkills: ['code-review', 'best-practices'],
count: 200,
distribution: { A: 8, B: 25, C: 40, D: 22, F: 5 },
},
};
export function getGrade(score: number): string {
if (score >= 90) return 'A';
if (score >= 80) return 'B';
if (score >= 70) return 'C';
if (score >= 60) return 'D';
return 'F';
}
export function detectCategory(skillName: string, tags: string[] = []): string {
const lowerName = skillName.toLowerCase();
const lowerTags = tags.map(t => t.toLowerCase());
const searchTerms = [lowerName, ...lowerTags];
const categoryKeywords: Record<string, string[]> = {
react: ['react', 'hooks', 'jsx', 'tsx', 'component', 'nextjs', 'remix'],
typescript: ['typescript', 'type', 'types', 'ts', 'strict'],
testing: ['test', 'testing', 'tdd', 'jest', 'vitest', 'playwright', 'e2e'],
git: ['git', 'commit', 'branch', 'merge', 'workflow', 'conventional'],
security: ['security', 'auth', 'owasp', 'vulnerability', 'safe'],
api: ['api', 'rest', 'graphql', 'endpoint', 'http'],
};
for (const [category, keywords] of Object.entries(categoryKeywords)) {
for (const term of searchTerms) {
if (keywords.some(kw => term.includes(kw))) {
return category;
}
}
}
return 'general';
}
export function calculatePercentile(score: number, categoryStats: CategoryStats): number {
const { distribution } = categoryStats;
const totalSkills = distribution.A + distribution.B + distribution.C + distribution.D + distribution.F;
let percentBelow = 0;
if (score < 60) {
percentBelow = (score / 60) * (distribution.F / totalSkills) * 100;
} else if (score < 70) {
percentBelow = (distribution.F / totalSkills) * 100;
percentBelow += ((score - 60) / 10) * (distribution.D / totalSkills) * 100;
} else if (score < 80) {
percentBelow = ((distribution.F + distribution.D) / totalSkills) * 100;
percentBelow += ((score - 70) / 10) * (distribution.C / totalSkills) * 100;
} else if (score < 90) {
percentBelow = ((distribution.F + distribution.D + distribution.C) / totalSkills) * 100;
percentBelow += ((score - 80) / 10) * (distribution.B / totalSkills) * 100;
} else {
percentBelow = ((distribution.F + distribution.D + distribution.C + distribution.B) / totalSkills) * 100;
percentBelow += ((score - 90) / 10) * (distribution.A / totalSkills) * 100;
}
return Math.round(Math.min(99, Math.max(1, percentBelow)));
}
export function generateComparisonNotes(
quality: QualityScore,
categoryStats: CategoryStats
): string[] {
const notes: string[] = [];
const topScore = categoryStats.topScore;
const avgScore = categoryStats.avgScore;
if (quality.overall >= topScore) {
notes.push('Your skill is among the top performers in this category');
} else if (quality.overall >= avgScore) {
notes.push(`Your skill is above the category average (${avgScore})`);
} else {
notes.push(`Your skill is ${avgScore - quality.overall} points below the category average`);
}
if (!quality.structure.hasExamples) {
notes.push('Missing code examples (present in 95% of top skills)');
}
if (!quality.structure.hasTriggers) {
notes.push('Missing trigger conditions (present in 80% of top skills)');
}
if (!quality.structure.hasBoundaries) {
notes.push('Missing "When Not to Use" section (present in 80% of top skills)');
}
if (quality.specificity.vagueTermCount > 3) {
notes.push('Trigger conditions are less specific than category average');
}
if (quality.clarity.lineCount > 300) {
notes.push('Skill is longer than recommended (top skills average 150-250 lines)');
}
if (quality.advanced.deprecatedPatterns.length > 0) {
notes.push('Contains deprecated patterns not found in top skills');
}
return notes;
}
export function generateRecommendations(
quality: QualityScore,
categoryStats: CategoryStats
): string[] {
const recommendations: string[] = [];
const gap = categoryStats.topScore - quality.overall;
if (gap > 20) {
recommendations.push('Consider studying top skills in this category for patterns');
}
if (!quality.structure.hasExamples) {
recommendations.push(`Add ${quality.specificity.hasCodeExamples ? 'more' : ''} code examples showing input/output`);
}
if (!quality.structure.hasTriggers) {
recommendations.push('Add explicit trigger conditions with patterns like "Triggers when:"');
}
if (!quality.structure.hasBoundaries) {
recommendations.push('Add a "Boundaries" or "Limitations" section');
}
if (quality.clarity.lineCount > 400) {
recommendations.push('Split into multiple focused skills (top skills are 150-250 lines)');
}
if (quality.specificity.vagueTermCount > 0) {
recommendations.push(`Replace ${quality.specificity.vagueTermCount} vague term(s) with specific instructions`);
}
if (quality.advanced.completeness.hasTodos) {
recommendations.push('Complete TODO items before publishing');
}
return recommendations;
}
export function benchmarkSkill(
skillName: string,
quality: QualityScore,
tags: string[] = [],
customCategoryStats?: CategoryStats
): BenchmarkResult {
const category = detectCategory(skillName, tags);
const categoryStats = customCategoryStats || CATEGORY_BENCHMARKS[category] || CATEGORY_BENCHMARKS.general;
const percentile = calculatePercentile(quality.overall, categoryStats);
const comparisonNotes = generateComparisonNotes(quality, categoryStats);
const recommendations = generateRecommendations(quality, categoryStats);
return {
skill: skillName,
score: quality.overall,
grade: getGrade(quality.overall),
categoryAvg: categoryStats.avgScore,
topSkillScore: categoryStats.topScore,
percentile,
comparisonNotes,
recommendations,
};
}
export function getCategoryStats(category: string): CategoryStats | null {
return CATEGORY_BENCHMARKS[category] || null;
}
export function getAllCategories(): string[] {
return Object.keys(CATEGORY_BENCHMARKS);
}
+589
View File
@@ -0,0 +1,589 @@
import { readFileSync, existsSync } from 'node:fs';
import { join, basename } from 'node:path';
export * from './benchmark.js';
export interface QualityScore {
overall: number;
structure: StructureScore;
clarity: ClarityScore;
specificity: SpecificityScore;
advanced: AdvancedScore;
warnings: string[];
suggestions: string[];
}
export interface AdvancedScore {
score: number;
deprecatedPatterns: string[];
conflictingInstructions: string[];
securityIssues: string[];
completeness: CompletenessResult;
}
export interface CompletenessResult {
score: number;
hasTodos: boolean;
todoCount: number;
emptySections: string[];
exampleCoverage: number;
}
export interface StructureScore {
score: number;
hasMetadata: boolean;
hasDescription: boolean;
hasTriggers: boolean;
hasExamples: boolean;
hasBoundaries: boolean;
hasWhenToUse: boolean;
}
export interface ClarityScore {
score: number;
lineCount: number;
tokenCount: number;
avgSentenceLength: number;
hasHeaders: boolean;
}
export interface SpecificityScore {
score: number;
hasConcreteCommands: boolean;
hasFilePatterns: boolean;
hasCodeExamples: boolean;
vagueTermCount: number;
}
const VAGUE_TERMS = [
'be helpful',
'assist the user',
'help with',
'try to',
'attempt to',
'do your best',
'as needed',
'when appropriate',
'if necessary',
'general purpose',
'various tasks',
'many things',
'etc.',
'and so on',
'stuff like that',
];
const BOUNDARY_PATTERNS = [
/never\s+(?:do|use|commit|push|delete|remove)/i,
/always\s+(?:do|use|check|verify|ensure)/i,
/don'?t\s+(?:do|use|commit|push|delete)/i,
/avoid\s+(?:using|doing|committing)/i,
/must\s+(?:not|always|never)/i,
/forbidden/i,
/prohibited/i,
/required/i,
];
const TRIGGER_PATTERNS = [
/when\s+to\s+use/i,
/use\s+this\s+(?:skill|when)/i,
/triggers?\s*(?:when|:)/i,
/activated?\s+(?:when|by)/i,
/applies?\s+(?:when|to)/i,
/invoke\s+(?:when|this)/i,
];
const COMMAND_PATTERNS = [
/```(?:bash|sh|shell|zsh)[\s\S]*?```/g,
/`(?:npm|pnpm|yarn|bun|npx|git|docker|kubectl)\s+[^`]+`/g,
/\$\s*\w+/g,
];
const CODE_EXAMPLE_PATTERNS = [
/```(?:typescript|javascript|tsx|jsx|python|go|rust|java)[\s\S]*?```/g,
/```[\s\S]{50,}?```/g,
];
const FILE_PATTERN_PATTERNS = [
/\*\*\/\*\.\w+/,
/\.\w+$/m,
/glob[s]?\s*[:=]/i,
/include[s]?\s*[:=]/i,
/pattern[s]?\s*[:=]/i,
];
const DEPRECATED_PATTERNS = [
{ pattern: /require\s*\(['"][^'"]+['"]\)/g, message: 'Uses CommonJS require() instead of ES modules' },
{ pattern: /React\.Component/g, message: 'Uses class components instead of functional' },
{ pattern: /componentDidMount|componentWillUnmount|componentDidUpdate/g, message: 'Uses lifecycle methods instead of hooks' },
{ pattern: /\bvar\s+\w+\s*=/g, message: 'Uses var instead of const/let' },
{ pattern: /\.then\s*\([^)]*\)\.catch/g, message: 'Uses .then().catch() instead of async/await' },
{ pattern: /new\s+Promise\s*\(/g, message: 'Consider using async/await instead of new Promise()' },
];
const SECURITY_PATTERNS = [
{ pattern: /password\s*[:=]\s*['"][^'"]+['"]/gi, message: 'Potential hardcoded password' },
{ pattern: /api[_-]?key\s*[:=]\s*['"][^'"]+['"]/gi, message: 'Potential hardcoded API key' },
{ pattern: /secret\s*[:=]\s*['"][^'"]+['"]/gi, message: 'Potential hardcoded secret' },
{ pattern: /token\s*[:=]\s*['"][A-Za-z0-9_-]{20,}['"]/gi, message: 'Potential hardcoded token' },
{ pattern: /\$\{[^}]*\}/g, message: 'Template literal - ensure proper sanitization in shell commands' },
{ pattern: /eval\s*\(/g, message: 'Uses eval() - potential code injection risk' },
{ pattern: /innerHTML\s*=/g, message: 'Uses innerHTML - potential XSS risk' },
{ pattern: /dangerouslySetInnerHTML/g, message: 'Uses dangerouslySetInnerHTML - potential XSS risk' },
];
function extractFrontmatter(content: string): Record<string, unknown> | null {
const normalizedContent = content.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
const match = normalizedContent.match(/^---\s*\n([\s\S]*?)\n---/);
if (!match) return null;
const frontmatter: Record<string, unknown> = {};
const lines = match[1].split('\n');
for (const line of lines) {
const colonIndex = line.indexOf(':');
if (colonIndex > 0) {
const key = line.slice(0, colonIndex).trim();
const value = line.slice(colonIndex + 1).trim();
frontmatter[key] = value;
}
}
return Object.keys(frontmatter).length > 0 ? frontmatter : null;
}
function countTokens(text: string): number {
return Math.ceil(text.length / 4);
}
function countVagueTerms(content: string): number {
const lowerContent = content.toLowerCase();
let count = 0;
for (const term of VAGUE_TERMS) {
const regex = new RegExp(term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'gi');
const matches = lowerContent.match(regex);
if (matches) count += matches.length;
}
return count;
}
function hasPattern(content: string, patterns: RegExp[]): boolean {
return patterns.some(p => p.test(content));
}
function countMatches(content: string, patterns: RegExp[]): number {
let count = 0;
for (const pattern of patterns) {
const matches = content.match(pattern);
if (matches) count += matches.length;
}
return count;
}
function calculateAvgSentenceLength(content: string): number {
const contentWithoutCode = content.replace(/```[\s\S]*?```/g, '');
const sentences = contentWithoutCode.split(/[.!?]+/).filter(s => s.trim().length > 0);
if (sentences.length === 0) return 0;
const totalWords = sentences.reduce((sum, s) => sum + s.trim().split(/\s+/).length, 0);
return Math.round(totalWords / sentences.length);
}
function evaluateStructure(content: string): StructureScore {
const frontmatter = extractFrontmatter(content);
const hasMetadata = frontmatter !== null && Object.keys(frontmatter).length > 0;
const hasDescription = !!(frontmatter?.description) || /^#+\s*description/im.test(content);
const hasTriggers = hasPattern(content, TRIGGER_PATTERNS);
const hasExamples = countMatches(content, CODE_EXAMPLE_PATTERNS) > 0;
const hasBoundaries = hasPattern(content, BOUNDARY_PATTERNS);
const hasWhenToUse = /when\s+to\s+use|use\s+case|scenario/i.test(content);
let score = 0;
if (hasMetadata) score += 15;
if (hasDescription) score += 10;
if (hasTriggers) score += 20;
if (hasExamples) score += 20;
if (hasBoundaries) score += 20;
if (hasWhenToUse) score += 15;
return {
score: Math.min(100, score),
hasMetadata,
hasDescription,
hasTriggers,
hasExamples,
hasBoundaries,
hasWhenToUse,
};
}
function evaluateClarity(content: string): ClarityScore {
const lines = content.split('\n');
const lineCount = lines.length;
const tokenCount = countTokens(content);
const avgSentenceLength = calculateAvgSentenceLength(content);
const hasHeaders = /^#+\s+/m.test(content);
let score = 100;
if (lineCount > 500) score -= 30;
else if (lineCount > 300) score -= 15;
else if (lineCount > 150) score -= 5;
if (tokenCount > 4000) score -= 30;
else if (tokenCount > 2000) score -= 15;
else if (tokenCount > 1000) score -= 5;
if (avgSentenceLength > 30) score -= 20;
else if (avgSentenceLength > 20) score -= 10;
if (!hasHeaders) score -= 15;
return {
score: Math.max(0, score),
lineCount,
tokenCount,
avgSentenceLength,
hasHeaders,
};
}
function countCodeBlocks(content: string): number {
const fencedBlocks = content.match(/```[\s\S]*?```/g) || [];
return fencedBlocks.length;
}
function detectDeprecatedPatterns(content: string): string[] {
const codeBlocks = content.match(/```[\s\S]*?```/g) || [];
const codeContent = codeBlocks.join('\n');
const issues: string[] = [];
for (const { pattern, message } of DEPRECATED_PATTERNS) {
const regex = new RegExp(pattern.source, pattern.flags);
if (regex.test(codeContent)) {
issues.push(message);
}
}
return [...new Set(issues)];
}
function detectSecurityPatterns(content: string): string[] {
const issues: string[] = [];
for (const { pattern, message } of SECURITY_PATTERNS) {
const regex = new RegExp(pattern.source, pattern.flags);
if (regex.test(content)) {
if (!message.includes('Template literal') || content.includes('bash') || content.includes('shell')) {
issues.push(message);
}
}
}
return [...new Set(issues)];
}
function detectConflictingInstructions(content: string): string[] {
const issues: string[] = [];
const lowerContent = content.toLowerCase();
const alwaysMatches = lowerContent.match(/always\s+(?:use|do|include|add)\s+(\w+)/gi) || [];
const neverMatches = lowerContent.match(/never\s+(?:use|do|include|add)\s+(\w+)/gi) || [];
for (const always of alwaysMatches) {
const term = always.replace(/always\s+(?:use|do|include|add)\s+/i, '').toLowerCase();
for (const never of neverMatches) {
const neverTerm = never.replace(/never\s+(?:use|do|include|add)\s+/i, '').toLowerCase();
if (term === neverTerm) {
issues.push(`Conflicting instructions: "always" and "never" used with "${term}"`);
}
}
}
const mustMatches = lowerContent.match(/must\s+(\w+)/gi) || [];
const mustNotMatches = lowerContent.match(/must\s+not\s+(\w+)/gi) || [];
for (const must of mustMatches) {
const term = must.replace(/must\s+/i, '').toLowerCase();
for (const mustNot of mustNotMatches) {
const notTerm = mustNot.replace(/must\s+not\s+/i, '').toLowerCase();
if (term === notTerm) {
issues.push(`Conflicting instructions: "must" and "must not" used with "${term}"`);
}
}
}
return [...new Set(issues)];
}
function assessCompleteness(content: string): CompletenessResult {
const todoMatches = content.match(/TODO|FIXME|XXX|HACK/gi) || [];
const todoCount = todoMatches.length;
const headerPositions: Array<{ header: string; index: number }> = [];
const lines = content.split('\n');
let inFence = false;
let offset = 0;
for (const line of lines) {
if (/^```|^~~~/.test(line)) {
inFence = !inFence;
} else if (!inFence && /^#+\s+.+$/.test(line)) {
headerPositions.push({ header: line, index: offset });
}
offset += line.length + 1;
}
const emptySections: string[] = [];
for (let i = 0; i < headerPositions.length - 1; i++) {
const current = headerPositions[i];
const next = headerPositions[i + 1];
const sectionContent = content.slice(current.index + current.header.length, next.index).trim();
if (sectionContent.length < 20) {
const sectionName = current.header.replace(/^#+\s+/, '');
emptySections.push(sectionName);
}
}
if (headerPositions.length > 0) {
const last = headerPositions[headerPositions.length - 1];
const tailContent = content.slice(last.index + last.header.length).trim();
if (tailContent.length < 20) {
const sectionName = last.header.replace(/^#+\s+/, '');
emptySections.push(sectionName);
}
}
const codeBlocks = countCodeBlocks(content);
const exampleCoverage = Math.min(100, codeBlocks * 25);
let score = 100;
if (todoCount > 0) score -= Math.min(30, todoCount * 10);
if (emptySections.length > 0) score -= Math.min(30, emptySections.length * 10);
if (codeBlocks < 2) score -= 20;
else if (codeBlocks < 4) score -= 10;
return {
score: Math.max(0, score),
hasTodos: todoCount > 0,
todoCount,
emptySections,
exampleCoverage,
};
}
function evaluateAdvanced(content: string): AdvancedScore {
const deprecatedPatterns = detectDeprecatedPatterns(content);
const conflictingInstructions = detectConflictingInstructions(content);
const securityIssues = detectSecurityPatterns(content);
const completeness = assessCompleteness(content);
let score = 100;
score -= Math.min(30, deprecatedPatterns.length * 10);
score -= Math.min(30, conflictingInstructions.length * 15);
score -= Math.min(25, securityIssues.length * 10);
score -= Math.round((100 - completeness.score) * 0.15);
return {
score: Math.max(0, score),
deprecatedPatterns,
conflictingInstructions,
securityIssues,
completeness,
};
}
function evaluateSpecificity(content: string): SpecificityScore {
const hasConcreteCommands = countMatches(content, COMMAND_PATTERNS) > 0;
const hasFilePatterns = hasPattern(content, FILE_PATTERN_PATTERNS);
const codeBlockCount = countCodeBlocks(content);
const hasCodeExamples = codeBlockCount >= 2;
const vagueTermCount = countVagueTerms(content);
let score = 0;
if (hasConcreteCommands) score += 30;
if (hasFilePatterns) score += 25;
if (hasCodeExamples) score += 30;
if (vagueTermCount === 0) score += 15;
else if (vagueTermCount <= 2) score += 10;
else if (vagueTermCount <= 5) score += 5;
return {
score: Math.min(100, score),
hasConcreteCommands,
hasFilePatterns,
hasCodeExamples,
vagueTermCount,
};
}
function generateWarnings(
structure: StructureScore,
clarity: ClarityScore,
specificity: SpecificityScore,
advanced: AdvancedScore
): string[] {
const warnings: string[] = [];
if (!structure.hasMetadata) {
warnings.push('Missing frontmatter metadata');
}
if (!structure.hasTriggers) {
warnings.push('No trigger conditions defined');
}
if (!structure.hasBoundaries) {
warnings.push('No boundaries or constraints specified');
}
if (clarity.lineCount > 500) {
warnings.push(`Skill is too long (${clarity.lineCount} lines)`);
}
if (clarity.tokenCount > 4000) {
warnings.push(`High token usage (${clarity.tokenCount} tokens)`);
}
if (specificity.vagueTermCount > 5) {
warnings.push(`Contains ${specificity.vagueTermCount} vague terms`);
}
if (!structure.hasExamples) {
warnings.push('No code examples provided');
} else if (!specificity.hasCodeExamples) {
warnings.push('Only one code example provided');
}
for (const issue of advanced.securityIssues) {
warnings.push(`Security: ${issue}`);
}
for (const conflict of advanced.conflictingInstructions) {
warnings.push(conflict);
}
if (advanced.completeness.hasTodos) {
warnings.push(`Contains ${advanced.completeness.todoCount} TODO/FIXME comment(s)`);
}
if (advanced.completeness.emptySections.length > 0) {
warnings.push(`Empty sections: ${advanced.completeness.emptySections.join(', ')}`);
}
return warnings;
}
function generateSuggestions(
structure: StructureScore,
clarity: ClarityScore,
specificity: SpecificityScore,
advanced: AdvancedScore
): string[] {
const suggestions: string[] = [];
if (!structure.hasMetadata) {
suggestions.push('Add YAML frontmatter with name, description, and globs');
}
if (!structure.hasTriggers) {
suggestions.push('Add a "When to Use" section with specific trigger conditions');
}
if (!structure.hasExamples) {
suggestions.push('Include code examples showing expected output');
}
if (!structure.hasBoundaries) {
suggestions.push('Define boundaries: what the agent should never do');
}
if (clarity.lineCount > 300) {
suggestions.push('Consider splitting into multiple focused skills');
}
if (!clarity.hasHeaders) {
suggestions.push('Use markdown headers to organize content');
}
if (specificity.vagueTermCount > 0) {
suggestions.push('Replace vague terms with specific instructions');
}
if (!specificity.hasConcreteCommands) {
suggestions.push('Add concrete executable commands with flags');
}
if (advanced.deprecatedPatterns.length > 0) {
suggestions.push('Update code examples to use modern patterns (ES modules, hooks, async/await)');
}
if (advanced.securityIssues.length > 0) {
suggestions.push('Review and remove potential security risks from examples');
}
if (advanced.completeness.hasTodos) {
suggestions.push('Complete or remove TODO/FIXME comments');
}
if (advanced.completeness.emptySections.length > 0) {
suggestions.push('Add content to empty sections or remove them');
}
if (advanced.completeness.exampleCoverage < 50) {
suggestions.push('Add more code examples to improve coverage');
}
return suggestions;
}
export function evaluateSkillContent(content: string): QualityScore {
const structure = evaluateStructure(content);
const clarity = evaluateClarity(content);
const specificity = evaluateSpecificity(content);
const advanced = evaluateAdvanced(content);
const overall = Math.round(
structure.score * 0.35 +
clarity.score * 0.25 +
specificity.score * 0.25 +
advanced.score * 0.15
);
const warnings = generateWarnings(structure, clarity, specificity, advanced);
const suggestions = generateSuggestions(structure, clarity, specificity, advanced);
return {
overall,
structure,
clarity,
specificity,
advanced,
warnings,
suggestions,
};
}
export function evaluateSkillFile(filePath: string): QualityScore | null {
if (!existsSync(filePath)) return null;
try {
const content = readFileSync(filePath, 'utf-8');
return evaluateSkillContent(content);
} catch {
return null;
}
}
export function evaluateSkillDirectory(dirPath: string): QualityScore | null {
const skillMdPath = join(dirPath, 'SKILL.md');
if (existsSync(skillMdPath)) {
return evaluateSkillFile(skillMdPath);
}
const mdcFiles = ['index.mdc', `${basename(dirPath)}.mdc`];
for (const file of mdcFiles) {
const mdcPath = join(dirPath, file);
if (existsSync(mdcPath)) {
return evaluateSkillFile(mdcPath);
}
}
return null;
}
export function getQualityGrade(score: number): string {
if (score >= 90) return 'A';
if (score >= 80) return 'B';
if (score >= 70) return 'C';
if (score >= 60) return 'D';
return 'F';
}
export function isHighQuality(score: QualityScore): boolean {
return score.overall >= 80 && score.warnings.length <= 2;
}
+83 -20
View File
@@ -8,10 +8,20 @@ export const SKILL_DISCOVERY_PATHS = [
'skills/.curated',
'skills/.experimental',
'skills/.system',
'agents',
'.agents/skills',
'.agent/skills',
'.amp/skills',
'.antigravity/skills',
'.claude/skills',
'.cline/skills',
'.clawdbot/skills',
'.codebuddy/skills',
'.codex/skills',
'.commandcode/skills',
'.continue/skills',
'.copilot/skills',
'.crush/skills',
'.cursor/skills',
'.factory/skills',
'.gemini/skills',
@@ -19,13 +29,19 @@ export const SKILL_DISCOVERY_PATHS = [
'.goose/skills',
'.kilocode/skills',
'.kiro/skills',
'.mcpjam/skills',
'.mux/skills',
'.neovate/skills',
'.opencode/skills',
'.openhands/skills',
'.pi/skills',
'.qoder/skills',
'.qwen/skills',
'.roo/skills',
'.trae/skills',
'.vercel/skills',
'.windsurf/skills',
'.clawdbot/skills',
'.antigravity/skills',
'.copilot/skills',
'.zencoder/skills',
];
function discoverSkillsInDir(dir: string): Skill[] {
@@ -38,13 +54,18 @@ function discoverSkillsInDir(dir: string): Skill[] {
const entries = readdirSync(dir, { withFileTypes: true });
for (const entry of entries) {
if (!entry.isDirectory()) continue;
if (entry.isDirectory()) {
const skillPath = join(dir, entry.name);
const skillMdPath = join(skillPath, 'SKILL.md');
const skillPath = join(dir, entry.name);
const skillMdPath = join(skillPath, 'SKILL.md');
if (existsSync(skillMdPath)) {
const skill = parseSkill(skillPath);
if (existsSync(skillMdPath)) {
const skill = parseSkill(skillPath);
if (skill) {
skills.push(skill);
}
}
} else if (entry.isFile() && entry.name.endsWith('.md') && entry.name !== 'README.md') {
const skill = parseStandaloneSkill(join(dir, entry.name));
if (skill) {
skills.push(skill);
}
@@ -54,6 +75,38 @@ function discoverSkillsInDir(dir: string): Skill[] {
return skills;
}
function parseStandaloneSkill(filePath: string, location: SkillLocation = 'project'): Skill | null {
if (!existsSync(filePath)) {
return null;
}
try {
const content = readFileSync(filePath, 'utf-8');
const frontmatter = extractFrontmatter(content);
if (!frontmatter) {
return null;
}
const name = (frontmatter.name as string) || basename(filePath, '.md');
const description = (frontmatter.description as string) || 'No description available';
if (!name || name.length === 0) {
return null;
}
return {
name,
description,
path: filePath,
location,
enabled: true,
};
} catch {
return null;
}
}
/**
* Recursively search for skills in all subdirectories
*/
@@ -77,20 +130,27 @@ function discoverSkillsRecursive(
continue;
}
if (!entry.isDirectory()) continue;
const entryPath = join(dir, entry.name);
const skillMdPath = join(entryPath, 'SKILL.md');
if (existsSync(skillMdPath)) {
const skill = parseSkill(entryPath);
if (entry.isDirectory()) {
const skillMdPath = join(entryPath, 'SKILL.md');
if (existsSync(skillMdPath)) {
const skill = parseSkill(entryPath);
if (skill && !seen.has(skill.name)) {
seen.add(skill.name);
skills.push(skill);
}
} else {
const subSkills = discoverSkillsRecursive(entryPath, seen, maxDepth, currentDepth + 1);
skills.push(...subSkills);
}
} else if (entry.isFile() && entry.name.endsWith('.md') && entry.name !== 'README.md') {
const skill = parseStandaloneSkill(entryPath);
if (skill && !seen.has(skill.name)) {
seen.add(skill.name);
skills.push(skill);
}
} else {
const subSkills = discoverSkillsRecursive(entryPath, seen, maxDepth, currentDepth + 1);
skills.push(...subSkills);
}
}
} catch {}
@@ -232,7 +292,9 @@ export function loadMetadata(skillPath: string): SkillMetadata | null {
}
export function readSkillContent(skillPath: string): string | null {
const skillMdPath = join(skillPath, 'SKILL.md');
const skillMdPath = skillPath.endsWith('.md')
? skillPath
: join(skillPath, 'SKILL.md');
if (!existsSync(skillMdPath)) {
return null;
@@ -283,9 +345,10 @@ export function findAllSkills(searchDirs: string[]): Skill[] {
export function validateSkill(skillPath: string): { valid: boolean; errors: string[]; warnings?: string[] } {
const errors: string[] = [];
const warnings: string[] = [];
const dirName = basename(skillPath);
const isStandalone = skillPath.endsWith('.md');
const dirName = isStandalone ? basename(skillPath, '.md') : basename(skillPath);
const skillMdPath = isStandalone ? skillPath : join(skillPath, 'SKILL.md');
const skillMdPath = join(skillPath, 'SKILL.md');
if (!existsSync(skillMdPath)) {
errors.push('Missing SKILL.md file');
return { valid: false, errors };
+15
View File
@@ -31,6 +31,21 @@ export const AGENT_FORMAT_MAP: Record<AgentType, FormatCategory> = {
'cursor': 'cursor-mdc',
'windsurf': 'markdown-rules',
'github-copilot': 'markdown-rules',
'cline': 'skill-md',
'codebuddy': 'skill-md',
'commandcode': 'skill-md',
'continue': 'skill-md',
'crush': 'skill-md',
'factory': 'skill-md',
'mcpjam': 'skill-md',
'mux': 'skill-md',
'neovate': 'skill-md',
'openhands': 'skill-md',
'pi': 'skill-md',
'qoder': 'skill-md',
'qwen': 'skill-md',
'vercel': 'skill-md',
'zencoder': 'skill-md',
};
/**
+15
View File
@@ -18,6 +18,21 @@ export const AgentType = z.enum([
'trae',
'windsurf',
'universal',
'cline',
'codebuddy',
'commandcode',
'continue',
'crush',
'factory',
'mcpjam',
'mux',
'neovate',
'openhands',
'pi',
'qoder',
'qwen',
'vercel',
'zencoder',
]);
export type AgentType = z.infer<typeof AgentType>;
+7 -3
View File
@@ -188,10 +188,14 @@ export function Installed({ onNavigate, cols = 80, rows = 24 }: InstalledProps)
const selected = actualIdx === selectedIndex;
const indicator = selected ? '▸' : ' ';
const statusIcon = skill.enabled !== false ? '●' : '○';
// Use single text element to avoid rendering overlap
const line = `${indicator}${statusIcon} ${skill.name}`;
const qualityBadge = skill.grade ? ` [${skill.grade}]` : '';
const warningIndicator = skill.warnings && skill.warnings > 2 ? ' ⚠' : '';
const line = `${indicator}${statusIcon} ${skill.name}${qualityBadge}${warningIndicator}`;
const badgeColor = skill.quality !== undefined
? (skill.quality >= 80 ? terminalColors.success : skill.quality >= 60 ? terminalColors.warning : terminalColors.error)
: terminalColors.text;
return (
<text key={skill.name} fg={selected ? terminalColors.accent : terminalColors.text}>
<text key={skill.name} fg={selected ? terminalColors.accent : badgeColor}>
{line}
</text>
);
+9 -7
View File
@@ -50,14 +50,14 @@ export function Recommend({ onNavigate, cols = 80, rows = 24 }: RecommendProps)
return () => clearInterval(interval);
}, [analyzing]);
// Recommendations data
// Recommendations data (with quality scores)
const recommendations = useMemo(() => [
{ name: 'tdd-workflow', reason: 'Based on your test files and coverage patterns', confidence: 95 },
{ name: 'react-patterns', reason: 'Detected React in package.json with hooks usage', confidence: 88 },
{ name: 'typescript-strict', reason: 'tsconfig.json found with strict mode disabled', confidence: 82 },
{ name: 'git-workflow', reason: '.git directory with complex branching detected', confidence: 75 },
{ name: 'api-design', reason: 'REST endpoints found in your codebase', confidence: 68 },
{ name: 'docker-compose', reason: 'docker-compose.yml detected for orchestration', confidence: 62 },
{ name: 'tdd-workflow', reason: 'Based on your test files and coverage patterns', confidence: 95, quality: 92, grade: 'A' },
{ name: 'react-patterns', reason: 'Detected React in package.json with hooks usage', confidence: 88, quality: 85, grade: 'B' },
{ name: 'typescript-strict', reason: 'tsconfig.json found with strict mode disabled', confidence: 82, quality: 78, grade: 'C' },
{ name: 'git-workflow', reason: '.git directory with complex branching detected', confidence: 75, quality: 82, grade: 'B' },
{ name: 'api-design', reason: 'REST endpoints found in your codebase', confidence: 68, quality: 71, grade: 'C' },
{ name: 'docker-compose', reason: 'docker-compose.yml detected for orchestration', confidence: 62, quality: 65, grade: 'D' },
], []);
const maxVisible = Math.max(3, Math.floor((rows - 10) / 2));
@@ -163,6 +163,7 @@ export function Recommend({ onNavigate, cols = 80, rows = 24 }: RecommendProps)
{visibleRecs.map((rec, idx) => {
const selected = idx === selectedIndex;
const indicator = selected ? '▸' : ' ';
const qualityColor = rec.quality >= 80 ? terminalColors.success : rec.quality >= 60 ? terminalColors.warning : terminalColors.error;
return (
<box key={rec.name} flexDirection="column">
<box flexDirection="row">
@@ -171,6 +172,7 @@ export function Recommend({ onNavigate, cols = 80, rows = 24 }: RecommendProps)
{rec.name}
</text>
<text fg={getConfColor(rec.confidence)}> {rec.confidence}%</text>
<text fg={qualityColor}> [{rec.grade}]</text>
</box>
<text fg={terminalColors.textMuted}> {rec.reason}</text>
<text> </text>
+2 -2
View File
@@ -92,6 +92,6 @@ export function getAgentAdapter(type: AgentType) {
}
/**
* Total number of supported agents
* Total number of supported agents (derived from adapters)
*/
export const TOTAL_AGENTS = 17;
export const TOTAL_AGENTS = getAllAdapters().length;
+13 -7
View File
@@ -1,7 +1,7 @@
/**
* Skills state management for SkillKit TUI
*/
import { findAllSkills } from '@skillkit/core';
import { findAllSkills, evaluateSkillDirectory, getQualityGrade } from '@skillkit/core';
import { rmSync } from 'node:fs';
import { resolve, normalize } from 'node:path';
import { getSearchDirs } from '../utils/helpers.js';
@@ -38,12 +38,18 @@ export function loadSkills(agentType?: AgentType): SkillsState {
const searchDirs = getSearchDirs(agentType);
const foundSkills = findAllSkills(searchDirs);
const skillItems: SkillItem[] = foundSkills.map((s) => ({
name: s.name,
description: s.description,
source: s.metadata?.source,
enabled: s.enabled,
}));
const skillItems: SkillItem[] = foundSkills.map((s) => {
const quality = evaluateSkillDirectory(s.path);
return {
name: s.name,
description: s.description,
source: s.metadata?.source,
enabled: s.enabled,
quality: quality?.overall,
grade: quality ? getQualityGrade(quality.overall) : undefined,
warnings: quality?.warnings.length,
};
});
return {
skills: skillItems,
+3
View File
@@ -4,6 +4,9 @@ export interface SkillItem {
source?: string;
installs?: number;
enabled?: boolean;
quality?: number;
grade?: string;
warnings?: number;
}
export interface RepoInfo {
+16 -1
View File
@@ -13,7 +13,7 @@ export interface AgentLogo {
}
/**
* All 17 supported agents with monochromatic Unicode logos
* All 32 supported agents with monochromatic Unicode logos
*/
export const AGENT_LOGOS: Record<string, AgentLogo> = {
'claude-code': { icon: '⟁', name: 'Claude Code', company: 'Anthropic' },
@@ -32,6 +32,21 @@ export const AGENT_LOGOS: Record<string, AgentLogo> = {
'trae': { icon: '◆', name: 'Trae', company: 'ByteDance' },
'antigravity': { icon: '⊛', name: 'Antigravity', company: '' },
'clawdbot': { icon: '⟐', name: 'Clawdbot', company: '' },
'cline': { icon: '⊕', name: 'Cline', company: '' },
'codebuddy': { icon: '⊗', name: 'CodeBuddy', company: '' },
'commandcode': { icon: '⊘', name: 'CommandCode', company: '' },
'continue': { icon: '⊞', name: 'Continue', company: '' },
'crush': { icon: '⊟', name: 'Crush', company: '' },
'factory': { icon: '⊠', name: 'Factory', company: '' },
'mcpjam': { icon: '⊡', name: 'MCPJam', company: '' },
'mux': { icon: '⊢', name: 'Mux', company: '' },
'neovate': { icon: '⊣', name: 'Neovate', company: '' },
'openhands': { icon: '⊤', name: 'OpenHands', company: '' },
'pi': { icon: '⊥', name: 'Pi', company: '' },
'qoder': { icon: '⊦', name: 'Qoder', company: '' },
'qwen': { icon: '⊧', name: 'Qwen', company: 'Alibaba' },
'vercel': { icon: '▲', name: 'Vercel', company: 'Vercel' },
'zencoder': { icon: '⊩', name: 'Zencoder', company: '' },
'universal': { icon: '●', name: 'Universal', company: '' },
} as const;
+3978
View File
File diff suppressed because it is too large Load Diff

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