mirror of
https://github.com/rohitg00/skillkit.git
synced 2026-11-19 02:13:58 +00:00
Compare commits
15
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
b2f52f5086 | ||
|
|
4c1d9ceea7 | ||
|
|
b9672931b0 | ||
|
|
58d3f96d40 | ||
|
|
de313ee9ee | ||
|
|
93140cd5ba | ||
|
|
074aa51d03 | ||
|
|
a211ff8194 | ||
|
|
95867edca9 | ||
|
|
c3fb888e57 | ||
|
|
12253f4b51 | ||
|
|
58bd0bbdd4 | ||
|
|
f0b59b3e39 | ||
|
|
a0b4ee77b4 | ||
|
|
d671b5795f |
@@ -1,42 +0,0 @@
|
||||
---
|
||||
name: Add Skill Source
|
||||
about: Submit your skill repository to be included in SkillKit
|
||||
title: "[Source] Add <repository-name>"
|
||||
labels: skill-source, enhancement
|
||||
assignees: rohitg00
|
||||
---
|
||||
|
||||
## Repository Information
|
||||
|
||||
**Repository URL:** `https://github.com/<owner>/<repo>`
|
||||
|
||||
**Repository Name:**
|
||||
<!-- Short name for display (e.g., "Anthropic Official", "React Patterns") -->
|
||||
|
||||
**Description:**
|
||||
<!-- Brief description of the skills in your repository -->
|
||||
|
||||
**License:**
|
||||
<!-- MIT, Apache 2.0, etc. -->
|
||||
|
||||
## Skill Details
|
||||
|
||||
**Approximate skill count:**
|
||||
<!-- How many skills does your repository contain? -->
|
||||
|
||||
**Categories/Tags:**
|
||||
<!-- What categories do your skills cover? e.g., react, typescript, security, testing -->
|
||||
|
||||
**Target AI Agents:**
|
||||
<!-- Which agents are your skills designed for? e.g., Claude Code, Cursor, all -->
|
||||
|
||||
## Checklist
|
||||
|
||||
- [ ] Repository is public
|
||||
- [ ] Repository contains valid SKILL.md files
|
||||
- [ ] Repository has a clear license
|
||||
- [ ] Skills follow the [Agent Skills specification](https://agenstskills.com)
|
||||
|
||||
## Additional Context
|
||||
|
||||
<!-- Any other information about your repository -->
|
||||
@@ -83,7 +83,7 @@ body:
|
||||
options:
|
||||
- label: Repository is public
|
||||
required: true
|
||||
- label: SKILL.md follows the agenstskills.com standard format
|
||||
- label: SKILL.md follows the agentskills.io standard format
|
||||
required: true
|
||||
- label: Skill has been tested with at least one AI agent
|
||||
required: false
|
||||
|
||||
@@ -7,60 +7,6 @@ on:
|
||||
branches: [main]
|
||||
|
||||
jobs:
|
||||
# Verify all packages have consistent versions
|
||||
version-check:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
|
||||
- name: Check version consistency
|
||||
run: |
|
||||
echo "Checking version consistency across all packages..."
|
||||
|
||||
# Get the main version from apps/skillkit
|
||||
MAIN_VERSION=$(node -p "require('./apps/skillkit/package.json').version")
|
||||
echo "Main version: $MAIN_VERSION"
|
||||
|
||||
# List of all packages to check
|
||||
PACKAGES=(
|
||||
"package.json"
|
||||
"apps/skillkit/package.json"
|
||||
"packages/cli/package.json"
|
||||
"packages/core/package.json"
|
||||
"packages/tui/package.json"
|
||||
"packages/agents/package.json"
|
||||
"packages/memory/package.json"
|
||||
"packages/mesh/package.json"
|
||||
"packages/messaging/package.json"
|
||||
"packages/mcp-memory/package.json"
|
||||
"packages/resources/package.json"
|
||||
"docs/skillkit/package.json"
|
||||
"docs/fumadocs/package.json"
|
||||
)
|
||||
|
||||
FAILED=0
|
||||
for pkg in "${PACKAGES[@]}"; do
|
||||
if [ -f "$pkg" ]; then
|
||||
PKG_VERSION=$(node -p "require('./$pkg').version")
|
||||
if [ "$PKG_VERSION" != "$MAIN_VERSION" ]; then
|
||||
echo "❌ Version mismatch: $pkg has $PKG_VERSION (expected $MAIN_VERSION)"
|
||||
FAILED=1
|
||||
else
|
||||
echo "✓ $pkg: $PKG_VERSION"
|
||||
fi
|
||||
fi
|
||||
done
|
||||
|
||||
if [ $FAILED -eq 1 ]; then
|
||||
echo ""
|
||||
echo "Version mismatch detected!"
|
||||
echo "Run: ./scripts/bump-version.sh $MAIN_VERSION"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
echo ""
|
||||
echo "All packages have consistent version: $MAIN_VERSION"
|
||||
|
||||
# Unit tests run on all Node versions
|
||||
test:
|
||||
runs-on: ubuntu-latest
|
||||
@@ -132,14 +78,12 @@ jobs:
|
||||
# Final status check for branch protection
|
||||
ci-success:
|
||||
runs-on: ubuntu-latest
|
||||
needs: [version-check, test, e2e]
|
||||
needs: [test, e2e]
|
||||
if: always()
|
||||
steps:
|
||||
- name: Check all jobs passed
|
||||
run: |
|
||||
if [[ "${{ needs.version-check.result }}" != "success" ]] || \
|
||||
[[ "${{ needs.test.result }}" != "success" ]] || \
|
||||
[[ "${{ needs.e2e.result }}" != "success" ]]; then
|
||||
if [[ "${{ needs.test.result }}" != "success" ]] || [[ "${{ needs.e2e.result }}" != "success" ]]; then
|
||||
echo "One or more jobs failed"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
@@ -16,19 +16,6 @@ jobs:
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
|
||||
- name: Verify tag matches package version
|
||||
run: |
|
||||
TAG_VERSION="${GITHUB_REF#refs/tags/v}"
|
||||
PKG_VERSION=$(node -p "require('./apps/skillkit/package.json').version")
|
||||
echo "Tag version: $TAG_VERSION"
|
||||
echo "Package version: $PKG_VERSION"
|
||||
if [ "$TAG_VERSION" != "$PKG_VERSION" ]; then
|
||||
echo "❌ Tag version ($TAG_VERSION) doesn't match package version ($PKG_VERSION)"
|
||||
echo "Please update package versions before creating the release tag."
|
||||
exit 1
|
||||
fi
|
||||
echo "✓ Version check passed"
|
||||
|
||||
- name: Install pnpm
|
||||
uses: pnpm/action-setup@v4
|
||||
|
||||
|
||||
+1
-2
@@ -63,5 +63,4 @@ skillkit.yaml
|
||||
|
||||
# Project documentation (not for version control)
|
||||
CLAUDE.md
|
||||
prd.md
|
||||
.vercel
|
||||
prd.md
|
||||
+1
-1
@@ -206,7 +206,7 @@ To add support for a new AI coding agent:
|
||||
|
||||
If you want to contribute skills to the ecosystem:
|
||||
|
||||
1. Follow the [Agent Skills specification](https://agenstskills.com)
|
||||
1. Follow the [Agent Skills specification](https://agentskills.io/specification)
|
||||
2. Include a `SKILL.md` with proper frontmatter
|
||||
3. Test with multiple agents using `skillkit translate`
|
||||
4. Submit to the appropriate skill repository
|
||||
|
||||
@@ -1,264 +1,358 @@
|
||||
<div align="center">
|
||||
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="docs/img/banner.svg">
|
||||
<source media="(prefers-color-scheme: light)" srcset="docs/img/banner.svg">
|
||||
<img alt="SkillKit - One Skill. 32 Agents." src="docs/img/banner.svg" width="100%">
|
||||
</picture>
|
||||
|
||||
<br/>
|
||||
|
||||
[](https://www.npmjs.com/package/skillkit)
|
||||
[](https://www.npmjs.com/package/skillkit)
|
||||
[](https://github.com/rohitg00/skillkit/stargazers)
|
||||
[](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
|
||||
[](https://opensource.org/licenses/Apache-2.0)
|
||||
[](https://agenstskills.com)
|
||||
[](https://agenstskills.com/docs)
|
||||
[](https://agenstskills.com/api)
|
||||
|
||||
**Write a skill once, deploy it to all 32 agents. No rewrites.**
|
||||
|
||||
[Website](https://agenstskills.com) · [Docs](https://agenstskills.com/docs) · [API](https://agenstskills.com/api) · [npm](https://www.npmjs.com/package/skillkit)
|
||||
|
||||
```
|
||||
██ SKILLKIT
|
||||
```
|
||||
</div>
|
||||
|
||||
---
|
||||
**Universal Skills for AI Coding Agents**
|
||||
|
||||
Skills make AI coding agents smarter. But every agent uses a different format:
|
||||
[](https://www.npmjs.com/package/skillkit)
|
||||
[](https://www.npmjs.com/package/skillkit)
|
||||
[](https://github.com/rohitg00/skillkit/pkgs/npm/skillkit)
|
||||
[](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
|
||||
[](https://agenstskills.com)
|
||||
[](https://opensource.org/licenses/Apache-2.0)
|
||||
|
||||
| Agent | Format | Directory |
|
||||
|-------|--------|-----------|
|
||||
| Claude Code | `SKILL.md` | `.claude/skills/` |
|
||||
| Cursor | `.mdc` | `.cursor/skills/` |
|
||||
| Copilot | Markdown | `.github/skills/` |
|
||||
| Windsurf | Markdown | `.windsurf/skills/` |
|
||||
## Supercharge Every AI Coding Agent
|
||||
|
||||
You end up rewriting the same skill for each agent, or locking into one platform.
|
||||
**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.
|
||||
|
||||
**SkillKit fixes this.** Install from 15,000+ skills, auto-translate between formats, persist learnings with Memory. Works with Claude, Cursor, Windsurf, Copilot, and 28 more.
|
||||
> **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.
|
||||
|
||||
```bash
|
||||
npx skillkit@latest
|
||||
npm install -g skillkit
|
||||
```
|
||||
|
||||
## Why 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 32 agents automatically. Write once, use everywhere.
|
||||
|
||||
## See It In Action
|
||||
|
||||
<div align="center">
|
||||
<video src="https://raw.githubusercontent.com/rohitg00/skillkit/main/docs/video/skillkit.mp4" controls width="100%"></video>
|
||||
|
||||
[](https://raw.githubusercontent.com/rohitg00/skillkit/main/docs/video/skillkit.mp4)
|
||||
|
||||
*Click the image above to watch the full demo*
|
||||
|
||||
</div>
|
||||
|
||||
## Quick Start
|
||||
> **Note:** If the video doesn't play above, [watch it here](https://raw.githubusercontent.com/rohitg00/skillkit/main/docs/video/skillkit.mp4)
|
||||
|
||||
```bash
|
||||
npx skillkit@latest init # Detect agents, create dirs
|
||||
skillkit recommend # Get smart suggestions
|
||||
skillkit install anthropics/skills # Install from marketplace
|
||||
skillkit sync # Deploy to your agents
|
||||
```
|
||||
# Install a skill for ALL your agents at once
|
||||
skillkit install anthropics/skills --agent claude-code,cursor,windsurf
|
||||
|
||||
Four commands. Your agents now have skills for PDF processing, code review, and more.
|
||||
# Or translate existing skills between any agents
|
||||
skillkit translate my-skill --from claude --to cursor,codex,copilot
|
||||
|
||||
## What Can You Do?
|
||||
|
||||
### Install skills from anywhere
|
||||
|
||||
```bash
|
||||
skillkit install anthropics/skills # GitHub
|
||||
skillkit install gitlab:team/skills # GitLab
|
||||
skillkit install ./my-local-skills # Local path
|
||||
```
|
||||
|
||||
### Translate between agents
|
||||
|
||||
Write for Claude, deploy to Cursor:
|
||||
|
||||
```bash
|
||||
skillkit translate my-skill --to cursor
|
||||
skillkit translate --all --to windsurf
|
||||
```
|
||||
|
||||
### Get smart recommendations
|
||||
|
||||
SkillKit reads your project, detects your stack, and suggests relevant skills:
|
||||
|
||||
```bash
|
||||
# Get smart recommendations based on your project
|
||||
skillkit recommend
|
||||
# 92% vercel-react-best-practices
|
||||
# 87% tailwind-v4-patterns
|
||||
# 85% nextjs-app-router
|
||||
# > 92% match: vercel-react-best-practices
|
||||
# > 87% match: tailwind-v4-patterns
|
||||
# > 85% match: nextjs-app-router
|
||||
```
|
||||
|
||||
### Discover skills at runtime
|
||||
## Beautiful CLI Experience
|
||||
|
||||
Start an API server and let agents find skills on demand:
|
||||
|
||||
```bash
|
||||
skillkit serve
|
||||
# Server running at http://localhost:3737
|
||||
|
||||
curl "http://localhost:3737/search?q=react+performance"
|
||||
```
|
||||
|
||||
Or use MCP for native agent integration:
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"skillkit": { "command": "npx", "args": ["@skillkit/mcp"] }
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Or use Python:
|
||||
|
||||
```bash
|
||||
pip install skillkit-client
|
||||
```
|
||||
|
||||
```python
|
||||
from skillkit import SkillKitClient
|
||||
|
||||
async with SkillKitClient() as client:
|
||||
results = await client.search("react performance", limit=5)
|
||||
```
|
||||
|
||||
[REST API docs](https://agenstskills.com/docs/rest-api) · [MCP Server docs](https://agenstskills.com/docs/mcp-server) · [Python Client docs](https://agenstskills.com/docs/python-client) · [Interactive API explorer](https://agenstskills.com/api)
|
||||
|
||||
### Auto-generate agent instructions
|
||||
|
||||
Let SkillKit analyze your codebase and create CLAUDE.md, .cursorrules, etc.:
|
||||
|
||||
```bash
|
||||
skillkit primer --all-agents
|
||||
```
|
||||
|
||||
### Session memory
|
||||
|
||||
Your AI agents learn patterns during sessions, then forget everything. SkillKit captures those learnings:
|
||||
|
||||
```bash
|
||||
skillkit memory compress
|
||||
skillkit memory search "auth patterns"
|
||||
skillkit memory export auth-patterns
|
||||
```
|
||||
|
||||
### AI skill generation
|
||||
|
||||
Generate skills from natural language with multi-source context:
|
||||
|
||||
```bash
|
||||
skillkit generate
|
||||
# Interactive wizard with 4 context sources:
|
||||
# - Documentation (via Context7)
|
||||
# - Your codebase patterns
|
||||
# - 15,000+ marketplace skills
|
||||
# - Memory (your corrections)
|
||||
```
|
||||
|
||||
Works with any LLM: Claude, GPT-4, Gemini, Ollama (local), or OpenRouter (100+ models). Generates agent-optimized variants with trust scores.
|
||||
|
||||
### Mesh network
|
||||
|
||||
Distribute agents across machines with encrypted P2P:
|
||||
|
||||
```bash
|
||||
skillkit mesh init
|
||||
skillkit mesh discover
|
||||
```
|
||||
|
||||
### Team collaboration
|
||||
|
||||
Share skills via a Git-committable `.skills` manifest:
|
||||
|
||||
```bash
|
||||
skillkit manifest init
|
||||
skillkit manifest add anthropics/skills
|
||||
git commit -m "add team skills"
|
||||
```
|
||||
|
||||
Team members run `skillkit manifest install` and they're in sync.
|
||||
|
||||
### Interactive TUI
|
||||
|
||||
```bash
|
||||
skillkit ui
|
||||
```
|
||||
|
||||
`h` Home · `m` Marketplace · `r` Recommend · `t` Translate · `i` Installed · `s` Sync · `q` Quit
|
||||
SkillKit features a polished, interactive CLI with visual feedback:
|
||||
|
||||

|
||||
|
||||
## Supported Agents (32)
|
||||
- **Adaptive Logo** - Full ASCII art on wide terminals, compact on narrow
|
||||
- **Agent Icons** - Visual indicators: ⟁ Claude · ◫ Cursor · ◎ Codex · ✦ Gemini · ⬡ OpenCode
|
||||
- **Interactive Selection** - Multi-select skills and agents with visual feedback
|
||||
- **Progress Indicators** - Step trails, spinners, and progress bars
|
||||
- **Smart Defaults** - Remembers your last selected agents
|
||||
|
||||
| Agent | Format | Directory |
|
||||
|-------|--------|-----------|
|
||||
| **Claude Code** | SKILL.md | `.claude/skills/` |
|
||||
| **Cursor** | .mdc | `.cursor/skills/` |
|
||||
| **Codex** | SKILL.md | `.codex/skills/` |
|
||||
| **Gemini CLI** | SKILL.md | `.gemini/skills/` |
|
||||
| **OpenCode** | SKILL.md | `.opencode/skills/` |
|
||||
| **GitHub Copilot** | Markdown | `.github/skills/` |
|
||||
| **Windsurf** | Markdown | `.windsurf/skills/` |
|
||||
## What Makes SkillKit Different
|
||||
|
||||
Plus 25 more: Amp, Antigravity, Clawdbot, Cline, CodeBuddy, CommandCode, Continue, Crush, Droid, Factory, Goose, Kilo Code, Kiro CLI, MCPJam, Mux, Neovate, OpenHands, Pi, Qoder, Qwen, Roo Code, Trae, Vercel, Zencoder, Universal
|
||||
| Feature | Without SkillKit | With SkillKit |
|
||||
|---------|-----------------|---------------|
|
||||
| **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 (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 |
|
||||
|
||||
[Full agent details](https://agenstskills.com/docs/agents)
|
||||
|
||||
## Commands
|
||||
|
||||
### Core
|
||||
## 5-Minute Quick Start
|
||||
|
||||
```bash
|
||||
skillkit install <source> # Install skills
|
||||
skillkit remove <skills> # Remove skills
|
||||
skillkit translate <skill> --to # Translate between agents
|
||||
skillkit sync # Deploy to agent config
|
||||
skillkit recommend # Smart recommendations
|
||||
skillkit generate # AI skill generation wizard
|
||||
skillkit serve # Start REST API server
|
||||
# 1. Install SkillKit globally
|
||||
npm install -g skillkit
|
||||
|
||||
# 2. Launch the interactive TUI (easiest way to start)
|
||||
skillkit
|
||||
|
||||
# Or use CLI commands directly:
|
||||
|
||||
# 3. Get personalized skill recommendations
|
||||
skillkit recommend
|
||||
|
||||
# 4. Install skills from the marketplace
|
||||
skillkit install anthropics/skills
|
||||
|
||||
# 5. Sync to your AI agent
|
||||
skillkit sync
|
||||
```
|
||||
|
||||
### Discovery & Security
|
||||
## Core Features
|
||||
|
||||
### Cross-Agent Translation
|
||||
|
||||
Use any skill with any agent. SkillKit automatically converts between formats:
|
||||
|
||||
```bash
|
||||
skillkit marketplace # Browse skills
|
||||
skillkit tree # Hierarchical taxonomy
|
||||
skillkit find <query> # Quick search
|
||||
skillkit scan <path> # Security scan for skills
|
||||
# Translate a Claude skill to Cursor format
|
||||
skillkit translate react-patterns --to cursor
|
||||
|
||||
# Translate all your skills to a new agent
|
||||
skillkit translate --all --to windsurf
|
||||
|
||||
# Preview translation without writing
|
||||
skillkit translate my-skill --to codex --dry-run
|
||||
|
||||
# Batch translate from a custom source directory
|
||||
skillkit agent translate --source ./my-skills --to cursor
|
||||
|
||||
# Recursively translate nested agent directories
|
||||
skillkit agent translate --source ./kubernetes-skills --to cursor --recursive
|
||||
```
|
||||
|
||||
### Advanced
|
||||
**Supported Agents:** Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Antigravity, Amp, Clawdbot, Droid, GitHub Copilot, Goose, Kilo, Kiro, Roo, Trae, Windsurf, Universal
|
||||
|
||||
### Smart Recommendations
|
||||
|
||||
SkillKit analyzes your project and suggests the perfect skills:
|
||||
|
||||
```bash
|
||||
skillkit primer --all-agents # Generate agent instructions
|
||||
skillkit memory compress # Capture session learnings
|
||||
skillkit mesh init # Multi-machine distribution
|
||||
skillkit message send # Inter-agent messaging
|
||||
skillkit workflow run <name> # Run workflows
|
||||
skillkit test # Test skills
|
||||
skillkit cicd init # CI/CD templates
|
||||
skillkit recommend
|
||||
|
||||
# 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
|
||||
```
|
||||
|
||||
[Full command reference](https://agenstskills.com/docs/commands)
|
||||
Filter by task, category, or minimum score:
|
||||
|
||||
```bash
|
||||
skillkit recommend --search "auth" # Task-based search
|
||||
skillkit recommend --category security # Category filter
|
||||
skillkit recommend --min-score 80 # Quality threshold
|
||||
```
|
||||
|
||||
### Session Memory System
|
||||
|
||||
Your AI agents learn, but that knowledge dies with the session. SkillKit captures learnings and makes them persistent:
|
||||
|
||||
```bash
|
||||
# Compress session observations into reusable learnings
|
||||
skillkit memory compress
|
||||
|
||||
# Search past learnings
|
||||
skillkit memory search "authentication patterns"
|
||||
|
||||
# Export a learning as a shareable skill
|
||||
skillkit memory export auth-insight --output auth-patterns.md
|
||||
|
||||
# Share memory across projects
|
||||
skillkit memory --global
|
||||
```
|
||||
|
||||
### Skill Marketplace
|
||||
|
||||
Browse and install from curated skill repositories:
|
||||
|
||||
```bash
|
||||
# Browse all available skills
|
||||
skillkit marketplace
|
||||
|
||||
# Search for specific skills
|
||||
skillkit marketplace search "react hooks"
|
||||
|
||||
# Filter by tags
|
||||
skillkit marketplace --tags typescript,testing
|
||||
|
||||
# Refresh the skill index
|
||||
skillkit marketplace refresh
|
||||
```
|
||||
|
||||
### Interactive TUI
|
||||
|
||||
Beautiful terminal interface for visual skill management:
|
||||
|
||||
```bash
|
||||
skillkit ui
|
||||
# or just
|
||||
skillkit
|
||||
```
|
||||
|
||||
**Navigation:** `h` Home | `b` Browse | `r` Recommend | `t` Translate | `c` Context | `l` List | `s` Sync | `q` Quit
|
||||
|
||||
### Skill Testing Framework
|
||||
|
||||
Test your skills with built-in assertions:
|
||||
|
||||
```bash
|
||||
# Run all skill tests
|
||||
skillkit test
|
||||
|
||||
# Test specific skills
|
||||
skillkit test ./my-skill
|
||||
|
||||
# Run tests with specific tags
|
||||
skillkit test --tags unit,integration
|
||||
|
||||
# JSON output for CI
|
||||
skillkit test --json
|
||||
```
|
||||
|
||||
### Workflow Orchestration
|
||||
|
||||
Compose skills into multi-step workflows:
|
||||
|
||||
```bash
|
||||
# List available workflows
|
||||
skillkit workflow list
|
||||
|
||||
# Run a workflow
|
||||
skillkit workflow run feature-development
|
||||
|
||||
# Create new workflow
|
||||
skillkit workflow create my-workflow
|
||||
```
|
||||
|
||||
### CI/CD Integration
|
||||
|
||||
Generate CI/CD templates for automated skill management:
|
||||
|
||||
```bash
|
||||
# GitHub Actions
|
||||
skillkit cicd github-action
|
||||
|
||||
# GitLab CI
|
||||
skillkit cicd gitlab-ci
|
||||
|
||||
# Pre-commit hooks
|
||||
skillkit cicd pre-commit
|
||||
```
|
||||
|
||||
## Supported Agents (17)
|
||||
|
||||
| Agent | Format | Skills Directory |
|
||||
|-------|--------|------------------|
|
||||
| Claude Code | SKILL.md | `.claude/skills/` |
|
||||
| Cursor | MDC (.mdc) | `.cursor/skills/` |
|
||||
| Codex | SKILL.md | `.codex/skills/` |
|
||||
| Gemini CLI | SKILL.md | `.gemini/skills/` |
|
||||
| OpenCode | SKILL.md | `.opencode/skills/` |
|
||||
| Antigravity | SKILL.md | `.antigravity/skills/` |
|
||||
| Amp | SKILL.md | `.amp/skills/` |
|
||||
| Clawdbot | SKILL.md | `skills/` or `~/.clawdbot/skills/` |
|
||||
| Droid (Factory) | SKILL.md | `.factory/skills/` |
|
||||
| GitHub Copilot | Markdown | `.github/skills/` |
|
||||
| Goose | SKILL.md | `.goose/skills/` |
|
||||
| Kilo Code | SKILL.md | `.kilocode/skills/` |
|
||||
| Kiro CLI | SKILL.md | `.kiro/skills/` |
|
||||
| Roo Code | SKILL.md | `.roo/skills/` |
|
||||
| Trae | SKILL.md | `.trae/skills/` |
|
||||
| Windsurf | Markdown | `.windsurf/skills/` |
|
||||
| Universal | SKILL.md | `skills/` |
|
||||
|
||||
## All Commands
|
||||
|
||||
### Skill Management
|
||||
|
||||
```bash
|
||||
skillkit install <source> # Install skills from GitHub/GitLab/Bitbucket/local
|
||||
skillkit remove <skills> # Remove installed skills
|
||||
skillkit update [skills] # Update skills from source
|
||||
skillkit list # List installed skills
|
||||
skillkit enable <skills> # Enable specific skills
|
||||
skillkit disable <skills> # Disable specific skills
|
||||
skillkit sync # Sync skills to agent config
|
||||
skillkit read <skills> # Read skill content for AI
|
||||
```
|
||||
|
||||
### Discovery & Recommendations
|
||||
|
||||
```bash
|
||||
skillkit recommend # Get smart recommendations
|
||||
skillkit marketplace # Browse skill marketplace
|
||||
skillkit marketplace search # Search marketplace
|
||||
```
|
||||
|
||||
### Translation & Context
|
||||
|
||||
```bash
|
||||
skillkit translate # Translate between formats
|
||||
skillkit context init # Initialize project context
|
||||
skillkit context sync # Sync context to agents
|
||||
```
|
||||
|
||||
### Custom AI Sub-Agents
|
||||
|
||||
```bash
|
||||
skillkit agent list # List all installed agents
|
||||
skillkit agent show <name> # Show agent details
|
||||
skillkit agent create <name> # Create a new agent
|
||||
skillkit agent translate # Translate agents between formats
|
||||
--source ./path # Source directory or file
|
||||
--to cursor # Target agent format
|
||||
--recursive # Scan subdirectories recursively
|
||||
--dry-run # Preview without writing
|
||||
skillkit agent sync # Sync agents to target AI agent
|
||||
skillkit agent validate # Validate agent definitions
|
||||
```
|
||||
|
||||
### Memory System
|
||||
|
||||
```bash
|
||||
skillkit memory status # View memory status
|
||||
skillkit memory search # Search learnings
|
||||
skillkit memory compress # Compress observations
|
||||
skillkit memory export # Export as skill
|
||||
```
|
||||
|
||||
### Testing & Workflows
|
||||
|
||||
```bash
|
||||
skillkit test # Run skill tests
|
||||
skillkit workflow run # Execute workflow
|
||||
skillkit cicd # Generate CI/CD templates
|
||||
```
|
||||
|
||||
### Utilities
|
||||
|
||||
```bash
|
||||
skillkit init # Initialize in project
|
||||
skillkit validate # Validate skill format
|
||||
skillkit create # Create new skill
|
||||
```
|
||||
|
||||
## Creating Skills
|
||||
|
||||
### Quick Start
|
||||
|
||||
```bash
|
||||
skillkit create my-skill
|
||||
```
|
||||
|
||||
Or manually create a `SKILL.md`:
|
||||
### Manual Creation
|
||||
|
||||
Create a `SKILL.md` file following the [Agent Skills specification](https://agentskills.io/specification):
|
||||
|
||||
```markdown
|
||||
---
|
||||
name: my-skill
|
||||
description: What this skill does
|
||||
description: What this skill does and when to use it
|
||||
license: MIT
|
||||
metadata:
|
||||
author: your-name
|
||||
version: "1.0"
|
||||
---
|
||||
|
||||
# My Skill
|
||||
@@ -277,62 +371,105 @@ Instructions for the AI agent.
|
||||
## Programmatic API
|
||||
|
||||
```typescript
|
||||
import { translateSkill, analyzeProject, RecommendationEngine } from 'skillkit';
|
||||
import {
|
||||
// Skill discovery
|
||||
findAllSkills,
|
||||
discoverSkills,
|
||||
detectAgent,
|
||||
getAdapter,
|
||||
|
||||
const skill = await translateSkill(content, 'cursor');
|
||||
// Translation
|
||||
translateSkill,
|
||||
translateSkillFile,
|
||||
|
||||
const profile = await analyzeProject('./my-project');
|
||||
// Recommendations
|
||||
RecommendationEngine,
|
||||
analyzeProject,
|
||||
|
||||
// Context
|
||||
ContextManager,
|
||||
syncToAllAgents,
|
||||
|
||||
// Memory
|
||||
createMemoryCompressor,
|
||||
createMemoryInjector,
|
||||
LearningStore,
|
||||
|
||||
// Marketplace
|
||||
createMarketplaceAggregator,
|
||||
|
||||
// Testing
|
||||
SkillTestRunner,
|
||||
|
||||
// Workflows
|
||||
WorkflowOrchestrator,
|
||||
} from 'skillkit';
|
||||
|
||||
// Example: Translate and install
|
||||
const skill = await translateSkill(skillContent, 'cursor');
|
||||
console.log(skill.content);
|
||||
|
||||
// Example: Get recommendations
|
||||
const engine = new RecommendationEngine();
|
||||
const recs = await engine.recommend(profile);
|
||||
const profile = await analyzeProject('./my-project');
|
||||
const recs = engine.recommend(profile);
|
||||
```
|
||||
|
||||
```typescript
|
||||
import { startServer } from '@skillkit/api';
|
||||
await startServer({ port: 3737, skills: [...] });
|
||||
```
|
||||
|
||||
```typescript
|
||||
import { MemoryCache, RelevanceRanker } from '@skillkit/core';
|
||||
const cache = new MemoryCache({ maxSize: 500, ttlMs: 86_400_000 });
|
||||
const ranker = new RelevanceRanker();
|
||||
const results = ranker.rank(skills, 'react performance');
|
||||
```
|
||||
|
||||
## Skill Sources
|
||||
|
||||
SkillKit aggregates skills from trusted sources. All original creators are credited with their licenses preserved.
|
||||
|
||||
### Official Partners
|
||||
## Popular Skill Repositories
|
||||
|
||||
| Repository | Description |
|
||||
|------------|-------------|
|
||||
| [anthropics/skills](https://github.com/anthropics/skills) | Official Claude Code skills |
|
||||
| [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | Next.js and React skills |
|
||||
| [expo/skills](https://github.com/expo/skills) | Mobile development with Expo |
|
||||
| [remotion-dev/skills](https://github.com/remotion-dev/skills) | Programmatic video creation |
|
||||
| [supabase/agent-skills](https://github.com/supabase/agent-skills) | Database and auth skills |
|
||||
| [stripe/ai](https://github.com/stripe/ai) | Payment integration patterns |
|
||||
| [anthropics/skills](https://github.com/anthropics/skills) | Official Claude Code marketplace - PDF, XLSX, DOCX processing |
|
||||
| [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | React/Next.js best practices, web design guidelines |
|
||||
|
||||
### Community
|
||||
|
||||
[trailofbits/skills](https://github.com/trailofbits/skills) · [obra/superpowers](https://github.com/obra/superpowers) · [wshobson/agents](https://github.com/wshobson/agents) · [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) · [travisvn/awesome-claude-skills](https://github.com/travisvn/awesome-claude-skills) · [langgenius/dify](https://github.com/langgenius/dify) · [better-auth/skills](https://github.com/better-auth/skills) · [onmax/nuxt-skills](https://github.com/onmax/nuxt-skills) · [elysiajs/skills](https://github.com/elysiajs/skills) · [kadajett/agent-nestjs-skills](https://github.com/kadajett/agent-nestjs-skills) · [cloudai-x/threejs-skills](https://github.com/cloudai-x/threejs-skills) · [dimillian/skills](https://github.com/dimillian/skills) · [waynesutton/convexskills](https://github.com/waynesutton/convexskills) · [kepano/obsidian-skills](https://github.com/kepano/obsidian-skills) · [giuseppe-trisciuoglio/developer-kit](https://github.com/giuseppe-trisciuoglio/developer-kit) · [openrouterteam/agent-skills](https://github.com/openrouterteam/agent-skills)
|
||||
|
||||
**Want to add your skills?** [Submit your repository](https://github.com/rohitg00/skillkit/issues/new?template=add-source.md)
|
||||
|
||||
## Install
|
||||
## Installation Options
|
||||
|
||||
```bash
|
||||
npm install -g skillkit # npm
|
||||
pnpm add -g skillkit # pnpm
|
||||
yarn global add skillkit # yarn
|
||||
bun add -g skillkit # bun
|
||||
npx skillkit <command> # no install
|
||||
# npm (recommended)
|
||||
npm install -g skillkit
|
||||
|
||||
# pnpm
|
||||
pnpm add -g skillkit
|
||||
|
||||
# yarn
|
||||
yarn global add skillkit
|
||||
|
||||
# bun
|
||||
bun add -g skillkit
|
||||
|
||||
# npx (no install)
|
||||
npx skillkit <command>
|
||||
|
||||
# GitHub Packages (alternative registry)
|
||||
npm install -g @rohitg00/skillkit --registry=https://npm.pkg.github.com
|
||||
```
|
||||
|
||||
## Configuration
|
||||
|
||||
Create `skillkit.yaml` in your project:
|
||||
|
||||
```yaml
|
||||
version: 1
|
||||
agent: cursor # Override auto-detection
|
||||
autoSync: true # Auto-sync on changes
|
||||
enabledSkills:
|
||||
- pdf
|
||||
- xlsx
|
||||
disabledSkills:
|
||||
- deprecated-skill
|
||||
```
|
||||
|
||||
## License
|
||||
|
||||
Apache License 2.0 — see [LICENSE](LICENSE).
|
||||
Apache License 2.0 - see [LICENSE](LICENSE) for details.
|
||||
|
||||
## Contributing
|
||||
|
||||
Contributions welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md).
|
||||
|
||||
## Links
|
||||
|
||||
[Documentation](https://agenstskills.com/docs) · [Website](https://agenstskills.com) · [API Explorer](https://agenstskills.com/api) · [npm](https://www.npmjs.com/package/skillkit) · [GitHub](https://github.com/rohitg00/skillkit)
|
||||
- [Agent Skills Specification](https://agentskills.io/specification)
|
||||
- [GitHub Repository](https://github.com/rohitg00/skillkit)
|
||||
- [NPM Package](https://www.npmjs.com/package/skillkit)
|
||||
- [GitHub Package](https://github.com/rohitg00/skillkit/pkgs/npm/skillkit)
|
||||
|
||||
@@ -1,93 +0,0 @@
|
||||
# Versioning
|
||||
|
||||
SkillKit uses **synchronized versioning** - all packages share the same version number.
|
||||
|
||||
## Package List
|
||||
|
||||
All these packages are kept in sync:
|
||||
|
||||
| Package | Location |
|
||||
|---------|----------|
|
||||
| `skillkit` | `apps/skillkit/` |
|
||||
| `@skillkit/cli` | `packages/cli/` |
|
||||
| `@skillkit/core` | `packages/core/` |
|
||||
| `@skillkit/tui` | `packages/tui/` |
|
||||
| `@skillkit/agents` | `packages/agents/` |
|
||||
| `@skillkit/memory` | `packages/memory/` |
|
||||
| `@skillkit/mesh` | `packages/mesh/` |
|
||||
| `@skillkit/messaging` | `packages/messaging/` |
|
||||
| `@skillkit/mcp-memory` | `packages/mcp-memory/` |
|
||||
| `@skillkit/resources` | `packages/resources/` |
|
||||
| `skillkit-docs` | `docs/fumadocs/` |
|
||||
| Website | `docs/skillkit/` |
|
||||
|
||||
## How to Release
|
||||
|
||||
### 1. Bump Version
|
||||
|
||||
Use the version bump script:
|
||||
|
||||
```bash
|
||||
./scripts/bump-version.sh 1.8.1
|
||||
```
|
||||
|
||||
This updates all package.json files to the same version.
|
||||
|
||||
### 2. Commit Changes
|
||||
|
||||
```bash
|
||||
git add -A
|
||||
git commit -m "chore: bump version to 1.8.1"
|
||||
git push origin main
|
||||
```
|
||||
|
||||
### 3. Create Release
|
||||
|
||||
```bash
|
||||
gh release create v1.8.1 --generate-notes
|
||||
```
|
||||
|
||||
Or with custom notes:
|
||||
|
||||
```bash
|
||||
gh release create v1.8.1 --title "v1.8.1 - Bug fixes" --notes "Release notes here"
|
||||
```
|
||||
|
||||
### 4. Automated Publishing
|
||||
|
||||
When you push a tag starting with `v`, the CI automatically:
|
||||
|
||||
1. Verifies tag matches package versions
|
||||
2. Runs tests
|
||||
3. Publishes to npm
|
||||
4. Publishes to GitHub Packages
|
||||
5. Creates GitHub Release
|
||||
|
||||
## CI Checks
|
||||
|
||||
The CI validates version consistency on every PR:
|
||||
|
||||
- **version-check** job compares all package versions
|
||||
- Fails if any package has a different version
|
||||
- Run `./scripts/bump-version.sh <version>` to fix mismatches
|
||||
|
||||
## Semantic Versioning
|
||||
|
||||
We follow [semver](https://semver.org/):
|
||||
|
||||
- **MAJOR** (x.0.0): Breaking changes
|
||||
- **MINOR** (0.x.0): New features, backward compatible
|
||||
- **PATCH** (0.0.x): Bug fixes, backward compatible
|
||||
|
||||
## Quick Commands
|
||||
|
||||
```bash
|
||||
# Check current versions
|
||||
grep -r '"version"' apps/skillkit/package.json
|
||||
|
||||
# Bump all packages
|
||||
./scripts/bump-version.sh 1.8.1
|
||||
|
||||
# Create release
|
||||
gh release create v1.8.1 --generate-notes
|
||||
```
|
||||
@@ -1,6 +1,6 @@
|
||||
# SkillKit
|
||||
|
||||
Universal skills manager for AI coding agents. Install, manage, and sync skills across 32 AI agents including Claude Code, Cursor, Codex, Gemini CLI, and more.
|
||||
Universal skills manager for AI coding agents. Install, manage, and sync skills across 17+ AI agents including Claude Code, Cursor, Codex, Gemini CLI, and more.
|
||||
|
||||
## Installation
|
||||
|
||||
@@ -150,11 +150,9 @@ skillkit memory compress
|
||||
skillkit memory export auth-insight --output auth-skill.md
|
||||
```
|
||||
|
||||
## Supported Agents (32)
|
||||
## Supported Agents (17)
|
||||
|
||||
**Primary (17):** Claude Code, Cursor, Codex, Gemini CLI, Windsurf, GitHub Copilot, OpenCode, Antigravity, Amp, Clawdbot, Droid, Goose, Kilo, Kiro, Roo, Trae, Universal
|
||||
|
||||
**Extended (15):** Cline, CodeBuddy, CommandCode, Continue, Crush, Factory, MCPJam, Mux, Neovate, OpenHands, Pi, Qoder, Qwen, Vercel, Zencoder
|
||||
Claude Code, Cursor, Codex, Gemini CLI, Windsurf, GitHub Copilot, OpenCode, Antigravity, Amp, Clawdbot, Droid, Goose, Kilo, Kiro, Roo, Trae, Universal
|
||||
|
||||
## Usage Examples
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "skillkit",
|
||||
"version": "1.14.0",
|
||||
"version": "1.7.6",
|
||||
"description": "Supercharge AI coding agents with portable skills. Install, translate, and share skills across Claude Code, Cursor, Codex, Copilot & 13 more",
|
||||
"type": "module",
|
||||
"bin": {
|
||||
@@ -53,14 +53,10 @@
|
||||
"node": ">=18.0.0"
|
||||
},
|
||||
"dependencies": {
|
||||
"@skillkit/api": "workspace:*",
|
||||
"@skillkit/core": "workspace:*",
|
||||
"@skillkit/agents": "workspace:*",
|
||||
"@skillkit/cli": "workspace:*",
|
||||
"@skillkit/tui": "workspace:*",
|
||||
"@skillkit/memory": "workspace:*",
|
||||
"@skillkit/mesh": "workspace:*",
|
||||
"@skillkit/messaging": "workspace:*",
|
||||
"clipanion": "^4.0.0-rc.4"
|
||||
},
|
||||
"devDependencies": {
|
||||
|
||||
+1
-107
@@ -26,8 +26,6 @@ import {
|
||||
WorkflowRunCommand,
|
||||
WorkflowListCommand,
|
||||
WorkflowCreateCommand,
|
||||
WorkflowPipelineCommand,
|
||||
WorkflowPipelineListCommand,
|
||||
RunCommand,
|
||||
TestCommand,
|
||||
MarketplaceCommand,
|
||||
@@ -38,27 +36,19 @@ import {
|
||||
PluginCommand,
|
||||
MethodologyCommand,
|
||||
HookCommand,
|
||||
HookTemplateListCommand,
|
||||
HookTemplateApplyCommand,
|
||||
HookTemplateShowCommand,
|
||||
PlanCommand,
|
||||
CommandCmd,
|
||||
CommandAvailableCommand,
|
||||
CommandInstallCommand,
|
||||
AICommand,
|
||||
AuditCommand,
|
||||
PublishCommand,
|
||||
PublishSubmitCommand,
|
||||
AgentCommand,
|
||||
AgentListCommand,
|
||||
AgentShowCommand,
|
||||
AgentCreateCommand,
|
||||
AgentFromSkillCommand,
|
||||
AgentTranslateCommand,
|
||||
AgentSyncCommand,
|
||||
AgentValidateCommand,
|
||||
AgentInstallCommand,
|
||||
AgentAvailableCommand,
|
||||
// New commands (Phase 21)
|
||||
CheckCommand,
|
||||
FindCommand,
|
||||
ManifestCommand,
|
||||
@@ -67,43 +57,6 @@ import {
|
||||
ManifestRemoveCommand,
|
||||
ManifestInstallCommand,
|
||||
ManifestGenerateCommand,
|
||||
PrimerCommand,
|
||||
MeshCommand,
|
||||
MessageCommand,
|
||||
LearnCommand,
|
||||
PatternStatusCommand,
|
||||
PatternFeedbackCommand,
|
||||
PatternApproveCommand,
|
||||
PatternRejectCommand,
|
||||
PatternExportCommand,
|
||||
PatternImportCommand,
|
||||
PatternClusterCommand,
|
||||
SessionCommand,
|
||||
SessionStatusCommand,
|
||||
SessionStartCommand,
|
||||
SessionLoadCommand,
|
||||
SessionListCommand,
|
||||
SessionNoteCommand,
|
||||
SessionCompleteCommand,
|
||||
SessionInProgressCommand,
|
||||
ProfileCommand,
|
||||
ProfileListCommand,
|
||||
ProfileCreateCommand,
|
||||
ProfileRemoveCommand,
|
||||
GuidelineCommand,
|
||||
GuidelineListCommand,
|
||||
GuidelineShowCommand,
|
||||
GuidelineEnableCommand,
|
||||
GuidelineDisableCommand,
|
||||
GuidelineCreateCommand,
|
||||
GuidelineRemoveCommand,
|
||||
TreeCommand,
|
||||
QuickCommand,
|
||||
SkillMdValidateCommand,
|
||||
SkillMdInitCommand,
|
||||
SkillMdCheckCommand,
|
||||
ServeCommand,
|
||||
ScanCommand,
|
||||
} from '@skillkit/cli';
|
||||
|
||||
const __filename = fileURLToPath(import.meta.url);
|
||||
@@ -158,12 +111,10 @@ cli.register(CommandCmd);
|
||||
cli.register(AICommand);
|
||||
cli.register(AuditCommand);
|
||||
cli.register(PublishCommand);
|
||||
cli.register(PublishSubmitCommand);
|
||||
cli.register(AgentCommand);
|
||||
cli.register(AgentListCommand);
|
||||
cli.register(AgentShowCommand);
|
||||
cli.register(AgentCreateCommand);
|
||||
cli.register(AgentFromSkillCommand);
|
||||
cli.register(AgentTranslateCommand);
|
||||
cli.register(AgentSyncCommand);
|
||||
cli.register(AgentValidateCommand);
|
||||
@@ -176,62 +127,5 @@ cli.register(ManifestAddCommand);
|
||||
cli.register(ManifestRemoveCommand);
|
||||
cli.register(ManifestInstallCommand);
|
||||
cli.register(ManifestGenerateCommand);
|
||||
cli.register(PrimerCommand);
|
||||
cli.register(MeshCommand);
|
||||
cli.register(MessageCommand);
|
||||
|
||||
cli.register(WorkflowPipelineCommand);
|
||||
cli.register(WorkflowPipelineListCommand);
|
||||
|
||||
cli.register(HookTemplateListCommand);
|
||||
cli.register(HookTemplateApplyCommand);
|
||||
cli.register(HookTemplateShowCommand);
|
||||
|
||||
cli.register(CommandAvailableCommand);
|
||||
cli.register(CommandInstallCommand);
|
||||
|
||||
cli.register(AgentInstallCommand);
|
||||
cli.register(AgentAvailableCommand);
|
||||
|
||||
cli.register(LearnCommand);
|
||||
cli.register(PatternStatusCommand);
|
||||
cli.register(PatternFeedbackCommand);
|
||||
cli.register(PatternApproveCommand);
|
||||
cli.register(PatternRejectCommand);
|
||||
cli.register(PatternExportCommand);
|
||||
cli.register(PatternImportCommand);
|
||||
cli.register(PatternClusterCommand);
|
||||
|
||||
cli.register(SessionCommand);
|
||||
cli.register(SessionStatusCommand);
|
||||
cli.register(SessionStartCommand);
|
||||
cli.register(SessionLoadCommand);
|
||||
cli.register(SessionListCommand);
|
||||
cli.register(SessionNoteCommand);
|
||||
cli.register(SessionCompleteCommand);
|
||||
cli.register(SessionInProgressCommand);
|
||||
|
||||
cli.register(ProfileCommand);
|
||||
cli.register(ProfileListCommand);
|
||||
cli.register(ProfileCreateCommand);
|
||||
cli.register(ProfileRemoveCommand);
|
||||
|
||||
cli.register(GuidelineCommand);
|
||||
cli.register(GuidelineListCommand);
|
||||
cli.register(GuidelineShowCommand);
|
||||
cli.register(GuidelineEnableCommand);
|
||||
cli.register(GuidelineDisableCommand);
|
||||
cli.register(GuidelineCreateCommand);
|
||||
cli.register(GuidelineRemoveCommand);
|
||||
|
||||
cli.register(TreeCommand);
|
||||
|
||||
cli.register(QuickCommand);
|
||||
cli.register(SkillMdValidateCommand);
|
||||
cli.register(SkillMdInitCommand);
|
||||
cli.register(SkillMdCheckCommand);
|
||||
|
||||
cli.register(ServeCommand);
|
||||
cli.register(ScanCommand);
|
||||
|
||||
cli.runExit(process.argv.slice(2));
|
||||
|
||||
@@ -1,42 +0,0 @@
|
||||
[build-system]
|
||||
requires = ["hatchling"]
|
||||
build-backend = "hatchling.build"
|
||||
|
||||
[project]
|
||||
name = "skillkit-client"
|
||||
version = "0.1.0"
|
||||
description = "Python client for the SkillKit REST API"
|
||||
readme = "README.md"
|
||||
license = "Apache-2.0"
|
||||
requires-python = ">=3.9"
|
||||
authors = [
|
||||
{ name = "Rohit Ghumare", email = "ghumare64@gmail.com" },
|
||||
]
|
||||
keywords = ["skillkit", "ai", "agents", "skills", "discovery"]
|
||||
classifiers = [
|
||||
"Development Status :: 3 - Alpha",
|
||||
"Intended Audience :: Developers",
|
||||
"License :: OSI Approved :: Apache Software License",
|
||||
"Programming Language :: Python :: 3",
|
||||
"Programming Language :: Python :: 3.9",
|
||||
"Programming Language :: Python :: 3.10",
|
||||
"Programming Language :: Python :: 3.11",
|
||||
"Programming Language :: Python :: 3.12",
|
||||
"Topic :: Software Development :: Libraries",
|
||||
]
|
||||
dependencies = [
|
||||
"httpx>=0.27",
|
||||
"pydantic>=2.0",
|
||||
]
|
||||
|
||||
[project.optional-dependencies]
|
||||
dev = [
|
||||
"pytest>=7.0",
|
||||
"pytest-asyncio>=0.23",
|
||||
"respx>=0.21",
|
||||
]
|
||||
|
||||
[project.urls]
|
||||
Homepage = "https://github.com/rohitg00/skillkit"
|
||||
Documentation = "https://agenstskills.com"
|
||||
Repository = "https://github.com/rohitg00/skillkit"
|
||||
@@ -1,12 +0,0 @@
|
||||
from skillkit.client import SkillKitClient
|
||||
from skillkit.models import Skill, SearchResponse, HealthResponse, CacheStats, Category
|
||||
|
||||
__all__ = [
|
||||
"SkillKitClient",
|
||||
"Skill",
|
||||
"SearchResponse",
|
||||
"HealthResponse",
|
||||
"CacheStats",
|
||||
"Category",
|
||||
]
|
||||
__version__ = "0.1.0"
|
||||
@@ -1,140 +0,0 @@
|
||||
from __future__ import annotations
|
||||
|
||||
from typing import Optional
|
||||
from urllib.parse import quote
|
||||
|
||||
import httpx
|
||||
|
||||
from skillkit.models import (
|
||||
CacheStats,
|
||||
CategoriesResponse,
|
||||
Category,
|
||||
HealthResponse,
|
||||
SearchResponse,
|
||||
Skill,
|
||||
TrendingResponse,
|
||||
)
|
||||
|
||||
|
||||
class SkillKitClient:
|
||||
def __init__(self, base_url: str = "http://localhost:3737", timeout: float = 30.0):
|
||||
self.base_url = base_url.rstrip("/")
|
||||
self.timeout = timeout
|
||||
self._client: Optional[httpx.AsyncClient] = None
|
||||
|
||||
async def __aenter__(self) -> "SkillKitClient":
|
||||
self._client = httpx.AsyncClient(base_url=self.base_url, timeout=self.timeout)
|
||||
return self
|
||||
|
||||
async def __aexit__(self, *args: object) -> None:
|
||||
if self._client:
|
||||
await self._client.aclose()
|
||||
self._client = None
|
||||
|
||||
def _get_client(self) -> httpx.AsyncClient:
|
||||
if self._client is None:
|
||||
self._client = httpx.AsyncClient(base_url=self.base_url, timeout=self.timeout)
|
||||
return self._client
|
||||
|
||||
async def health(self) -> HealthResponse:
|
||||
client = self._get_client()
|
||||
response = await client.get("/health")
|
||||
response.raise_for_status()
|
||||
data = response.json()
|
||||
return HealthResponse(
|
||||
status=data["status"],
|
||||
version=data["version"],
|
||||
skill_count=data.get("skillCount", 0),
|
||||
uptime=data.get("uptime", 0),
|
||||
)
|
||||
|
||||
async def search(
|
||||
self,
|
||||
query: str,
|
||||
limit: int = 20,
|
||||
include_content: bool = False,
|
||||
) -> SearchResponse:
|
||||
client = self._get_client()
|
||||
params = {"q": query, "limit": str(limit)}
|
||||
if include_content:
|
||||
params["include_content"] = "true"
|
||||
response = await client.get("/search", params=params)
|
||||
response.raise_for_status()
|
||||
data = response.json()
|
||||
return SearchResponse(
|
||||
skills=[Skill(**s) for s in data["skills"]],
|
||||
total=data["total"],
|
||||
query=data["query"],
|
||||
limit=data["limit"],
|
||||
)
|
||||
|
||||
async def search_with_filters(
|
||||
self,
|
||||
query: str,
|
||||
limit: int = 20,
|
||||
include_content: bool = False,
|
||||
tags: Optional[list[str]] = None,
|
||||
category: Optional[str] = None,
|
||||
source: Optional[str] = None,
|
||||
) -> SearchResponse:
|
||||
client = self._get_client()
|
||||
body: dict = {"query": query, "limit": limit, "include_content": include_content}
|
||||
filters: dict = {}
|
||||
if tags:
|
||||
filters["tags"] = tags
|
||||
if category:
|
||||
filters["category"] = category
|
||||
if source:
|
||||
filters["source"] = source
|
||||
if filters:
|
||||
body["filters"] = filters
|
||||
response = await client.post("/search", json=body)
|
||||
response.raise_for_status()
|
||||
data = response.json()
|
||||
return SearchResponse(
|
||||
skills=[Skill(**s) for s in data["skills"]],
|
||||
total=data["total"],
|
||||
query=data["query"],
|
||||
limit=data["limit"],
|
||||
)
|
||||
|
||||
async def get_skill(self, source: str, skill_id: str) -> Skill:
|
||||
client = self._get_client()
|
||||
parts = source.split("/", 1)
|
||||
owner = quote(parts[0], safe="")
|
||||
repo = quote(parts[1], safe="") if len(parts) > 1 else owner
|
||||
response = await client.get(f"/skills/{owner}/{repo}/{quote(skill_id, safe='')}")
|
||||
response.raise_for_status()
|
||||
return Skill(**response.json())
|
||||
|
||||
async def trending(self, limit: int = 20) -> list[Skill]:
|
||||
client = self._get_client()
|
||||
response = await client.get("/trending", params={"limit": str(limit)})
|
||||
response.raise_for_status()
|
||||
data = response.json()
|
||||
return [Skill(**s) for s in data["skills"]]
|
||||
|
||||
async def categories(self) -> list[Category]:
|
||||
client = self._get_client()
|
||||
response = await client.get("/categories")
|
||||
response.raise_for_status()
|
||||
data = response.json()
|
||||
return [Category(**c) for c in data["categories"]]
|
||||
|
||||
async def cache_stats(self) -> CacheStats:
|
||||
client = self._get_client()
|
||||
response = await client.get("/cache/stats")
|
||||
response.raise_for_status()
|
||||
data = response.json()
|
||||
return CacheStats(
|
||||
hits=data["hits"],
|
||||
misses=data["misses"],
|
||||
size=data["size"],
|
||||
max_size=data.get("maxSize", 0),
|
||||
hit_rate=data.get("hitRate", 0.0),
|
||||
)
|
||||
|
||||
async def close(self) -> None:
|
||||
if self._client:
|
||||
await self._client.aclose()
|
||||
self._client = None
|
||||
@@ -1,51 +0,0 @@
|
||||
from typing import Optional
|
||||
from pydantic import BaseModel
|
||||
|
||||
|
||||
class Skill(BaseModel):
|
||||
name: str
|
||||
description: Optional[str] = None
|
||||
source: str
|
||||
repo: Optional[str] = None
|
||||
tags: Optional[list[str]] = None
|
||||
category: Optional[str] = None
|
||||
content: Optional[str] = None
|
||||
stars: Optional[int] = None
|
||||
installs: Optional[int] = None
|
||||
|
||||
|
||||
class SearchResponse(BaseModel):
|
||||
skills: list[Skill]
|
||||
total: int
|
||||
query: str
|
||||
limit: int
|
||||
|
||||
|
||||
class HealthResponse(BaseModel):
|
||||
status: str
|
||||
version: str
|
||||
skill_count: int = 0
|
||||
uptime: int = 0
|
||||
|
||||
|
||||
class CacheStats(BaseModel):
|
||||
hits: int
|
||||
misses: int
|
||||
size: int
|
||||
max_size: int = 0
|
||||
hit_rate: float = 0.0
|
||||
|
||||
|
||||
class Category(BaseModel):
|
||||
name: str
|
||||
count: int
|
||||
|
||||
|
||||
class CategoriesResponse(BaseModel):
|
||||
categories: list[Category]
|
||||
total: int
|
||||
|
||||
|
||||
class TrendingResponse(BaseModel):
|
||||
skills: list[Skill]
|
||||
limit: int
|
||||
@@ -1,99 +0,0 @@
|
||||
import pytest
|
||||
import httpx
|
||||
import respx
|
||||
|
||||
from skillkit import SkillKitClient
|
||||
|
||||
|
||||
BASE_URL = "http://localhost:3737"
|
||||
|
||||
|
||||
@pytest.fixture
|
||||
def mock_api():
|
||||
with respx.mock(base_url=BASE_URL) as respx_mock:
|
||||
yield respx_mock
|
||||
|
||||
|
||||
@pytest.mark.asyncio
|
||||
async def test_health(mock_api):
|
||||
mock_api.get("/health").respond(
|
||||
json={"status": "ok", "version": "1.11.0", "skillCount": 100, "uptime": 60}
|
||||
)
|
||||
async with SkillKitClient(BASE_URL) as client:
|
||||
health = await client.health()
|
||||
assert health.status == "ok"
|
||||
assert health.version == "1.11.0"
|
||||
assert health.skill_count == 100
|
||||
|
||||
|
||||
@pytest.mark.asyncio
|
||||
async def test_search(mock_api):
|
||||
mock_api.get("/search").respond(
|
||||
json={
|
||||
"skills": [{"name": "react-perf", "source": "owner/repo"}],
|
||||
"total": 1,
|
||||
"query": "react",
|
||||
"limit": 20,
|
||||
}
|
||||
)
|
||||
async with SkillKitClient(BASE_URL) as client:
|
||||
result = await client.search("react")
|
||||
assert result.total == 1
|
||||
assert result.skills[0].name == "react-perf"
|
||||
|
||||
|
||||
@pytest.mark.asyncio
|
||||
async def test_search_with_filters(mock_api):
|
||||
mock_api.post("/search").respond(
|
||||
json={
|
||||
"skills": [{"name": "nextjs-auth", "source": "other/repo"}],
|
||||
"total": 1,
|
||||
"query": "auth",
|
||||
"limit": 20,
|
||||
}
|
||||
)
|
||||
async with SkillKitClient(BASE_URL) as client:
|
||||
result = await client.search_with_filters("auth", tags=["nextjs"])
|
||||
assert result.total == 1
|
||||
|
||||
|
||||
@pytest.mark.asyncio
|
||||
async def test_get_skill(mock_api):
|
||||
mock_api.get("/skills/owner/repo/react-perf").respond(
|
||||
json={"name": "react-perf", "description": "React performance", "source": "owner/repo"}
|
||||
)
|
||||
async with SkillKitClient(BASE_URL) as client:
|
||||
skill = await client.get_skill("owner/repo", "react-perf")
|
||||
assert skill.name == "react-perf"
|
||||
|
||||
|
||||
@pytest.mark.asyncio
|
||||
async def test_trending(mock_api):
|
||||
mock_api.get("/trending").respond(
|
||||
json={"skills": [{"name": "a", "source": "x/y"}], "limit": 20}
|
||||
)
|
||||
async with SkillKitClient(BASE_URL) as client:
|
||||
trending = await client.trending()
|
||||
assert len(trending) == 1
|
||||
|
||||
|
||||
@pytest.mark.asyncio
|
||||
async def test_categories(mock_api):
|
||||
mock_api.get("/categories").respond(
|
||||
json={"categories": [{"name": "react", "count": 5}], "total": 1}
|
||||
)
|
||||
async with SkillKitClient(BASE_URL) as client:
|
||||
cats = await client.categories()
|
||||
assert len(cats) == 1
|
||||
assert cats[0].name == "react"
|
||||
|
||||
|
||||
@pytest.mark.asyncio
|
||||
async def test_cache_stats(mock_api):
|
||||
mock_api.get("/cache/stats").respond(
|
||||
json={"hits": 10, "misses": 5, "size": 8, "maxSize": 500, "hitRate": 0.667}
|
||||
)
|
||||
async with SkillKitClient(BASE_URL) as client:
|
||||
stats = await client.cache_stats()
|
||||
assert stats.hits == 10
|
||||
assert stats.size == 8
|
||||
@@ -4,4 +4,3 @@ node_modules/
|
||||
out/
|
||||
.turbo/
|
||||
*.tsbuildinfo
|
||||
.vercel
|
||||
|
||||
@@ -87,151 +87,6 @@ import { RecommendationEngine, analyzeProject } from '@skillkit/core/recommend'
|
||||
const engine = new RecommendationEngine()
|
||||
const profile = await analyzeProject('./my-project')
|
||||
const recommendations = engine.recommend(profile)
|
||||
|
||||
// Recommendations with scores and reasons
|
||||
recommendations.forEach(rec => {
|
||||
console.log(`${rec.score}% - ${rec.skill.name}`)
|
||||
console.log(`Reasons: ${rec.reasons.join(', ')}`)
|
||||
})
|
||||
```
|
||||
|
||||
## Primer (Auto-Generate Instructions)
|
||||
|
||||
```typescript
|
||||
import { promises as fs } from 'node:fs'
|
||||
import { analyzeProject, generateInstructions } from '@skillkit/core'
|
||||
|
||||
// Analyze project
|
||||
const analysis = await analyzeProject('./my-project')
|
||||
console.log(analysis.techStack)
|
||||
// { framework: 'Next.js', language: 'TypeScript', styling: 'Tailwind' }
|
||||
|
||||
// Generate instructions for specific agents
|
||||
const instructions = await generateInstructions(analysis, {
|
||||
agents: ['claude', 'cursor', 'windsurf'],
|
||||
includeExamples: true,
|
||||
tone: 'detailed',
|
||||
})
|
||||
|
||||
// Write to files
|
||||
for (const [agent, content] of Object.entries(instructions)) {
|
||||
await fs.writeFile(`.${agent}/instructions.md`, content)
|
||||
}
|
||||
```
|
||||
|
||||
## Mesh Network
|
||||
|
||||
```typescript
|
||||
import { MeshHost, PeerIdentity } from '@skillkit/mesh'
|
||||
|
||||
// Generate identity
|
||||
const identity = await PeerIdentity.generate()
|
||||
|
||||
// Create mesh host
|
||||
const host = new MeshHost({
|
||||
hostId: 'my-workstation',
|
||||
identity,
|
||||
security: { mode: 'secure' },
|
||||
})
|
||||
|
||||
await host.start()
|
||||
|
||||
// Send message to peer
|
||||
await host.send('peer-fingerprint', {
|
||||
type: 'skill-sync',
|
||||
payload: { skills: ['react-patterns'] },
|
||||
})
|
||||
|
||||
// Listen for messages
|
||||
host.on('message', (msg) => {
|
||||
console.log('Received:', msg.type, 'from', msg.from)
|
||||
})
|
||||
```
|
||||
|
||||
## Inter-Agent Messaging
|
||||
|
||||
```typescript
|
||||
import { MessagingClient } from '@skillkit/messaging'
|
||||
|
||||
// Create messaging client (host is a MeshHost instance from the example above)
|
||||
const messaging = new MessagingClient({
|
||||
meshHost: host, // See MeshHost setup in "Mesh Network" section above
|
||||
storagePath: '~/.skillkit/messages',
|
||||
})
|
||||
|
||||
await messaging.init()
|
||||
|
||||
// Send a message
|
||||
await messaging.send({
|
||||
to: 'claude@laptop',
|
||||
subject: 'Code review completed',
|
||||
body: 'I reviewed the auth module...',
|
||||
priority: 'normal',
|
||||
})
|
||||
|
||||
// Listen for new messages
|
||||
messaging.on('message', (msg) => {
|
||||
console.log('New message from:', msg.from)
|
||||
console.log('Subject:', msg.subject)
|
||||
})
|
||||
|
||||
// Get inbox
|
||||
const inbox = await messaging.getInbox({ unread: true })
|
||||
```
|
||||
|
||||
## Workflow Orchestration
|
||||
|
||||
```typescript
|
||||
import { WorkflowEngine, WorkflowStep } from '@skillkit/core'
|
||||
|
||||
// Define workflow
|
||||
const workflow = {
|
||||
name: 'feature-development',
|
||||
steps: [
|
||||
{ skill: 'tdd-workflow', action: 'write-tests' },
|
||||
{ skill: 'code-implementation', action: 'implement' },
|
||||
{ skill: 'code-review', action: 'review' },
|
||||
{ skill: 'documentation', action: 'update-docs' },
|
||||
],
|
||||
}
|
||||
|
||||
// Execute workflow
|
||||
const engine = new WorkflowEngine()
|
||||
const result = await engine.run(workflow)
|
||||
|
||||
console.log('Workflow completed:', result.status)
|
||||
console.log('Steps executed:', result.steps.length)
|
||||
```
|
||||
|
||||
## Skill Testing
|
||||
|
||||
```typescript
|
||||
import { SkillTestRunner, SkillTest } from '@skillkit/core'
|
||||
|
||||
// Define test
|
||||
const test: SkillTest = {
|
||||
name: 'pdf-processing',
|
||||
setup: async () => {
|
||||
// Setup test environment
|
||||
},
|
||||
assertions: [
|
||||
{
|
||||
type: 'file_exists',
|
||||
path: './output.pdf',
|
||||
},
|
||||
{
|
||||
type: 'content_includes',
|
||||
text: 'Expected content',
|
||||
},
|
||||
],
|
||||
}
|
||||
|
||||
// Run test
|
||||
const runner = new SkillTestRunner()
|
||||
const result = await runner.run(test)
|
||||
|
||||
console.log('Test passed:', result.passed)
|
||||
console.log('Assertions:', result.assertions)
|
||||
```
|
||||
|
||||
## Types
|
||||
@@ -244,15 +99,6 @@ interface Skill {
|
||||
content: string
|
||||
metadata: SkillMetadata
|
||||
enabled: boolean
|
||||
agent: string
|
||||
}
|
||||
|
||||
interface SkillMetadata {
|
||||
version?: string
|
||||
author?: string
|
||||
tags?: string[]
|
||||
dependencies?: string[]
|
||||
quality?: QualityScore
|
||||
}
|
||||
|
||||
interface QualityScore {
|
||||
@@ -268,155 +114,4 @@ interface Recommendation {
|
||||
score: number
|
||||
reasons: string[]
|
||||
}
|
||||
|
||||
interface ProjectAnalysis {
|
||||
techStack: {
|
||||
framework?: string
|
||||
language: string
|
||||
styling?: string
|
||||
testing?: string
|
||||
packageManager: string
|
||||
}
|
||||
patterns: {
|
||||
architecture: string
|
||||
codeStyle: Record<string, any>
|
||||
directory: string
|
||||
}
|
||||
dependencies: Record<string, string>
|
||||
}
|
||||
|
||||
interface MeshMessage {
|
||||
from: string
|
||||
to: string
|
||||
type: string
|
||||
payload: any
|
||||
timestamp: number
|
||||
signature?: string
|
||||
}
|
||||
|
||||
interface WorkflowResult {
|
||||
status: 'success' | 'failure'
|
||||
steps: WorkflowStepResult[]
|
||||
duration: number
|
||||
}
|
||||
```
|
||||
|
||||
## Package Exports
|
||||
|
||||
### @skillkit/core
|
||||
|
||||
```typescript
|
||||
export {
|
||||
// Discovery
|
||||
findAllSkills,
|
||||
findSkill,
|
||||
|
||||
// Quality
|
||||
evaluateSkillContent,
|
||||
getQualityGrade,
|
||||
|
||||
// Translation
|
||||
translateSkill,
|
||||
|
||||
// Memory
|
||||
MemoryCompressor,
|
||||
LearningStore,
|
||||
|
||||
// Recommendations
|
||||
RecommendationEngine,
|
||||
analyzeProject,
|
||||
|
||||
// Primer
|
||||
generateInstructions,
|
||||
|
||||
// Workflows
|
||||
WorkflowEngine,
|
||||
|
||||
// Testing
|
||||
SkillTestRunner,
|
||||
}
|
||||
```
|
||||
|
||||
### @skillkit/mesh
|
||||
|
||||
```typescript
|
||||
export {
|
||||
MeshHost,
|
||||
PeerIdentity,
|
||||
PeerRegistry,
|
||||
SecureTransport,
|
||||
}
|
||||
```
|
||||
|
||||
### @skillkit/messaging
|
||||
|
||||
```typescript
|
||||
export {
|
||||
MessagingClient,
|
||||
MessageBuilder,
|
||||
MessageRouter,
|
||||
}
|
||||
```
|
||||
|
||||
### @skillkit/memory
|
||||
|
||||
```typescript
|
||||
export {
|
||||
MemoryStore,
|
||||
TierManager,
|
||||
EmbeddingEncoder,
|
||||
}
|
||||
```
|
||||
|
||||
## Full Example: Custom Build Pipeline
|
||||
|
||||
```typescript
|
||||
import { promises as fs } from 'node:fs'
|
||||
import {
|
||||
analyzeProject,
|
||||
generateInstructions,
|
||||
RecommendationEngine,
|
||||
translateSkill,
|
||||
} from '@skillkit/core'
|
||||
|
||||
async function setupProject() {
|
||||
// 1. Analyze project
|
||||
const analysis = await analyzeProject('./my-project')
|
||||
|
||||
// 2. Generate base instructions
|
||||
const instructions = await generateInstructions(analysis, {
|
||||
agents: ['claude', 'cursor', 'windsurf'],
|
||||
})
|
||||
|
||||
// 3. Get recommendations
|
||||
const engine = new RecommendationEngine()
|
||||
const recommendations = engine.recommend(analysis)
|
||||
|
||||
// 4. Install top recommendations
|
||||
const topSkills = recommendations.slice(0, 5)
|
||||
for (const rec of topSkills) {
|
||||
console.log(`Installing ${rec.skill.name} (${rec.score}% match)`)
|
||||
}
|
||||
|
||||
// 5. Translate skills to all agents
|
||||
for (const agent of ['claude', 'cursor', 'windsurf']) {
|
||||
const translated = await translateSkill(
|
||||
topSkills[0].skill.content,
|
||||
agent
|
||||
)
|
||||
await fs.writeFile(`.${agent}/skills/${translated.filename}`, translated.content)
|
||||
}
|
||||
|
||||
console.log('✅ Project setup complete!')
|
||||
}
|
||||
|
||||
setupProject()
|
||||
```
|
||||
|
||||
## Next Steps
|
||||
|
||||
- [Commands Reference](/docs/commands) - CLI commands
|
||||
- [Memory System](/docs/memory) - Persistent learning
|
||||
- [Mesh Network](/docs/mesh) - Multi-machine setup
|
||||
- [Workflows](/docs/workflows) - Automation
|
||||
- [Testing](/docs/testing) - Skill validation
|
||||
|
||||
@@ -5,7 +5,7 @@ description: Complete reference for all SkillKit CLI commands
|
||||
|
||||
# CLI Commands
|
||||
|
||||
SkillKit provides 50+ commands organized into functional categories. Built on Clipanion v4 with interactive prompts via @clack/prompts.
|
||||
SkillKit provides 40+ commands organized into functional categories. Built on Clipanion v4 with interactive prompts via @clack/prompts.
|
||||
|
||||
## Global Options
|
||||
|
||||
@@ -127,72 +127,6 @@ AI-powered recommendations based on project analysis.
|
||||
| `--category` | Filter by category |
|
||||
| `--min-score` | Quality threshold |
|
||||
|
||||
## Generate Command
|
||||
|
||||
AI-powered skill generation with multi-source context and agent optimization.
|
||||
|
||||
```bash
|
||||
skillkit generate [options]
|
||||
```
|
||||
|
||||
### Generate Options
|
||||
|
||||
| Option | Type | Purpose |
|
||||
|--------|------|---------|
|
||||
| `--provider` | string | LLM provider: anthropic, openai, google, ollama, openrouter |
|
||||
| `--model` | string | Specific model (e.g., gpt-4o, gemini-2.0-flash) |
|
||||
| `--compose` | string | Natural language search to find skills to compose |
|
||||
| `--agents` | array | Target agents for optimization |
|
||||
| `--no-memory` | boolean | Skip memory context |
|
||||
| `--context-sources` | string | Comma-separated: docs,codebase,skills,memory |
|
||||
|
||||
### Context Sources
|
||||
|
||||
The wizard gathers context from 4 sources:
|
||||
|
||||
| Source | Description |
|
||||
|--------|-------------|
|
||||
| **Documentation** | Library docs via Context7 MCP |
|
||||
| **Codebase** | Local project patterns and conventions |
|
||||
| **Skills** | 15,000+ marketplace skills for composition |
|
||||
| **Memory** | Your corrections and learned patterns |
|
||||
|
||||
### Examples
|
||||
|
||||
```bash
|
||||
# Interactive wizard (recommended)
|
||||
skillkit generate
|
||||
|
||||
# Use specific provider
|
||||
skillkit generate --provider openai --model gpt-4o
|
||||
|
||||
# Compose from existing skills
|
||||
skillkit generate --compose "testing patterns for react"
|
||||
|
||||
# Generate for specific agents
|
||||
skillkit generate --agents claude-code,cursor
|
||||
|
||||
# Skip memory personalization
|
||||
skillkit generate --no-memory
|
||||
```
|
||||
|
||||
### Trust Score
|
||||
|
||||
Generated skills receive a trust score (0-10):
|
||||
|
||||
| Grade | Score | Meaning |
|
||||
|-------|-------|---------|
|
||||
| Trusted | 8-10 | High clarity, well-bounded |
|
||||
| Review | 5-7 | May need refinement |
|
||||
| Caution | 0-4 | Requires careful review |
|
||||
|
||||
### Agent Compatibility
|
||||
|
||||
The wizard shows compatibility scores for each target agent based on:
|
||||
- Context length limits
|
||||
- MCP/tool support
|
||||
- Format requirements
|
||||
|
||||
## Marketplace Command
|
||||
|
||||
```bash
|
||||
@@ -236,19 +170,11 @@ owner/repo@v1.2.3
|
||||
```bash
|
||||
skillkit memory status # View memory status
|
||||
skillkit memory search <query> # Search learnings
|
||||
skillkit memory compress # Compress observations to learnings
|
||||
skillkit memory export <name> # Export learnings as skill
|
||||
skillkit memory sync-claude # Update CLAUDE.md with learnings
|
||||
skillkit memory index # View memory index (Layer 1)
|
||||
skillkit memory compress # Compress observations
|
||||
skillkit memory export <name> # Export as skill
|
||||
skillkit memory --global # Use global memory
|
||||
```
|
||||
|
||||
| Option | Purpose |
|
||||
|--------|---------|
|
||||
| `--global` | Use global memory instead of project |
|
||||
| `--limit` | Limit number of results |
|
||||
| `--tags` | Filter by tags |
|
||||
|
||||
## Translation Commands
|
||||
|
||||
```bash
|
||||
@@ -300,49 +226,6 @@ skillkit cicd gitlab-ci # Generate GitLab CI
|
||||
skillkit cicd pre-commit # Generate pre-commit hooks
|
||||
```
|
||||
|
||||
## Serve Command
|
||||
|
||||
Start the SkillKit REST API server for runtime skill discovery.
|
||||
|
||||
```bash
|
||||
skillkit serve [options]
|
||||
```
|
||||
|
||||
| Option | Short | Default | Description |
|
||||
|--------|-------|---------|-------------|
|
||||
| `--port` | `-p` | `3737` | Port to listen on |
|
||||
| `--host` | `-H` | `0.0.0.0` | Host to bind to |
|
||||
| `--cors` | — | `*` | CORS allowed origin |
|
||||
| `--cache-ttl` | — | `86400000` | Cache TTL in milliseconds |
|
||||
|
||||
### Examples
|
||||
|
||||
```bash
|
||||
# Start with defaults
|
||||
skillkit serve
|
||||
|
||||
# Custom port and host
|
||||
skillkit serve --port 8080 --host localhost
|
||||
|
||||
# Restricted CORS
|
||||
skillkit serve --cors "http://localhost:3000"
|
||||
|
||||
# Short cache TTL (1 hour)
|
||||
skillkit serve --cache-ttl 3600000
|
||||
```
|
||||
|
||||
### Endpoints
|
||||
|
||||
| Method | Path | Description |
|
||||
|--------|------|-------------|
|
||||
| GET | `/search?q=...` | Search skills |
|
||||
| POST | `/search` | Search with filters |
|
||||
| GET | `/skills/:owner/:repo/:id` | Get specific skill |
|
||||
| GET | `/trending?limit=20` | Trending skills |
|
||||
| GET | `/categories` | Skill categories |
|
||||
| GET | `/health` | Server health |
|
||||
| GET | `/cache/stats` | Cache statistics |
|
||||
|
||||
## Utility Commands
|
||||
|
||||
```bash
|
||||
@@ -350,52 +233,10 @@ skillkit init # Initialize project
|
||||
skillkit create <name> # Create new skill
|
||||
skillkit validate [path] # Validate skill format
|
||||
skillkit read <skills> # Read skill content
|
||||
skillkit publish # Publish to marketplace
|
||||
skillkit settings --set key=value # Configure settings
|
||||
```
|
||||
|
||||
## Publishing Commands
|
||||
|
||||
```bash
|
||||
skillkit publish [path] # Generate well-known hosting structure
|
||||
skillkit publish --output dir # Output to specific directory
|
||||
skillkit publish --dry-run # Preview without writing
|
||||
skillkit publish submit # Submit to SkillKit marketplace
|
||||
```
|
||||
|
||||
## Security Scanning
|
||||
|
||||
```bash
|
||||
skillkit scan <path> # Scan skill for vulnerabilities
|
||||
skillkit scan <path> --format json # Output as JSON
|
||||
skillkit scan <path> --format table # Tabular output
|
||||
skillkit scan <path> --format sarif # SARIF for GitHub Code Scanning
|
||||
skillkit scan <path> --fail-on high # Exit 1 if HIGH+ findings
|
||||
skillkit scan <path> --skip-rules UC001 # Skip specific rules
|
||||
skillkit scan <path> --quiet # Suppress non-essential output
|
||||
```
|
||||
|
||||
**Threat Categories:**
|
||||
|
||||
| Category | Description |
|
||||
|----------|-------------|
|
||||
| Prompt Injection | Override/bypass agent instructions |
|
||||
| Command Injection | eval(), exec(), shell commands |
|
||||
| Data Exfiltration | Webhook URLs, env var reads, credential access |
|
||||
| Tool Abuse | Tool shadowing, autonomy escalation |
|
||||
| Hardcoded Secrets | API keys, tokens, private keys |
|
||||
| Unicode Steganography | Zero-width chars, bidi overrides |
|
||||
|
||||
**Install Integration:**
|
||||
|
||||
Skills are automatically scanned during `skillkit install`. Use `--no-scan` to skip, or `--force` to install despite findings.
|
||||
|
||||
**Output Formats:**
|
||||
|
||||
- `summary` (default) - colored terminal output
|
||||
- `json` - machine-readable JSON
|
||||
- `table` - tabular format
|
||||
- `sarif` - SARIF v2.1 for GitHub Code Scanning / IDE integration
|
||||
|
||||
## Interactive TUI
|
||||
|
||||
```bash
|
||||
|
||||
@@ -86,132 +86,19 @@ skillkit settings --set autoSync=true
|
||||
skillkit settings --get agent
|
||||
```
|
||||
|
||||
## Advanced Configuration
|
||||
|
||||
### Memory System
|
||||
|
||||
```yaml
|
||||
# skillkit.yaml
|
||||
memory:
|
||||
enabled: true
|
||||
tier: personal # personal, project, global
|
||||
compression:
|
||||
minObservations: 10 # Compress after N observations
|
||||
autoExport: true # Auto-export as skills
|
||||
storage:
|
||||
backend: cozodb # cozodb, sqlite, memory
|
||||
path: ~/.skillkit/memory
|
||||
```
|
||||
|
||||
### Mesh Network
|
||||
|
||||
```yaml
|
||||
# skillkit.yaml
|
||||
mesh:
|
||||
enabled: true
|
||||
hostId: my-workstation
|
||||
discovery:
|
||||
method: local # local, tailscale, manual
|
||||
port: 9876
|
||||
security:
|
||||
mode: secure # development, signed, secure, strict
|
||||
keyPath: ~/.skillkit/mesh/keys
|
||||
peers:
|
||||
- id: laptop-dev
|
||||
address: 192.168.1.100
|
||||
trusted: true
|
||||
```
|
||||
|
||||
### Messaging
|
||||
|
||||
```yaml
|
||||
# skillkit.yaml
|
||||
messaging:
|
||||
enabled: true
|
||||
storagePath: ~/.skillkit/messages
|
||||
notifications: true
|
||||
autoArchive:
|
||||
enabled: true
|
||||
afterDays: 30
|
||||
```
|
||||
|
||||
### Primer
|
||||
|
||||
```yaml
|
||||
# skillkit.yaml
|
||||
primer:
|
||||
autoGenerate: true # Generate on changes
|
||||
agents:
|
||||
priority: [claude, cursor, windsurf]
|
||||
customize:
|
||||
tone: detailed # concise, detailed, technical
|
||||
includeExamples: true
|
||||
exclude:
|
||||
- node_modules
|
||||
- dist
|
||||
- .next
|
||||
```
|
||||
|
||||
## Directory Structure
|
||||
|
||||
```
|
||||
~/.skillkit/
|
||||
├── preferences.json # User preferences
|
||||
├── cache/ # Marketplace cache
|
||||
├── memory/ # Learning storage
|
||||
│ ├── observations/
|
||||
│ ├── learnings/
|
||||
│ └── index.json
|
||||
├── mesh/ # Mesh network
|
||||
│ ├── keys/ # Encryption keys
|
||||
│ ├── peers.json # Known peers
|
||||
│ └── config.json
|
||||
└── messages/ # Inter-agent messages
|
||||
├── inbox/
|
||||
├── sent/
|
||||
└── archived/
|
||||
└── memory/ # Learning storage
|
||||
├── observations/
|
||||
├── learnings/
|
||||
└── index.json
|
||||
|
||||
./project/
|
||||
├── skillkit.yaml # Project config
|
||||
├── .skills # Team manifest
|
||||
├── skills/ # Local skills
|
||||
└── .skillkit/ # Project-specific
|
||||
├── cache/
|
||||
├── primer-config.json
|
||||
└── memory/
|
||||
└── skills/ # Local skills
|
||||
```
|
||||
|
||||
## Configuration Profiles
|
||||
|
||||
Create different profiles for different environments:
|
||||
|
||||
```yaml
|
||||
# skillkit.yaml
|
||||
profiles:
|
||||
development:
|
||||
agent: claude
|
||||
autoSync: true
|
||||
mesh:
|
||||
security:
|
||||
mode: development
|
||||
|
||||
production:
|
||||
agent: universal
|
||||
autoSync: false
|
||||
mesh:
|
||||
security:
|
||||
mode: strict
|
||||
```
|
||||
|
||||
Use profiles:
|
||||
|
||||
```bash
|
||||
skillkit --profile production sync
|
||||
```
|
||||
|
||||
## Next Steps
|
||||
|
||||
- [Primer](/docs/primer) - Auto-generate instructions
|
||||
- [Memory System](/docs/memory) - Persistent learning
|
||||
- [Mesh Network](/docs/mesh) - Multi-machine setup
|
||||
- [Team Collaboration](/docs/teams) - Team configuration
|
||||
|
||||
@@ -1,21 +1,28 @@
|
||||
---
|
||||
title: SkillKit
|
||||
description: Universal skill management for AI coding agents
|
||||
title: SkillKit Documentation
|
||||
description: Universal CLI for managing AI agent skills across 32 coding platforms
|
||||
---
|
||||
|
||||
# SkillKit
|
||||
|
||||
Skills make AI coding agents smarter. But every agent uses a different format — Claude Code wants `.claude/skills/`, Cursor uses `.mdc`, Copilot expects `.github/skills/`. You end up rewriting the same skill three times, or locking into one platform.
|
||||
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across **32 AI coding platforms**.
|
||||
|
||||
SkillKit fixes this. Write a skill once, deploy it to all 32 agents.
|
||||
**Current Version:** v1.7.5
|
||||
|
||||
## Get Started
|
||||
## The Problem
|
||||
|
||||
```bash
|
||||
npx skillkit@latest
|
||||
```
|
||||
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/`
|
||||
|
||||
That's it. No global install needed. Or if you prefer:
|
||||
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
|
||||
@@ -24,130 +31,39 @@ skillkit install anthropics/skills
|
||||
skillkit sync
|
||||
```
|
||||
|
||||
Four commands. Your agents now have skills for PDF processing, code review, and more.
|
||||
## Key Features
|
||||
|
||||
## What Can You Do?
|
||||
| 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 |
|
||||
|
||||
### Install skills from anywhere
|
||||
## Architecture
|
||||
|
||||
```bash
|
||||
skillkit install anthropics/skills # GitHub
|
||||
skillkit install gitlab:team/skills # GitLab
|
||||
skillkit install ./my-local-skills # Local
|
||||
```
|
||||
|
||||
### Translate between agents
|
||||
|
||||
Write for Claude, deploy to Cursor:
|
||||
|
||||
```bash
|
||||
skillkit translate my-skill --to cursor
|
||||
skillkit translate --all --to windsurf # All skills at once
|
||||
```
|
||||
|
||||
### Get smart recommendations
|
||||
|
||||
SkillKit reads your `package.json`, detects your stack, and suggests relevant skills:
|
||||
|
||||
```bash
|
||||
skillkit recommend
|
||||
# 92% vercel-react-best-practices
|
||||
# 87% tailwind-v4-patterns
|
||||
# 85% nextjs-app-router
|
||||
```
|
||||
|
||||
### Discover skills at runtime
|
||||
|
||||
Start an API server and let agents find skills on demand:
|
||||
|
||||
```bash
|
||||
skillkit serve
|
||||
# Server running at http://localhost:3737
|
||||
```
|
||||
|
||||
```bash
|
||||
curl "http://localhost:3737/search?q=react+performance"
|
||||
```
|
||||
|
||||
Or use MCP for native agent integration:
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"skillkit": { "command": "npx", "args": ["@skillkit/mcp"] }
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
[REST API](/docs/rest-api) | [MCP Server](/docs/mcp-server) | [Python Client](/docs/python-client)
|
||||
|
||||
## How It Works
|
||||
|
||||
SkillKit sits between your skills and your agents. It handles format translation, discovery, and synchronization automatically.
|
||||
|
||||
| Layer | What It Does |
|
||||
|-------|-------------|
|
||||
| **CLI + TUI** | Install, translate, recommend, sync |
|
||||
| **APIs** | REST server on :3737, MCP via stdio |
|
||||
| **Core** | Translation engine, relevance ranker, skill parser |
|
||||
| **Data** | 15,000+ skills from 31 curated sources |
|
||||
| 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
|
||||
|
||||
32 agents and counting:
|
||||
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
|
||||
|
||||
**Claude Code** | **Cursor** | **Codex** | **Gemini CLI** | **OpenCode** | **GitHub Copilot** | **Windsurf** | Amp | Antigravity | Clawdbot | Cline | CodeBuddy | CommandCode | Continue | Crush | Droid | Factory | Goose | Kilo Code | Kiro CLI | MCPJam | Mux | Neovate | OpenHands | Pi | Qoder | Qwen | Roo Code | Trae | Vercel | Zencoder | Universal
|
||||
## Popular Sources
|
||||
|
||||
[Full agent details](/docs/agents)
|
||||
| Repository | Skills |
|
||||
|------------|--------|
|
||||
| anthropics/skills | PDF, XLSX, DOCX processing |
|
||||
| vercel-labs/agent-skills | React/Next.js best practices |
|
||||
|
||||
## Beyond Basic Skills
|
||||
## Get Started
|
||||
|
||||
### Session Memory
|
||||
|
||||
Your AI agents learn patterns during sessions, then forget everything. SkillKit captures those learnings and makes them permanent.
|
||||
|
||||
```bash
|
||||
skillkit memory compress
|
||||
skillkit memory search "auth patterns"
|
||||
skillkit memory export auth-patterns
|
||||
```
|
||||
|
||||
### Primer
|
||||
|
||||
Auto-generate CLAUDE.md, .cursorrules, and agent instructions by analyzing your codebase:
|
||||
|
||||
```bash
|
||||
skillkit primer --all-agents
|
||||
```
|
||||
|
||||
### Mesh Network
|
||||
|
||||
Distribute agents across machines with encrypted P2P:
|
||||
|
||||
```bash
|
||||
skillkit mesh init
|
||||
skillkit mesh discover
|
||||
```
|
||||
|
||||
### Team Collaboration
|
||||
|
||||
Share skills via a Git-committable `.skills` manifest:
|
||||
|
||||
```bash
|
||||
skillkit manifest init
|
||||
skillkit manifest add anthropics/skills
|
||||
git commit -m "add team skills"
|
||||
```
|
||||
|
||||
Team members run `skillkit manifest install` and they're in sync.
|
||||
|
||||
## Next Steps
|
||||
|
||||
- [Installation](/docs/installation) — Install and configure
|
||||
- [Quick Start](/docs/quickstart) — First project setup
|
||||
- [Commands](/docs/commands) — Full CLI reference
|
||||
- [REST API](/docs/rest-api) — Runtime discovery server
|
||||
- [MCP Server](/docs/mcp-server) — Agent-native discovery
|
||||
- [Python Client](/docs/python-client) — Python SDK
|
||||
|
||||
**Current version:** v1.12.0 | [npm](https://www.npmjs.com/package/skillkit) | [GitHub](https://github.com/rohitg00/skillkit) | Apache-2.0
|
||||
1. [Installation](/docs/installation) - Install and initialize
|
||||
2. [Quick Start](/docs/quickstart) - 5-minute guide
|
||||
3. [Commands](/docs/commands) - Full CLI reference
|
||||
4. [Skills](/docs/skills) - Skill format and lifecycle
|
||||
|
||||
@@ -5,82 +5,128 @@ description: Install SkillKit and set up your first project
|
||||
|
||||
# Installation
|
||||
|
||||
## No install needed
|
||||
SkillKit is distributed as an npm package. Current version: **v1.7.5**
|
||||
|
||||
The fastest way to start:
|
||||
|
||||
```bash
|
||||
npx skillkit@latest
|
||||
```
|
||||
|
||||
This runs the latest version directly. No global install, no setup.
|
||||
|
||||
## Global install
|
||||
|
||||
For frequent use, install globally:
|
||||
## Install Globally
|
||||
|
||||
```bash
|
||||
npm install -g skillkit
|
||||
```
|
||||
|
||||
Also works with pnpm, yarn, or bun:
|
||||
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>
|
||||
```
|
||||
|
||||
Both `skillkit` and `sk` work as command aliases.
|
||||
## GitHub Packages
|
||||
|
||||
## Verify
|
||||
```bash
|
||||
npm install -g @rohitg00/skillkit --registry=https://npm.pkg.github.com
|
||||
```
|
||||
|
||||
## Verify Installation
|
||||
|
||||
```bash
|
||||
skillkit --version
|
||||
# or
|
||||
sk --version
|
||||
```
|
||||
|
||||
**Requirements:** Node.js 18+ (Bun 1.2+ for the TUI).
|
||||
## Requirements
|
||||
|
||||
## Initialize a project
|
||||
- **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
|
||||
cd my-project
|
||||
skillkit init
|
||||
```
|
||||
|
||||
The init command:
|
||||
### Init Command Options
|
||||
|
||||
1. **Detects your AI agent** — scans for `.claude/`, `.cursor/`, `.github/` directories
|
||||
2. **Creates the skills folder** — sets up the right directory for your agent
|
||||
3. **Saves preferences** — remembers your choices for next time
|
||||
| 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 |
|
||||
|
||||
### Specify an agent directly
|
||||
### What Init Creates
|
||||
|
||||
```bash
|
||||
skillkit init --agent cursor
|
||||
skillkit init --list # Show all 32 supported agents
|
||||
skillkit init --quiet # Skip logo and prompts (for CI)
|
||||
```
|
||||
|
||||
### What gets created
|
||||
|
||||
| Agent | Skills Directory | Config |
|
||||
|-------|-----------------|--------|
|
||||
| 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` |
|
||||
|
||||
Preferences are stored in `~/.skillkit/preferences.json`.
|
||||
## Visual Theme
|
||||
|
||||
## Next steps
|
||||
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 recommend # Get skill suggestions for your project
|
||||
skillkit install anthropics/skills # Install skills from GitHub
|
||||
skillkit sync # Deploy to your agent
|
||||
skillkit ui # Launch the terminal UI
|
||||
skillkit init --quiet
|
||||
```
|
||||
|
||||
[Quick Start guide](/docs/quickstart) | [Full command reference](/docs/commands)
|
||||
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
|
||||
```
|
||||
|
||||
@@ -48,39 +48,8 @@ skillkit install anthropics/skills --agent claude-code,cursor
|
||||
|
||||
## Publish Skills
|
||||
|
||||
### Self-Host on Your Domain (Recommended)
|
||||
|
||||
Generate a well-known URI structure (RFC 8615) to host skills on your own domain:
|
||||
|
||||
```bash
|
||||
# Create and validate your skill
|
||||
skillkit create my-skill
|
||||
skillkit validate my-skill
|
||||
|
||||
# Generate hosting structure
|
||||
skillkit publish ./my-skill --output ./public
|
||||
skillkit publish
|
||||
```
|
||||
|
||||
This creates:
|
||||
```
|
||||
.well-known/skills/
|
||||
index.json # Skill manifest for auto-discovery
|
||||
my-skill/
|
||||
SKILL.md # Your skill content
|
||||
```
|
||||
|
||||
Deploy the `.well-known` folder to your web server. Users can then install via:
|
||||
|
||||
```bash
|
||||
skillkit add https://your-domain.com
|
||||
```
|
||||
|
||||
### Submit to SkillKit Marketplace
|
||||
|
||||
To submit your skill for inclusion in the central marketplace:
|
||||
|
||||
```bash
|
||||
skillkit publish submit
|
||||
```
|
||||
|
||||
This opens a GitHub issue for review by maintainers.
|
||||
|
||||
@@ -1,105 +0,0 @@
|
||||
---
|
||||
title: MCP Server
|
||||
description: Agent-native skill discovery via Model Context Protocol
|
||||
---
|
||||
|
||||
# MCP Server
|
||||
|
||||
The REST API works great for HTTP clients. But AI agents speak MCP — the Model Context Protocol. The `@skillkit/mcp` package lets agents discover skills natively, without HTTP calls or curl commands.
|
||||
|
||||
Think of it as giving your agent a direct line to the entire skill catalog.
|
||||
|
||||
## Setup
|
||||
|
||||
### Claude Desktop
|
||||
|
||||
Add this to `~/Library/Application Support/Claude/claude_desktop_config.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"skillkit": {
|
||||
"command": "npx",
|
||||
"args": ["@skillkit/mcp"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Restart Claude Desktop. Done.
|
||||
|
||||
### Cursor
|
||||
|
||||
Add to `.cursor/mcp.json` in your project:
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"skillkit": {
|
||||
"command": "npx",
|
||||
"args": ["@skillkit/mcp"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Any MCP client
|
||||
|
||||
The server uses stdio transport. Works with any MCP-compatible client:
|
||||
|
||||
```bash
|
||||
npx @skillkit/mcp
|
||||
```
|
||||
|
||||
## What your agent can do
|
||||
|
||||
Once connected, your agent gets four tools:
|
||||
|
||||
### Search skills
|
||||
|
||||
Ask your agent: *"Find skills for React performance optimization"*
|
||||
|
||||
Behind the scenes, it calls `search_skills` with your query and returns ranked results. You can filter by tags, category, or source repository.
|
||||
|
||||
```
|
||||
> Search for authentication skills tagged with "security"
|
||||
```
|
||||
|
||||
The agent searches across the full catalog, ranks results by relevance, and shows you the best matches.
|
||||
|
||||
### Get a specific skill
|
||||
|
||||
Ask: *"Get the pdf-processing skill from anthropics/skills"*
|
||||
|
||||
The agent calls `get_skill` and returns the full skill details — description, tags, content, and references.
|
||||
|
||||
### Get recommendations
|
||||
|
||||
Ask: *"What skills would you recommend for my TypeScript React project?"*
|
||||
|
||||
The agent calls `recommend_skills` with your stack context (languages, frameworks, libraries) and returns personalized suggestions ranked by relevance.
|
||||
|
||||
### Browse categories
|
||||
|
||||
Ask: *"What skill categories are available?"*
|
||||
|
||||
The agent calls `list_categories` and returns all categories with counts, so you know what's out there.
|
||||
|
||||
## Resources
|
||||
|
||||
The server also exposes two read-only resources:
|
||||
|
||||
- **`skills://trending`** — Top 20 skills by relevance score
|
||||
- **`skills://categories`** — All categories with counts
|
||||
|
||||
Agents can read these without making a tool call.
|
||||
|
||||
## How it works
|
||||
|
||||
1. On startup, the server loads all skills from the marketplace catalog
|
||||
2. Your agent sends a natural language request
|
||||
3. The MCP client translates it into a tool call
|
||||
4. The `RelevanceRanker` scores and ranks results (same algorithm as the REST API)
|
||||
5. Results come back as structured JSON through the MCP protocol
|
||||
|
||||
Same ranking, same data, same quality — just native to your agent instead of going through HTTP.
|
||||
@@ -5,51 +5,25 @@ description: Persistent learning across AI agent sessions
|
||||
|
||||
# Memory System
|
||||
|
||||
Capture learnings from AI sessions and convert them into reusable skills. SkillKit's memory system provides automatic observation capture, intelligent compression, and token-optimized retrieval.
|
||||
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 to learnings
|
||||
skillkit memory compress # Compress observations
|
||||
skillkit memory export <name> # Export as skill
|
||||
skillkit memory sync-claude # Update CLAUDE.md with learnings
|
||||
skillkit memory index # View memory index (Layer 1)
|
||||
skillkit memory --global # Global memory operations
|
||||
skillkit memory --global # Global memory
|
||||
```
|
||||
|
||||
## How It Works
|
||||
|
||||
### Observation → Learning Pipeline
|
||||
|
||||
1. **Observations** - Track patterns during sessions (tool use, errors, solutions)
|
||||
2. **Compression** - Distill observations into reusable learnings
|
||||
3. **Injection** - Load relevant learnings into new sessions
|
||||
1. **Observations** - Track patterns during sessions
|
||||
2. **Compression** - Distill into reusable knowledge
|
||||
3. **Injection** - Load into new sessions
|
||||
4. **Export** - Convert to shareable skills
|
||||
|
||||
### Lifecycle Hooks
|
||||
|
||||
SkillKit integrates with Claude Code's lifecycle hooks for automatic memory capture:
|
||||
|
||||
| Hook | Trigger | Action |
|
||||
|------|---------|--------|
|
||||
| **SessionStart** | Session begins | Inject relevant learnings |
|
||||
| **PostToolUse** | Tool completes | Capture outcomes as observations |
|
||||
| **SessionEnd** | Session closes | Compress observations to learnings |
|
||||
|
||||
### Progressive Disclosure (Token Optimization)
|
||||
|
||||
Memory retrieval uses a 3-layer system to minimize token usage:
|
||||
|
||||
| Layer | Content | ~Tokens |
|
||||
|-------|---------|---------|
|
||||
| **Index** | Titles, tags, timestamps | 50-100 |
|
||||
| **Timeline** | Context, excerpts, activity | ~200 |
|
||||
| **Details** | Full content, metadata | 500-1000 |
|
||||
|
||||
The system starts with Layer 1 and progressively fetches deeper layers based on relevance and token budget.
|
||||
|
||||
## Storage
|
||||
|
||||
```
|
||||
@@ -57,123 +31,17 @@ The system starts with Layer 1 and progressively fetches deeper layers based on
|
||||
├── observations/ # Raw session data
|
||||
├── learnings/ # Compressed knowledge
|
||||
└── index.json # Memory index
|
||||
|
||||
<project>/.skillkit/memory/
|
||||
├── observations/ # Project-specific observations
|
||||
├── learnings/ # Project learnings
|
||||
└── index.json # Project memory index
|
||||
```
|
||||
|
||||
## Auto-CLAUDE.md Updates
|
||||
|
||||
Sync your most effective learnings to CLAUDE.md:
|
||||
|
||||
```bash
|
||||
skillkit memory sync-claude
|
||||
```
|
||||
|
||||
This populates the `## LEARNED` section with high-effectiveness insights, giving your agent persistent context across sessions.
|
||||
|
||||
## Programmatic API
|
||||
|
||||
### Memory Compression
|
||||
|
||||
```typescript
|
||||
import { MemoryCompressor, LearningStore } from '@skillkit/core'
|
||||
|
||||
const compressor = new MemoryCompressor(projectPath)
|
||||
const { learnings } = await compressor.compress(observations)
|
||||
const compressor = new MemoryCompressor()
|
||||
const learning = await compressor.compress(observations)
|
||||
|
||||
const store = new LearningStore('project', projectPath)
|
||||
const store = new LearningStore()
|
||||
await store.add(learning)
|
||||
const results = await store.search('authentication')
|
||||
```
|
||||
|
||||
### Lifecycle Hooks
|
||||
|
||||
```typescript
|
||||
import { MemoryHookManager } from '@skillkit/core'
|
||||
|
||||
const manager = new MemoryHookManager(projectPath)
|
||||
|
||||
// Session start - inject relevant learnings
|
||||
const startResult = await manager.onSessionStart()
|
||||
|
||||
// After tool use - capture outcomes
|
||||
await manager.onToolUse({
|
||||
tool_name: 'Write',
|
||||
tool_input: { file_path: '/src/auth.ts' },
|
||||
tool_result: 'File written successfully',
|
||||
duration_ms: 150
|
||||
})
|
||||
|
||||
// Session end - compress to learnings
|
||||
const endResult = await manager.onSessionEnd()
|
||||
```
|
||||
|
||||
### Progressive Disclosure
|
||||
|
||||
```typescript
|
||||
import { ProgressiveDisclosureManager } from '@skillkit/core'
|
||||
|
||||
const pdm = new ProgressiveDisclosureManager(projectPath)
|
||||
|
||||
// Layer 1: Index (~50 tokens each)
|
||||
const index = pdm.getIndex({ includeGlobal: true })
|
||||
|
||||
// Layer 2: Timeline (~200 tokens each)
|
||||
const timeline = pdm.getTimeline(['id1', 'id2'])
|
||||
|
||||
// Layer 3: Full details (~600 tokens each)
|
||||
const details = pdm.getDetails(['id1'])
|
||||
|
||||
// Smart retrieval with token budget
|
||||
const result = pdm.smartRetrieve('authentication patterns', 2000)
|
||||
// Returns optimal layer based on budget
|
||||
```
|
||||
|
||||
### CLAUDE.md Updater
|
||||
|
||||
```typescript
|
||||
import { ClaudeMdUpdater } from '@skillkit/core'
|
||||
|
||||
const updater = new ClaudeMdUpdater(projectPath)
|
||||
|
||||
// Preview what would be updated
|
||||
const preview = updater.preview({ minEffectiveness: 70 })
|
||||
|
||||
// Update CLAUDE.md
|
||||
const result = updater.update({
|
||||
minEffectiveness: 60,
|
||||
maxLearnings: 20,
|
||||
preserveManualEntries: true
|
||||
})
|
||||
```
|
||||
|
||||
## Configuration
|
||||
|
||||
Configure memory behavior in `.skillkit/config.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"memory": {
|
||||
"enabled": true,
|
||||
"autoInjectOnSessionStart": true,
|
||||
"autoCaptureToolUse": true,
|
||||
"autoCompressOnSessionEnd": true,
|
||||
"minRelevanceForCapture": 30,
|
||||
"maxTokensForInjection": 2000,
|
||||
"compressionThreshold": 50
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Claude Code Integration
|
||||
|
||||
Generate hooks configuration for Claude Code:
|
||||
|
||||
```typescript
|
||||
const manager = new MemoryHookManager(projectPath)
|
||||
const config = manager.generateClaudeCodeHooksConfig()
|
||||
// Outputs hooks.json format for Claude Code integration
|
||||
```
|
||||
|
||||
@@ -1,118 +0,0 @@
|
||||
---
|
||||
title: Mesh Network
|
||||
description: Multi-machine agent distribution with secure peer-to-peer communication
|
||||
---
|
||||
|
||||
# Mesh Network
|
||||
|
||||
SkillKit's mesh network enables secure communication between AI agents across multiple machines. Share skills, synchronize memory, and collaborate across your development environment.
|
||||
|
||||
## Quick Start
|
||||
|
||||
```bash
|
||||
# Initialize mesh on your machine
|
||||
npx skillkit mesh init
|
||||
|
||||
# Discover other hosts on your LAN
|
||||
npx skillkit mesh discover
|
||||
|
||||
# Add a specific host
|
||||
npx skillkit mesh add 192.168.1.100
|
||||
```
|
||||
|
||||
## Security
|
||||
|
||||
The mesh network uses enterprise-grade security:
|
||||
|
||||
- **Ed25519** - Peer identity and message signing
|
||||
- **XChaCha20-Poly1305** - End-to-end message encryption
|
||||
- **TLS 1.3** - Transport layer security
|
||||
- **JWT with EdDSA** - Authentication tokens
|
||||
|
||||
### Initialize Security
|
||||
|
||||
```bash
|
||||
# Generate encryption keys
|
||||
npx skillkit mesh security init
|
||||
|
||||
# Check security status
|
||||
npx skillkit mesh security status
|
||||
```
|
||||
|
||||
### Peer Trust Management
|
||||
|
||||
```bash
|
||||
# Trust a peer by fingerprint
|
||||
npx skillkit mesh peer trust abc123def456
|
||||
|
||||
# Revoke a peer's trust
|
||||
npx skillkit mesh peer revoke abc123def456
|
||||
|
||||
# List trusted peers
|
||||
npx skillkit mesh peer list
|
||||
```
|
||||
|
||||
## Commands Reference
|
||||
|
||||
| Command | Description |
|
||||
|---------|-------------|
|
||||
| `mesh init` | Initialize mesh network |
|
||||
| `mesh add <address>` | Add a host to mesh |
|
||||
| `mesh remove <id>` | Remove a host |
|
||||
| `mesh list` | List known hosts |
|
||||
| `mesh discover` | Discover hosts on LAN |
|
||||
| `mesh health` | Check host health |
|
||||
| `mesh status` | Show mesh status |
|
||||
| `mesh security init` | Setup encryption keys |
|
||||
| `mesh security status` | Show security status |
|
||||
| `mesh peer trust <id>` | Trust a peer |
|
||||
| `mesh peer revoke <id>` | Revoke peer trust |
|
||||
| `mesh peer list` | List trusted peers |
|
||||
|
||||
## Security Levels
|
||||
|
||||
| Level | Discovery | Transport | Auth | Use Case |
|
||||
|-------|-----------|-----------|------|----------|
|
||||
| `development` | open | none | none | Local dev |
|
||||
| `signed` | signed | optional | optional | Trusted LAN |
|
||||
| `secure` (default) | signed | required | required | Production |
|
||||
| `strict` | trusted-only | required | mTLS | High security |
|
||||
|
||||
## Architecture
|
||||
|
||||
The mesh network uses:
|
||||
|
||||
1. **UDP Multicast** - LAN discovery with signed announcements
|
||||
2. **WebSocket (WSS)** - Real-time bidirectional communication
|
||||
3. **HTTPS** - RESTful API for management
|
||||
|
||||
All messages are signed and optionally encrypted based on your security level.
|
||||
|
||||
## Programmatic API
|
||||
|
||||
```typescript
|
||||
import { MeshHost, PeerIdentity } from '@skillkit/mesh';
|
||||
|
||||
// Generate identity
|
||||
const identity = await PeerIdentity.generate();
|
||||
|
||||
// Create mesh host
|
||||
const host = new MeshHost({
|
||||
hostId: 'my-workstation',
|
||||
identity,
|
||||
security: { mode: 'secure' },
|
||||
});
|
||||
|
||||
await host.start();
|
||||
|
||||
// Send message to peer
|
||||
await host.send('peer-fingerprint', {
|
||||
type: 'skill-sync',
|
||||
payload: { skills: ['react-patterns'] },
|
||||
});
|
||||
```
|
||||
|
||||
## Next Steps
|
||||
|
||||
- [Inter-Agent Messaging](/docs/messaging) - Send messages between agents
|
||||
- [Memory System](/docs/memory) - Share learnings across the mesh
|
||||
@@ -1,98 +0,0 @@
|
||||
---
|
||||
title: Inter-Agent Messaging
|
||||
description: Send messages between AI agents across the mesh network
|
||||
---
|
||||
|
||||
# Inter-Agent Messaging
|
||||
|
||||
SkillKit's messaging system enables asynchronous communication between AI agents. Send code reviews, share insights, and coordinate work across your team.
|
||||
|
||||
## Quick Start
|
||||
|
||||
```bash
|
||||
# Send a message
|
||||
npx skillkit message send
|
||||
|
||||
# View inbox
|
||||
npx skillkit message inbox
|
||||
|
||||
# Read a message
|
||||
npx skillkit message read <message-id>
|
||||
```
|
||||
|
||||
## Commands Reference
|
||||
|
||||
| Command | Description |
|
||||
|---------|-------------|
|
||||
| `message send` | Send message to agent |
|
||||
| `message inbox` | View inbox |
|
||||
| `message read <id>` | Read a message |
|
||||
| `message reply <id>` | Reply to message |
|
||||
| `message archive <id>` | Archive message |
|
||||
| `message sent` | View sent messages |
|
||||
| `message status` | Messaging status |
|
||||
|
||||
## Message Types
|
||||
|
||||
Messages can include:
|
||||
|
||||
- **Text** - Plain text messages
|
||||
- **Code** - Code snippets with syntax highlighting
|
||||
- **Diffs** - Code changes and patches
|
||||
- **Skills** - Skill file attachments
|
||||
|
||||
## Priority Levels
|
||||
|
||||
- **urgent** - Immediate attention required
|
||||
- **normal** - Standard priority (default)
|
||||
- **low** - Can be addressed when convenient
|
||||
|
||||
## Inbox Management
|
||||
|
||||
```bash
|
||||
# View unread messages
|
||||
npx skillkit message inbox --unread
|
||||
|
||||
# Archive old messages
|
||||
npx skillkit message archive <id>
|
||||
|
||||
# View sent messages
|
||||
npx skillkit message sent
|
||||
```
|
||||
|
||||
## Programmatic API
|
||||
|
||||
```typescript
|
||||
import { MessagingClient } from '@skillkit/messaging';
|
||||
import { MeshHost } from '@skillkit/mesh';
|
||||
|
||||
// Create messaging client
|
||||
const messaging = new MessagingClient({
|
||||
meshHost: host,
|
||||
storagePath: '~/.skillkit/messages',
|
||||
});
|
||||
|
||||
await messaging.init();
|
||||
|
||||
// Send a message
|
||||
await messaging.send({
|
||||
to: 'claude@laptop',
|
||||
subject: 'Code review completed',
|
||||
body: 'I reviewed the auth module...',
|
||||
priority: 'normal',
|
||||
});
|
||||
|
||||
// Listen for new messages
|
||||
messaging.on('message', (msg) => {
|
||||
console.log('New message from:', msg.from);
|
||||
});
|
||||
```
|
||||
|
||||
## TUI Navigation
|
||||
|
||||
In the Terminal UI, press `j` to access the Messages screen.
|
||||
|
||||
## Next Steps
|
||||
|
||||
- [Mesh Network](/docs/mesh) - Configure the underlying network
|
||||
- [Team Collaboration](/docs/teams) - Share skills with your team
|
||||
@@ -9,22 +9,14 @@
|
||||
"agents",
|
||||
"translation",
|
||||
"marketplace",
|
||||
"tree",
|
||||
"recommendations",
|
||||
"primer",
|
||||
"memory",
|
||||
"mesh",
|
||||
"messaging",
|
||||
"workflows",
|
||||
"testing",
|
||||
"commands",
|
||||
"configuration",
|
||||
"api-reference",
|
||||
"rest-api",
|
||||
"mcp-server",
|
||||
"python-client",
|
||||
"cicd",
|
||||
"teams",
|
||||
"custom-agents",
|
||||
"contributing"
|
||||
]
|
||||
|
||||
@@ -1,303 +0,0 @@
|
||||
---
|
||||
title: Primer
|
||||
description: Auto-generate AI agent instructions from your codebase
|
||||
---
|
||||
|
||||
# Primer
|
||||
|
||||
Primer analyzes your codebase and automatically generates optimized instructions for all 32 AI agents. No more manual configuration—let SkillKit detect your tech stack, coding patterns, and project structure.
|
||||
|
||||
## Quick Start
|
||||
|
||||
```bash
|
||||
# Analyze current project
|
||||
skillkit primer
|
||||
|
||||
# Generate for specific agents
|
||||
skillkit primer --agent claude,cursor,windsurf
|
||||
|
||||
# Generate for all 32 agents
|
||||
skillkit primer --all-agents
|
||||
|
||||
# Preview without writing files
|
||||
skillkit primer --dry-run
|
||||
```
|
||||
|
||||
## What Primer Detects
|
||||
|
||||
### Tech Stack
|
||||
- **Frameworks**: React, Next.js, Vue, Angular, Svelte, etc.
|
||||
- **Languages**: TypeScript, JavaScript, Python, Go, Rust, etc.
|
||||
- **Build Tools**: Vite, Webpack, Turbopack, esbuild
|
||||
- **Package Managers**: npm, pnpm, yarn, bun
|
||||
|
||||
### Project Patterns
|
||||
- **Architecture**: Monorepo, microservices, serverless
|
||||
- **Code Style**: Formatting rules, naming conventions
|
||||
- **Directory Structure**: Feature-based, layer-based, domain-driven
|
||||
- **Dependencies**: Key libraries and their versions
|
||||
|
||||
### Best Practices
|
||||
- **Testing Setup**: Jest, Vitest, Playwright, Cypress
|
||||
- **Linting**: ESLint, Prettier, TypeScript strict mode
|
||||
- **Documentation**: JSDoc, TSDoc, README patterns
|
||||
- **Git Workflow**: Branch strategy, commit conventions
|
||||
|
||||
## Generated Instructions
|
||||
|
||||
Primer creates agent-specific instructions for:
|
||||
|
||||
### Claude Code
|
||||
```
|
||||
.claude/
|
||||
└── CLAUDE.md # Full project context
|
||||
```
|
||||
|
||||
### Cursor
|
||||
```
|
||||
.cursor/
|
||||
└── .cursorrules # IDE-specific rules
|
||||
```
|
||||
|
||||
### GitHub Copilot
|
||||
```
|
||||
.github/
|
||||
└── copilot-instructions.md
|
||||
```
|
||||
|
||||
### All 32 Agents
|
||||
Each agent gets optimized instructions in their native format.
|
||||
|
||||
## Example Output
|
||||
|
||||
```bash
|
||||
$ skillkit primer
|
||||
|
||||
🔍 Analyzing project...
|
||||
|
||||
Detected:
|
||||
Framework: Next.js 14 (App Router)
|
||||
Language: TypeScript (strict mode)
|
||||
Styling: Tailwind CSS v3
|
||||
Testing: Vitest + Playwright
|
||||
Package Manager: pnpm
|
||||
|
||||
✅ Generated instructions for:
|
||||
- Claude Code (.claude/CLAUDE.md)
|
||||
- Cursor (.cursor/.cursorrules)
|
||||
- Codex (.codex/instructions.md)
|
||||
+ 29 more agents
|
||||
|
||||
💡 Tip: Run `skillkit sync` to apply changes
|
||||
```
|
||||
|
||||
## Customization
|
||||
|
||||
### Configuration File
|
||||
|
||||
Create `.skillkit/primer-config.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"include": {
|
||||
"techStack": true,
|
||||
"codeStyle": true,
|
||||
"testingPatterns": true,
|
||||
"customRules": [
|
||||
"Always use async/await over promises",
|
||||
"Prefer functional components in React",
|
||||
"Use Zod for runtime validation"
|
||||
]
|
||||
},
|
||||
"exclude": {
|
||||
"directories": ["node_modules", "dist", ".next"],
|
||||
"patterns": ["*.test.ts", "*.spec.ts"]
|
||||
},
|
||||
"agents": {
|
||||
"priority": ["claude", "cursor", "windsurf"],
|
||||
"customize": {
|
||||
"claude": {
|
||||
"tone": "detailed",
|
||||
"examples": true
|
||||
},
|
||||
"cursor": {
|
||||
"tone": "concise",
|
||||
"shortcuts": true
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Template Overrides
|
||||
|
||||
Override default templates in `.skillkit/primer-templates/`:
|
||||
|
||||
```
|
||||
.skillkit/primer-templates/
|
||||
├── claude.template.md
|
||||
├── cursor.template.md
|
||||
└── shared/
|
||||
├── header.md
|
||||
└── footer.md
|
||||
```
|
||||
|
||||
## Update Strategies
|
||||
|
||||
### Incremental Updates
|
||||
|
||||
```bash
|
||||
# Update only when changes detected
|
||||
skillkit primer --incremental
|
||||
|
||||
# Force regeneration
|
||||
skillkit primer --force
|
||||
```
|
||||
|
||||
### Git Integration
|
||||
|
||||
```bash
|
||||
# Auto-generate on git hooks
|
||||
cat > .git/hooks/post-checkout << 'EOF'
|
||||
#!/usr/bin/env bash
|
||||
skillkit primer --incremental
|
||||
EOF
|
||||
chmod +x .git/hooks/post-checkout
|
||||
```
|
||||
|
||||
### CI/CD Pipeline
|
||||
|
||||
```yaml
|
||||
# .github/workflows/primer.yml
|
||||
name: Update Agent Instructions
|
||||
|
||||
on:
|
||||
push:
|
||||
branches: [main]
|
||||
paths:
|
||||
- 'package.json'
|
||||
- 'tsconfig.json'
|
||||
- 'src/**'
|
||||
|
||||
jobs:
|
||||
primer:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v3
|
||||
- run: npx skillkit primer --all-agents
|
||||
- uses: stefanzweifel/git-auto-commit-action@v4
|
||||
with:
|
||||
commit_message: "chore: update agent instructions"
|
||||
```
|
||||
|
||||
## Programmatic API
|
||||
|
||||
```typescript
|
||||
import { analyzeProject, generateInstructions } from '@skillkit/core';
|
||||
|
||||
// Analyze project
|
||||
const analysis = await analyzeProject('./my-project');
|
||||
console.log(analysis.techStack);
|
||||
// { framework: 'Next.js', language: 'TypeScript', ... }
|
||||
|
||||
// Generate instructions
|
||||
const instructions = await generateInstructions(analysis, {
|
||||
agents: ['claude', 'cursor'],
|
||||
includeExamples: true,
|
||||
tone: 'detailed',
|
||||
});
|
||||
|
||||
// Write to files
|
||||
for (const [agent, content] of Object.entries(instructions)) {
|
||||
await writeAgentFile(agent, content);
|
||||
}
|
||||
```
|
||||
|
||||
## Best Practices
|
||||
|
||||
### When to Run Primer
|
||||
|
||||
- **Initial Setup** - First time configuring agents
|
||||
- **Major Changes** - New frameworks or architecture changes
|
||||
- **Team Onboarding** - New developers joining the project
|
||||
- **Agent Migration** - Switching to new AI coding tools
|
||||
|
||||
### What to Commit
|
||||
|
||||
```text
|
||||
# Commit generated instructions
|
||||
.claude/
|
||||
.cursor/
|
||||
.github/copilot-instructions.md
|
||||
|
||||
# Don't commit
|
||||
.skillkit/cache/
|
||||
.skillkit/primer-temp/
|
||||
```
|
||||
|
||||
### Combining with Skills
|
||||
|
||||
Primer generates base instructions. Layer on specific skills:
|
||||
|
||||
```bash
|
||||
# 1. Generate base instructions
|
||||
skillkit primer --all-agents
|
||||
|
||||
# 2. Install domain-specific skills
|
||||
skillkit install anthropics/skills --skill pdf,xlsx
|
||||
|
||||
# 3. Sync everything
|
||||
skillkit sync
|
||||
```
|
||||
|
||||
## Comparison
|
||||
|
||||
| Method | Setup Time | Accuracy | Maintenance |
|
||||
|--------|-----------|----------|-------------|
|
||||
| **Manual Writing** | Hours | Variable | Manual updates |
|
||||
| **AI Generation** | Minutes | High | Auto-detect changes |
|
||||
| **Copy/Paste** | Minutes | Low | Stale quickly |
|
||||
| **Primer** | Seconds | Very High | Auto-incremental |
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Primer Not Detecting Framework
|
||||
|
||||
```bash
|
||||
# Specify manually
|
||||
skillkit primer --framework nextjs --language typescript
|
||||
|
||||
# Check detection logs
|
||||
skillkit primer --verbose
|
||||
```
|
||||
|
||||
### Generated Instructions Too Generic
|
||||
|
||||
Customize with `primer-config.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"tone": "detailed",
|
||||
"includeExamples": true,
|
||||
"customRules": [
|
||||
"Your specific coding guidelines..."
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
### Instructions Out of Sync
|
||||
|
||||
```bash
|
||||
# Force regeneration
|
||||
skillkit primer --force
|
||||
|
||||
# Clean cache
|
||||
rm -rf .skillkit/cache/primer
|
||||
```
|
||||
|
||||
## Next Steps
|
||||
|
||||
- [Memory System](/docs/memory) - Capture learnings from sessions
|
||||
- [Skills](/docs/skills) - Install domain-specific skills
|
||||
- [Translation](/docs/translation) - Convert between agent formats
|
||||
- [Team Collaboration](/docs/teams) - Share instructions with your team
|
||||
@@ -1,105 +0,0 @@
|
||||
---
|
||||
title: Python Client
|
||||
description: Async Python SDK for skill discovery
|
||||
---
|
||||
|
||||
# Python Client
|
||||
|
||||
Not everything runs on Node. The `skillkit-client` package gives Python apps the same skill discovery capabilities as the REST API — async, typed, and ready to go.
|
||||
|
||||
## Install
|
||||
|
||||
```bash
|
||||
pip install skillkit-client
|
||||
```
|
||||
|
||||
Requires Python 3.10+.
|
||||
|
||||
## Quick start
|
||||
|
||||
```python
|
||||
from skillkit import SkillKitClient
|
||||
|
||||
async with SkillKitClient() as client:
|
||||
results = await client.search("react performance", limit=5)
|
||||
for skill in results.skills:
|
||||
print(f"{skill.name}: {skill.description}")
|
||||
```
|
||||
|
||||
The client connects to `http://localhost:3737` by default. Make sure the API server is running:
|
||||
|
||||
```bash
|
||||
skillkit serve
|
||||
```
|
||||
|
||||
## Search with filters
|
||||
|
||||
```python
|
||||
results = await client.search_with_filters(
|
||||
"authentication",
|
||||
tags=["security"],
|
||||
category="backend",
|
||||
limit=10,
|
||||
)
|
||||
```
|
||||
|
||||
## Get a specific skill
|
||||
|
||||
```python
|
||||
skill = await client.get_skill("anthropics/skills", "pdf-processing")
|
||||
print(skill.name, skill.description, skill.tags)
|
||||
```
|
||||
|
||||
## Trending and categories
|
||||
|
||||
```python
|
||||
trending = await client.trending(limit=10)
|
||||
categories = await client.categories()
|
||||
|
||||
for skill in trending:
|
||||
print(f"{skill.name} ({skill.source})")
|
||||
|
||||
for cat in categories:
|
||||
print(f"{cat.name}: {cat.count} skills")
|
||||
```
|
||||
|
||||
## Health and cache
|
||||
|
||||
```python
|
||||
health = await client.health()
|
||||
print(f"v{health.version} — {health.skill_count} skills loaded")
|
||||
|
||||
stats = await client.cache_stats()
|
||||
print(f"Cache hit rate: {stats.hit_rate:.0%}")
|
||||
```
|
||||
|
||||
## Connect to a remote server
|
||||
|
||||
```python
|
||||
async with SkillKitClient("https://my-server.example.com:3737") as client:
|
||||
results = await client.search("deployment")
|
||||
```
|
||||
|
||||
## Models
|
||||
|
||||
The client returns typed dataclasses:
|
||||
|
||||
```python
|
||||
Skill(name, source, description, tags, category, content, score)
|
||||
SearchResponse(skills, total, query, limit)
|
||||
HealthResponse(status, version, skill_count, uptime)
|
||||
Category(name, count)
|
||||
CacheStats(hits, misses, size, max_size, hit_rate)
|
||||
```
|
||||
|
||||
All fields except `name` and `source` on `Skill` are optional — they depend on what the server returns and whether you requested `include_content`.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
The Python client talks to the SkillKit REST API. You need a running server:
|
||||
|
||||
```bash
|
||||
skillkit serve
|
||||
```
|
||||
|
||||
Then run your Python script in another terminal. The client handles connection management, retries, and cleanup automatically when used with `async with`.
|
||||
@@ -1,27 +1,55 @@
|
||||
---
|
||||
title: Quick Start
|
||||
description: Get productive with SkillKit in under 5 minutes
|
||||
description: Get up and running with SkillKit in 5 minutes
|
||||
---
|
||||
|
||||
# Quick Start
|
||||
|
||||
Go from zero to skills-enabled in four steps.
|
||||
This guide walks you through installing SkillKit, setting up your first project, and installing skills.
|
||||
|
||||
## 1. Init
|
||||
## 1. Install SkillKit
|
||||
|
||||
```bash
|
||||
npx skillkit@latest init
|
||||
npm install -g skillkit
|
||||
```
|
||||
|
||||
SkillKit detects your AI agent, creates the skills directory, and saves your preferences.
|
||||
Verify installation:
|
||||
|
||||
## 2. Get recommendations
|
||||
```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
|
||||
```
|
||||
|
||||
SkillKit reads your project (package.json, languages, frameworks) and suggests relevant skills:
|
||||
Example output:
|
||||
|
||||
```
|
||||
Project: my-app (Next.js + TypeScript + Tailwind)
|
||||
@@ -30,93 +58,116 @@ Recommended Skills:
|
||||
92% vercel-react-best-practices
|
||||
87% tailwind-v4-patterns
|
||||
85% nextjs-app-router
|
||||
78% typescript-strict-mode
|
||||
```
|
||||
|
||||
## 3. Install
|
||||
## 4. Install Skills
|
||||
|
||||
### Interactive Installation
|
||||
|
||||
```bash
|
||||
skillkit install anthropics/skills
|
||||
```
|
||||
|
||||
Pick which skills to install, choose target agents, and you're set. For CI/CD or scripting:
|
||||
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
|
||||
```
|
||||
|
||||
Install for multiple agents at once:
|
||||
### List Available Skills
|
||||
|
||||
Preview without installing:
|
||||
|
||||
```bash
|
||||
skillkit install vercel-labs/agent-skills --agent claude,cursor,windsurf
|
||||
skillkit install anthropics/skills --list
|
||||
```
|
||||
|
||||
## 4. Sync
|
||||
## 5. Sync to Your Agent
|
||||
|
||||
Deploy installed skills to your agent's configuration:
|
||||
|
||||
```bash
|
||||
skillkit sync
|
||||
```
|
||||
|
||||
Skills are now in your agent's configuration. Start coding.
|
||||
## 6. Launch the TUI
|
||||
|
||||
## What else?
|
||||
|
||||
### Translate between agents
|
||||
|
||||
Already have Claude skills? Deploy them to Cursor:
|
||||
|
||||
```bash
|
||||
skillkit translate my-skill --to cursor
|
||||
```
|
||||
|
||||
### Auto-generate agent instructions
|
||||
|
||||
Let SkillKit analyze your codebase and create CLAUDE.md, .cursorrules, etc.:
|
||||
|
||||
```bash
|
||||
skillkit primer --all-agents
|
||||
```
|
||||
|
||||
### Launch the TUI
|
||||
For a visual interface:
|
||||
|
||||
```bash
|
||||
skillkit ui
|
||||
# or just
|
||||
skillkit
|
||||
```
|
||||
|
||||
`h` Home | `m` Marketplace | `r` Recommend | `i` Installed | `s` Sync | `q` Quit
|
||||
**Navigation:** `h` Home | `m` Marketplace | `r` Recommend | `i` Installed | `s` Sync | `q` Quit
|
||||
|
||||
### Start the discovery server
|
||||
|
||||
Let agents find skills at runtime:
|
||||
## Complete Example
|
||||
|
||||
```bash
|
||||
skillkit serve
|
||||
# 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
|
||||
```
|
||||
|
||||
[REST API](/docs/rest-api) | [MCP Server](/docs/mcp-server)
|
||||
## Team Collaboration
|
||||
|
||||
### Share with your team
|
||||
Share skills with your team using manifest files:
|
||||
|
||||
```bash
|
||||
# Create manifest
|
||||
skillkit manifest init
|
||||
|
||||
# Add skill sources
|
||||
skillkit manifest add anthropics/skills
|
||||
git add .skills && git commit -m "add team skills"
|
||||
skillkit manifest add ./local-skills
|
||||
|
||||
# Team members install from manifest
|
||||
skillkit manifest install
|
||||
```
|
||||
|
||||
Team members run `skillkit manifest install` and get the same setup.
|
||||
The `.skills` file can be committed to Git for team-wide consistency.
|
||||
|
||||
## Full workflow
|
||||
## User Preferences
|
||||
|
||||
```bash
|
||||
npx skillkit@latest init # Detect agents, create dirs
|
||||
skillkit recommend # Get smart suggestions
|
||||
skillkit install anthropics/skills # Install from marketplace
|
||||
skillkit primer --all-agents # Generate agent instructions
|
||||
skillkit sync # Deploy everything
|
||||
Your choices are saved to `~/.skillkit/preferences.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"lastSelectedAgents": ["claude", "cursor"],
|
||||
"autoSync": true,
|
||||
"marketplace": {
|
||||
"lastRefresh": "2025-01-01T00:00:00Z"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Next steps
|
||||
## Next Steps
|
||||
|
||||
- [Commands](/docs/commands) — Full CLI reference
|
||||
- [Skills](/docs/skills) — Skill format and lifecycle
|
||||
- [Memory](/docs/memory) — Persistent session learning
|
||||
- [Mesh](/docs/mesh) — Multi-machine distribution
|
||||
- **Browse Marketplace** - `skillkit marketplace`
|
||||
- **Create Custom Skills** - `skillkit create my-skill`
|
||||
- **Translate Between Agents** - `skillkit translate skill --to cursor`
|
||||
- **View All Commands** - `skillkit --help`
|
||||
|
||||
@@ -32,33 +32,6 @@ skillkit recommend --category security
|
||||
skillkit recommend --min-score 80
|
||||
```
|
||||
|
||||
## Explainable Recommendations
|
||||
|
||||
See WHY skills match your project:
|
||||
|
||||
```bash
|
||||
skillkit recommend --explain
|
||||
```
|
||||
|
||||
Output:
|
||||
|
||||
```
|
||||
vercel-react-best-practices (Score: 92)
|
||||
├── Matched: React, TypeScript, Next.js
|
||||
├── Your stack: Next.js 14, React 18
|
||||
└── Path: Frontend > React > Best Practices
|
||||
```
|
||||
|
||||
## LLM-Based Reasoning
|
||||
|
||||
Use reasoning-based discovery for complex queries:
|
||||
|
||||
```bash
|
||||
skillkit recommend --reasoning
|
||||
```
|
||||
|
||||
This uses an LLM to traverse the skill taxonomy and find the most relevant skills based on semantic understanding.
|
||||
|
||||
## How It Works
|
||||
|
||||
The engine analyzes:
|
||||
@@ -77,22 +50,9 @@ Scores based on:
|
||||
## Programmatic API
|
||||
|
||||
```typescript
|
||||
import {
|
||||
RecommendationEngine,
|
||||
ReasoningRecommendationEngine,
|
||||
analyzeProject
|
||||
} from '@skillkit/core'
|
||||
import { RecommendationEngine, analyzeProject } from '@skillkit/core'
|
||||
|
||||
// Basic recommendations
|
||||
const engine = new RecommendationEngine()
|
||||
const profile = await analyzeProject('./my-project')
|
||||
const recs = engine.recommend(profile)
|
||||
|
||||
// With reasoning and explanations
|
||||
const reasoningEngine = new ReasoningRecommendationEngine()
|
||||
await reasoningEngine.initReasoning()
|
||||
const explained = await reasoningEngine.recommendWithReasoning(profile, {
|
||||
reasoning: true,
|
||||
explain: true
|
||||
})
|
||||
```
|
||||
|
||||
@@ -1,205 +0,0 @@
|
||||
---
|
||||
title: REST API
|
||||
description: Runtime skill discovery via HTTP
|
||||
---
|
||||
|
||||
# REST API
|
||||
|
||||
Skills shouldn't require pre-installation. With the SkillKit REST API, any agent, framework, or tool can discover and retrieve skills on demand over HTTP.
|
||||
|
||||
## Start the server
|
||||
|
||||
```bash
|
||||
skillkit serve
|
||||
```
|
||||
|
||||
That's it. The API is now running at `http://localhost:3737`.
|
||||
|
||||
## Search for skills
|
||||
|
||||
```bash
|
||||
curl "http://localhost:3737/search?q=react+performance"
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
"skills": [
|
||||
{
|
||||
"name": "react-performance",
|
||||
"description": "React app performance optimization",
|
||||
"source": "anthropics/skills",
|
||||
"tags": ["react", "performance"],
|
||||
"score": 87
|
||||
}
|
||||
],
|
||||
"total": 42,
|
||||
"query": "react performance",
|
||||
"limit": 20
|
||||
}
|
||||
```
|
||||
|
||||
Results are ranked by a multi-signal scoring system. The best matches come first.
|
||||
|
||||
### With filters
|
||||
|
||||
Use POST for advanced filtering:
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:3737/search \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"query": "auth",
|
||||
"filters": { "tags": ["security"], "category": "backend" }
|
||||
}'
|
||||
```
|
||||
|
||||
### Include full content
|
||||
|
||||
Add `include_content=true` to get the complete SKILL.md body:
|
||||
|
||||
```bash
|
||||
curl "http://localhost:3737/search?q=pdf&include_content=true&limit=3"
|
||||
```
|
||||
|
||||
## Get a specific skill
|
||||
|
||||
```bash
|
||||
curl http://localhost:3737/skills/anthropics/skills/pdf-processing
|
||||
```
|
||||
|
||||
The path follows the pattern `/skills/:owner/:repo/:skill-name`.
|
||||
|
||||
## Browse trending skills
|
||||
|
||||
```bash
|
||||
curl http://localhost:3737/trending?limit=10
|
||||
```
|
||||
|
||||
Returns the top skills ranked by relevance score across all sources.
|
||||
|
||||
## List categories
|
||||
|
||||
```bash
|
||||
curl http://localhost:3737/categories
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
"categories": [
|
||||
{ "name": "react", "count": 156 },
|
||||
{ "name": "typescript", "count": 134 },
|
||||
{ "name": "testing", "count": 89 }
|
||||
],
|
||||
"total": 89
|
||||
}
|
||||
```
|
||||
|
||||
## How ranking works
|
||||
|
||||
Every search result gets a score from 0 to 100, computed from four signals:
|
||||
|
||||
| Signal | Points | What it measures |
|
||||
|--------|--------|-----------------|
|
||||
| Content | 40 | Has a description and SKILL.md body |
|
||||
| Query match | 30 | How well the name/description matches your search |
|
||||
| Popularity | 15 | GitHub stars + install count (log-scaled) |
|
||||
| References | 15 | Has example files, docs, or resources |
|
||||
|
||||
A skill with full content, an exact name match, high stars, and example files scores close to 100. A skill with just a name and no content scores around 10.
|
||||
|
||||
## Server options
|
||||
|
||||
```bash
|
||||
skillkit serve --port 8080 --host localhost --cors "http://localhost:3000"
|
||||
```
|
||||
|
||||
| Option | Default | What it does |
|
||||
|--------|---------|-------------|
|
||||
| `--port` / `-p` | `3737` | Port to listen on |
|
||||
| `--host` / `-H` | `0.0.0.0` | Host to bind to |
|
||||
| `--cors` | `*` | Allowed CORS origin |
|
||||
| `--cache-ttl` | `86400000` | Cache lifetime in ms (default 24h) |
|
||||
|
||||
## Rate limiting
|
||||
|
||||
60 requests per minute per IP. Response headers tell you where you stand:
|
||||
|
||||
| Header | Meaning |
|
||||
|--------|---------|
|
||||
| `X-RateLimit-Remaining` | Requests left in this window |
|
||||
| `X-RateLimit-Reset` | When the window resets |
|
||||
|
||||
Exceed the limit and you'll get HTTP 429 with a `retryAfter` field.
|
||||
|
||||
## Caching
|
||||
|
||||
Search results are cached in memory using an LRU strategy. Same query, same results, no recomputation. Check cache performance:
|
||||
|
||||
```bash
|
||||
curl http://localhost:3737/cache/stats
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
"hits": 142,
|
||||
"misses": 38,
|
||||
"size": 45,
|
||||
"maxSize": 500,
|
||||
"hitRate": 0.789
|
||||
}
|
||||
```
|
||||
|
||||
## Health check
|
||||
|
||||
```bash
|
||||
curl http://localhost:3737/health
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
"status": "ok",
|
||||
"version": "1.12.0",
|
||||
"skillCount": 15062,
|
||||
"uptime": 3600
|
||||
}
|
||||
```
|
||||
|
||||
## Use it programmatically
|
||||
|
||||
```typescript
|
||||
import { createApp, startServer } from '@skillkit/api';
|
||||
|
||||
const { server, app, cache } = await startServer({
|
||||
port: 3737,
|
||||
skills: mySkillsArray,
|
||||
});
|
||||
```
|
||||
|
||||
Or get just the Hono app for testing:
|
||||
|
||||
```typescript
|
||||
const { app, cache } = createApp({
|
||||
skills: mySkillsArray,
|
||||
cacheTtlMs: 3_600_000,
|
||||
});
|
||||
```
|
||||
|
||||
## Interactive docs
|
||||
|
||||
The server includes built-in Swagger UI at `/docs` and an OpenAPI 3.1 spec at `/openapi.json`. Open `http://localhost:3737/docs` in your browser to try endpoints interactively.
|
||||
|
||||
The hosted version is available at [agenstskills.com/api](https://agenstskills.com/api).
|
||||
|
||||
## All endpoints
|
||||
|
||||
| Method | Path | Description |
|
||||
|--------|------|-------------|
|
||||
| GET | `/search?q=...` | Search skills |
|
||||
| POST | `/search` | Search with filters |
|
||||
| GET | `/skills/:owner/:repo/:id` | Get specific skill |
|
||||
| GET | `/trending?limit=20` | Trending skills |
|
||||
| GET | `/categories` | Skill categories |
|
||||
| GET | `/health` | Server health |
|
||||
| GET | `/cache/stats` | Cache statistics |
|
||||
| GET | `/docs` | Swagger UI |
|
||||
| GET | `/openapi.json` | OpenAPI spec |
|
||||
@@ -94,22 +94,6 @@ Or manually create a `SKILL.md` file following the format above.
|
||||
# Test locally
|
||||
skillkit validate ./my-skill
|
||||
|
||||
# Generate well-known hosting structure for self-hosting
|
||||
skillkit publish ./my-skill --output ./public
|
||||
|
||||
# Or submit to SkillKit marketplace
|
||||
skillkit publish submit
|
||||
# Publish to marketplace
|
||||
skillkit publish
|
||||
```
|
||||
|
||||
### Self-Hosting
|
||||
|
||||
The `skillkit publish` command generates an RFC 8615 well-known URI structure:
|
||||
|
||||
```
|
||||
.well-known/skills/
|
||||
index.json # Manifest for auto-discovery
|
||||
my-skill/
|
||||
SKILL.md # Skill content
|
||||
```
|
||||
|
||||
Deploy to your domain and users can install via `skillkit add https://your-domain.com`.
|
||||
|
||||
@@ -1,455 +0,0 @@
|
||||
---
|
||||
title: Team Collaboration
|
||||
description: Share skills and maintain consistency across your development team
|
||||
---
|
||||
|
||||
# Team Collaboration
|
||||
|
||||
SkillKit provides powerful team collaboration features to ensure every developer has the same AI agent capabilities, follows the same patterns, and stays in sync.
|
||||
|
||||
## Quick Start
|
||||
|
||||
```bash
|
||||
# Initialize team manifest
|
||||
skillkit team init
|
||||
|
||||
# Add skills to team manifest
|
||||
skillkit team add anthropics/skills
|
||||
skillkit team add ./local-skills
|
||||
|
||||
# Share with team (commit to Git)
|
||||
git add .skills
|
||||
git commit -m "Add team skills manifest"
|
||||
git push
|
||||
|
||||
# Team members install
|
||||
git pull
|
||||
skillkit team install
|
||||
```
|
||||
|
||||
## Team Manifest (.skills)
|
||||
|
||||
The `.skills` file is a Git-committable manifest that defines your team's skill stack.
|
||||
|
||||
### Example Manifest
|
||||
|
||||
```json
|
||||
{
|
||||
"version": "1.0",
|
||||
"name": "my-team",
|
||||
"skills": [
|
||||
{
|
||||
"source": "anthropics/skills",
|
||||
"skills": ["pdf", "xlsx", "docx"],
|
||||
"version": "1.2.0"
|
||||
},
|
||||
{
|
||||
"source": "vercel-labs/agent-skills",
|
||||
"skills": ["react-best-practices", "nextjs-patterns"],
|
||||
"version": "latest"
|
||||
},
|
||||
{
|
||||
"source": "./local-skills",
|
||||
"skills": ["company-coding-standards", "api-guidelines"],
|
||||
"type": "local"
|
||||
}
|
||||
],
|
||||
"agents": ["claude", "cursor", "windsurf"],
|
||||
"config": {
|
||||
"autoSync": true,
|
||||
"syncOnPull": true
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Commands
|
||||
|
||||
### Initialize Team
|
||||
|
||||
```bash
|
||||
# Create .skills manifest
|
||||
skillkit team init
|
||||
|
||||
# Specify team name
|
||||
skillkit team init --name engineering-team
|
||||
|
||||
# Add initial skills
|
||||
skillkit team init --skills anthropics/skills,vercel-labs/agent-skills
|
||||
```
|
||||
|
||||
### Manage Skills
|
||||
|
||||
```bash
|
||||
# Add skill source
|
||||
skillkit team add anthropics/skills
|
||||
|
||||
# Add specific skills
|
||||
skillkit team add anthropics/skills --skills pdf,xlsx
|
||||
|
||||
# Remove skill
|
||||
skillkit team remove anthropics/skills
|
||||
|
||||
# List team skills
|
||||
skillkit team list
|
||||
```
|
||||
|
||||
### Install & Sync
|
||||
|
||||
```bash
|
||||
# Install all team skills
|
||||
skillkit team install
|
||||
|
||||
# Install and sync
|
||||
skillkit team install --sync
|
||||
|
||||
# Force reinstall
|
||||
skillkit team install --force
|
||||
```
|
||||
|
||||
### Share & Update
|
||||
|
||||
```bash
|
||||
# Share current skills as team manifest
|
||||
skillkit team share
|
||||
|
||||
# Update team manifest from installed skills
|
||||
skillkit team update
|
||||
|
||||
# Sync team manifest with Git remote
|
||||
skillkit team sync
|
||||
```
|
||||
|
||||
## Git Integration
|
||||
|
||||
### Auto-Install on Pull
|
||||
|
||||
Add to `.git/hooks/post-merge`:
|
||||
|
||||
```bash
|
||||
#!/bin/sh
|
||||
if [ -f .skills ]; then
|
||||
echo "📦 Installing team skills..."
|
||||
skillkit team install --yes
|
||||
fi
|
||||
```
|
||||
|
||||
Make it executable:
|
||||
|
||||
```bash
|
||||
chmod +x .git/hooks/post-merge
|
||||
```
|
||||
|
||||
### Pre-Commit Validation
|
||||
|
||||
Ensure skills are valid before committing:
|
||||
|
||||
```bash
|
||||
# .git/hooks/pre-commit
|
||||
#!/bin/sh
|
||||
if [ -f .skills ]; then
|
||||
echo "🔍 Validating team skills..."
|
||||
skillkit team validate
|
||||
if [ $? -ne 0 ]; then
|
||||
echo "❌ Team skills validation failed"
|
||||
exit 1
|
||||
fi
|
||||
fi
|
||||
```
|
||||
|
||||
## CI/CD Integration
|
||||
|
||||
### GitHub Actions
|
||||
|
||||
```yaml
|
||||
# .github/workflows/skills.yml
|
||||
name: Team Skills
|
||||
|
||||
on:
|
||||
pull_request:
|
||||
paths:
|
||||
- '.skills'
|
||||
|
||||
jobs:
|
||||
validate:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v3
|
||||
|
||||
- name: Setup Node
|
||||
uses: actions/setup-node@v3
|
||||
with:
|
||||
node-version: '18'
|
||||
|
||||
- name: Install SkillKit
|
||||
run: npm install -g skillkit
|
||||
|
||||
- name: Validate Team Manifest
|
||||
run: skillkit team validate
|
||||
|
||||
- name: Install Skills
|
||||
run: skillkit team install --yes
|
||||
|
||||
- name: Run Skill Tests
|
||||
run: skillkit test
|
||||
```
|
||||
|
||||
### GitLab CI
|
||||
|
||||
```yaml
|
||||
# .gitlab-ci.yml
|
||||
skills:validate:
|
||||
stage: test
|
||||
script:
|
||||
- npm install -g skillkit
|
||||
- skillkit team validate
|
||||
- skillkit team install --yes
|
||||
- skillkit test
|
||||
only:
|
||||
changes:
|
||||
- .skills
|
||||
```
|
||||
|
||||
## Private Registries
|
||||
|
||||
Host proprietary skills in private repositories.
|
||||
|
||||
### Setup Private Registry
|
||||
|
||||
```bash
|
||||
# Add private registry
|
||||
skillkit registry add company-skills \
|
||||
--url https://github.com/mycompany/skills \
|
||||
--token $GITHUB_TOKEN
|
||||
|
||||
# Install from private registry
|
||||
skillkit install company-skills/auth-patterns
|
||||
```
|
||||
|
||||
### Team Manifest with Private Skills
|
||||
|
||||
```json
|
||||
{
|
||||
"skills": [
|
||||
{
|
||||
"source": "company-skills/proprietary-skills",
|
||||
"registry": "company-skills",
|
||||
"skills": ["auth-patterns", "payment-processing"],
|
||||
"private": true
|
||||
}
|
||||
],
|
||||
"registries": [
|
||||
{
|
||||
"name": "company-skills",
|
||||
"url": "https://github.com/mycompany/skills",
|
||||
"auth": "env:GITHUB_TOKEN"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
## Team Workflows
|
||||
|
||||
### Onboarding New Developers
|
||||
|
||||
```bash
|
||||
# 1. Clone repository
|
||||
git clone https://github.com/company/project
|
||||
cd project
|
||||
|
||||
# 2. Install team skills
|
||||
skillkit team install
|
||||
|
||||
# 3. Generate project instructions
|
||||
skillkit primer --all-agents
|
||||
|
||||
# 4. Sync to agents
|
||||
skillkit sync
|
||||
|
||||
# ✅ Developer is ready!
|
||||
```
|
||||
|
||||
### Creating Team-Wide Skills
|
||||
|
||||
```bash
|
||||
# 1. Create new skill
|
||||
skillkit create company-coding-standards
|
||||
|
||||
# 2. Add to local skills
|
||||
mv company-coding-standards ./local-skills/
|
||||
|
||||
# 3. Add to team manifest
|
||||
skillkit team add ./local-skills
|
||||
|
||||
# 4. Commit and push
|
||||
git add .skills local-skills/
|
||||
git commit -m "Add company coding standards"
|
||||
git push
|
||||
```
|
||||
|
||||
### Updating Team Skills
|
||||
|
||||
```bash
|
||||
# 1. Update skill version
|
||||
skillkit team update anthropics/skills --version 1.3.0
|
||||
|
||||
# 2. Test locally
|
||||
skillkit team install
|
||||
skillkit test
|
||||
|
||||
# 3. Commit if tests pass
|
||||
git add .skills
|
||||
git commit -m "Update anthropics/skills to v1.3.0"
|
||||
git push
|
||||
```
|
||||
|
||||
## Best Practices
|
||||
|
||||
### Version Pinning
|
||||
|
||||
Pin critical skills to specific versions:
|
||||
|
||||
```json
|
||||
{
|
||||
"skills": [
|
||||
{
|
||||
"source": "anthropics/skills",
|
||||
"version": "1.2.0",
|
||||
"pinned": true
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
### Skill Categories
|
||||
|
||||
Organize by category:
|
||||
|
||||
```json
|
||||
{
|
||||
"skills": [
|
||||
{
|
||||
"category": "core",
|
||||
"source": "anthropics/skills",
|
||||
"required": true
|
||||
},
|
||||
{
|
||||
"category": "optional",
|
||||
"source": "vercel-labs/agent-skills",
|
||||
"required": false
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
### Environment-Specific Skills
|
||||
|
||||
```json
|
||||
{
|
||||
"environments": {
|
||||
"development": {
|
||||
"skills": ["debug-tools", "dev-server-patterns"]
|
||||
},
|
||||
"production": {
|
||||
"skills": ["performance-monitoring", "error-tracking"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Conflict Resolution
|
||||
|
||||
### Skill Name Conflicts
|
||||
|
||||
When multiple sources provide the same skill name:
|
||||
|
||||
```bash
|
||||
# List conflicts
|
||||
skillkit team conflicts
|
||||
|
||||
# Resolve by priority
|
||||
skillkit team resolve --priority "local,anthropics,vercel"
|
||||
```
|
||||
|
||||
### Version Conflicts
|
||||
|
||||
```bash
|
||||
# Show version mismatches
|
||||
skillkit team check-versions
|
||||
|
||||
# Align to latest
|
||||
skillkit team align --strategy latest
|
||||
|
||||
# Align to pinned
|
||||
skillkit team align --strategy pinned
|
||||
```
|
||||
|
||||
## Programmatic API
|
||||
|
||||
```typescript
|
||||
import { TeamManifest, TeamSync } from '@skillkit/core'
|
||||
|
||||
// Load team manifest
|
||||
const manifest = await TeamManifest.load('./.skills')
|
||||
|
||||
// Install team skills
|
||||
const sync = new TeamSync(manifest)
|
||||
await sync.install({
|
||||
agents: ['claude', 'cursor'],
|
||||
force: false,
|
||||
})
|
||||
|
||||
// Update manifest
|
||||
manifest.addSkill({
|
||||
source: 'anthropics/skills',
|
||||
skills: ['pdf'],
|
||||
version: '1.2.0',
|
||||
})
|
||||
|
||||
await manifest.save()
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Skills Not Syncing
|
||||
|
||||
```bash
|
||||
# Force reinstall
|
||||
skillkit team install --force
|
||||
|
||||
# Clear cache
|
||||
skillkit team clean
|
||||
|
||||
# Reinstall
|
||||
skillkit team install
|
||||
```
|
||||
|
||||
### Manifest Validation Errors
|
||||
|
||||
```bash
|
||||
# Validate manifest
|
||||
skillkit team validate --verbose
|
||||
|
||||
# Fix common issues
|
||||
skillkit team validate --fix
|
||||
```
|
||||
|
||||
### Merge Conflicts in .skills
|
||||
|
||||
```bash
|
||||
# Accept theirs
|
||||
git checkout --theirs .skills
|
||||
skillkit team install
|
||||
|
||||
# Accept ours
|
||||
git checkout --ours .skills
|
||||
skillkit team install
|
||||
|
||||
# Merge manually
|
||||
skillkit team merge-conflicts
|
||||
```
|
||||
|
||||
## Next Steps
|
||||
|
||||
- [CI/CD Integration](/docs/cicd) - Automate skill deployment
|
||||
- [Workflows](/docs/workflows) - Team-wide automation
|
||||
- [Testing](/docs/testing) - Validate skills before deployment
|
||||
@@ -1,144 +0,0 @@
|
||||
---
|
||||
title: Skill Tree
|
||||
description: Browse skills in a hierarchical taxonomy
|
||||
---
|
||||
|
||||
# Skill Tree
|
||||
|
||||
Browse and navigate skills organized in a hierarchical taxonomy structure.
|
||||
|
||||
## Quick Start
|
||||
|
||||
```bash
|
||||
# Show full skill tree
|
||||
skillkit tree
|
||||
|
||||
# Navigate to a category
|
||||
skillkit tree Frontend
|
||||
|
||||
# Navigate to subcategory
|
||||
skillkit tree "Frontend > React"
|
||||
```
|
||||
|
||||
## Commands
|
||||
|
||||
### Display Tree
|
||||
|
||||
```bash
|
||||
skillkit tree # Full tree
|
||||
skillkit tree Development # Specific category
|
||||
skillkit tree --depth 2 # Limit display depth
|
||||
```
|
||||
|
||||
### Generate Tree
|
||||
|
||||
```bash
|
||||
skillkit tree --generate # Generate from skill index
|
||||
```
|
||||
|
||||
This builds a hierarchical tree from the skill index based on tags and metadata.
|
||||
|
||||
### Export Formats
|
||||
|
||||
```bash
|
||||
skillkit tree --json # JSON output
|
||||
skillkit tree --markdown # Markdown output
|
||||
```
|
||||
|
||||
### Statistics
|
||||
|
||||
```bash
|
||||
skillkit tree --stats
|
||||
```
|
||||
|
||||
Output:
|
||||
|
||||
```
|
||||
Overview:
|
||||
Total Skills: 15,064
|
||||
Categories: 156
|
||||
Max Depth: 4
|
||||
|
||||
Top-Level Categories:
|
||||
Development 4,521 skills (30.0%)
|
||||
Frontend (1,245), Backend (1,102), Mobile (456)
|
||||
DevOps 2,340 skills (15.5%)
|
||||
CI/CD (890), Kubernetes (567), Docker (445)
|
||||
AI/ML 1,890 skills (12.5%)
|
||||
LLM Integration (756), Agents (445), RAG (312)
|
||||
```
|
||||
|
||||
## Categories
|
||||
|
||||
The tree organizes skills into 12 top-level categories:
|
||||
|
||||
| Category | Description |
|
||||
|----------|-------------|
|
||||
| Development | General coding, programming patterns |
|
||||
| Frontend | React, Vue, Angular, Svelte, UI/UX |
|
||||
| Backend | Node.js, Python, Go, APIs, servers |
|
||||
| Mobile | React Native, Flutter, iOS, Android |
|
||||
| DevOps | CI/CD, Kubernetes, Docker, cloud |
|
||||
| Testing | Unit, E2E, integration, TDD |
|
||||
| Security | Auth, encryption, vulnerabilities |
|
||||
| AI/ML | LLM, agents, RAG, embeddings |
|
||||
| Database | SQL, NoSQL, ORM, migrations |
|
||||
| Tooling | Linting, formatting, bundling |
|
||||
| Documentation | API docs, guides, READMEs |
|
||||
| Performance | Optimization, caching, profiling |
|
||||
|
||||
## TUI Tree View
|
||||
|
||||
In the TUI, press `v` to toggle tree view in the Marketplace:
|
||||
|
||||
- **Arrow keys** - Navigate tree
|
||||
- **Enter** - Expand category / select skill
|
||||
- **←** - Go back / collapse
|
||||
- **v** - Toggle list/tree view
|
||||
|
||||
## Related Skills Graph
|
||||
|
||||
Find skills related to each other:
|
||||
|
||||
```typescript
|
||||
import { buildSkillGraph, getRelatedSkills } from '@skillkit/core'
|
||||
|
||||
const graph = buildSkillGraph(skills)
|
||||
const related = getRelatedSkills('react-patterns', graph, skills, {
|
||||
limit: 5,
|
||||
types: ['similar', 'complementary']
|
||||
})
|
||||
```
|
||||
|
||||
### Relation Types
|
||||
|
||||
- **similar** - Shares tags and functionality
|
||||
- **complementary** - Works well together
|
||||
- **dependency** - Required by other skills
|
||||
- **alternative** - Different approach to same problem
|
||||
|
||||
## Programmatic API
|
||||
|
||||
```typescript
|
||||
import {
|
||||
TreeGenerator,
|
||||
generateSkillTree,
|
||||
loadTree,
|
||||
saveTree,
|
||||
treeToMarkdown
|
||||
} from '@skillkit/core'
|
||||
|
||||
// Generate tree from skills
|
||||
const generator = new TreeGenerator({ maxDepth: 3 })
|
||||
const tree = generator.generateTree(skills)
|
||||
|
||||
// Or use the helper function
|
||||
const tree = generateSkillTree(skills)
|
||||
|
||||
// Save and load
|
||||
saveTree(tree, './skill-tree.json')
|
||||
const loaded = loadTree('./skill-tree.json')
|
||||
|
||||
// Export to markdown
|
||||
const markdown = treeToMarkdown(tree)
|
||||
```
|
||||
@@ -18,12 +18,10 @@ skillkit
|
||||
## Framework
|
||||
|
||||
Built on modern technologies:
|
||||
- **@opentui/solid** - Terminal rendering with Solid.js
|
||||
- **Solid.js 1.9.0** - Reactive component architecture
|
||||
- **@opentui/react** - Terminal rendering
|
||||
- **React 19.0.0** - Component architecture
|
||||
- **Bun 1.2.0+** - Runtime requirement
|
||||
|
||||
The TUI was migrated from React to Solid.js in v1.8.0 for improved performance and smaller bundle size.
|
||||
|
||||
## Screens
|
||||
|
||||
| Screen | Key | Purpose |
|
||||
@@ -105,20 +103,6 @@ Browse 15,000+ skills:
|
||||
- Featured skills
|
||||
- 3-phase animation loading
|
||||
- Quality scoring
|
||||
- **Tree View** - Press `v` to toggle hierarchical navigation
|
||||
|
||||
#### Tree View Mode
|
||||
|
||||
Navigate skills in a hierarchical taxonomy:
|
||||
|
||||
| Key | Action |
|
||||
|-----|--------|
|
||||
| `v` | Toggle tree/list view |
|
||||
| `→` or `Enter` | Expand category |
|
||||
| `←` | Collapse / go back |
|
||||
| `↑`/`↓` | Navigate |
|
||||
|
||||
Categories include: Development, Frontend, Backend, Mobile, DevOps, Testing, Security, AI/ML, Database, Tooling, Documentation, Performance
|
||||
|
||||
### Recommend Screen
|
||||
|
||||
@@ -175,10 +159,8 @@ loadSkills()
|
||||
|
||||
### Performance Optimizations
|
||||
|
||||
- `createMemo` for filtered lists and computed values
|
||||
- `createSignal` for reactive state management
|
||||
- `createEffect` for side effects and subscriptions
|
||||
- Windowed list rendering for large datasets
|
||||
- `useMemo` for filtered lists
|
||||
- `useCallback` for event handlers
|
||||
- Pagination limits rendered items
|
||||
- Progressive animation with phases
|
||||
|
||||
@@ -192,32 +174,18 @@ loadSkills()
|
||||
|
||||
## Integration
|
||||
|
||||
The TUI integrates with @skillkit/core using Solid.js reactive patterns:
|
||||
The TUI integrates with @skillkit/core:
|
||||
|
||||
```typescript
|
||||
import { createSignal, createMemo, createEffect } from 'solid-js';
|
||||
|
||||
const [skills, setSkills] = createSignal([]);
|
||||
|
||||
createEffect(async () => {
|
||||
const result = await findAllSkills(searchDirs);
|
||||
setSkills(result);
|
||||
});
|
||||
|
||||
const filteredSkills = createMemo(() =>
|
||||
skills().filter(s => s.name.includes(searchTerm()))
|
||||
);
|
||||
findAllSkills(searchDirs) // Returns skill metadata
|
||||
evaluateSkillDirectory(path) // Quality metrics
|
||||
getQualityGrade(score) // 0-100 to A-F
|
||||
```
|
||||
|
||||
Core functions:
|
||||
- `findAllSkills(searchDirs)` - Returns skill metadata
|
||||
- `evaluateSkillDirectory(path)` - Quality metrics
|
||||
- `getQualityGrade(score)` - 0-100 to A-F
|
||||
|
||||
## Graceful Exit
|
||||
|
||||
The TUI handles shutdown gracefully:
|
||||
1. Runs Solid.js cleanup functions (`onCleanup`)
|
||||
1. Unmounts React components
|
||||
2. Restores terminal state
|
||||
3. Cleans up signal handlers
|
||||
4. Exits process cleanly
|
||||
|
||||
@@ -5,9 +5,6 @@ const withMDX = createMDX();
|
||||
/** @type {import('next').NextConfig} */
|
||||
const config = {
|
||||
reactStrictMode: true,
|
||||
trailingSlash: false,
|
||||
skipTrailingSlashRedirect: true,
|
||||
assetPrefix: 'https://skillkit-docs.vercel.app',
|
||||
};
|
||||
|
||||
export default withMDX(config);
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "skillkit-docs",
|
||||
"version": "1.14.0",
|
||||
"version": "1.0.0",
|
||||
"private": true,
|
||||
"scripts": {
|
||||
"build": "next build",
|
||||
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 1.0 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 437 B |
@@ -1,4 +0,0 @@
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">
|
||||
<rect width="32" height="32" fill="#000000"/>
|
||||
<rect x="8" y="8" width="16" height="16" fill="#ffffff"/>
|
||||
</svg>
|
||||
|
Before Width: | Height: | Size: 176 B |
Binary file not shown.
|
Before Width: | Height: | Size: 158 KiB |
@@ -1,5 +1,17 @@
|
||||
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,
|
||||
}: {
|
||||
@@ -10,24 +22,34 @@ export default function HomeLayout({
|
||||
<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">
|
||||
<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-4">
|
||||
<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="noopener noreferrer"
|
||||
className="text-zinc-400 hover:text-white transition-colors text-sm font-mono"
|
||||
rel="noreferrer noopener"
|
||||
className="text-zinc-400 hover:text-white transition-colors p-2"
|
||||
aria-label="GitHub"
|
||||
>
|
||||
GitHub
|
||||
{GITHUB_ICON}
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -1,96 +1,40 @@
|
||||
import Link from 'next/link'
|
||||
'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">
|
||||
<main className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8 py-20">
|
||||
{/* Hero */}
|
||||
<div className="text-center mb-16">
|
||||
<div className="inline-flex items-center space-x-2 border border-zinc-800 bg-zinc-900/50 px-3 py-1 mb-6">
|
||||
<span className="flex h-2 w-2 bg-white rounded-full"></span>
|
||||
<span className="text-sm font-mono text-zinc-400">v1.8.0</span>
|
||||
<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>
|
||||
|
||||
<h1 className="text-4xl sm:text-5xl lg:text-6xl font-bold tracking-tight text-white mb-6 font-mono">
|
||||
Universal Skills for<br />
|
||||
<span className="text-zinc-500">AI Coding Agents</span>
|
||||
</h1>
|
||||
|
||||
<p className="text-lg text-zinc-400 mb-8 max-w-2xl mx-auto font-mono">
|
||||
One CLI to install, sync, and manage skills across Claude Code, Cursor,
|
||||
Windsurf, Copilot, and 28 more agents. 15,000+ skills ready to use.
|
||||
</p>
|
||||
|
||||
<div className="flex flex-wrap justify-center gap-4 mb-12">
|
||||
<code className="inline-flex items-center bg-zinc-900 border border-zinc-700 px-4 py-3 text-sm font-mono">
|
||||
<span className="text-zinc-500 mr-2">$</span>
|
||||
<span className="text-white">npx skillkit@latest</span>
|
||||
</code>
|
||||
|
||||
<Link
|
||||
href="/docs"
|
||||
className="inline-flex items-center bg-white text-black px-6 py-3 font-mono text-sm hover:bg-zinc-200 transition-colors"
|
||||
>
|
||||
Read the Docs →
|
||||
</Link>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Features Grid */}
|
||||
<div className="grid grid-cols-1 md:grid-cols-3 gap-6 mb-16">
|
||||
<div className="border border-zinc-800 bg-zinc-900/30 p-6">
|
||||
<h3 className="text-lg font-bold text-white mb-2 font-mono">32 Agents</h3>
|
||||
<p className="text-zinc-500 text-sm">Claude, Cursor, Codex, Windsurf, Copilot, and 27 more supported out of the box.</p>
|
||||
</div>
|
||||
<div className="border border-zinc-800 bg-zinc-900/30 p-6">
|
||||
<h3 className="text-lg font-bold text-white mb-2 font-mono">15,000+ Skills</h3>
|
||||
<p className="text-zinc-500 text-sm">Browse the marketplace or create your own. Install with a single command.</p>
|
||||
</div>
|
||||
<div className="border border-zinc-800 bg-zinc-900/30 p-6">
|
||||
<h3 className="text-lg font-bold text-white mb-2 font-mono">Auto Translation</h3>
|
||||
<p className="text-zinc-500 text-sm">Write once, deploy everywhere. Automatic format conversion between all agents.</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Quick Links */}
|
||||
<div className="text-center">
|
||||
<h2 className="text-2xl font-bold text-white mb-6 font-mono">Get Started</h2>
|
||||
<div className="flex flex-wrap justify-center gap-4">
|
||||
<Link href="/docs/quickstart" className="text-zinc-400 hover:text-white font-mono text-sm border border-zinc-800 px-4 py-2 hover:border-zinc-600 transition-colors">
|
||||
Quick Start
|
||||
</Link>
|
||||
<Link href="/docs/primer" className="text-zinc-400 hover:text-white font-mono text-sm border border-zinc-800 px-4 py-2 hover:border-zinc-600 transition-colors">
|
||||
Primer
|
||||
</Link>
|
||||
<Link href="/docs/memory" className="text-zinc-400 hover:text-white font-mono text-sm border border-zinc-800 px-4 py-2 hover:border-zinc-600 transition-colors">
|
||||
Memory System
|
||||
</Link>
|
||||
<Link href="/docs/mesh" className="text-zinc-400 hover:text-white font-mono text-sm border border-zinc-800 px-4 py-2 hover:border-zinc-600 transition-colors">
|
||||
Mesh Network
|
||||
</Link>
|
||||
<Link href="/docs/api-reference" className="text-zinc-400 hover:text-white font-mono text-sm border border-zinc-800 px-4 py-2 hover:border-zinc-600 transition-colors">
|
||||
API Reference
|
||||
</Link>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
</main>
|
||||
|
||||
{/* Footer */}
|
||||
<footer className="border-t border-zinc-800 py-8">
|
||||
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
|
||||
<div className="flex flex-col sm:flex-row items-center justify-between gap-4">
|
||||
<div className="flex items-center gap-2">
|
||||
<div className="w-4 h-4 bg-white"></div>
|
||||
<span className="font-mono font-bold text-white">SKILLKIT</span>
|
||||
</div>
|
||||
<div className="flex items-center gap-6 text-sm font-mono text-zinc-500">
|
||||
<a href="https://github.com/rohitg00/skillkit" target="_blank" rel="noopener noreferrer" className="hover:text-white transition-colors">GitHub</a>
|
||||
<a href="https://www.npmjs.com/package/skillkit" target="_blank" rel="noopener noreferrer" className="hover:text-white transition-colors">npm</a>
|
||||
<Link href="/docs" className="hover:text-white transition-colors">Docs</Link>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</footer>
|
||||
|
||||
<Footer />
|
||||
</div>
|
||||
)
|
||||
}
|
||||
|
||||
@@ -1,42 +1,12 @@
|
||||
import { RootProvider } from 'fumadocs-ui/provider/next'
|
||||
import './global.css'
|
||||
import { Inter } from 'next/font/google'
|
||||
import type { Metadata } from 'next'
|
||||
|
||||
const inter = Inter({
|
||||
subsets: ['latin'],
|
||||
weight: ['400', '500', '600', '700'],
|
||||
})
|
||||
|
||||
export const metadata: Metadata = {
|
||||
title: {
|
||||
default: 'SkillKit - Universal Skills for AI Coding Agents',
|
||||
template: '%s | SkillKit',
|
||||
},
|
||||
description: 'One CLI to install, sync, and manage skills across Claude Code, Cursor, Windsurf, Copilot, and 28 more agents. 15,000+ skills ready to use.',
|
||||
icons: {
|
||||
icon: [
|
||||
{ url: '/favicon.svg', type: 'image/svg+xml' },
|
||||
{ url: '/favicon-32.png', sizes: '32x32', type: 'image/png' },
|
||||
],
|
||||
apple: '/apple-touch-icon.png',
|
||||
},
|
||||
openGraph: {
|
||||
title: 'SkillKit - Universal Skills for AI Coding Agents',
|
||||
description: 'One CLI to install, sync, and manage skills across Claude Code, Cursor, Windsurf, Copilot, and 28 more agents.',
|
||||
url: 'https://agenstskills.com',
|
||||
siteName: 'SkillKit',
|
||||
images: [{ url: '/og-image.png', width: 1200, height: 630 }],
|
||||
type: 'website',
|
||||
},
|
||||
twitter: {
|
||||
card: 'summary_large_image',
|
||||
title: 'SkillKit - Universal Skills for AI Coding Agents',
|
||||
description: 'One CLI to install, sync, and manage skills across Claude Code, Cursor, Windsurf, Copilot, and 28 more agents.',
|
||||
images: ['/og-image.png'],
|
||||
},
|
||||
}
|
||||
|
||||
export default function Layout({ children }: { children: React.ReactNode }) {
|
||||
return (
|
||||
<html lang="en" className={inter.className} suppressHydrationWarning>
|
||||
|
||||
@@ -33,15 +33,6 @@ const COMMAND_GROUPS: CommandGroup[] = [
|
||||
{ cmd: 'publish', desc: 'Submit to marketplace' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Security',
|
||||
commands: [
|
||||
{ cmd: 'scan <path>', desc: 'Security vulnerability scanner' },
|
||||
{ cmd: 'scan --format sarif', desc: 'SARIF for GitHub Code Scanning' },
|
||||
{ cmd: 'scan --fail-on high', desc: 'CI security gate' },
|
||||
{ cmd: 'audit log', desc: 'View audit trail' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Advanced',
|
||||
commands: [
|
||||
|
||||
@@ -18,7 +18,7 @@ export function Footer(): React.ReactElement {
|
||||
</p>
|
||||
<span className="hidden sm:inline text-zinc-700">•</span>
|
||||
<a
|
||||
href="https://agenstskills.com"
|
||||
href="https://agentskills.io"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="text-zinc-600 hover:text-zinc-400 text-xs font-mono transition-colors"
|
||||
|
||||
@@ -2,11 +2,11 @@ import React, { useState, useEffect } from 'react';
|
||||
import { Button } from './Button';
|
||||
|
||||
const ASCII_LOGO = `
|
||||
____ _ __ _ _ _ _ __ _ _____
|
||||
/ ___|| |/ /| || | | | | |/ /| ||_ _|
|
||||
\\___ \\| ' / | || | | | | ' / | | | |
|
||||
___) | . \\ | || |___ | |___ | . \\ | | | |
|
||||
|____/|_|\\_\\|_||_____||_____||_|\\_\\|_| |_|
|
||||
███████ ██ ██ ██ ██ ██ ██ ██ ██ ████████
|
||||
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
|
||||
███████ █████ ██ ██ ██ █████ ██ ██
|
||||
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
|
||||
███████ ██ ██ ██ ███████ ███████ ██ ██ ██ ██
|
||||
`.trim();
|
||||
|
||||
interface TerminalLine {
|
||||
@@ -116,7 +116,7 @@ export function Hero(): React.ReactElement {
|
||||
|
||||
<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-500 text-[11px] leading-tight font-mono select-none whitespace-pre">
|
||||
<pre className="text-zinc-700 text-[10px] leading-tight font-mono select-none whitespace-pre">
|
||||
{ASCII_LOGO}
|
||||
</pre>
|
||||
</div>
|
||||
|
||||
@@ -0,0 +1,13 @@
|
||||
{
|
||||
"$schema": "https://turbo.build/schema.json",
|
||||
"extends": [],
|
||||
"tasks": {
|
||||
"build": {
|
||||
"outputs": [".next/**", "!.next/cache/**"]
|
||||
},
|
||||
"dev": {
|
||||
"cache": false,
|
||||
"persistent": true
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -1,57 +0,0 @@
|
||||
<svg width="1200" height="400" viewBox="0 0 1200 400" xmlns="http://www.w3.org/2000/svg">
|
||||
<defs>
|
||||
<linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
|
||||
<stop offset="0%" style="stop-color:#0a0a0a"/>
|
||||
<stop offset="50%" style="stop-color:#111111"/>
|
||||
<stop offset="100%" style="stop-color:#0a0a0a"/>
|
||||
</linearGradient>
|
||||
<linearGradient id="border" x1="0%" y1="0%" x2="100%" y2="0%">
|
||||
<stop offset="0%" style="stop-color:#333"/>
|
||||
<stop offset="50%" style="stop-color:#555"/>
|
||||
<stop offset="100%" style="stop-color:#333"/>
|
||||
</linearGradient>
|
||||
<linearGradient id="accent" x1="0%" y1="0%" x2="100%" y2="0%">
|
||||
<stop offset="0%" style="stop-color:#666"/>
|
||||
<stop offset="100%" style="stop-color:#999"/>
|
||||
</linearGradient>
|
||||
</defs>
|
||||
|
||||
<rect width="1200" height="400" fill="url(#bg)" rx="12"/>
|
||||
<rect x="1" y="1" width="1198" height="398" fill="none" stroke="url(#border)" stroke-width="1" rx="12"/>
|
||||
|
||||
<line x1="60" y1="340" x2="1140" y2="340" stroke="#1a1a1a" stroke-width="1"/>
|
||||
|
||||
<g transform="translate(60, 80)">
|
||||
<rect width="16" height="16" fill="white" rx="2"/>
|
||||
</g>
|
||||
|
||||
<text x="90" y="94" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="20" font-weight="700" fill="white" letter-spacing="3">SKILLKIT</text>
|
||||
|
||||
<text x="600" y="200" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="62" font-weight="700" fill="white" text-anchor="middle" letter-spacing="-1">One Skill. 32 Agents.</text>
|
||||
|
||||
<text x="600" y="248" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="20" fill="#888" text-anchor="middle" letter-spacing="0.5">The open source package manager for AI agent skills</text>
|
||||
|
||||
<g transform="translate(280, 280)">
|
||||
<rect width="280" height="40" fill="#1a1a1a" stroke="#333" stroke-width="1" rx="6"/>
|
||||
<text x="16" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#666">$</text>
|
||||
<text x="32" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#ccc">npx skillkit@latest</text>
|
||||
</g>
|
||||
|
||||
<g transform="translate(580, 280)">
|
||||
<rect width="160" height="40" fill="transparent" stroke="#444" stroke-width="1" rx="6"/>
|
||||
<text x="80" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#999" text-anchor="middle">15,000+ skills</text>
|
||||
</g>
|
||||
|
||||
<g transform="translate(760, 280)">
|
||||
<rect width="160" height="40" fill="transparent" stroke="#444" stroke-width="1" rx="6"/>
|
||||
<text x="80" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#999" text-anchor="middle">Zero rewrites</text>
|
||||
</g>
|
||||
|
||||
<g transform="translate(60, 355)">
|
||||
<circle cx="5" cy="5" r="3" fill="#666"/>
|
||||
<circle cx="15" cy="5" r="3" fill="#555"/>
|
||||
<circle cx="25" cy="5" r="3" fill="#444"/>
|
||||
<circle cx="35" cy="5" r="3" fill="#333"/>
|
||||
<text x="50" y="9" font-family="'SF Mono', monospace" font-size="11" fill="#444">Claude Cursor Codex Gemini Copilot Windsurf OpenCode +25 more</text>
|
||||
</g>
|
||||
</svg>
|
||||
|
Before Width: | Height: | Size: 3.0 KiB |
+26
-194
@@ -6,15 +6,6 @@ import { Footer } from './components/Footer';
|
||||
import { SkillGenerator } from './components/SkillGenerator';
|
||||
import { SkillSubmitForm } from './components/SkillSubmitForm';
|
||||
import { Commands } from './components/Commands';
|
||||
import { StackBuilder } from './components/StackBuilder';
|
||||
import { TrendingSkills } from './components/TrendingSkills';
|
||||
import { Attribution } from './components/Attribution';
|
||||
import { AdvancedFeatures } from './components/AdvancedFeatures';
|
||||
import { UseCases } from './components/UseCases';
|
||||
import { TeamEnterprise } from './components/TeamEnterprise';
|
||||
import { BadgeGenerator } from './components/BadgeGenerator';
|
||||
import { CompatibilityMatrix } from './components/CompatibilityMatrix';
|
||||
import { useStats } from './hooks/useStats';
|
||||
|
||||
const GITHUB_ICON = (
|
||||
<svg className="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
|
||||
@@ -22,108 +13,51 @@ const GITHUB_ICON = (
|
||||
</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>
|
||||
);
|
||||
|
||||
function scrollToTop(e: React.MouseEvent): void {
|
||||
e.preventDefault();
|
||||
window.scrollTo({ top: 0, behavior: 'smooth' });
|
||||
}
|
||||
|
||||
function scrollToSection(e: React.MouseEvent, sectionId: string): void {
|
||||
e.preventDefault();
|
||||
const element = document.getElementById(sectionId);
|
||||
if (element) {
|
||||
element.scrollIntoView({ behavior: 'smooth' });
|
||||
history.replaceState(null, '', `#${sectionId}`);
|
||||
}
|
||||
}
|
||||
|
||||
export default function App(): React.ReactElement {
|
||||
const stats = useStats();
|
||||
|
||||
return (
|
||||
<div className="min-h-screen text-zinc-100 font-sans selection:bg-white selection:text-black" style={{ backgroundColor: '#000000' }}>
|
||||
<nav className="fixed top-0 left-0 right-0 z-50 border-b border-zinc-800 backdrop-blur-md" style={{ backgroundColor: 'rgba(0,0,0,0.9)' }}>
|
||||
<div className="min-h-screen bg-background text-zinc-100 font-sans selection:bg-white selection:text-black">
|
||||
<nav className="fixed top-0 left-0 right-0 z-50 border-b border-zinc-800 bg-background/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 gap-2">
|
||||
<div className="flex h-14 items-center justify-between">
|
||||
<a href="#" onClick={scrollToTop} className="flex items-center gap-2 cursor-pointer">
|
||||
<div className="w-4 h-4 bg-white"></div>
|
||||
<span className="text-base font-bold tracking-tight text-white font-mono">SKILLKIT</span>
|
||||
</a>
|
||||
<div className="hidden sm:flex items-center gap-4 text-xs font-mono">
|
||||
<div className="flex items-center gap-2 sm:gap-4">
|
||||
<a
|
||||
href="#trending"
|
||||
onClick={(e) => scrollToSection(e, 'trending')}
|
||||
className="text-zinc-500 hover:text-white transition-colors"
|
||||
>
|
||||
Trending
|
||||
</a>
|
||||
<a
|
||||
href="#stack"
|
||||
onClick={(e) => scrollToSection(e, 'stack')}
|
||||
className="text-zinc-500 hover:text-white transition-colors"
|
||||
>
|
||||
Stack
|
||||
</a>
|
||||
<a
|
||||
href="#matrix"
|
||||
onClick={(e) => scrollToSection(e, 'matrix')}
|
||||
className="text-zinc-500 hover:text-white transition-colors"
|
||||
>
|
||||
Matrix
|
||||
</a>
|
||||
<a
|
||||
href="#badge"
|
||||
onClick={(e) => scrollToSection(e, 'badge')}
|
||||
className="text-zinc-500 hover:text-white transition-colors"
|
||||
>
|
||||
Badge
|
||||
</a>
|
||||
<a
|
||||
href="#advanced"
|
||||
onClick={(e) => scrollToSection(e, 'advanced')}
|
||||
className="text-zinc-500 hover:text-white transition-colors"
|
||||
>
|
||||
Features
|
||||
</a>
|
||||
<a
|
||||
href="#use-cases"
|
||||
onClick={(e) => scrollToSection(e, 'use-cases')}
|
||||
className="text-zinc-500 hover:text-white transition-colors"
|
||||
>
|
||||
Use Cases
|
||||
</a>
|
||||
<a
|
||||
href="#skills"
|
||||
onClick={(e) => scrollToSection(e, 'skills')}
|
||||
className="text-zinc-500 hover:text-white transition-colors"
|
||||
>
|
||||
Generator
|
||||
</a>
|
||||
</div>
|
||||
<div className="flex items-center gap-3 sm:gap-4">
|
||||
<a
|
||||
href="/api"
|
||||
className="text-zinc-400 hover:text-white transition-colors text-xs sm:text-sm font-mono"
|
||||
>
|
||||
API
|
||||
</a>
|
||||
<a
|
||||
href="https://agenstskills.com/docs"
|
||||
className="text-zinc-400 hover:text-white transition-colors text-xs sm:text-sm font-mono"
|
||||
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="noopener noreferrer"
|
||||
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="noopener noreferrer"
|
||||
className="inline-flex items-center gap-1.5 border border-zinc-700 hover:border-zinc-500 px-2 py-1 transition-colors group"
|
||||
aria-label="GitHub Stars"
|
||||
className="text-zinc-400 hover:text-white transition-colors p-2"
|
||||
aria-label="GitHub"
|
||||
>
|
||||
{GITHUB_ICON}
|
||||
<svg className="w-3.5 h-3.5 text-zinc-500 group-hover:text-yellow-500 transition-colors" fill="currentColor" viewBox="0 0 24 24">
|
||||
<path d="M12 2l3.09 6.26L22 9.27l-5 4.87 1.18 6.88L12 17.77l-6.18 3.25L7 14.14 2 9.27l6.91-1.01L12 2z" />
|
||||
</svg>
|
||||
<span className="text-xs font-mono text-zinc-400 group-hover:text-white transition-colors">{stats.stars}</span>
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
@@ -131,113 +65,16 @@ export default function App(): React.ReactElement {
|
||||
</nav>
|
||||
|
||||
<main className="pt-14">
|
||||
<Hero version={stats.version} stars={stats.stars} />
|
||||
|
||||
<div className="border-b border-zinc-800/50 py-2.5" style={{ background: 'linear-gradient(to bottom, rgba(9,9,11,0.95), rgba(0,0,0,1))' }}>
|
||||
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
|
||||
<div className="flex items-center justify-center gap-4 sm:gap-6 text-xs font-mono">
|
||||
<a
|
||||
href="https://www.npmjs.com/package/skillkit"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="flex items-center gap-1.5 text-zinc-500 hover:text-white transition-colors group"
|
||||
>
|
||||
<span className="text-zinc-600 group-hover:text-zinc-400">v</span>
|
||||
<span className="text-white font-medium">{stats.version}</span>
|
||||
</a>
|
||||
<span className="text-zinc-800">·</span>
|
||||
<a
|
||||
href="https://www.npmjs.com/package/skillkit"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="flex items-center gap-1.5 text-zinc-500 hover:text-white transition-colors group"
|
||||
>
|
||||
<svg className="w-3 h-3 text-zinc-600 group-hover:text-zinc-400" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-4l-4 4m0 0l-4-4m4 4V4" />
|
||||
</svg>
|
||||
<span className="text-white font-medium">{stats.downloads}</span>
|
||||
</a>
|
||||
<span className="text-zinc-800">·</span>
|
||||
<a
|
||||
href="https://github.com/rohitg00/skillkit"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="flex items-center gap-1.5 text-zinc-500 hover:text-white transition-colors group"
|
||||
>
|
||||
<svg className="w-3 h-3 text-zinc-600 group-hover:text-yellow-500" fill="currentColor" viewBox="0 0 24 24">
|
||||
<path d="M12 2l3.09 6.26L22 9.27l-5 4.87 1.18 6.88L12 17.77l-6.18 3.25L7 14.14 2 9.27l6.91-1.01L12 2z" />
|
||||
</svg>
|
||||
<span className="text-white font-medium">{stats.stars}</span>
|
||||
</a>
|
||||
<span className="text-zinc-800 hidden sm:inline">·</span>
|
||||
<a
|
||||
href="https://www.producthunt.com/products/skillkit-2?embed=true&utm_source=badge-featured&utm_medium=badge&utm_campaign=badge-skillkit-2"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="hidden sm:inline-flex items-center hover:opacity-80 transition-opacity"
|
||||
>
|
||||
<img
|
||||
src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1071813&theme=dark"
|
||||
alt="SkillKit on Product Hunt"
|
||||
height="28"
|
||||
style={{ height: '28px', width: 'auto' }}
|
||||
/>
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Agent Support - Quick visual proof */}
|
||||
<Hero />
|
||||
<Agents />
|
||||
|
||||
{/* Core Features & Comparison - Value prop at a glance */}
|
||||
<Features />
|
||||
|
||||
{/* Trending Skills - Social proof, what's popular */}
|
||||
<section id="trending" style={{ scrollMarginTop: '4rem' }}>
|
||||
<TrendingSkills />
|
||||
</section>
|
||||
|
||||
{/* Stack Builder - Interactive, engaging */}
|
||||
<section id="stack" style={{ scrollMarginTop: '4rem' }}>
|
||||
<StackBuilder />
|
||||
</section>
|
||||
|
||||
{/* Compatibility Matrix */}
|
||||
<section id="matrix" style={{ scrollMarginTop: '4rem' }}>
|
||||
<CompatibilityMatrix />
|
||||
</section>
|
||||
|
||||
{/* Badge Generator */}
|
||||
<section id="badge" style={{ scrollMarginTop: '4rem' }}>
|
||||
<BadgeGenerator />
|
||||
</section>
|
||||
|
||||
{/* Advanced Capabilities: Memory, Primer, Mesh, Messaging */}
|
||||
<section id="advanced" style={{ scrollMarginTop: '4rem' }}>
|
||||
<AdvancedFeatures />
|
||||
</section>
|
||||
|
||||
{/* Commands Reference */}
|
||||
<Commands />
|
||||
|
||||
{/* Real-World Use Cases */}
|
||||
<section id="use-cases" style={{ scrollMarginTop: '4rem' }}>
|
||||
<UseCases />
|
||||
</section>
|
||||
|
||||
{/* Team & Enterprise */}
|
||||
<section id="team" style={{ scrollMarginTop: '4rem' }}>
|
||||
<TeamEnterprise />
|
||||
</section>
|
||||
|
||||
{/* Skill Generator */}
|
||||
<section id="skills" className="py-12 border-b border-zinc-800" style={{ scrollMarginTop: '4rem' }}>
|
||||
<section id="skills" className="py-12 border-b border-zinc-800">
|
||||
<SkillGenerator />
|
||||
</section>
|
||||
|
||||
{/* Submit Skill */}
|
||||
<section id="submit" className="py-12 border-b border-zinc-800" style={{ backgroundColor: '#09090b', scrollMarginTop: '4rem' }}>
|
||||
<section id="submit" 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="text-center mb-8">
|
||||
<h2 className="text-2xl font-bold text-white mb-2 font-mono">Submit Your Skill</h2>
|
||||
@@ -248,11 +85,6 @@ export default function App(): React.ReactElement {
|
||||
<SkillSubmitForm />
|
||||
</div>
|
||||
</section>
|
||||
|
||||
{/* Attribution & Sources */}
|
||||
<section id="sources" style={{ scrollMarginTop: '4rem' }}>
|
||||
<Attribution />
|
||||
</section>
|
||||
</main>
|
||||
|
||||
<Footer />
|
||||
|
||||
@@ -1,230 +0,0 @@
|
||||
import React, { useState } from 'react';
|
||||
|
||||
interface AdvancedFeature {
|
||||
id: string;
|
||||
title: string;
|
||||
subtitle: string;
|
||||
description: string;
|
||||
icon: React.ReactNode;
|
||||
commands: Array<{ cmd: string; desc: string }>;
|
||||
highlight: string;
|
||||
}
|
||||
|
||||
const ADVANCED_FEATURES: AdvancedFeature[] = [
|
||||
{
|
||||
id: 'generate',
|
||||
title: 'AI Generate',
|
||||
subtitle: 'Create Skills from Natural Language',
|
||||
description: 'Generate skills from plain English with multi-source context. Pulls from documentation (Context7), your codebase patterns, 15,000+ marketplace skills, and your corrections. Works with any LLM: Claude, GPT-4, Gemini, Ollama, or OpenRouter.',
|
||||
highlight: 'Multi-provider AI with 4 context sources',
|
||||
icon: (
|
||||
<svg className="w-8 h-8" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M13 10V3L4 14h7v7l9-11h-7z" />
|
||||
</svg>
|
||||
),
|
||||
commands: [
|
||||
{ cmd: 'generate', desc: 'Interactive skill wizard' },
|
||||
{ cmd: 'generate --provider openai', desc: 'Use specific LLM' },
|
||||
{ cmd: 'generate --compose "testing"', desc: 'Compose from skills' },
|
||||
{ cmd: 'generate --agents claude,cursor', desc: 'Multi-agent output' },
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'memory',
|
||||
title: 'Session Memory',
|
||||
subtitle: 'AI That Actually Learns',
|
||||
description: 'Your AI agents learn patterns during sessions—then forget everything. SkillKit captures these learnings and makes them permanent. Knowledge persists across sessions, projects, and even different agents.',
|
||||
highlight: 'Persistent learning across all agents',
|
||||
icon: (
|
||||
<svg className="w-8 h-8" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9.663 17h4.673M12 3v1m6.364 1.636l-.707.707M21 12h-1M4 12H3m3.343-5.657l-.707-.707m2.828 9.9a5 5 0 117.072 0l-.548.547A3.374 3.374 0 0014 18.469V19a2 2 0 11-4 0v-.531c0-.895-.356-1.754-.988-2.386l-.548-.547z" />
|
||||
</svg>
|
||||
),
|
||||
commands: [
|
||||
{ cmd: 'memory compress', desc: 'Turn observations into learnings' },
|
||||
{ cmd: 'memory search "auth"', desc: 'Find past patterns' },
|
||||
{ cmd: 'memory export', desc: 'Convert to shareable skill' },
|
||||
{ cmd: 'memory --global', desc: 'Share across all projects' },
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'primer',
|
||||
title: 'Primer',
|
||||
subtitle: 'Zero-Config AI Instructions',
|
||||
description: 'Automatically generate CLAUDE.md, .cursorrules, and agent instructions by analyzing your codebase. Detects your tech stack, coding patterns, and project structure—then creates optimized instructions for all 32 agents.',
|
||||
highlight: 'Auto-generates instructions for 32 agents',
|
||||
icon: (
|
||||
<svg className="w-8 h-8" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-3 7h3m-3 4h3m-6-4h.01M9 16h.01" />
|
||||
</svg>
|
||||
),
|
||||
commands: [
|
||||
{ cmd: 'primer', desc: 'Analyze & generate for detected agents' },
|
||||
{ cmd: 'primer --all-agents', desc: 'Generate for all 32 agents' },
|
||||
{ cmd: 'primer --analyze-only', desc: 'Preview codebase analysis' },
|
||||
{ cmd: 'primer --json', desc: 'Machine-readable output' },
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'mesh',
|
||||
title: 'Mesh Network',
|
||||
subtitle: 'Multi-Machine Agent Distribution',
|
||||
description: 'Run agents across multiple machines with encrypted P2P communication. Discover peers on your LAN, establish trust with Ed25519 keys, and distribute skills across your entire infrastructure.',
|
||||
highlight: 'Encrypted P2P agent network',
|
||||
icon: (
|
||||
<svg className="w-8 h-8" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M21 12a9 9 0 01-9 9m9-9a9 9 0 00-9-9m9 9H3m9 9a9 9 0 01-9-9m9 9c1.657 0 3-4.03 3-9s-1.343-9-3-9m0 18c-1.657 0-3-4.03-3-9s1.343-9 3-9m-9 9a9 9 0 019-9" />
|
||||
</svg>
|
||||
),
|
||||
commands: [
|
||||
{ cmd: 'mesh init', desc: 'Initialize your mesh node' },
|
||||
{ cmd: 'mesh discover', desc: 'Find peers on LAN' },
|
||||
{ cmd: 'mesh security init', desc: 'Setup Ed25519 encryption' },
|
||||
{ cmd: 'mesh peer trust <id>', desc: 'Establish peer trust' },
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'messaging',
|
||||
title: 'Inter-Agent Messaging',
|
||||
subtitle: 'Agents That Communicate',
|
||||
description: 'Send messages between AI agents across your mesh network. Coordinate complex tasks, share context, and build multi-agent workflows where agents collaborate to solve problems.',
|
||||
highlight: 'Agents collaborate across machines',
|
||||
icon: (
|
||||
<svg className="w-8 h-8" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M8 12h.01M12 12h.01M16 12h.01M21 12c0 4.418-4.03 8-9 8a9.863 9.863 0 01-4.255-.949L3 20l1.395-3.72C3.512 15.042 3 13.574 3 12c0-4.418 4.03-8 9-8s9 3.582 9 8z" />
|
||||
</svg>
|
||||
),
|
||||
commands: [
|
||||
{ cmd: 'message send', desc: 'Send to another agent' },
|
||||
{ cmd: 'message inbox', desc: 'Check your inbox' },
|
||||
{ cmd: 'message reply <id>', desc: 'Reply to messages' },
|
||||
{ cmd: 'message archive', desc: 'Archive old messages' },
|
||||
],
|
||||
},
|
||||
];
|
||||
|
||||
export function AdvancedFeatures(): React.ReactElement {
|
||||
const [activeFeature, setActiveFeature] = useState<string>('generate');
|
||||
const feature = ADVANCED_FEATURES.find(f => f.id === activeFeature) || ADVANCED_FEATURES[0];
|
||||
|
||||
return (
|
||||
<section className="py-12 sm:py-16 border-b border-zinc-800 relative overflow-hidden">
|
||||
{/* Gradient background */}
|
||||
<div className="absolute inset-0 bg-gradient-to-b from-zinc-950 via-zinc-900/50 to-zinc-950"></div>
|
||||
<div className="absolute inset-0 bg-[radial-gradient(ellipse_at_top,rgba(255,255,255,0.03),transparent_50%)]"></div>
|
||||
|
||||
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8 relative">
|
||||
{/* Section Header */}
|
||||
<div className="text-center mb-8 sm:mb-12">
|
||||
<div className="inline-flex items-center gap-2 border border-zinc-700 bg-zinc-900/80 px-2 sm:px-3 py-1 mb-4 backdrop-blur-sm">
|
||||
<span className="w-1.5 h-1.5 bg-emerald-400 rounded-full animate-pulse"></span>
|
||||
<span className="text-[10px] sm:text-xs font-mono text-zinc-300 uppercase tracking-wider">Beyond Installation</span>
|
||||
</div>
|
||||
<h2 className="text-2xl sm:text-3xl lg:text-4xl font-bold text-white mb-3 font-mono tracking-tight">
|
||||
Advanced Capabilities
|
||||
</h2>
|
||||
<p className="text-zinc-400 font-mono text-xs sm:text-sm max-w-2xl mx-auto px-4">
|
||||
SkillKit isn't just a package manager. It's a complete infrastructure for
|
||||
intelligent, distributed AI agent orchestration.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
{/* Feature Tabs */}
|
||||
<div className="flex justify-center gap-1 sm:gap-2 mb-8 flex-wrap" role="tablist" aria-label="Advanced features">
|
||||
{ADVANCED_FEATURES.map((f) => {
|
||||
const isActive = f.id === activeFeature;
|
||||
return (
|
||||
<button
|
||||
key={f.id}
|
||||
role="tab"
|
||||
aria-selected={isActive}
|
||||
aria-controls="advanced-features-panel"
|
||||
id={`tab-${f.id}`}
|
||||
onClick={() => setActiveFeature(f.id)}
|
||||
className={`group relative px-2 sm:px-4 py-1.5 sm:py-2 font-mono text-xs sm:text-sm transition-all duration-300 ${
|
||||
isActive
|
||||
? 'text-white'
|
||||
: 'text-zinc-500 hover:text-zinc-300'
|
||||
}`}
|
||||
>
|
||||
<span className="relative z-10">{f.title}</span>
|
||||
{isActive && (
|
||||
<div className="absolute inset-0 bg-gradient-to-r from-zinc-800 to-zinc-700 border border-zinc-600"></div>
|
||||
)}
|
||||
</button>
|
||||
);
|
||||
})}
|
||||
</div>
|
||||
|
||||
{/* Feature Content */}
|
||||
<div
|
||||
className="grid grid-cols-1 lg:grid-cols-2 gap-6 sm:gap-8 items-start"
|
||||
role="tabpanel"
|
||||
id="advanced-features-panel"
|
||||
aria-labelledby={`tab-${activeFeature}`}
|
||||
>
|
||||
{/* Left: Description */}
|
||||
<div className="space-y-4 sm:space-y-6">
|
||||
<div className="flex items-start gap-3 sm:gap-4">
|
||||
<div className="p-2 sm:p-3 bg-zinc-800/50 border border-zinc-700 text-white flex-shrink-0">
|
||||
{feature.icon}
|
||||
</div>
|
||||
<div>
|
||||
<h3 className="text-xl sm:text-2xl font-bold text-white font-mono mb-1">
|
||||
{feature.title}
|
||||
</h3>
|
||||
<p className="text-zinc-500 font-mono text-xs sm:text-sm">
|
||||
{feature.subtitle}
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<p className="text-zinc-300 leading-relaxed text-sm sm:text-base">
|
||||
{feature.description}
|
||||
</p>
|
||||
|
||||
<div className="inline-flex items-center gap-2 bg-emerald-950/30 border border-emerald-800/50 px-2 sm:px-3 py-1.5 sm:py-2">
|
||||
<svg className="w-3 h-3 sm:w-4 sm:h-4 text-emerald-400 flex-shrink-0" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M5 13l4 4L19 7" />
|
||||
</svg>
|
||||
<span className="text-emerald-300 text-xs sm:text-sm font-mono">{feature.highlight}</span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Right: Commands */}
|
||||
<div className="bg-black/60 border border-zinc-800 backdrop-blur-sm">
|
||||
<div className="flex items-center gap-1.5 px-4 py-3 border-b border-zinc-800 bg-zinc-900/50">
|
||||
<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>
|
||||
<span className="ml-2 text-zinc-500 text-xs font-mono">Terminal</span>
|
||||
</div>
|
||||
<div className="p-3 sm:p-4 space-y-3">
|
||||
{feature.commands.map((cmd, index) => (
|
||||
<div key={index} className="group">
|
||||
<div className="flex items-center gap-2 overflow-x-auto">
|
||||
<span className="text-zinc-600 font-mono text-xs flex-shrink-0">$</span>
|
||||
<code className="text-white font-mono text-xs sm:text-sm whitespace-nowrap">skillkit {cmd.cmd}</code>
|
||||
</div>
|
||||
<div className="pl-4 mt-1">
|
||||
<span className="text-zinc-500 font-mono text-[10px] sm:text-xs">→ {cmd.desc}</span>
|
||||
</div>
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Bottom CTA */}
|
||||
<div className="mt-12 pt-8 border-t border-zinc-800/50 text-center">
|
||||
<p className="text-zinc-500 text-sm font-mono mb-4">
|
||||
Ready to supercharge your AI agents?
|
||||
</p>
|
||||
<code className="inline-block bg-zinc-900 border border-zinc-700 px-4 py-2 text-sm font-mono text-zinc-300">
|
||||
npx skillkit@latest
|
||||
</code>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
@@ -1,101 +0,0 @@
|
||||
import React from 'react';
|
||||
|
||||
const OFFICIAL_SOURCES = [
|
||||
{ repo: 'anthropics/skills', name: 'Anthropic' },
|
||||
{ repo: 'vercel-labs/agent-skills', name: 'Vercel' },
|
||||
{ repo: 'expo/skills', name: 'Expo' },
|
||||
{ repo: 'remotion-dev/skills', name: 'Remotion' },
|
||||
{ repo: 'supabase/agent-skills', name: 'Supabase' },
|
||||
{ repo: 'stripe/ai', name: 'Stripe' },
|
||||
];
|
||||
|
||||
const COMMUNITY_SOURCES = [
|
||||
'trailofbits/skills',
|
||||
'obra/superpowers',
|
||||
'wshobson/agents',
|
||||
'ComposioHQ/awesome-claude-skills',
|
||||
'travisvn/awesome-claude-skills',
|
||||
'mhattingpete/claude-skills-marketplace',
|
||||
'langgenius/dify',
|
||||
'better-auth/skills',
|
||||
'onmax/nuxt-skills',
|
||||
'elysiajs/skills',
|
||||
'kadajett/agent-nestjs-skills',
|
||||
'cloudai-x/threejs-skills',
|
||||
'dimillian/skills',
|
||||
'waynesutton/convexskills',
|
||||
'kepano/obsidian-skills',
|
||||
'giuseppe-trisciuoglio/developer-kit',
|
||||
'openrouterteam/agent-skills',
|
||||
'intellectronica/agent-skills',
|
||||
];
|
||||
|
||||
export function Attribution(): React.ReactElement {
|
||||
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">Skill Sources</h2>
|
||||
<p className="text-zinc-500 font-mono text-xs">
|
||||
Skills aggregated from open source repositories
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div className="mb-8">
|
||||
<div className="text-xs font-mono text-zinc-500 uppercase tracking-wider mb-4">
|
||||
Official
|
||||
</div>
|
||||
<div className="flex flex-wrap gap-2">
|
||||
{OFFICIAL_SOURCES.map(source => (
|
||||
<a
|
||||
key={source.repo}
|
||||
href={`https://github.com/${source.repo}`}
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="inline-flex items-center gap-2 bg-zinc-900 border border-zinc-800 px-3 py-2 hover:border-zinc-600 hover:text-white transition-colors text-zinc-400 font-mono text-xs"
|
||||
>
|
||||
<svg className="w-4 h-4" 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>
|
||||
{source.name}
|
||||
</a>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="mb-8">
|
||||
<div className="text-xs font-mono text-zinc-500 uppercase tracking-wider mb-4">
|
||||
Community
|
||||
</div>
|
||||
<div className="flex flex-wrap gap-1.5">
|
||||
{COMMUNITY_SOURCES.map(repo => (
|
||||
<a
|
||||
key={repo}
|
||||
href={`https://github.com/${repo}`}
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="text-zinc-600 hover:text-white transition-colors font-mono text-[11px] px-2 py-1 bg-zinc-900/50 border border-zinc-800/50 hover:border-zinc-700"
|
||||
>
|
||||
{repo}
|
||||
</a>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="pt-6 border-t border-zinc-800 text-center">
|
||||
<a
|
||||
href="https://github.com/rohitg00/skillkit/issues/new?template=add-source.md"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="inline-flex items-center gap-2 text-zinc-500 hover:text-white transition-colors font-mono text-xs"
|
||||
>
|
||||
<svg className="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M12 6v6m0 0v6m0-6h6m-6 0H6" />
|
||||
</svg>
|
||||
Add your repository
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
@@ -1,201 +0,0 @@
|
||||
import React, { useState, useMemo } from 'react';
|
||||
|
||||
const SKILLKIT_LOGO_SVG_BASE64 =
|
||||
'PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0id2hpdGUiPjxyZWN0IHdpZHRoPSI2IiBoZWlnaHQ9IjYiIHg9IjEiIHk9IjEiLz48cmVjdCB3aWR0aD0iNiIgaGVpZ2h0PSI2IiB4PSI5IiB5PSIxIi8+PHJlY3Qgd2lkdGg9IjYiIGhlaWdodD0iNiIgeD0iMSIgeT0iOSIvPjxyZWN0IHdpZHRoPSI2IiBoZWlnaHQ9IjYiIHg9IjkiIHk9IjkiLz48L3N2Zz4=';
|
||||
|
||||
const SUGGESTED_SKILLS = [
|
||||
'react', 'typescript', 'nextjs', 'python', 'docker',
|
||||
'kubernetes', 'tailwind', 'graphql', 'prisma', 'langchain',
|
||||
'openai', 'rust', 'go', 'vue', 'svelte',
|
||||
'security', 'testing', 'cicd', 'aws', 'terraform',
|
||||
];
|
||||
|
||||
function encodeBadgeSegment(text: string): string {
|
||||
return encodeURIComponent(text).replace(/-/g, '--');
|
||||
}
|
||||
|
||||
function buildBadgeUrl(skills: string[]): string {
|
||||
if (skills.length === 0) {
|
||||
return `https://img.shields.io/badge/SkillKit-No%20Skills-555555?style=flat-square&logo=data:image/svg+xml;base64,${SKILLKIT_LOGO_SVG_BASE64}`;
|
||||
}
|
||||
|
||||
const maxDisplay = 5;
|
||||
const displayNames = skills.slice(0, maxDisplay);
|
||||
const suffix = skills.length > maxDisplay ? ` +${skills.length - maxDisplay} more` : '';
|
||||
const label = `SkillKit ${skills.length} skills`;
|
||||
const message = displayNames.join(' | ') + suffix;
|
||||
|
||||
return `https://img.shields.io/badge/${encodeBadgeSegment(label)}-${encodeBadgeSegment(message)}-black?style=flat-square&logo=data:image/svg+xml;base64,${SKILLKIT_LOGO_SVG_BASE64}`;
|
||||
}
|
||||
|
||||
export function BadgeGenerator(): React.ReactElement {
|
||||
const [skills, setSkills] = useState<string[]>(['react', 'typescript', 'nextjs']);
|
||||
const [inputValue, setInputValue] = useState('');
|
||||
const [copiedType, setCopiedType] = useState<string | null>(null);
|
||||
|
||||
const badgeUrl = useMemo(() => buildBadgeUrl(skills), [skills]);
|
||||
|
||||
const markdown = `[](https://agenstskills.com)`;
|
||||
const html = `<a href="https://agenstskills.com"><img src="${badgeUrl}" alt="SkillKit Stack" /></a>`;
|
||||
|
||||
function addSkill(skill: string): void {
|
||||
const trimmed = skill.trim().toLowerCase();
|
||||
if (trimmed && !skills.includes(trimmed)) {
|
||||
setSkills([...skills, trimmed]);
|
||||
}
|
||||
setInputValue('');
|
||||
}
|
||||
|
||||
function removeSkill(skill: string): void {
|
||||
setSkills(skills.filter(s => s !== skill));
|
||||
}
|
||||
|
||||
function handleKeyDown(e: React.KeyboardEvent<HTMLInputElement>): void {
|
||||
if (e.key === 'Enter' && inputValue.trim()) {
|
||||
e.preventDefault();
|
||||
addSkill(inputValue);
|
||||
}
|
||||
}
|
||||
|
||||
async function copyToClipboard(text: string, type: string): Promise<void> {
|
||||
try {
|
||||
await navigator.clipboard.writeText(text);
|
||||
setCopiedType(type);
|
||||
setTimeout(() => setCopiedType(null), 2000);
|
||||
} catch {
|
||||
// silently ignore
|
||||
}
|
||||
}
|
||||
|
||||
const availableSuggestions = SUGGESTED_SKILLS.filter(s => !skills.includes(s));
|
||||
|
||||
return (
|
||||
<section className="py-12 border-b border-zinc-800">
|
||||
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
|
||||
<div className="mb-6">
|
||||
<h2 className="text-xl font-bold text-white mb-1 font-mono">Badge Generator</h2>
|
||||
<p className="text-zinc-500 font-mono text-xs">
|
||||
Create a shareable badge for your skill stack. Add it to your README.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div className="flex flex-col lg:flex-row gap-6">
|
||||
<div className="flex-1 space-y-4">
|
||||
<div className="relative">
|
||||
<input
|
||||
type="text"
|
||||
value={inputValue}
|
||||
onChange={(e) => setInputValue(e.target.value)}
|
||||
onKeyDown={handleKeyDown}
|
||||
placeholder="Type a skill name and press Enter..."
|
||||
className="w-full bg-zinc-900 border border-zinc-700 text-white px-4 py-3 focus:ring-2 focus:ring-white focus:border-transparent outline-none font-mono text-sm placeholder-zinc-600"
|
||||
/>
|
||||
</div>
|
||||
|
||||
<div className="space-y-2">
|
||||
<span className="text-zinc-500 text-xs font-mono block">Quick add:</span>
|
||||
<div className="flex flex-wrap gap-1.5">
|
||||
{availableSuggestions.slice(0, 12).map(skill => (
|
||||
<button
|
||||
key={skill}
|
||||
onClick={() => addSkill(skill)}
|
||||
className="text-[10px] sm:text-xs bg-zinc-900 text-zinc-400 px-2 sm:px-3 py-1 sm:py-1.5 border border-zinc-700 hover:border-zinc-500 hover:text-white transition-colors font-mono"
|
||||
>
|
||||
+ {skill}
|
||||
</button>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{skills.length > 0 && (
|
||||
<div className="space-y-2">
|
||||
<div className="flex items-center justify-between">
|
||||
<div className="text-xs font-mono text-zinc-500 uppercase tracking-wider">
|
||||
Skills in Badge ({skills.length})
|
||||
</div>
|
||||
<button
|
||||
onClick={() => setSkills([])}
|
||||
className="text-zinc-500 hover:text-red-400 font-mono text-xs transition-colors"
|
||||
>
|
||||
Clear All
|
||||
</button>
|
||||
</div>
|
||||
<div className="flex flex-wrap gap-2">
|
||||
{skills.map(skill => (
|
||||
<div
|
||||
key={skill}
|
||||
className="flex items-center gap-1.5 bg-zinc-900/50 border border-zinc-800 px-3 py-1.5 group"
|
||||
>
|
||||
<span className="font-mono text-sm text-white">{skill}</span>
|
||||
<button
|
||||
onClick={() => removeSkill(skill)}
|
||||
aria-label={`Remove ${skill}`}
|
||||
className="text-zinc-600 hover:text-red-400 transition-colors opacity-0 group-hover:opacity-100 focus-visible:opacity-100"
|
||||
>
|
||||
<svg className="w-3 h-3" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M6 18L18 6M6 6l12 12" />
|
||||
</svg>
|
||||
</button>
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
|
||||
<div className="lg:w-80 lg:flex-shrink-0">
|
||||
<div className="lg:sticky lg:top-20 bg-zinc-900/30 border border-zinc-800 p-4 space-y-4">
|
||||
<div className="text-xs font-mono text-zinc-500 uppercase tracking-wider">Preview</div>
|
||||
|
||||
<div className="flex justify-center py-3 bg-black/50 border border-zinc-800">
|
||||
{skills.length > 0 ? (
|
||||
<img
|
||||
src={badgeUrl}
|
||||
alt="SkillKit Stack Badge"
|
||||
className="h-5"
|
||||
/>
|
||||
) : (
|
||||
<span className="text-zinc-600 text-xs font-mono">Add skills to preview</span>
|
||||
)}
|
||||
</div>
|
||||
|
||||
<div className="space-y-2">
|
||||
<div className="text-xs font-mono text-zinc-500">Markdown</div>
|
||||
<pre className="bg-black/50 p-2 overflow-x-auto text-[10px] border border-zinc-800">
|
||||
<code className="font-mono text-zinc-300 whitespace-pre-wrap break-all">
|
||||
{markdown}
|
||||
</code>
|
||||
</pre>
|
||||
<button
|
||||
onClick={() => copyToClipboard(markdown, 'markdown')}
|
||||
className="w-full bg-zinc-800 text-zinc-300 py-1.5 font-mono text-xs hover:bg-zinc-700 hover:text-white transition-colors flex items-center justify-center gap-1.5 border border-zinc-700"
|
||||
>
|
||||
{copiedType === 'markdown' ? 'Copied!' : 'Copy Markdown'}
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<div className="space-y-2">
|
||||
<div className="text-xs font-mono text-zinc-500">HTML</div>
|
||||
<pre className="bg-black/50 p-2 overflow-x-auto text-[10px] border border-zinc-800">
|
||||
<code className="font-mono text-zinc-300 whitespace-pre-wrap break-all">
|
||||
{html}
|
||||
</code>
|
||||
</pre>
|
||||
<button
|
||||
onClick={() => copyToClipboard(html, 'html')}
|
||||
className="w-full bg-zinc-800 text-zinc-300 py-1.5 font-mono text-xs hover:bg-zinc-700 hover:text-white transition-colors flex items-center justify-center gap-1.5 border border-zinc-700"
|
||||
>
|
||||
{copiedType === 'html' ? 'Copied!' : 'Copy HTML'}
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<div className="text-[10px] font-mono text-zinc-600 text-center pt-2 border-t border-zinc-800">
|
||||
Powered by shields.io
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
@@ -34,8 +34,7 @@ export function Card({
|
||||
|
||||
return (
|
||||
<div
|
||||
className={`relative border border-zinc-800 transition-colors duration-300 ${paddingClass} ${clickableClass} ${className}`}
|
||||
style={{ backgroundColor: '#000000' }}
|
||||
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}
|
||||
|
||||
@@ -7,101 +7,39 @@ interface CommandGroup {
|
||||
|
||||
const COMMAND_GROUPS: CommandGroup[] = [
|
||||
{
|
||||
name: 'Start',
|
||||
name: 'Core',
|
||||
commands: [
|
||||
{ cmd: '', desc: 'Launch interactive TUI' },
|
||||
{ cmd: 'install <repo>', desc: 'Install from GitHub' },
|
||||
{ cmd: 'add <repo>', desc: 'Alias for install' },
|
||||
{ cmd: 'recommend', desc: 'Smart suggestions' },
|
||||
{ cmd: 'tree', desc: 'Browse skill taxonomy' },
|
||||
{ cmd: 'marketplace', desc: 'Browse skills' },
|
||||
{ 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: 'Manage',
|
||||
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' },
|
||||
{ cmd: 'sync', desc: 'Deploy to all agents' },
|
||||
{ cmd: 'translate --to <agent>', desc: 'Convert formats' },
|
||||
{ cmd: 'update', desc: 'Update all skills' },
|
||||
{ cmd: 'remove <skill>', desc: 'Remove a skill' },
|
||||
{ cmd: 'status', desc: 'Show skill status' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Mesh',
|
||||
commands: [
|
||||
{ cmd: 'mesh init', desc: 'Initialize network' },
|
||||
{ cmd: 'mesh discover', desc: 'Find hosts on LAN' },
|
||||
{ cmd: 'mesh add <host>', desc: 'Add a host' },
|
||||
{ cmd: 'mesh security init', desc: 'Setup encryption' },
|
||||
{ cmd: 'mesh peer trust', desc: 'Trust a peer' },
|
||||
{ cmd: 'mesh health', desc: 'Check host health' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Message',
|
||||
commands: [
|
||||
{ cmd: 'message send', desc: 'Send to agent' },
|
||||
{ cmd: 'message inbox', desc: 'View inbox' },
|
||||
{ cmd: 'message read <id>', desc: 'Read message' },
|
||||
{ cmd: 'message reply <id>', desc: 'Reply to message' },
|
||||
{ cmd: 'message archive', desc: 'Archive messages' },
|
||||
{ cmd: 'message sent', desc: 'View sent' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Memory',
|
||||
commands: [
|
||||
{ cmd: 'memory status', desc: 'View memory status' },
|
||||
{ cmd: 'memory search <q>', desc: 'Search learnings' },
|
||||
{ cmd: 'memory compress', desc: 'Compress observations' },
|
||||
{ cmd: 'memory export', desc: 'Export as skill' },
|
||||
{ cmd: 'memory reinforce', desc: 'Boost memory' },
|
||||
{ cmd: 'memory --global', desc: 'Global memory' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Team',
|
||||
commands: [
|
||||
{ cmd: 'manifest init', desc: 'Create .skills file' },
|
||||
{ cmd: 'team init', desc: 'Initialize team' },
|
||||
{ cmd: 'team share', desc: 'Share via Git' },
|
||||
{ cmd: 'manifest install', desc: 'Install from manifest' },
|
||||
{ cmd: 'team share', desc: 'Share skills via Git' },
|
||||
{ cmd: 'publish', desc: 'Submit to marketplace' },
|
||||
{ cmd: 'cicd init', desc: 'CI/CD templates' },
|
||||
{ cmd: 'team sync', desc: 'Sync team skills' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Server',
|
||||
commands: [
|
||||
{ cmd: 'serve', desc: 'Start REST API' },
|
||||
{ cmd: 'serve --port 8080', desc: 'Custom port' },
|
||||
{ cmd: 'serve --host localhost', desc: 'Bind host' },
|
||||
{ cmd: 'serve --cors "*"', desc: 'Set CORS origin' },
|
||||
{ cmd: 'serve --cache-ttl 3600000', desc: 'Cache TTL' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Security',
|
||||
commands: [
|
||||
{ cmd: 'scan <path>', desc: 'Security scan' },
|
||||
{ cmd: 'scan --format sarif', desc: 'SARIF output' },
|
||||
{ cmd: 'scan --fail-on high', desc: 'CI gate' },
|
||||
{ cmd: 'install --no-scan', desc: 'Skip scan' },
|
||||
{ cmd: 'audit log', desc: 'View audit logs' },
|
||||
{ cmd: 'validate', desc: 'Validate format' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Advanced',
|
||||
commands: [
|
||||
{ cmd: 'primer', desc: 'Generate CLAUDE.md' },
|
||||
{ cmd: 'agent translate', desc: 'Batch convert' },
|
||||
{ cmd: 'command generate', desc: 'Create /commands' },
|
||||
{ cmd: 'context init', desc: 'Project context' },
|
||||
{ cmd: 'workflow run', desc: 'Run workflow' },
|
||||
{ cmd: 'test', desc: 'Test skills' },
|
||||
{ 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' },
|
||||
],
|
||||
},
|
||||
];
|
||||
@@ -114,13 +52,13 @@ 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">50+ 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>
|
||||
</div>
|
||||
|
||||
<div className="flex justify-center gap-1.5 sm:gap-2 mb-4 sm:mb-6 flex-wrap">
|
||||
<div className="flex justify-center gap-2 mb-6">
|
||||
{COMMAND_GROUPS.map((g, i) => {
|
||||
const isActive = i === activeGroup;
|
||||
const buttonClass = isActive
|
||||
@@ -130,7 +68,7 @@ export function Commands(): React.ReactElement {
|
||||
<button
|
||||
key={g.name}
|
||||
onClick={() => setActiveGroup(i)}
|
||||
className={`px-2 sm:px-3 py-1 sm:py-1.5 text-[10px] sm:text-xs font-mono border transition-colors ${buttonClass}`}
|
||||
className={`px-3 py-1.5 text-xs font-mono border transition-colors ${buttonClass}`}
|
||||
>
|
||||
{g.name}
|
||||
</button>
|
||||
@@ -138,26 +76,24 @@ export function Commands(): React.ReactElement {
|
||||
})}
|
||||
</div>
|
||||
|
||||
<div className="border border-zinc-800 bg-black/50 p-3 sm:p-4 font-mono text-[10px] sm:text-xs">
|
||||
<div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-1 sm:gap-2">
|
||||
<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 || 'tui'}
|
||||
className="flex items-center gap-2 p-2 hover:bg-zinc-900/50 transition-colors rounded group"
|
||||
key={c.cmd}
|
||||
className="flex items-center gap-3 p-2 hover:bg-zinc-900/50 transition-colors rounded"
|
||||
>
|
||||
<span className="text-zinc-700 group-hover:text-zinc-500">$</span>
|
||||
<code className="text-white text-[10px] sm:text-xs whitespace-nowrap">
|
||||
{c.cmd ? `skillkit ${c.cmd}` : 'npx skillkit@latest'}
|
||||
</code>
|
||||
<span className="text-zinc-700 ml-auto hidden sm:inline">→</span>
|
||||
<span className="text-zinc-500 text-[9px] sm:text-[11px] hidden sm:inline">{c.desc}</span>
|
||||
<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-3 sm:mt-4 text-center">
|
||||
<span className="text-zinc-600 text-[10px] sm:text-xs font-mono">
|
||||
<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>
|
||||
|
||||
@@ -1,351 +0,0 @@
|
||||
import React, { useState, useMemo } from 'react';
|
||||
|
||||
type Support = 'full' | 'partial' | 'none';
|
||||
|
||||
interface AgentDef {
|
||||
id: string;
|
||||
name: string;
|
||||
icon: string;
|
||||
group: string;
|
||||
}
|
||||
|
||||
interface CategoryDef {
|
||||
id: string;
|
||||
name: string;
|
||||
icon: string;
|
||||
}
|
||||
|
||||
const AGENTS: AgentDef[] = [
|
||||
{ id: 'claude-code', name: 'Claude Code', icon: '\u27C1', group: 'Tier 1' },
|
||||
{ id: 'cursor', name: 'Cursor', icon: '\u25EB', group: 'Tier 1' },
|
||||
{ id: 'codex', name: 'Codex', icon: '\u25CE', group: 'Tier 1' },
|
||||
{ id: 'gemini-cli', name: 'Gemini CLI', icon: '\u2726', group: 'Tier 1' },
|
||||
{ id: 'opencode', name: 'OpenCode', icon: '\u2B21', group: 'Tier 1' },
|
||||
{ id: 'windsurf', name: 'Windsurf', icon: '\u25C7', group: 'Tier 1' },
|
||||
{ id: 'github-copilot', name: 'Copilot', icon: '\u2318', group: 'Tier 1' },
|
||||
{ id: 'goose', name: 'Goose', icon: '\u25CA', group: 'Tier 2' },
|
||||
{ id: 'kilo', name: 'Kilo', icon: '\u25B3', group: 'Tier 2' },
|
||||
{ id: 'kiro-cli', name: 'Kiro CLI', icon: '\u25BD', group: 'Tier 2' },
|
||||
{ id: 'roo', name: 'Roo', icon: '\u25C6', group: 'Tier 2' },
|
||||
{ id: 'trae', name: 'Trae', icon: '\u25A0', group: 'Tier 2' },
|
||||
{ id: 'amp', name: 'AMP', icon: '\u26A1', group: 'Tier 2' },
|
||||
{ id: 'cline', name: 'Cline', icon: '\u25CF', group: 'Tier 3' },
|
||||
{ id: 'continue', name: 'Continue', icon: '\u25B6', group: 'Tier 3' },
|
||||
{ id: 'antigravity', name: 'Antigravity', icon: '\u2191', group: 'Tier 3' },
|
||||
];
|
||||
|
||||
const CATEGORIES: CategoryDef[] = [
|
||||
{ id: 'security', name: 'Security', icon: '\u25D0' },
|
||||
{ id: 'testing', name: 'Testing', icon: '\u25D2' },
|
||||
{ id: 'react-frontend', name: 'React/Frontend', icon: '\u269B' },
|
||||
{ id: 'backend', name: 'Backend', icon: '\u2393' },
|
||||
{ id: 'devops', name: 'DevOps', icon: '\u25D1' },
|
||||
{ id: 'python', name: 'Python', icon: '\u25C9' },
|
||||
{ id: 'go', name: 'Go', icon: '\u25C8' },
|
||||
{ id: 'typescript', name: 'TypeScript', icon: '\u25C8' },
|
||||
{ id: 'database', name: 'Database', icon: '\u25A3' },
|
||||
{ id: 'performance', name: 'Performance', icon: '\u25CE' },
|
||||
{ id: 'documentation', name: 'Documentation', icon: '\u25A1' },
|
||||
{ id: 'ai-ml', name: 'AI/ML', icon: '\u25CE' },
|
||||
];
|
||||
|
||||
const MATRIX: Record<string, Record<string, Support>> = {
|
||||
'security': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'full', 'goose': 'partial',
|
||||
'kilo': 'partial', 'kiro-cli': 'partial', 'roo': 'full', 'trae': 'partial',
|
||||
'amp': 'full', 'cline': 'full', 'continue': 'partial', 'antigravity': 'partial',
|
||||
},
|
||||
'testing': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'full', 'goose': 'full',
|
||||
'kilo': 'partial', 'kiro-cli': 'partial', 'roo': 'full', 'trae': 'partial',
|
||||
'amp': 'full', 'cline': 'full', 'continue': 'full', 'antigravity': 'partial',
|
||||
},
|
||||
'react-frontend': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'partial', 'windsurf': 'full', 'github-copilot': 'full', 'goose': 'partial',
|
||||
'kilo': 'partial', 'kiro-cli': 'partial', 'roo': 'full', 'trae': 'full',
|
||||
'amp': 'full', 'cline': 'full', 'continue': 'full', 'antigravity': 'none',
|
||||
},
|
||||
'backend': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'full', 'goose': 'full',
|
||||
'kilo': 'partial', 'kiro-cli': 'partial', 'roo': 'full', 'trae': 'partial',
|
||||
'amp': 'full', 'cline': 'full', 'continue': 'full', 'antigravity': 'partial',
|
||||
},
|
||||
'devops': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'partial', 'github-copilot': 'full', 'goose': 'partial',
|
||||
'kilo': 'partial', 'kiro-cli': 'none', 'roo': 'partial', 'trae': 'partial',
|
||||
'amp': 'full', 'cline': 'partial', 'continue': 'partial', 'antigravity': 'none',
|
||||
},
|
||||
'python': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'full', 'goose': 'full',
|
||||
'kilo': 'partial', 'kiro-cli': 'partial', 'roo': 'full', 'trae': 'partial',
|
||||
'amp': 'full', 'cline': 'full', 'continue': 'full', 'antigravity': 'partial',
|
||||
},
|
||||
'go': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'partial', 'github-copilot': 'full', 'goose': 'partial',
|
||||
'kilo': 'none', 'kiro-cli': 'none', 'roo': 'partial', 'trae': 'partial',
|
||||
'amp': 'partial', 'cline': 'partial', 'continue': 'partial', 'antigravity': 'none',
|
||||
},
|
||||
'typescript': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'full', 'goose': 'full',
|
||||
'kilo': 'partial', 'kiro-cli': 'partial', 'roo': 'full', 'trae': 'full',
|
||||
'amp': 'full', 'cline': 'full', 'continue': 'full', 'antigravity': 'partial',
|
||||
},
|
||||
'database': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'partial', 'windsurf': 'partial', 'github-copilot': 'full', 'goose': 'partial',
|
||||
'kilo': 'none', 'kiro-cli': 'none', 'roo': 'partial', 'trae': 'partial',
|
||||
'amp': 'partial', 'cline': 'partial', 'continue': 'partial', 'antigravity': 'none',
|
||||
},
|
||||
'performance': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'partial', 'windsurf': 'partial', 'github-copilot': 'partial', 'goose': 'partial',
|
||||
'kilo': 'none', 'kiro-cli': 'none', 'roo': 'partial', 'trae': 'partial',
|
||||
'amp': 'partial', 'cline': 'partial', 'continue': 'partial', 'antigravity': 'none',
|
||||
},
|
||||
'documentation': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'full', 'goose': 'full',
|
||||
'kilo': 'partial', 'kiro-cli': 'partial', 'roo': 'full', 'trae': 'full',
|
||||
'amp': 'full', 'cline': 'full', 'continue': 'full', 'antigravity': 'partial',
|
||||
},
|
||||
'ai-ml': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'partial', 'windsurf': 'partial', 'github-copilot': 'partial', 'goose': 'partial',
|
||||
'kilo': 'none', 'kiro-cli': 'none', 'roo': 'partial', 'trae': 'partial',
|
||||
'amp': 'partial', 'cline': 'partial', 'continue': 'partial', 'antigravity': 'none',
|
||||
},
|
||||
};
|
||||
|
||||
const SUPPORT_CONFIG: Record<Support, { color: string; bg: string; label: string }> = {
|
||||
full: { color: 'text-green-400', bg: 'bg-green-400/10', label: 'Full' },
|
||||
partial: { color: 'text-yellow-400', bg: 'bg-yellow-400/10', label: 'Partial' },
|
||||
none: { color: 'text-red-400', bg: 'bg-red-400/10', label: 'None' },
|
||||
};
|
||||
|
||||
const SUPPORT_SCORE: Record<Support, number> = { full: 2, partial: 1, none: 0 };
|
||||
|
||||
function SupportCell({ support }: { support: Support }): React.ReactElement {
|
||||
const config = SUPPORT_CONFIG[support];
|
||||
return (
|
||||
<td className="px-1 py-2 text-center">
|
||||
<div className={`inline-flex items-center justify-center w-5 h-5 rounded-full ${config.bg}`}>
|
||||
<span className={`text-[10px] font-bold ${config.color}`}>
|
||||
{support === 'full' ? '\u2713' : support === 'partial' ? '\u25CB' : '\u2715'}
|
||||
</span>
|
||||
</div>
|
||||
</td>
|
||||
);
|
||||
}
|
||||
|
||||
function getAgentScore(agentId: string): number {
|
||||
return Object.values(MATRIX).reduce((sum, row) => sum + SUPPORT_SCORE[row[agentId] || 'none'], 0);
|
||||
}
|
||||
|
||||
function getMaxScore(): number {
|
||||
return CATEGORIES.length * 2;
|
||||
}
|
||||
|
||||
export function CompatibilityMatrix(): React.ReactElement {
|
||||
const [filter, setFilter] = useState('');
|
||||
const [groupFilter, setGroupFilter] = useState<string | null>(null);
|
||||
|
||||
const groups = useMemo(() => {
|
||||
const seen = new Set<string>();
|
||||
return AGENTS.reduce<string[]>((acc, a) => {
|
||||
if (!seen.has(a.group)) {
|
||||
seen.add(a.group);
|
||||
acc.push(a.group);
|
||||
}
|
||||
return acc;
|
||||
}, []);
|
||||
}, []);
|
||||
|
||||
const { filteredAgents, filteredCategories } = useMemo(() => {
|
||||
let agents = AGENTS;
|
||||
if (groupFilter) {
|
||||
agents = agents.filter(a => a.group === groupFilter);
|
||||
}
|
||||
|
||||
if (!filter.trim()) {
|
||||
return { filteredAgents: agents, filteredCategories: CATEGORIES };
|
||||
}
|
||||
|
||||
const q = filter.toLowerCase();
|
||||
|
||||
const matchedAgents = agents.filter(a =>
|
||||
a.name.toLowerCase().includes(q) || a.id.toLowerCase().includes(q)
|
||||
);
|
||||
const matchedCategories = CATEGORIES.filter(c =>
|
||||
c.name.toLowerCase().includes(q) || c.id.toLowerCase().includes(q)
|
||||
);
|
||||
|
||||
return {
|
||||
filteredAgents: matchedAgents.length > 0 ? matchedAgents : (matchedCategories.length > 0 ? agents : []),
|
||||
filteredCategories: matchedCategories.length > 0 ? matchedCategories : (matchedAgents.length > 0 ? CATEGORIES : []),
|
||||
};
|
||||
}, [filter, groupFilter]);
|
||||
|
||||
const maxScore = getMaxScore();
|
||||
|
||||
return (
|
||||
<section className="py-12 border-b border-zinc-800" style={{ backgroundColor: '#09090b' }}>
|
||||
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
|
||||
<div className="flex flex-col sm:flex-row sm:items-center justify-between gap-2 mb-6">
|
||||
<div>
|
||||
<h2 className="text-lg sm:text-xl font-bold text-white mb-1 font-mono">Compatibility Matrix</h2>
|
||||
<p className="text-zinc-500 font-mono text-[10px] sm:text-xs">
|
||||
Skill support across 16 agents and 12 categories.
|
||||
</p>
|
||||
</div>
|
||||
<div className="flex items-center gap-2">
|
||||
<span className="w-2 h-2 bg-green-500 rounded-full"></span>
|
||||
<span className="text-[10px] sm:text-xs font-mono text-zinc-500">Updated Feb 2026</span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="flex flex-col sm:flex-row gap-2 sm:gap-3 mb-6">
|
||||
<div className="relative flex-1">
|
||||
<svg className="absolute left-2.5 top-1/2 -translate-y-1/2 w-3.5 h-3.5 text-zinc-600" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z" />
|
||||
</svg>
|
||||
<input
|
||||
type="text"
|
||||
value={filter}
|
||||
onChange={(e) => setFilter(e.target.value)}
|
||||
placeholder="Filter agents or categories..."
|
||||
className="w-full bg-black border border-zinc-800 text-zinc-300 placeholder-zinc-700 font-mono text-xs px-8 py-2 focus:outline-none focus:border-zinc-600 transition-colors"
|
||||
/>
|
||||
{filter && (
|
||||
<button
|
||||
onClick={() => setFilter('')}
|
||||
className="absolute right-2.5 top-1/2 -translate-y-1/2 text-zinc-600 hover:text-zinc-400 transition-colors"
|
||||
>
|
||||
<svg className="w-3.5 h-3.5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M6 18L18 6M6 6l12 12" />
|
||||
</svg>
|
||||
</button>
|
||||
)}
|
||||
</div>
|
||||
<div className="flex gap-1.5">
|
||||
<button
|
||||
onClick={() => setGroupFilter(null)}
|
||||
className={`px-2.5 py-1.5 font-mono text-[10px] sm:text-xs transition-all ${
|
||||
groupFilter === null
|
||||
? 'bg-white text-black'
|
||||
: 'bg-zinc-900 text-zinc-400 border border-zinc-800 hover:border-zinc-600 hover:text-white'
|
||||
}`}
|
||||
>
|
||||
All
|
||||
</button>
|
||||
{groups.map(g => (
|
||||
<button
|
||||
key={g}
|
||||
onClick={() => setGroupFilter(groupFilter === g ? null : g)}
|
||||
className={`px-2.5 py-1.5 font-mono text-[10px] sm:text-xs transition-all ${
|
||||
groupFilter === g
|
||||
? 'bg-white text-black'
|
||||
: 'bg-zinc-900 text-zinc-400 border border-zinc-800 hover:border-zinc-600 hover:text-white'
|
||||
}`}
|
||||
>
|
||||
{g}
|
||||
</button>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="flex items-center gap-4 mb-4">
|
||||
{Object.entries(SUPPORT_CONFIG).map(([key, config]) => (
|
||||
<div key={key} className="flex items-center gap-1.5">
|
||||
<div className={`w-3 h-3 rounded-full ${config.bg} flex items-center justify-center`}>
|
||||
<span className={`text-[8px] font-bold ${config.color}`}>
|
||||
{key === 'full' ? '\u2713' : key === 'partial' ? '\u25CB' : '\u2715'}
|
||||
</span>
|
||||
</div>
|
||||
<span className="text-[10px] font-mono text-zinc-500">{config.label}</span>
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
|
||||
<div className="overflow-x-auto -mx-4 px-4 sm:mx-0 sm:px-0">
|
||||
<div className="min-w-[700px]">
|
||||
<table className="w-full border-collapse font-mono text-[10px]">
|
||||
<thead>
|
||||
<tr className="border-b border-zinc-800">
|
||||
<th className="text-left text-zinc-500 uppercase tracking-wider py-2 pr-3 sticky left-0 bg-[#09090b] z-10 min-w-[120px]">
|
||||
Category
|
||||
</th>
|
||||
{filteredAgents.map(agent => (
|
||||
<th key={agent.id} className="px-1 py-2 text-center">
|
||||
<div className="flex flex-col items-center gap-0.5">
|
||||
<span className="text-sm">{agent.icon}</span>
|
||||
<span className="text-zinc-400 whitespace-nowrap max-w-[50px] truncate" title={agent.name}>
|
||||
{agent.name.length > 7 ? agent.name.slice(0, 7) : agent.name}
|
||||
</span>
|
||||
</div>
|
||||
</th>
|
||||
))}
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
{filteredCategories.map(category => (
|
||||
<tr key={category.id} className="border-b border-zinc-800/50 hover:bg-zinc-900/50 transition-colors">
|
||||
<td className="py-2 pr-3 sticky left-0 bg-[#09090b] z-10">
|
||||
<div className="flex items-center gap-1.5">
|
||||
<span className="text-zinc-600">{category.icon}</span>
|
||||
<span className="text-zinc-300 whitespace-nowrap">{category.name}</span>
|
||||
</div>
|
||||
</td>
|
||||
{filteredAgents.map(agent => (
|
||||
<SupportCell
|
||||
key={agent.id}
|
||||
support={MATRIX[category.id]?.[agent.id] || 'none'}
|
||||
/>
|
||||
))}
|
||||
</tr>
|
||||
))}
|
||||
</tbody>
|
||||
<tfoot>
|
||||
<tr className="border-t border-zinc-700">
|
||||
<td className="py-3 pr-3 sticky left-0 bg-[#09090b] z-10">
|
||||
<span className="text-zinc-400 font-bold uppercase tracking-wider">Score</span>
|
||||
</td>
|
||||
{filteredAgents.map(agent => {
|
||||
const score = getAgentScore(agent.id);
|
||||
const pct = Math.round((score / maxScore) * 100);
|
||||
const color = pct >= 80 ? 'text-green-400' : pct >= 50 ? 'text-yellow-400' : 'text-red-400';
|
||||
return (
|
||||
<td key={agent.id} className="px-1 py-3 text-center">
|
||||
<div className={`font-bold text-xs ${color}`}>{pct}%</div>
|
||||
<div className="text-zinc-600 text-[9px]">{score}/{maxScore}</div>
|
||||
</td>
|
||||
);
|
||||
})}
|
||||
</tr>
|
||||
</tfoot>
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{filteredAgents.length === 0 && (
|
||||
<div className="text-center py-8 text-zinc-600 font-mono text-sm">
|
||||
No agents match your filter.
|
||||
</div>
|
||||
)}
|
||||
|
||||
{filteredCategories.length === 0 && filteredAgents.length > 0 && (
|
||||
<div className="text-center py-8 text-zinc-600 font-mono text-sm">
|
||||
No categories match your filter.
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
@@ -46,7 +46,6 @@ const sections: DocSection[] = [
|
||||
</p>
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Core Capabilities</h3>
|
||||
<ul className="list-disc list-inside space-y-2 text-zinc-400">
|
||||
<li><span className="text-white">AI Instruction Generation (Primer)</span> - Analyze your codebase and generate customized instruction files for all 32 agents</li>
|
||||
<li><span className="text-white">Skill Discovery</span> - Browse 15,000+ skills from marketplace with AI-powered recommendations</li>
|
||||
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 32 agent-specific formats</li>
|
||||
<li><span className="text-white">Team Collaboration</span> - Share skills via .skills manifest files and publish to marketplace</li>
|
||||
@@ -204,15 +203,6 @@ 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">AI Instruction Generation (Primer)</h3>
|
||||
<CodeBlock>{`skillkit primer # Analyze codebase, generate for detected agents
|
||||
skillkit primer --all-agents # Generate for all 32 agents
|
||||
skillkit primer --agent claude-code,cursor # Specific agents only
|
||||
skillkit primer --analyze-only # Only show codebase analysis
|
||||
skillkit primer --dry-run # Preview without writing files
|
||||
skillkit primer --json # Output analysis as JSON
|
||||
skillkit primer --output ./dir # Custom output directory`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Advanced</h3>
|
||||
<CodeBlock>{`skillkit ui # Launch Terminal UI
|
||||
skillkit workflow # Manage workflows
|
||||
|
||||
@@ -8,89 +8,44 @@ interface Feature {
|
||||
|
||||
const FEATURES: Feature[] = [
|
||||
{
|
||||
title: 'Smart Recommendations',
|
||||
description: 'AI analyzes your codebase and recommends from 15,000+ skills.',
|
||||
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="M9.663 17h4.673M12 3v1m6.364 1.636l-.707.707M21 12h-1M4 12H3m3.343-5.657l-.707-.707m2.828 9.9a5 5 0 117.072 0l-.548.547A3.374 3.374 0 0014 18.469V19a2 2 0 11-4 0v-.531c0-.895-.356-1.754-.988-2.386l-.548-.547z" />
|
||||
<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: 'Auto Translation',
|
||||
description: 'The npm for agent skills. Write once, auto-translate to 32 formats.',
|
||||
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 7h12m0 0l-4-4m4 4l-4 4m0 6H4m0 0l4 4m-4-4l4-4" />
|
||||
<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: 'Session Memory',
|
||||
description: 'AI learnings persist across sessions and projects.',
|
||||
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="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2" />
|
||||
<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: 'Primer',
|
||||
description: 'Auto-generate agent instructions for all 32 agents from your codebase.',
|
||||
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="M13 10V3L4 14h7v7l9-11h-7z" />
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
title: 'Skill Tree',
|
||||
description: 'Browse 15K+ skills in a hierarchical taxonomy with 12 categories.',
|
||||
icon: (
|
||||
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M3 7v10a2 2 0 002 2h14a2 2 0 002-2V9a2 2 0 00-2-2h-6l-2-2H5a2 2 0 00-2 2z" />
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
title: 'Workflows',
|
||||
description: 'Compose multi-step automated skill sequences.',
|
||||
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 5a1 1 0 011-1h14a1 1 0 011 1v2a1 1 0 01-1 1H5a1 1 0 01-1-1V5zM4 13a1 1 0 011-1h6a1 1 0 011 1v6a1 1 0 01-1 1H5a1 1 0 01-1-1v-6zM16 13a1 1 0 011-1h2a1 1 0 011 1v6a1 1 0 01-1 1h-2a1 1 0 01-1-1v-6z" />
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
title: 'Team Sync',
|
||||
description: 'Git-based .skills manifest for 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="M17 20h5v-2a3 3 0 00-5.356-1.857M17 20H7m10 0v-2c0-.656-.126-1.283-.356-1.857M7 20H2v-2a3 3 0 015.356-1.857M7 20v-2c0-.656.126-1.283.356-1.857m0 0a5.002 5.002 0 019.288 0M15 7a3 3 0 11-6 0 3 3 0 016 0z" />
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
title: 'Security Scanner',
|
||||
description: 'Detect prompt injection, secrets, and malicious patterns in skills.',
|
||||
icon: (
|
||||
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9 12.75L11.25 15 15 9.75m-3-7.036A11.959 11.959 0 013.598 6 11.99 11.99 0 003 9.749c0 5.592 3.824 10.29 9 11.623 5.176-1.332 9-6.03 9-11.622 0-1.31-.21-2.571-.598-3.751h-.152c-3.196 0-6.1-1.248-8.25-3.285z" />
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
title: 'Testing',
|
||||
description: 'Built-in test framework with assertions.',
|
||||
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 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z" />
|
||||
<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 Actions, GitLab CI, pre-commit.',
|
||||
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" />
|
||||
@@ -98,25 +53,22 @@ const FEATURES: Feature[] = [
|
||||
)
|
||||
},
|
||||
{
|
||||
title: 'REST & MCP APIs',
|
||||
description: 'REST server, MCP server, and Python client for runtime discovery.',
|
||||
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="M5 12h14M5 12a2 2 0 01-2-2V6a2 2 0 012-2h14a2 2 0 012 2v4a2 2 0 01-2 2M5 12a2 2 0 00-2 2v4a2 2 0 002 2h14a2 2 0 002-2v-4a2 2 0 00-2-2m-2-4h.01M17 16h.01" />
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M7 20l4-16m2 16l4-16M6 9h14M4 15h14" />
|
||||
</svg>
|
||||
)
|
||||
}
|
||||
];
|
||||
|
||||
const COMPARISONS = [
|
||||
['Agent Support', '1 agent', '32 agents'],
|
||||
['Setup', 'Write rules manually', 'Auto-generate (Primer)'],
|
||||
['Learning', 'Lost each session', 'Persistent memory'],
|
||||
['Translation', 'Rewrite for each', 'One-click conversion'],
|
||||
['Team Sharing', 'Copy/paste files', '.skills manifest'],
|
||||
['Discovery', 'Search forums', 'AI recommendations'],
|
||||
['Security', 'Manual review', 'Auto-scan on install'],
|
||||
['API Access', 'None', 'REST + MCP + Python'],
|
||||
['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 {
|
||||
@@ -135,11 +87,11 @@ export function Features(): React.ReactElement {
|
||||
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Agents</div>
|
||||
</div>
|
||||
<div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">50+</div>
|
||||
<div className="text-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-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>
|
||||
@@ -167,7 +119,7 @@ export function Features(): React.ReactElement {
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="grid grid-cols-2 sm:grid-cols-3 gap-3">
|
||||
<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}
|
||||
|
||||
@@ -10,7 +10,7 @@ export function Footer(): React.ReactElement {
|
||||
const currentYear = new Date().getFullYear();
|
||||
|
||||
return (
|
||||
<footer className="border-t border-border py-6" style={{ backgroundColor: '#000000' }}>
|
||||
<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">
|
||||
@@ -18,7 +18,7 @@ export function Footer(): React.ReactElement {
|
||||
</p>
|
||||
<span className="hidden sm:inline text-zinc-700">•</span>
|
||||
<a
|
||||
href="https://agenstskills.com"
|
||||
href="https://agentskills.io"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="text-zinc-600 hover:text-zinc-400 text-xs font-mono transition-colors"
|
||||
|
||||
@@ -1,17 +1,12 @@
|
||||
import React, { useState, useEffect } from 'react';
|
||||
|
||||
interface HeroProps {
|
||||
version: string;
|
||||
stars?: number;
|
||||
}
|
||||
import { Button } from './Button';
|
||||
|
||||
const ASCII_LOGO = `
|
||||
███████╗██╗ ██╗██╗██╗ ██╗ ██╗ ██╗██╗████████╗
|
||||
██╔════╝██║ ██╔╝██║██║ ██║ ██║ ██╔╝██║╚══██╔══╝
|
||||
███████╗█████╔╝ ██║██║ ██║ █████╔╝ ██║ ██║
|
||||
╚════██║██╔═██╗ ██║██║ ██║ ██╔═██╗ ██║ ██║
|
||||
███████║██║ ██╗██║███████╗███████╗██║ ██╗██║ ██║
|
||||
╚══════╝╚═╝ ╚═╝╚═╝╚══════╝╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝
|
||||
███████ ██ ██ ██ ██ ██ ██ ██ ██ ████████
|
||||
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
|
||||
███████ █████ ██ ██ ██ █████ ██ ██
|
||||
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
|
||||
███████ ██ ██ ██ ███████ ███████ ██ ██ ██ ██
|
||||
`.trim();
|
||||
|
||||
interface TerminalLine {
|
||||
@@ -20,16 +15,17 @@ interface TerminalLine {
|
||||
}
|
||||
|
||||
const TERMINAL_LINES: TerminalLine[] = [
|
||||
{ type: 'cmd', text: 'skillkit install anthropics/skills --agent all' },
|
||||
{ type: 'out', text: '→ Installed to 32 agents' },
|
||||
{ type: 'cmd', text: 'skillkit recommend' },
|
||||
{ type: 'out', text: ' 92% vercel-react-best-practices' },
|
||||
{ type: 'out', text: ' 87% typescript-strict-mode' },
|
||||
{ type: 'cmd', text: 'skillkit serve' },
|
||||
{ type: 'out', text: '→ API server on http://0.0.0.0:3737' },
|
||||
{ type: 'out', text: ' GET /search · /trending · /categories' },
|
||||
{ type: 'cmd', text: 'curl localhost:3737/search?q=react' },
|
||||
{ type: 'out', text: ' {"skills":[...],"total":42}' },
|
||||
{ type: '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 = `
|
||||
@@ -58,7 +54,7 @@ const COPY_ICON = (
|
||||
</svg>
|
||||
);
|
||||
|
||||
export function Hero({ version, stars }: HeroProps): React.ReactElement {
|
||||
export function Hero(): React.ReactElement {
|
||||
const [copied, setCopied] = useState(false);
|
||||
const [visibleLines, setVisibleLines] = useState(0);
|
||||
const [typingIndex, setTypingIndex] = useState(0);
|
||||
@@ -120,30 +116,29 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
|
||||
|
||||
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8 pt-8 pb-10 relative">
|
||||
<div className="hidden lg:block mb-6 overflow-hidden">
|
||||
<pre className="text-zinc-600 text-[10px] leading-none font-mono select-none whitespace-pre" style={{ fontFamily: 'JetBrains Mono, Consolas, monospace' }}>
|
||||
<pre className="text-zinc-800 text-[8px] leading-none font-mono select-none animate-pulse">
|
||||
{ASCII_LOGO}
|
||||
</pre>
|
||||
</div>
|
||||
|
||||
<div className="grid grid-cols-1 md:grid-cols-2 gap-6 lg:gap-8 items-start">
|
||||
<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">v{version}</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">
|
||||
One Skill.<br />
|
||||
<span className="text-zinc-500">32 Agents. Zero Rewrites.</span>
|
||||
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">
|
||||
The open source package manager for AI agent skills. Install from 15,000+ skills,
|
||||
auto-translate between formats, persist learnings with Memory.
|
||||
Works with Claude, Cursor, Windsurf, Copilot, and 28 more.
|
||||
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-2 mb-4">
|
||||
<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"
|
||||
@@ -161,28 +156,13 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
|
||||
)}
|
||||
</span>
|
||||
</button>
|
||||
<button
|
||||
onClick={openGitHub}
|
||||
className="inline-flex items-center gap-2 border border-zinc-700 px-3 py-2 hover:border-zinc-500 transition-colors group"
|
||||
>
|
||||
<svg className="w-4 h-4 text-zinc-400 group-hover:text-white transition-colors" fill="currentColor" viewBox="0 0 24 24">
|
||||
<path fillRule="evenodd" d="M12 2C6.477 2 2 6.484 2 12.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.531 1.032 1.531 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0112 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.202 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.943.359.309.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482A10.019 10.019 0 0022 12.017C22 6.484 17.522 2 12 2z" clipRule="evenodd" />
|
||||
</svg>
|
||||
<span className="font-mono text-sm text-zinc-300 group-hover:text-white transition-colors">Star</span>
|
||||
{typeof stars === 'number' && (
|
||||
<>
|
||||
<span className="w-px h-4 bg-zinc-700"></span>
|
||||
<svg className="w-3.5 h-3.5 text-yellow-500" fill="currentColor" viewBox="0 0 24 24">
|
||||
<path d="M12 2l3.09 6.26L22 9.27l-5 4.87 1.18 6.88L12 17.77l-6.18 3.25L7 14.14 2 9.27l6.91-1.01L12 2z" />
|
||||
</svg>
|
||||
<span className="font-mono text-sm text-white font-medium">{stars}</span>
|
||||
</>
|
||||
)}
|
||||
</button>
|
||||
<Button variant="outline" onClick={openGitHub}>
|
||||
GITHUB
|
||||
</Button>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="hidden md:block relative animate-fade-in-delay w-full">
|
||||
<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">
|
||||
@@ -191,7 +171,7 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
|
||||
<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-3 md:p-4 font-mono text-[10px] md:text-xs min-h-[180px] md:min-h-[200px] max-h-[240px] md:max-h-[280px]">
|
||||
<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' ? (
|
||||
@@ -224,32 +204,6 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Video Demo */}
|
||||
<div className="mt-8 sm:mt-10 animate-fade-in-delay">
|
||||
<div className="relative mx-auto max-w-3xl">
|
||||
<div className="absolute -inset-1 bg-gradient-to-r from-zinc-800 via-zinc-600 to-zinc-800 rounded-lg opacity-30 blur-xl"></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-red-500/80"></div>
|
||||
<div className="w-2.5 h-2.5 rounded-full bg-yellow-500/80"></div>
|
||||
<div className="w-2.5 h-2.5 rounded-full bg-green-500/80"></div>
|
||||
<span className="ml-2 text-zinc-500 text-xs font-mono">skillkit demo</span>
|
||||
</div>
|
||||
<video
|
||||
className="w-full"
|
||||
autoPlay
|
||||
loop
|
||||
muted
|
||||
playsInline
|
||||
poster="/og-image.png"
|
||||
>
|
||||
<source src="/skillkit.mp4" type="video/mp4" />
|
||||
Your browser does not support the video tag.
|
||||
</video>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<style>{FADE_ANIMATION_STYLES}</style>
|
||||
|
||||
@@ -1,121 +1,649 @@
|
||||
import React, { useState } from 'react';
|
||||
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 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 frontmatter = `---
|
||||
name: "${skill.name}"
|
||||
description: "${skill.description}"
|
||||
version: "${skill.version}"
|
||||
tags: [${skill.tags.map(t => `"${t}"`).join(', ')}]
|
||||
${skill.filePatterns?.length ? `globs: [${skill.filePatterns.map(p => `"${p}"`).join(', ')}]` : ''}
|
||||
---`;
|
||||
|
||||
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);
|
||||
}
|
||||
|
||||
// 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 [query, setQuery] = useState('');
|
||||
const [results, setResults] = useState<IndexedSkill[]>([]);
|
||||
const [hasSearched, setHasSearched] = useState(false);
|
||||
const [copied, setCopied] = useState<string | null>(null);
|
||||
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 (!query.trim()) return;
|
||||
const found = searchSkills(query);
|
||||
setResults(found);
|
||||
setHasSearched(true);
|
||||
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 copyInstall(skill: IndexedSkill): Promise<void> {
|
||||
const cmd = `npx skillkit@latest install ${skill.id.split('/').slice(0, 2).join('/')}`;
|
||||
try {
|
||||
await navigator.clipboard.writeText(cmd);
|
||||
setCopied(skill.id);
|
||||
setTimeout(() => setCopied(null), 2000);
|
||||
} catch {
|
||||
// ignore
|
||||
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">
|
||||
<div className="text-center mb-8">
|
||||
<h2 className="text-xl font-bold text-white mb-2 font-mono">Find Skills</h2>
|
||||
<p className="text-zinc-500 font-mono text-xs">
|
||||
Search 15,000+ skills from the marketplace
|
||||
<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="max-w-2xl mx-auto mb-8">
|
||||
<div className="flex gap-2">
|
||||
<form onSubmit={handleSearch} className="mb-6">
|
||||
<div className="flex flex-col sm:flex-row gap-3">
|
||||
<input
|
||||
ref={inputRef}
|
||||
type="text"
|
||||
value={query}
|
||||
onChange={(e) => setQuery(e.target.value)}
|
||||
placeholder="react, typescript, testing, kubernetes..."
|
||||
className="flex-1 bg-zinc-900 border border-zinc-800 text-white px-4 py-3 font-mono text-sm focus:border-zinc-600 outline-none placeholder-zinc-600"
|
||||
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"
|
||||
className="bg-zinc-800 text-white px-6 py-3 font-mono text-sm hover:bg-zinc-700 transition-colors border border-zinc-700"
|
||||
>
|
||||
Search
|
||||
</button>
|
||||
<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>
|
||||
|
||||
{hasSearched && (
|
||||
<div className="max-w-2xl mx-auto">
|
||||
{results.length > 0 ? (
|
||||
<div className="space-y-2">
|
||||
<div className="text-xs font-mono text-zinc-500 mb-4">
|
||||
{results.length} result{results.length !== 1 ? 's' : ''} for "{query}"
|
||||
</div>
|
||||
{results.map((skill) => (
|
||||
<div
|
||||
key={skill.id}
|
||||
className="bg-zinc-900/50 border border-zinc-800 p-4 hover:border-zinc-700 transition-colors"
|
||||
>
|
||||
<div className="flex items-start justify-between gap-4">
|
||||
<div className="flex-1 min-w-0">
|
||||
<div className="font-mono text-sm text-white mb-1">{skill.name}</div>
|
||||
<div className="text-xs text-zinc-500 mb-2 truncate">{skill.description || 'No description'}</div>
|
||||
<div className="text-[11px] text-zinc-600 font-mono">{skill.source}</div>
|
||||
{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>
|
||||
<button
|
||||
onClick={() => copyInstall(skill)}
|
||||
className="text-xs font-mono text-zinc-500 hover:text-white transition-colors shrink-0"
|
||||
>
|
||||
{copied === skill.id ? 'Copied' : 'Copy'}
|
||||
</button>
|
||||
</div>
|
||||
{skill.tags.length > 0 && (
|
||||
<div className="flex flex-wrap gap-1 mt-3">
|
||||
{skill.tags.slice(0, 4).map((tag, idx) => (
|
||||
<span key={idx} className="text-[10px] text-zinc-600 px-1.5 py-0.5 bg-zinc-800/50">
|
||||
{tag}
|
||||
</span>
|
||||
))}
|
||||
</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>
|
||||
))}
|
||||
</div>
|
||||
) : (
|
||||
<div className="text-center text-zinc-500 font-mono text-sm py-8">
|
||||
No skills found for "{query}"
|
||||
</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} isLoading={status === LoadingState.LOADING}>
|
||||
GENERATE WITH AI
|
||||
</Button>
|
||||
</div>
|
||||
</div>
|
||||
)}
|
||||
|
||||
{!hasSearched && (
|
||||
<div className="max-w-2xl mx-auto text-center">
|
||||
<div className="flex flex-wrap justify-center gap-2 text-xs font-mono">
|
||||
{['react', 'typescript', 'nextjs', 'testing', 'docker', 'kubernetes', 'python', 'security'].map(tag => (
|
||||
{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
|
||||
key={tag}
|
||||
onClick={() => {
|
||||
setQuery(tag);
|
||||
const found = searchSkills(tag);
|
||||
setResults(found);
|
||||
setHasSearched(true);
|
||||
}}
|
||||
className="text-zinc-600 hover:text-white px-2 py-1 border border-zinc-800 hover:border-zinc-600 transition-colors"
|
||||
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"
|
||||
>
|
||||
{tag}
|
||||
<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="flex items-start justify-between mb-8 border-b border-zinc-800 pb-6">
|
||||
<div className="flex-1">
|
||||
<div className="flex flex-wrap items-center gap-2 mb-2">
|
||||
<h3 className="text-xl sm: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-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-col sm:flex-row gap-2 shrink-0 ml-4">
|
||||
<button
|
||||
onClick={downloadGeneratedSkillMd}
|
||||
className="flex items-center justify-center gap-2 bg-white text-black px-4 py-2 font-mono 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>
|
||||
DOWNLOAD
|
||||
</button>
|
||||
<button
|
||||
onClick={submitToMarketplace}
|
||||
className="flex items-center justify-center gap-2 bg-purple-600 text-white px-4 py-2 font-mono 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>
|
||||
SUBMIT
|
||||
</button>
|
||||
</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}>
|
||||
<a
|
||||
href={ref}
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="text-zinc-400 hover:text-white font-mono text-sm transition-colors"
|
||||
>
|
||||
{ref}
|
||||
</a>
|
||||
</li>
|
||||
))}
|
||||
</ul>
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
|
||||
@@ -1,75 +1,549 @@
|
||||
import React, { useState } from 'react';
|
||||
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 [repoUrl, setRepoUrl] = useState('');
|
||||
const [copied, setCopied] = useState(false);
|
||||
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);
|
||||
|
||||
const repoMatch = repoUrl.match(/github\.com\/([^\/]+)\/([^\/\s]+)/);
|
||||
const owner = repoMatch?.[1] || 'owner';
|
||||
const repo = repoMatch?.[2]?.replace(/\.git$/, '') || 'repo';
|
||||
const skillName = repo.replace(/-skill$/, '').replace(/-/g, '-');
|
||||
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;
|
||||
});
|
||||
}
|
||||
|
||||
const command = `npx skillkit@latest publish ${repoUrl || 'https://github.com/owner/repo'}`;
|
||||
|
||||
async function copyCommand(): Promise<void> {
|
||||
if (!repoUrl) return;
|
||||
try {
|
||||
await navigator.clipboard.writeText(command);
|
||||
setCopied(true);
|
||||
setTimeout(() => setCopied(false), 2000);
|
||||
} catch {
|
||||
// ignore
|
||||
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 issueUrl = repoUrl
|
||||
? `https://github.com/rohitg00/skillkit/issues/new?title=${encodeURIComponent(`[Skill] ${owner}/${repo}`)}&body=${encodeURIComponent(`## Skill Submission\n\n**Repository:** ${repoUrl}\n\n**Description:** \n\n**Tags:** `)}&labels=skill-submission`
|
||||
: 'https://github.com/rohitg00/skillkit/issues/new?template=skill-submission.md';
|
||||
function parseSkillContent(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) => {
|
||||
parseSkillContent(event.target?.result as string);
|
||||
};
|
||||
reader.readAsText(file);
|
||||
}, []);
|
||||
|
||||
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="max-w-2xl mx-auto">
|
||||
<div className="space-y-6">
|
||||
<div>
|
||||
<label className="block text-xs font-mono text-zinc-500 mb-2">
|
||||
Your GitHub repository URL
|
||||
</label>
|
||||
<input
|
||||
type="text"
|
||||
value={repoUrl}
|
||||
onChange={(e) => setRepoUrl(e.target.value)}
|
||||
placeholder="https://github.com/username/my-skill"
|
||||
className="w-full bg-zinc-900 border border-zinc-800 text-white px-4 py-3 font-mono text-sm focus:border-zinc-600 outline-none placeholder-zinc-600"
|
||||
/>
|
||||
</div>
|
||||
<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="bg-black border border-zinc-800 p-4">
|
||||
<div className="flex items-center justify-between mb-2">
|
||||
<span className="text-xs font-mono text-zinc-500">Run this command</span>
|
||||
<button
|
||||
onClick={copyCommand}
|
||||
disabled={!repoUrl}
|
||||
className={`text-xs font-mono transition-colors ${
|
||||
repoUrl ? 'text-zinc-500 hover:text-white' : 'text-zinc-700'
|
||||
}`}
|
||||
<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}
|
||||
>
|
||||
{copied ? 'Copied' : 'Copy'}
|
||||
</button>
|
||||
</div>
|
||||
<code className="block font-mono text-sm text-zinc-300 break-all">
|
||||
<span className="text-zinc-600">$</span> {command}
|
||||
</code>
|
||||
<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="text-center text-xs font-mono text-zinc-600">
|
||||
or{' '}
|
||||
<a
|
||||
href={issueUrl}
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="text-zinc-400 hover:text-white underline"
|
||||
<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'
|
||||
}`}
|
||||
>
|
||||
open a GitHub issue
|
||||
</a>
|
||||
{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>
|
||||
|
||||
@@ -1,267 +0,0 @@
|
||||
import React, { useState, useEffect } from 'react';
|
||||
import { searchSkills, IndexedSkill, SKILLS_INDEX } from '../data/skills-index';
|
||||
|
||||
interface StackItem extends IndexedSkill {
|
||||
addedAt: number;
|
||||
}
|
||||
|
||||
// Default starter skills to show on load
|
||||
const DEFAULT_SKILLS = ['react', 'typescript', 'nextjs'];
|
||||
|
||||
const POPULAR_STACKS = [
|
||||
{
|
||||
name: 'Full Stack TypeScript',
|
||||
skills: ['react', 'nextjs', 'typescript', 'prisma', 'tailwind'],
|
||||
icon: '⚡',
|
||||
},
|
||||
{
|
||||
name: 'AI/ML Development',
|
||||
skills: ['python', 'langchain', 'openai', 'embeddings', 'llm'],
|
||||
icon: '🤖',
|
||||
},
|
||||
{
|
||||
name: 'DevOps & Cloud',
|
||||
skills: ['docker', 'kubernetes', 'terraform', 'github-actions', 'kubernetes-mcp'],
|
||||
icon: '☁️',
|
||||
},
|
||||
{
|
||||
name: 'Mobile Development',
|
||||
skills: ['react-native', 'expo', 'ios', 'android', 'swift'],
|
||||
icon: '📱',
|
||||
},
|
||||
{
|
||||
name: 'Backend & API',
|
||||
skills: ['nodejs', 'express', 'graphql', 'rest', 'nestjs'],
|
||||
icon: '🔧',
|
||||
},
|
||||
{
|
||||
name: 'Security',
|
||||
skills: ['security', 'auth', 'oauth', 'jwt', 'vulnerability'],
|
||||
icon: '🔒',
|
||||
},
|
||||
{
|
||||
name: 'Data Engineering',
|
||||
skills: ['sql', 'postgres', 'redis', 'elasticsearch', 'kafka'],
|
||||
icon: '📊',
|
||||
},
|
||||
{
|
||||
name: 'Web3 & Blockchain',
|
||||
skills: ['solidity', 'ethereum', 'web3', 'smart-contract'],
|
||||
icon: '⛓️',
|
||||
},
|
||||
];
|
||||
|
||||
export function StackBuilder(): React.ReactElement {
|
||||
const [stack, setStack] = useState<StackItem[]>([]);
|
||||
const [searchQuery, setSearchQuery] = useState('');
|
||||
const [searchResults, setSearchResults] = useState<IndexedSkill[]>([]);
|
||||
const [copied, setCopied] = useState(false);
|
||||
|
||||
// Load default skills on mount
|
||||
useEffect(() => {
|
||||
const initialStack: StackItem[] = [];
|
||||
DEFAULT_SKILLS.forEach(query => {
|
||||
const results = searchSkills(query);
|
||||
if (results.length > 0 && !initialStack.some(s => s.id === results[0].id)) {
|
||||
initialStack.push({ ...results[0], addedAt: Date.now() });
|
||||
}
|
||||
});
|
||||
if (initialStack.length > 0) {
|
||||
setStack(initialStack);
|
||||
}
|
||||
}, []);
|
||||
|
||||
function handleSearch(query: string): void {
|
||||
setSearchQuery(query);
|
||||
if (query.trim()) {
|
||||
const results = searchSkills(query).filter(
|
||||
skill => !stack.some(s => s.id === skill.id)
|
||||
);
|
||||
setSearchResults(results);
|
||||
} else {
|
||||
setSearchResults([]);
|
||||
}
|
||||
}
|
||||
|
||||
function addToStack(skill: IndexedSkill): void {
|
||||
if (!stack.some(s => s.id === skill.id)) {
|
||||
setStack([...stack, { ...skill, addedAt: Date.now() }]);
|
||||
setSearchQuery('');
|
||||
setSearchResults([]);
|
||||
}
|
||||
}
|
||||
|
||||
function removeFromStack(skillId: string): void {
|
||||
setStack(stack.filter(s => s.id !== skillId));
|
||||
}
|
||||
|
||||
function loadPresetStack(presetSkills: string[]): void {
|
||||
const newItems: StackItem[] = [];
|
||||
presetSkills.forEach(query => {
|
||||
const results = searchSkills(query);
|
||||
if (results.length > 0 && !stack.some(s => s.id === results[0].id) && !newItems.some(s => s.id === results[0].id)) {
|
||||
newItems.push({ ...results[0], addedAt: Date.now() });
|
||||
}
|
||||
});
|
||||
setStack([...stack, ...newItems]);
|
||||
}
|
||||
|
||||
function generateInstallCommand(): string {
|
||||
if (stack.length === 0) return '';
|
||||
const skillIds = [...new Set(stack.map(s => s.id.split('/').slice(0, 2).join('/')))];
|
||||
if (skillIds.length === 1) {
|
||||
return `npx skillkit@latest install ${skillIds[0]}`;
|
||||
}
|
||||
return `npx skillkit@latest install ${skillIds.join(' ')}`;
|
||||
}
|
||||
|
||||
async function copyCommand(): Promise<void> {
|
||||
const cmd = generateInstallCommand();
|
||||
if (!cmd) return;
|
||||
try {
|
||||
await navigator.clipboard.writeText(cmd);
|
||||
setCopied(true);
|
||||
setTimeout(() => setCopied(false), 2000);
|
||||
} catch {
|
||||
// Clipboard API failed, silently ignore
|
||||
}
|
||||
}
|
||||
|
||||
function clearStack(): void {
|
||||
setStack([]);
|
||||
}
|
||||
|
||||
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="flex items-center justify-between mb-6">
|
||||
<div>
|
||||
<h2 className="text-xl font-bold text-white mb-1 font-mono">Stack Builder</h2>
|
||||
<p className="text-zinc-500 font-mono text-xs">
|
||||
Compose your perfect skill stack. Install everything with one command.
|
||||
</p>
|
||||
</div>
|
||||
{stack.length > 0 && (
|
||||
<button
|
||||
onClick={clearStack}
|
||||
className="text-zinc-500 hover:text-red-400 font-mono text-xs transition-colors"
|
||||
>
|
||||
Clear All
|
||||
</button>
|
||||
)}
|
||||
</div>
|
||||
|
||||
<div className="flex flex-col lg:flex-row gap-6">
|
||||
<div className="flex-1 space-y-4">
|
||||
<div className="relative">
|
||||
<input
|
||||
type="text"
|
||||
value={searchQuery}
|
||||
onChange={(e) => handleSearch(e.target.value)}
|
||||
placeholder="Search skills to add..."
|
||||
className="w-full bg-zinc-900 border border-zinc-700 text-white px-4 py-3 focus:ring-2 focus:ring-white focus:border-transparent outline-none font-mono text-sm placeholder-zinc-600"
|
||||
/>
|
||||
{searchResults.length > 0 && (
|
||||
<div className="absolute z-10 w-full mt-1 bg-zinc-900 border border-zinc-700 max-h-60 overflow-y-auto">
|
||||
{searchResults.slice(0, 8).map(skill => (
|
||||
<button
|
||||
key={skill.id}
|
||||
onClick={() => addToStack(skill)}
|
||||
className="w-full text-left px-4 py-3 hover:bg-zinc-800 transition-colors border-b border-zinc-800 last:border-b-0"
|
||||
>
|
||||
<div className="font-mono text-sm text-white">{skill.name}</div>
|
||||
<div className="text-xs text-zinc-500 truncate">{skill.description}</div>
|
||||
</button>
|
||||
))}
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
|
||||
<div className="space-y-2">
|
||||
<span className="text-zinc-500 text-xs font-mono block">Quick add:</span>
|
||||
<div className="flex flex-wrap gap-2">
|
||||
{POPULAR_STACKS.map(preset => (
|
||||
<button
|
||||
key={preset.name}
|
||||
onClick={() => loadPresetStack(preset.skills)}
|
||||
className="text-[10px] sm:text-xs bg-zinc-900 text-zinc-400 px-2 sm:px-3 py-1 sm:py-1.5 border border-zinc-700 hover:border-zinc-500 hover:text-white transition-colors font-mono"
|
||||
>
|
||||
{preset.icon} <span className="hidden sm:inline">{preset.name}</span><span className="sm:hidden">{preset.name.split(' ')[0]}</span>
|
||||
</button>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{stack.length > 0 && (
|
||||
<div className="space-y-2">
|
||||
<div className="text-xs font-mono text-zinc-500 uppercase tracking-wider">
|
||||
Your Stack ({stack.length} skills)
|
||||
</div>
|
||||
<div className="grid grid-cols-1 sm:grid-cols-2 gap-2">
|
||||
{stack.map(skill => (
|
||||
<div
|
||||
key={skill.id}
|
||||
className="flex items-center justify-between bg-zinc-900/50 border border-zinc-800 p-3 group"
|
||||
>
|
||||
<div className="flex-1 min-w-0">
|
||||
<div className="font-mono text-sm text-white truncate">{skill.name}</div>
|
||||
<div className="text-xs text-zinc-600 truncate">{skill.source}</div>
|
||||
</div>
|
||||
<button
|
||||
onClick={() => removeFromStack(skill.id)}
|
||||
aria-label={`Remove ${skill.name} from stack`}
|
||||
className="ml-2 text-zinc-600 hover:text-red-400 transition-colors opacity-0 group-hover:opacity-100 focus-visible:opacity-100"
|
||||
>
|
||||
<svg className="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M6 18L18 6M6 6l12 12" />
|
||||
</svg>
|
||||
</button>
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
|
||||
<div className="lg:w-72 lg:flex-shrink-0">
|
||||
<div className="lg:sticky lg:top-20 bg-zinc-900/30 border border-zinc-800 p-3">
|
||||
{stack.length > 0 ? (
|
||||
<>
|
||||
<pre className="bg-black/50 p-2 overflow-x-auto text-[11px] mb-2">
|
||||
<code className="font-mono text-zinc-300 whitespace-pre-wrap break-all">
|
||||
{generateInstallCommand()}
|
||||
</code>
|
||||
</pre>
|
||||
<button
|
||||
onClick={copyCommand}
|
||||
className="w-full bg-zinc-800 text-zinc-300 py-1.5 font-mono text-xs hover:bg-zinc-700 hover:text-white transition-colors flex items-center justify-center gap-1.5 border border-zinc-700"
|
||||
>
|
||||
{copied ? (
|
||||
<>
|
||||
<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>
|
||||
Copied
|
||||
</>
|
||||
) : (
|
||||
<>
|
||||
<svg className="w-3 h-3" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z" />
|
||||
</svg>
|
||||
Copy
|
||||
</>
|
||||
)}
|
||||
</button>
|
||||
</>
|
||||
) : (
|
||||
<div className="text-zinc-600 text-xs font-mono text-center py-4">
|
||||
Add skills to generate command
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
@@ -1,125 +0,0 @@
|
||||
import React from 'react';
|
||||
|
||||
interface TeamFeature {
|
||||
title: string;
|
||||
description: string;
|
||||
icon: React.ReactNode;
|
||||
}
|
||||
|
||||
const TEAM_FEATURES: TeamFeature[] = [
|
||||
{
|
||||
title: '.skills Manifest',
|
||||
description: 'Define your team\'s skill stack in a single file. Everyone gets the same capabilities.',
|
||||
icon: (
|
||||
<svg className="w-6 h-6" 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: 'Git-Based Sync',
|
||||
description: 'Skills live in your repo. Push to share. Pull to update. Works with your existing workflow.',
|
||||
icon: (
|
||||
<svg className="w-6 h-6" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M8 7v8a2 2 0 002 2h6M8 7V5a2 2 0 012-2h4.586a1 1 0 01.707.293l4.414 4.414a1 1 0 01.293.707V15a2 2 0 01-2 2h-2M8 7H6a2 2 0 00-2 2v10a2 2 0 002 2h8a2 2 0 002-2v-2" />
|
||||
</svg>
|
||||
),
|
||||
},
|
||||
{
|
||||
title: 'CI/CD Integration',
|
||||
description: 'Auto-validate and deploy skills on every commit. GitHub Actions, GitLab CI, pre-commit hooks.',
|
||||
icon: (
|
||||
<svg className="w-6 h-6" 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: 'Private Registries',
|
||||
description: 'Host internal skills in private repos. Control access and maintain proprietary knowledge.',
|
||||
icon: (
|
||||
<svg className="w-6 h-6" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M12 15v2m-6 4h12a2 2 0 002-2v-6a2 2 0 00-2-2H6a2 2 0 00-2 2v6a2 2 0 002 2zm10-10V7a4 4 0 00-8 0v4h8z" />
|
||||
</svg>
|
||||
),
|
||||
},
|
||||
];
|
||||
|
||||
export function TeamEnterprise(): React.ReactElement {
|
||||
return (
|
||||
<section className="py-12 sm:py-16 border-b border-zinc-800 bg-gradient-to-b from-zinc-950 to-black">
|
||||
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
|
||||
{/* Section Header */}
|
||||
<div className="text-center mb-8 sm:mb-12">
|
||||
<div className="inline-flex items-center gap-2 border border-zinc-700 bg-zinc-900/80 px-2 sm:px-3 py-1 mb-4 backdrop-blur-sm">
|
||||
<span className="text-[10px] sm:text-xs font-mono text-zinc-300 uppercase tracking-wider">For Teams</span>
|
||||
</div>
|
||||
<h2 className="text-2xl sm:text-3xl lg:text-4xl font-bold text-white mb-3 font-mono tracking-tight">
|
||||
Scale Across Your Organization
|
||||
</h2>
|
||||
<p className="text-zinc-400 font-mono text-xs sm:text-sm max-w-2xl mx-auto">
|
||||
From solo developers to enterprise teams. SkillKit grows with you.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
{/* Team Features Grid */}
|
||||
<div className="grid grid-cols-1 md:grid-cols-2 gap-3 sm:gap-4 mb-8 sm:mb-12">
|
||||
{TEAM_FEATURES.map((feature, index) => (
|
||||
<div
|
||||
key={index}
|
||||
className="group p-4 sm:p-5 border border-zinc-800 bg-zinc-900/30 hover:border-zinc-700 hover:bg-zinc-900/60 transition-all duration-300"
|
||||
>
|
||||
<div className="flex items-start gap-3 sm:gap-4">
|
||||
<div className="p-2 bg-zinc-800/50 border border-zinc-700 text-zinc-400 group-hover:text-white transition-colors flex-shrink-0">
|
||||
{feature.icon}
|
||||
</div>
|
||||
<div>
|
||||
<h3 className="text-base sm:text-lg font-bold text-white font-mono mb-1">{feature.title}</h3>
|
||||
<p className="text-zinc-500 text-xs sm:text-sm">{feature.description}</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
|
||||
{/* API Teaser */}
|
||||
<div className="border border-zinc-800 bg-black/30 p-4 sm:p-6">
|
||||
<div className="flex flex-col sm:flex-row items-start sm:items-center justify-between gap-4">
|
||||
<div>
|
||||
<h3 className="text-base sm:text-lg font-bold text-white font-mono mb-1">TypeScript API</h3>
|
||||
<p className="text-zinc-500 text-xs sm:text-sm">
|
||||
Full programmatic access. Import <code className="text-zinc-400">translateSkill</code>, <code className="text-zinc-400">analyzeProject</code> and more.
|
||||
</p>
|
||||
</div>
|
||||
<a
|
||||
href="https://agenstskills.com/docs/api-reference"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="inline-flex items-center gap-2 px-3 sm:px-4 py-2 bg-zinc-800 text-white font-mono text-xs sm:text-sm hover:bg-zinc-700 transition-colors border border-zinc-700 whitespace-nowrap"
|
||||
>
|
||||
<span>View API</span>
|
||||
<svg className="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5l7 7-7 7" />
|
||||
</svg>
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Bottom CTA */}
|
||||
<div className="mt-6 sm:mt-8 text-center">
|
||||
<a
|
||||
href="https://agenstskills.com/docs"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="inline-flex items-center gap-2 px-4 sm:px-6 py-2.5 sm:py-3 bg-white text-black font-mono text-xs sm:text-sm hover:bg-zinc-200 transition-colors cursor-pointer"
|
||||
>
|
||||
<span>Read the Documentation</span>
|
||||
<svg className="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5l7 7-7 7" />
|
||||
</svg>
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
@@ -1,155 +0,0 @@
|
||||
import React, { useState } from 'react';
|
||||
import { SKILLS_INDEX, IndexedSkill, getSkillsByTag } from '../data/skills-index';
|
||||
|
||||
const CATEGORIES = [
|
||||
{ id: 'all', name: 'All', icon: '◆' },
|
||||
{ id: 'react', name: 'React', icon: '⚛' },
|
||||
{ id: 'typescript', name: 'TypeScript', icon: '◈' },
|
||||
{ id: 'python', name: 'Python', icon: '◉' },
|
||||
{ id: 'ai', name: 'AI/ML', icon: '◎' },
|
||||
{ id: 'security', name: 'Security', icon: '◐' },
|
||||
{ id: 'devops', name: 'DevOps', icon: '◑' },
|
||||
{ id: 'testing', name: 'Testing', icon: '◒' },
|
||||
] as const;
|
||||
|
||||
const TRENDING_SKILLS = [
|
||||
'anthropics/skills/claude-code-guide',
|
||||
'anthropics/skills/claude-code-setup',
|
||||
'obra/superpowers/tdd',
|
||||
'vercel-labs/agent-skills/nextjs',
|
||||
'trailofbits/skills/security-review',
|
||||
'expo/skills/react-native',
|
||||
'remotion-dev/skills/video',
|
||||
'supabase/agent-skills/database',
|
||||
];
|
||||
|
||||
function getTrendingSkills(): IndexedSkill[] {
|
||||
return TRENDING_SKILLS
|
||||
.map(id => SKILLS_INDEX.find(s => s.id === id))
|
||||
.filter((s): s is IndexedSkill => s !== undefined)
|
||||
.slice(0, 8);
|
||||
}
|
||||
|
||||
function getPopularByCategory(category: string): IndexedSkill[] {
|
||||
if (category === 'all') {
|
||||
return SKILLS_INDEX.slice(0, 12);
|
||||
}
|
||||
return getSkillsByTag(category).slice(0, 12);
|
||||
}
|
||||
|
||||
export function TrendingSkills(): React.ReactElement {
|
||||
const [activeCategory, setActiveCategory] = useState('all');
|
||||
const [hoveredSkill, setHoveredSkill] = useState<string | null>(null);
|
||||
|
||||
const trendingSkills = getTrendingSkills();
|
||||
const categorySkills = getPopularByCategory(activeCategory);
|
||||
|
||||
return (
|
||||
<section className="py-12 border-b border-zinc-800 bg-zinc-950">
|
||||
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
|
||||
<div className="flex flex-col sm:flex-row sm:items-center justify-between gap-2 mb-6">
|
||||
<div>
|
||||
<h2 className="text-lg sm:text-xl font-bold text-white mb-1 font-mono">Trending Skills</h2>
|
||||
<p className="text-zinc-500 font-mono text-[10px] sm:text-xs">
|
||||
Popular skills used by the community.
|
||||
</p>
|
||||
</div>
|
||||
<div className="flex items-center gap-2">
|
||||
<span className="w-2 h-2 bg-green-500 rounded-full animate-pulse"></span>
|
||||
<span className="text-[10px] sm:text-xs font-mono text-zinc-500">Updated weekly</span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="grid grid-cols-2 sm:grid-cols-4 gap-2 sm:gap-3 mb-8">
|
||||
{trendingSkills.map((skill, index) => (
|
||||
<div
|
||||
key={skill.id}
|
||||
className="relative group bg-zinc-900/50 border border-zinc-800 p-2 sm:p-4 hover:border-zinc-600 transition-all cursor-pointer"
|
||||
onMouseEnter={() => setHoveredSkill(skill.id)}
|
||||
onMouseLeave={() => setHoveredSkill(null)}
|
||||
>
|
||||
<div className="absolute top-1 sm:top-2 right-1 sm:right-2 text-[10px] sm:text-xs font-mono text-zinc-600">
|
||||
#{index + 1}
|
||||
</div>
|
||||
<div className="font-mono text-[11px] sm:text-sm text-white mb-1 truncate pr-4 sm:pr-6">{skill.name}</div>
|
||||
<div className="text-[10px] sm:text-xs text-zinc-600 truncate">{skill.source}</div>
|
||||
{skill.tags.length > 0 && (
|
||||
<div className="hidden sm:flex flex-wrap gap-1 mt-2">
|
||||
{skill.tags.slice(0, 2).map((tag, idx) => (
|
||||
<span key={idx} className="text-[10px] bg-zinc-800 text-zinc-500 px-1.5 py-0.5">
|
||||
{tag}
|
||||
</span>
|
||||
))}
|
||||
</div>
|
||||
)}
|
||||
{hoveredSkill === skill.id && (
|
||||
<div className="absolute inset-0 bg-white/5 pointer-events-none transition-opacity"></div>
|
||||
)}
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
|
||||
<div className="border-t border-zinc-800 pt-6 sm:pt-8">
|
||||
<div className="mb-3 sm:mb-4">
|
||||
<h3 className="text-xs sm:text-sm font-mono text-zinc-400 uppercase tracking-wider">Browse by Category</h3>
|
||||
</div>
|
||||
|
||||
<div className="flex flex-wrap gap-1.5 sm:gap-2 mb-4 sm:mb-6 overflow-x-auto pb-2 -mx-4 px-4 sm:mx-0 sm:px-0">
|
||||
{CATEGORIES.map(cat => (
|
||||
<button
|
||||
key={cat.id}
|
||||
onClick={() => setActiveCategory(cat.id)}
|
||||
className={`px-2 sm:px-3 py-1 sm:py-1.5 font-mono text-[10px] sm:text-xs transition-all whitespace-nowrap flex-shrink-0 ${
|
||||
activeCategory === cat.id
|
||||
? 'bg-white text-black'
|
||||
: 'bg-zinc-900 text-zinc-400 border border-zinc-800 hover:border-zinc-600 hover:text-white'
|
||||
}`}
|
||||
>
|
||||
<span className="mr-1 sm:mr-1.5">{cat.icon}</span>
|
||||
{cat.name}
|
||||
</button>
|
||||
))}
|
||||
</div>
|
||||
|
||||
<div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-2 sm:gap-3">
|
||||
{categorySkills.map(skill => (
|
||||
<div
|
||||
key={skill.id}
|
||||
className="bg-zinc-900/30 border border-zinc-800 p-4 hover:border-zinc-700 transition-all group"
|
||||
>
|
||||
<div className="flex items-start justify-between">
|
||||
<div className="flex-1 min-w-0">
|
||||
<div className="font-mono text-sm text-white mb-1 truncate">{skill.name}</div>
|
||||
<div className="text-xs text-zinc-600 line-clamp-2">{skill.description || 'No description'}</div>
|
||||
</div>
|
||||
<svg
|
||||
className="w-4 h-4 text-zinc-700 group-hover:text-zinc-400 transition-colors flex-shrink-0 ml-2"
|
||||
fill="none"
|
||||
viewBox="0 0 24 24"
|
||||
stroke="currentColor"
|
||||
>
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5l7 7-7 7" />
|
||||
</svg>
|
||||
</div>
|
||||
<div className="flex items-center justify-between mt-3 pt-3 border-t border-zinc-800">
|
||||
<div className="text-[10px] text-zinc-600 font-mono truncate">{skill.source}</div>
|
||||
{skill.tags.length > 0 && (
|
||||
<span className="text-[10px] bg-zinc-800 text-zinc-500 px-1.5 py-0.5 flex-shrink-0 ml-2">
|
||||
{skill.tags[0]}
|
||||
</span>
|
||||
)}
|
||||
</div>
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
|
||||
{categorySkills.length === 0 && (
|
||||
<div className="text-center py-8 text-zinc-600 font-mono text-sm">
|
||||
No skills found in this category.
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
@@ -1,158 +0,0 @@
|
||||
import React from 'react';
|
||||
|
||||
interface UseCase {
|
||||
persona: string;
|
||||
problem: string;
|
||||
solution: string;
|
||||
command: string;
|
||||
icon: React.ReactNode;
|
||||
gradient: string;
|
||||
}
|
||||
|
||||
const USE_CASES: UseCase[] = [
|
||||
{
|
||||
persona: 'Multi-Agent Developer',
|
||||
problem: 'You\'ve built skills for Claude Code. Now your team wants Cursor, and you want to try Windsurf.',
|
||||
solution: 'SkillKit translates skills between all 32 agents. Write once, deploy everywhere.',
|
||||
command: 'skillkit translate --to cursor,windsurf',
|
||||
gradient: 'from-violet-500/10 to-purple-500/10',
|
||||
icon: (
|
||||
<svg className="w-6 h-6" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z" />
|
||||
</svg>
|
||||
),
|
||||
},
|
||||
{
|
||||
persona: 'Team Lead',
|
||||
problem: 'Each developer has different skills. Onboarding takes weeks. Knowledge is scattered.',
|
||||
solution: 'Shared .skills manifest ensures everyone has the same capabilities. Git-based sync keeps teams aligned.',
|
||||
command: 'skillkit team init && skillkit team share',
|
||||
gradient: 'from-blue-500/10 to-cyan-500/10',
|
||||
icon: (
|
||||
<svg className="w-6 h-6" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M17 20h5v-2a3 3 0 00-5.356-1.857M17 20H7m10 0v-2c0-.656-.126-1.283-.356-1.857M7 20H2v-2a3 3 0 015.356-1.857M7 20v-2c0-.656.126-1.283.356-1.857m0 0a5.002 5.002 0 019.288 0M15 7a3 3 0 11-6 0 3 3 0 016 0zm6 3a2 2 0 11-4 0 2 2 0 014 0zM7 10a2 2 0 11-4 0 2 2 0 014 0z" />
|
||||
</svg>
|
||||
),
|
||||
},
|
||||
{
|
||||
persona: 'New Project Starter',
|
||||
problem: 'Configuring AI agents for each new project is tedious. You forget best practices.',
|
||||
solution: 'Primer analyzes your codebase and auto-generates optimized instructions for all agents.',
|
||||
command: 'skillkit primer --all-agents',
|
||||
gradient: 'from-emerald-500/10 to-teal-500/10',
|
||||
icon: (
|
||||
<svg className="w-6 h-6" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M13 10V3L4 14h7v7l9-11h-7z" />
|
||||
</svg>
|
||||
),
|
||||
},
|
||||
{
|
||||
persona: 'Enterprise Architect',
|
||||
problem: 'Running AI agents across multiple machines and keeping them in sync is a nightmare.',
|
||||
solution: 'Mesh network with encrypted P2P, peer trust, and inter-agent messaging.',
|
||||
command: 'skillkit mesh init && skillkit mesh discover',
|
||||
gradient: 'from-orange-500/10 to-amber-500/10',
|
||||
icon: (
|
||||
<svg className="w-6 h-6" 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>
|
||||
),
|
||||
},
|
||||
];
|
||||
|
||||
const WORKFLOW_FEATURES = [
|
||||
{
|
||||
title: 'Workflow Orchestration',
|
||||
description: 'Compose skills into multi-step workflows. Chain operations, handle errors, and automate complex tasks.',
|
||||
command: 'skillkit workflow run feature-development',
|
||||
},
|
||||
{
|
||||
title: 'Skill Testing',
|
||||
description: 'Built-in test framework with assertions. Validate skills work correctly before deployment.',
|
||||
command: 'skillkit test --tags unit,integration',
|
||||
},
|
||||
{
|
||||
title: 'CI/CD Integration',
|
||||
description: 'Generate GitHub Actions, GitLab CI, and pre-commit hooks for automated skill management.',
|
||||
command: 'skillkit cicd init --provider github',
|
||||
},
|
||||
{
|
||||
title: 'Slash Commands',
|
||||
description: 'Auto-generate /commands for Claude, Cursor, and other agents from your skills.',
|
||||
command: 'skillkit command generate',
|
||||
},
|
||||
];
|
||||
|
||||
export function UseCases(): React.ReactElement {
|
||||
return (
|
||||
<section className="py-12 sm:py-16 border-b border-zinc-800 bg-zinc-950">
|
||||
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
|
||||
{/* Section Header */}
|
||||
<div className="text-center mb-8 sm:mb-12">
|
||||
<h2 className="text-2xl sm:text-3xl lg:text-4xl font-bold text-white mb-3 font-mono tracking-tight">
|
||||
Built for Real Workflows
|
||||
</h2>
|
||||
<p className="text-zinc-400 font-mono text-xs sm:text-sm max-w-2xl mx-auto">
|
||||
Whether you're a solo developer or managing enterprise infrastructure,
|
||||
SkillKit adapts to your needs.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
{/* Use Cases Grid */}
|
||||
<div className="grid grid-cols-1 md:grid-cols-2 gap-3 sm:gap-4 mb-12">
|
||||
{USE_CASES.map((useCase, index) => (
|
||||
<div
|
||||
key={index}
|
||||
className={`relative group p-4 sm:p-6 border border-zinc-800 bg-gradient-to-br ${useCase.gradient} hover:border-zinc-700 transition-all duration-300`}
|
||||
>
|
||||
<div className="flex items-start gap-3 sm:gap-4 mb-4">
|
||||
<div className="p-2 bg-zinc-800/80 border border-zinc-700 text-zinc-300 group-hover:text-white transition-colors flex-shrink-0">
|
||||
{useCase.icon}
|
||||
</div>
|
||||
<div>
|
||||
<h3 className="text-base sm:text-lg font-bold text-white font-mono">{useCase.persona}</h3>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="space-y-3">
|
||||
<div className="flex items-start gap-2">
|
||||
<span className="text-red-400 text-[10px] sm:text-xs mt-0.5 font-mono flex-shrink-0">PAIN:</span>
|
||||
<p className="text-zinc-400 text-xs sm:text-sm">{useCase.problem}</p>
|
||||
</div>
|
||||
<div className="flex items-start gap-2">
|
||||
<span className="text-emerald-400 text-[10px] sm:text-xs mt-0.5 font-mono flex-shrink-0">FIX:</span>
|
||||
<p className="text-zinc-300 text-xs sm:text-sm">{useCase.solution}</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="mt-4 pt-4 border-t border-zinc-800/50">
|
||||
<code className="text-[10px] sm:text-xs font-mono text-zinc-500 bg-black/30 px-2 py-1 block overflow-x-auto whitespace-nowrap">
|
||||
$ {useCase.command}
|
||||
</code>
|
||||
</div>
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
|
||||
{/* Workflow Features */}
|
||||
<div className="border border-zinc-800 bg-black/30 p-4 sm:p-6">
|
||||
<h3 className="text-base sm:text-lg font-bold text-white mb-4 sm:mb-6 font-mono text-center">
|
||||
Developer Tools Built-In
|
||||
</h3>
|
||||
<div className="grid grid-cols-1 sm:grid-cols-2 gap-3 sm:gap-4">
|
||||
{WORKFLOW_FEATURES.map((feature, index) => (
|
||||
<div key={index} className="flex items-start gap-2 sm:gap-3 p-2 sm:p-3 hover:bg-zinc-900/50 transition-colors">
|
||||
<span className="text-zinc-500 mt-1 flex-shrink-0">▸</span>
|
||||
<div className="min-w-0">
|
||||
<h4 className="text-xs sm:text-sm font-bold text-white font-mono mb-1">{feature.title}</h4>
|
||||
<p className="text-[10px] sm:text-xs text-zinc-500 mb-2">{feature.description}</p>
|
||||
<code className="text-[9px] sm:text-[10px] font-mono text-zinc-600 break-all">{feature.command}</code>
|
||||
</div>
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
@@ -1,119 +0,0 @@
|
||||
import { useState, useEffect } from 'react';
|
||||
|
||||
interface Stats {
|
||||
version: string;
|
||||
downloads: string;
|
||||
stars: number;
|
||||
loading: boolean;
|
||||
}
|
||||
|
||||
const CACHE_KEY = 'skillkit_stats_cache';
|
||||
const CACHE_TTL = 5 * 60 * 1000; // 5 minutes
|
||||
|
||||
interface CachedStats {
|
||||
data: Omit<Stats, 'loading'>;
|
||||
timestamp: number;
|
||||
}
|
||||
|
||||
function formatDownloads(count: number): string {
|
||||
if (count >= 1000000) {
|
||||
return `${(count / 1000000).toFixed(1)}M`;
|
||||
}
|
||||
if (count >= 1000) {
|
||||
return `${(count / 1000).toFixed(1)}k`;
|
||||
}
|
||||
return count.toString();
|
||||
}
|
||||
|
||||
function getCachedStats(): CachedStats | null {
|
||||
try {
|
||||
const cached = localStorage.getItem(CACHE_KEY);
|
||||
if (cached) {
|
||||
const parsed: CachedStats = JSON.parse(cached);
|
||||
if (Date.now() - parsed.timestamp < CACHE_TTL) {
|
||||
return parsed;
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
// Ignore localStorage errors
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
function setCachedStats(data: Omit<Stats, 'loading'>): void {
|
||||
try {
|
||||
const cached: CachedStats = {
|
||||
data,
|
||||
timestamp: Date.now(),
|
||||
};
|
||||
localStorage.setItem(CACHE_KEY, JSON.stringify(cached));
|
||||
} catch {
|
||||
// Ignore localStorage errors
|
||||
}
|
||||
}
|
||||
|
||||
export function useStats(): Stats {
|
||||
const [stats, setStats] = useState<Stats>({
|
||||
version: '1.9.0',
|
||||
downloads: '2.4k',
|
||||
stars: 66,
|
||||
loading: true,
|
||||
});
|
||||
|
||||
useEffect(() => {
|
||||
const cached = getCachedStats();
|
||||
if (cached) {
|
||||
setStats({ ...cached.data, loading: false });
|
||||
return;
|
||||
}
|
||||
|
||||
async function fetchStats(): Promise<void> {
|
||||
try {
|
||||
const [npmResponse, githubResponse] = await Promise.allSettled([
|
||||
fetch('https://api.npmjs.org/downloads/point/last-month/skillkit'),
|
||||
fetch('https://api.github.com/repos/rohitg00/skillkit'),
|
||||
]);
|
||||
|
||||
let downloads = '2.4k';
|
||||
let stars = 66;
|
||||
let version = '1.9.0';
|
||||
|
||||
if (npmResponse.status === 'fulfilled' && npmResponse.value.ok) {
|
||||
const npmData = await npmResponse.value.json();
|
||||
if (typeof npmData.downloads === 'number' && Number.isFinite(npmData.downloads)) {
|
||||
downloads = formatDownloads(npmData.downloads);
|
||||
}
|
||||
}
|
||||
|
||||
if (githubResponse.status === 'fulfilled' && githubResponse.value.ok) {
|
||||
const githubData = await githubResponse.value.json();
|
||||
if (typeof githubData.stargazers_count === 'number' && Number.isFinite(githubData.stargazers_count)) {
|
||||
stars = githubData.stargazers_count;
|
||||
}
|
||||
}
|
||||
|
||||
try {
|
||||
const registryResponse = await fetch('https://registry.npmjs.org/skillkit/latest');
|
||||
if (registryResponse.ok) {
|
||||
const registryData = await registryResponse.json();
|
||||
if (registryData.version) {
|
||||
version = registryData.version;
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
// Use default version
|
||||
}
|
||||
|
||||
const newStats = { version, downloads, stars };
|
||||
setCachedStats(newStats);
|
||||
setStats({ ...newStats, loading: false });
|
||||
} catch {
|
||||
setStats((prev) => ({ ...prev, loading: false }));
|
||||
}
|
||||
}
|
||||
|
||||
fetchStats();
|
||||
}, []);
|
||||
|
||||
return stats;
|
||||
}
|
||||
+81
-10
@@ -4,31 +4,102 @@
|
||||
<meta charset="UTF-8" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||
<title>SkillKit - Universal Skills for AI Coding Agents</title>
|
||||
<meta name="description" content="Write once, deploy to 32 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
||||
<meta name="description" content="Portable, reusable skills that work across Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and 12 more AI coding agents.">
|
||||
|
||||
<!-- Open Graph -->
|
||||
<meta property="og:type" content="website">
|
||||
<meta property="og:url" content="https://agenstskills.com/">
|
||||
<meta property="og:url" content="https://skillkit.dev/">
|
||||
<meta property="og:title" content="SkillKit - Universal Skills for AI Coding Agents">
|
||||
<meta property="og:description" content="Write once, deploy to 32 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
||||
<meta property="og:image" content="https://agenstskills.com/og-image.png">
|
||||
<meta property="og:image:width" content="1200">
|
||||
<meta property="og:image:height" content="630">
|
||||
<meta property="og:site_name" content="SkillKit">
|
||||
<meta property="og:description" content="Portable, reusable skills that work across Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and 12 more AI coding agents.">
|
||||
<meta property="og:image" content="/og-image.png">
|
||||
|
||||
<!-- Twitter -->
|
||||
<meta name="twitter:card" content="summary_large_image">
|
||||
<meta name="twitter:url" content="https://agenstskills.com/">
|
||||
<meta name="twitter:title" content="SkillKit - Universal Skills for AI Coding Agents">
|
||||
<meta name="twitter:description" content="Write once, deploy to 32 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
||||
<meta name="twitter:image" content="https://agenstskills.com/og-image.png">
|
||||
<meta name="twitter:description" content="Portable, reusable skills that work across Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and 12 more AI coding agents.">
|
||||
<meta name="twitter:image" content="/og-image.png">
|
||||
|
||||
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
|
||||
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32.png" />
|
||||
<link rel="apple-touch-icon" href="/apple-touch-icon.png" />
|
||||
<script src="https://cdn.tailwindcss.com"></script>
|
||||
<link rel="preconnect" href="https://fonts.googleapis.com">
|
||||
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
||||
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
|
||||
<script>
|
||||
tailwind.config = {
|
||||
darkMode: 'class',
|
||||
theme: {
|
||||
screens: {
|
||||
'xs': '475px',
|
||||
'sm': '640px',
|
||||
'md': '768px',
|
||||
'lg': '1024px',
|
||||
'xl': '1280px',
|
||||
'2xl': '1536px',
|
||||
},
|
||||
extend: {
|
||||
fontFamily: {
|
||||
sans: ['Inter', 'sans-serif'],
|
||||
mono: ['JetBrains Mono', 'monospace'],
|
||||
},
|
||||
colors: {
|
||||
background: '#000000',
|
||||
surface: '#09090b',
|
||||
border: '#27272a',
|
||||
highlight: '#ffffff',
|
||||
},
|
||||
animation: {
|
||||
'cursor-blink': 'blink 1s step-end infinite',
|
||||
},
|
||||
keyframes: {
|
||||
blink: {
|
||||
'0%, 100%': { opacity: '1' },
|
||||
'50%': { opacity: '0' },
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
</script>
|
||||
<style>
|
||||
body {
|
||||
background-color: #000000;
|
||||
color: #e4e4e7;
|
||||
font-family: 'Inter', sans-serif;
|
||||
}
|
||||
h1, h2, h3, h4, h5, h6, .font-mono {
|
||||
font-family: 'JetBrains Mono', monospace;
|
||||
}
|
||||
::selection {
|
||||
background-color: #ffffff;
|
||||
color: #000000;
|
||||
}
|
||||
::-webkit-scrollbar {
|
||||
width: 10px;
|
||||
background: #000000;
|
||||
}
|
||||
::-webkit-scrollbar-thumb {
|
||||
background: #27272a;
|
||||
border: 1px solid #000000;
|
||||
}
|
||||
::-webkit-scrollbar-thumb:hover {
|
||||
background: #3f3f46;
|
||||
}
|
||||
|
||||
.terminal-scanline {
|
||||
background: linear-gradient(to bottom, rgba(255,255,255,0), rgba(255,255,255,0) 50%, rgba(0,0,0,0.1) 50%, rgba(0,0,0,0.1));
|
||||
background-size: 100% 4px;
|
||||
position: absolute;
|
||||
top: 0;
|
||||
left: 0;
|
||||
right: 0;
|
||||
bottom: 0;
|
||||
pointer-events: none;
|
||||
z-index: 10;
|
||||
opacity: 0.1;
|
||||
}
|
||||
</style>
|
||||
<script type="importmap">
|
||||
{
|
||||
"imports": {
|
||||
|
||||
@@ -1,6 +1,5 @@
|
||||
import React from 'react';
|
||||
import ReactDOM from 'react-dom/client';
|
||||
import './styles.css';
|
||||
import App from './App';
|
||||
|
||||
const rootElement = document.getElementById('root');
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
{
|
||||
"name": "SkillKit",
|
||||
"description": "Supercharge Every AI Coding Agent. Translate, manage, and sync skills across Claude, Cursor, Windsurf, and 32 agents.",
|
||||
"description": "Supercharge Every AI Coding Agent. Translate, manage, and sync skills across Claude, Cursor, Windsurf, and 17+ agents.",
|
||||
"requestFramePermissions": []
|
||||
}
|
||||
Generated
-679
@@ -13,29 +13,12 @@
|
||||
"react-dom": "^19.2.3"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@tailwindcss/postcss": "^4.1.18",
|
||||
"@types/node": "^22.14.0",
|
||||
"@vitejs/plugin-react": "^5.0.0",
|
||||
"autoprefixer": "^10.4.23",
|
||||
"postcss": "^8.5.6",
|
||||
"tailwindcss": "^4.1.18",
|
||||
"typescript": "~5.8.2",
|
||||
"vite": "^6.2.0"
|
||||
}
|
||||
},
|
||||
"node_modules/@alloc/quick-lru": {
|
||||
"version": "5.2.0",
|
||||
"resolved": "https://registry.npmjs.org/@alloc/quick-lru/-/quick-lru-5.2.0.tgz",
|
||||
"integrity": "sha512-UrcABB+4bUrFABwbluTIBErXwvbsU/V7TZWfmbgJfbkwiBuziS9gxdODUyuiecfdGQ85jglMW6juS3+z5TsKLw==",
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"engines": {
|
||||
"node": ">=10"
|
||||
},
|
||||
"funding": {
|
||||
"url": "https://github.com/sponsors/sindresorhus"
|
||||
}
|
||||
},
|
||||
"node_modules/@babel/code-frame": {
|
||||
"version": "7.28.6",
|
||||
"resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.28.6.tgz",
|
||||
@@ -1280,277 +1263,6 @@
|
||||
"win32"
|
||||
]
|
||||
},
|
||||
"node_modules/@tailwindcss/node": {
|
||||
"version": "4.1.18",
|
||||
"resolved": "https://registry.npmjs.org/@tailwindcss/node/-/node-4.1.18.tgz",
|
||||
"integrity": "sha512-DoR7U1P7iYhw16qJ49fgXUlry1t4CpXeErJHnQ44JgTSKMaZUdf17cfn5mHchfJ4KRBZRFA/Coo+MUF5+gOaCQ==",
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"@jridgewell/remapping": "^2.3.4",
|
||||
"enhanced-resolve": "^5.18.3",
|
||||
"jiti": "^2.6.1",
|
||||
"lightningcss": "1.30.2",
|
||||
"magic-string": "^0.30.21",
|
||||
"source-map-js": "^1.2.1",
|
||||
"tailwindcss": "4.1.18"
|
||||
}
|
||||
},
|
||||
"node_modules/@tailwindcss/oxide": {
|
||||
"version": "4.1.18",
|
||||
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide/-/oxide-4.1.18.tgz",
|
||||
"integrity": "sha512-EgCR5tTS5bUSKQgzeMClT6iCY3ToqE1y+ZB0AKldj809QXk1Y+3jB0upOYZrn9aGIzPtUsP7sX4QQ4XtjBB95A==",
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"engines": {
|
||||
"node": ">= 10"
|
||||
},
|
||||
"optionalDependencies": {
|
||||
"@tailwindcss/oxide-android-arm64": "4.1.18",
|
||||
"@tailwindcss/oxide-darwin-arm64": "4.1.18",
|
||||
"@tailwindcss/oxide-darwin-x64": "4.1.18",
|
||||
"@tailwindcss/oxide-freebsd-x64": "4.1.18",
|
||||
"@tailwindcss/oxide-linux-arm-gnueabihf": "4.1.18",
|
||||
"@tailwindcss/oxide-linux-arm64-gnu": "4.1.18",
|
||||
"@tailwindcss/oxide-linux-arm64-musl": "4.1.18",
|
||||
"@tailwindcss/oxide-linux-x64-gnu": "4.1.18",
|
||||
"@tailwindcss/oxide-linux-x64-musl": "4.1.18",
|
||||
"@tailwindcss/oxide-wasm32-wasi": "4.1.18",
|
||||
"@tailwindcss/oxide-win32-arm64-msvc": "4.1.18",
|
||||
"@tailwindcss/oxide-win32-x64-msvc": "4.1.18"
|
||||
}
|
||||
},
|
||||
"node_modules/@tailwindcss/oxide-android-arm64": {
|
||||
"version": "4.1.18",
|
||||
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-android-arm64/-/oxide-android-arm64-4.1.18.tgz",
|
||||
"integrity": "sha512-dJHz7+Ugr9U/diKJA0W6N/6/cjI+ZTAoxPf9Iz9BFRF2GzEX8IvXxFIi/dZBloVJX/MZGvRuFA9rqwdiIEZQ0Q==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"android"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 10"
|
||||
}
|
||||
},
|
||||
"node_modules/@tailwindcss/oxide-darwin-arm64": {
|
||||
"version": "4.1.18",
|
||||
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-darwin-arm64/-/oxide-darwin-arm64-4.1.18.tgz",
|
||||
"integrity": "sha512-Gc2q4Qhs660bhjyBSKgq6BYvwDz4G+BuyJ5H1xfhmDR3D8HnHCmT/BSkvSL0vQLy/nkMLY20PQ2OoYMO15Jd0A==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"darwin"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 10"
|
||||
}
|
||||
},
|
||||
"node_modules/@tailwindcss/oxide-darwin-x64": {
|
||||
"version": "4.1.18",
|
||||
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-darwin-x64/-/oxide-darwin-x64-4.1.18.tgz",
|
||||
"integrity": "sha512-FL5oxr2xQsFrc3X9o1fjHKBYBMD1QZNyc1Xzw/h5Qu4XnEBi3dZn96HcHm41c/euGV+GRiXFfh2hUCyKi/e+yw==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"darwin"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 10"
|
||||
}
|
||||
},
|
||||
"node_modules/@tailwindcss/oxide-freebsd-x64": {
|
||||
"version": "4.1.18",
|
||||
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-freebsd-x64/-/oxide-freebsd-x64-4.1.18.tgz",
|
||||
"integrity": "sha512-Fj+RHgu5bDodmV1dM9yAxlfJwkkWvLiRjbhuO2LEtwtlYlBgiAT4x/j5wQr1tC3SANAgD+0YcmWVrj8R9trVMA==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"freebsd"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 10"
|
||||
}
|
||||
},
|
||||
"node_modules/@tailwindcss/oxide-linux-arm-gnueabihf": {
|
||||
"version": "4.1.18",
|
||||
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm-gnueabihf/-/oxide-linux-arm-gnueabihf-4.1.18.tgz",
|
||||
"integrity": "sha512-Fp+Wzk/Ws4dZn+LV2Nqx3IilnhH51YZoRaYHQsVq3RQvEl+71VGKFpkfHrLM/Li+kt5c0DJe/bHXK1eHgDmdiA==",
|
||||
"cpu": [
|
||||
"arm"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 10"
|
||||
}
|
||||
},
|
||||
"node_modules/@tailwindcss/oxide-linux-arm64-gnu": {
|
||||
"version": "4.1.18",
|
||||
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm64-gnu/-/oxide-linux-arm64-gnu-4.1.18.tgz",
|
||||
"integrity": "sha512-S0n3jboLysNbh55Vrt7pk9wgpyTTPD0fdQeh7wQfMqLPM/Hrxi+dVsLsPrycQjGKEQk85Kgbx+6+QnYNiHalnw==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 10"
|
||||
}
|
||||
},
|
||||
"node_modules/@tailwindcss/oxide-linux-arm64-musl": {
|
||||
"version": "4.1.18",
|
||||
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm64-musl/-/oxide-linux-arm64-musl-4.1.18.tgz",
|
||||
"integrity": "sha512-1px92582HkPQlaaCkdRcio71p8bc8i/ap5807tPRDK/uw953cauQBT8c5tVGkOwrHMfc2Yh6UuxaH4vtTjGvHg==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 10"
|
||||
}
|
||||
},
|
||||
"node_modules/@tailwindcss/oxide-linux-x64-gnu": {
|
||||
"version": "4.1.18",
|
||||
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-x64-gnu/-/oxide-linux-x64-gnu-4.1.18.tgz",
|
||||
"integrity": "sha512-v3gyT0ivkfBLoZGF9LyHmts0Isc8jHZyVcbzio6Wpzifg/+5ZJpDiRiUhDLkcr7f/r38SWNe7ucxmGW3j3Kb/g==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 10"
|
||||
}
|
||||
},
|
||||
"node_modules/@tailwindcss/oxide-linux-x64-musl": {
|
||||
"version": "4.1.18",
|
||||
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-x64-musl/-/oxide-linux-x64-musl-4.1.18.tgz",
|
||||
"integrity": "sha512-bhJ2y2OQNlcRwwgOAGMY0xTFStt4/wyU6pvI6LSuZpRgKQwxTec0/3Scu91O8ir7qCR3AuepQKLU/kX99FouqQ==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 10"
|
||||
}
|
||||
},
|
||||
"node_modules/@tailwindcss/oxide-wasm32-wasi": {
|
||||
"version": "4.1.18",
|
||||
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-wasm32-wasi/-/oxide-wasm32-wasi-4.1.18.tgz",
|
||||
"integrity": "sha512-LffYTvPjODiP6PT16oNeUQJzNVyJl1cjIebq/rWWBF+3eDst5JGEFSc5cWxyRCJ0Mxl+KyIkqRxk1XPEs9x8TA==",
|
||||
"bundleDependencies": [
|
||||
"@napi-rs/wasm-runtime",
|
||||
"@emnapi/core",
|
||||
"@emnapi/runtime",
|
||||
"@tybys/wasm-util",
|
||||
"@emnapi/wasi-threads",
|
||||
"tslib"
|
||||
],
|
||||
"cpu": [
|
||||
"wasm32"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"dependencies": {
|
||||
"@emnapi/core": "^1.7.1",
|
||||
"@emnapi/runtime": "^1.7.1",
|
||||
"@emnapi/wasi-threads": "^1.1.0",
|
||||
"@napi-rs/wasm-runtime": "^1.1.0",
|
||||
"@tybys/wasm-util": "^0.10.1",
|
||||
"tslib": "^2.4.0"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=14.0.0"
|
||||
}
|
||||
},
|
||||
"node_modules/@tailwindcss/oxide-win32-arm64-msvc": {
|
||||
"version": "4.1.18",
|
||||
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-win32-arm64-msvc/-/oxide-win32-arm64-msvc-4.1.18.tgz",
|
||||
"integrity": "sha512-HjSA7mr9HmC8fu6bdsZvZ+dhjyGCLdotjVOgLA2vEqxEBZaQo9YTX4kwgEvPCpRh8o4uWc4J/wEoFzhEmjvPbA==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"win32"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 10"
|
||||
}
|
||||
},
|
||||
"node_modules/@tailwindcss/oxide-win32-x64-msvc": {
|
||||
"version": "4.1.18",
|
||||
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-win32-x64-msvc/-/oxide-win32-x64-msvc-4.1.18.tgz",
|
||||
"integrity": "sha512-bJWbyYpUlqamC8dpR7pfjA0I7vdF6t5VpUGMWRkXVE3AXgIZjYUYAK7II1GNaxR8J1SSrSrppRar8G++JekE3Q==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"win32"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 10"
|
||||
}
|
||||
},
|
||||
"node_modules/@tailwindcss/postcss": {
|
||||
"version": "4.1.18",
|
||||
"resolved": "https://registry.npmjs.org/@tailwindcss/postcss/-/postcss-4.1.18.tgz",
|
||||
"integrity": "sha512-Ce0GFnzAOuPyfV5SxjXGn0CubwGcuDB0zcdaPuCSzAa/2vII24JTkH+I6jcbXLb1ctjZMZZI6OjDaLPJQL1S0g==",
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"@alloc/quick-lru": "^5.2.0",
|
||||
"@tailwindcss/node": "4.1.18",
|
||||
"@tailwindcss/oxide": "4.1.18",
|
||||
"postcss": "^8.4.41",
|
||||
"tailwindcss": "4.1.18"
|
||||
}
|
||||
},
|
||||
"node_modules/@types/babel__core": {
|
||||
"version": "7.20.5",
|
||||
"resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.20.5.tgz",
|
||||
@@ -1666,43 +1378,6 @@
|
||||
"url": "https://github.com/chalk/ansi-styles?sponsor=1"
|
||||
}
|
||||
},
|
||||
"node_modules/autoprefixer": {
|
||||
"version": "10.4.23",
|
||||
"resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-10.4.23.tgz",
|
||||
"integrity": "sha512-YYTXSFulfwytnjAPlw8QHncHJmlvFKtczb8InXaAx9Q0LbfDnfEYDE55omerIJKihhmU61Ft+cAOSzQVaBUmeA==",
|
||||
"dev": true,
|
||||
"funding": [
|
||||
{
|
||||
"type": "opencollective",
|
||||
"url": "https://opencollective.com/postcss/"
|
||||
},
|
||||
{
|
||||
"type": "tidelift",
|
||||
"url": "https://tidelift.com/funding/github/npm/autoprefixer"
|
||||
},
|
||||
{
|
||||
"type": "github",
|
||||
"url": "https://github.com/sponsors/ai"
|
||||
}
|
||||
],
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"browserslist": "^4.28.1",
|
||||
"caniuse-lite": "^1.0.30001760",
|
||||
"fraction.js": "^5.3.4",
|
||||
"picocolors": "^1.1.1",
|
||||
"postcss-value-parser": "^4.2.0"
|
||||
},
|
||||
"bin": {
|
||||
"autoprefixer": "bin/autoprefixer"
|
||||
},
|
||||
"engines": {
|
||||
"node": "^10 || ^12 || >=14"
|
||||
},
|
||||
"peerDependencies": {
|
||||
"postcss": "^8.1.0"
|
||||
}
|
||||
},
|
||||
"node_modules/balanced-match": {
|
||||
"version": "1.0.2",
|
||||
"resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
|
||||
@@ -1883,16 +1558,6 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"node_modules/detect-libc": {
|
||||
"version": "2.1.2",
|
||||
"resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
|
||||
"integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",
|
||||
"dev": true,
|
||||
"license": "Apache-2.0",
|
||||
"engines": {
|
||||
"node": ">=8"
|
||||
}
|
||||
},
|
||||
"node_modules/eastasianwidth": {
|
||||
"version": "0.2.0",
|
||||
"resolved": "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz",
|
||||
@@ -1921,20 +1586,6 @@
|
||||
"integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==",
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/enhanced-resolve": {
|
||||
"version": "5.18.4",
|
||||
"resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.18.4.tgz",
|
||||
"integrity": "sha512-LgQMM4WXU3QI+SYgEc2liRgznaD5ojbmY3sb8LxyguVkIg5FxdpTkvk72te2R38/TGKxH634oLxXRGY6d7AP+Q==",
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"graceful-fs": "^4.2.4",
|
||||
"tapable": "^2.2.0"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=10.13.0"
|
||||
}
|
||||
},
|
||||
"node_modules/esbuild": {
|
||||
"version": "0.25.12",
|
||||
"resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.12.tgz",
|
||||
@@ -2062,20 +1713,6 @@
|
||||
"node": ">=12.20.0"
|
||||
}
|
||||
},
|
||||
"node_modules/fraction.js": {
|
||||
"version": "5.3.4",
|
||||
"resolved": "https://registry.npmjs.org/fraction.js/-/fraction.js-5.3.4.tgz",
|
||||
"integrity": "sha512-1X1NTtiJphryn/uLQz3whtY6jK3fTqoE3ohKs0tT+Ujr1W59oopxmoEh7Lu5p6vBaPbgoM0bzveAW4Qi5RyWDQ==",
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"engines": {
|
||||
"node": "*"
|
||||
},
|
||||
"funding": {
|
||||
"type": "github",
|
||||
"url": "https://github.com/sponsors/rawify"
|
||||
}
|
||||
},
|
||||
"node_modules/fsevents": {
|
||||
"version": "2.3.3",
|
||||
"resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
|
||||
@@ -2177,13 +1814,6 @@
|
||||
"node": ">=14"
|
||||
}
|
||||
},
|
||||
"node_modules/graceful-fs": {
|
||||
"version": "4.2.11",
|
||||
"resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
|
||||
"integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
|
||||
"dev": true,
|
||||
"license": "ISC"
|
||||
},
|
||||
"node_modules/gtoken": {
|
||||
"version": "8.0.0",
|
||||
"resolved": "https://registry.npmjs.org/gtoken/-/gtoken-8.0.0.tgz",
|
||||
@@ -2240,16 +1870,6 @@
|
||||
"@pkgjs/parseargs": "^0.11.0"
|
||||
}
|
||||
},
|
||||
"node_modules/jiti": {
|
||||
"version": "2.6.1",
|
||||
"resolved": "https://registry.npmjs.org/jiti/-/jiti-2.6.1.tgz",
|
||||
"integrity": "sha512-ekilCSN1jwRvIbgeg/57YFh8qQDNbwDb9xT/qu2DAHbFFZUicIl4ygVaAvzveMhMVr3LnpSKTNnwt8PoOfmKhQ==",
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"bin": {
|
||||
"jiti": "lib/jiti-cli.mjs"
|
||||
}
|
||||
},
|
||||
"node_modules/js-tokens": {
|
||||
"version": "4.0.0",
|
||||
"resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
|
||||
@@ -2313,267 +1933,6 @@
|
||||
"safe-buffer": "^5.0.1"
|
||||
}
|
||||
},
|
||||
"node_modules/lightningcss": {
|
||||
"version": "1.30.2",
|
||||
"resolved": "https://registry.npmjs.org/lightningcss/-/lightningcss-1.30.2.tgz",
|
||||
"integrity": "sha512-utfs7Pr5uJyyvDETitgsaqSyjCb2qNRAtuqUeWIAKztsOYdcACf2KtARYXg2pSvhkt+9NfoaNY7fxjl6nuMjIQ==",
|
||||
"dev": true,
|
||||
"license": "MPL-2.0",
|
||||
"dependencies": {
|
||||
"detect-libc": "^2.0.3"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">= 12.0.0"
|
||||
},
|
||||
"funding": {
|
||||
"type": "opencollective",
|
||||
"url": "https://opencollective.com/parcel"
|
||||
},
|
||||
"optionalDependencies": {
|
||||
"lightningcss-android-arm64": "1.30.2",
|
||||
"lightningcss-darwin-arm64": "1.30.2",
|
||||
"lightningcss-darwin-x64": "1.30.2",
|
||||
"lightningcss-freebsd-x64": "1.30.2",
|
||||
"lightningcss-linux-arm-gnueabihf": "1.30.2",
|
||||
"lightningcss-linux-arm64-gnu": "1.30.2",
|
||||
"lightningcss-linux-arm64-musl": "1.30.2",
|
||||
"lightningcss-linux-x64-gnu": "1.30.2",
|
||||
"lightningcss-linux-x64-musl": "1.30.2",
|
||||
"lightningcss-win32-arm64-msvc": "1.30.2",
|
||||
"lightningcss-win32-x64-msvc": "1.30.2"
|
||||
}
|
||||
},
|
||||
"node_modules/lightningcss-android-arm64": {
|
||||
"version": "1.30.2",
|
||||
"resolved": "https://registry.npmjs.org/lightningcss-android-arm64/-/lightningcss-android-arm64-1.30.2.tgz",
|
||||
"integrity": "sha512-BH9sEdOCahSgmkVhBLeU7Hc9DWeZ1Eb6wNS6Da8igvUwAe0sqROHddIlvU06q3WyXVEOYDZ6ykBZQnjTbmo4+A==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MPL-2.0",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"android"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 12.0.0"
|
||||
},
|
||||
"funding": {
|
||||
"type": "opencollective",
|
||||
"url": "https://opencollective.com/parcel"
|
||||
}
|
||||
},
|
||||
"node_modules/lightningcss-darwin-arm64": {
|
||||
"version": "1.30.2",
|
||||
"resolved": "https://registry.npmjs.org/lightningcss-darwin-arm64/-/lightningcss-darwin-arm64-1.30.2.tgz",
|
||||
"integrity": "sha512-ylTcDJBN3Hp21TdhRT5zBOIi73P6/W0qwvlFEk22fkdXchtNTOU4Qc37SkzV+EKYxLouZ6M4LG9NfZ1qkhhBWA==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MPL-2.0",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"darwin"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 12.0.0"
|
||||
},
|
||||
"funding": {
|
||||
"type": "opencollective",
|
||||
"url": "https://opencollective.com/parcel"
|
||||
}
|
||||
},
|
||||
"node_modules/lightningcss-darwin-x64": {
|
||||
"version": "1.30.2",
|
||||
"resolved": "https://registry.npmjs.org/lightningcss-darwin-x64/-/lightningcss-darwin-x64-1.30.2.tgz",
|
||||
"integrity": "sha512-oBZgKchomuDYxr7ilwLcyms6BCyLn0z8J0+ZZmfpjwg9fRVZIR5/GMXd7r9RH94iDhld3UmSjBM6nXWM2TfZTQ==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MPL-2.0",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"darwin"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 12.0.0"
|
||||
},
|
||||
"funding": {
|
||||
"type": "opencollective",
|
||||
"url": "https://opencollective.com/parcel"
|
||||
}
|
||||
},
|
||||
"node_modules/lightningcss-freebsd-x64": {
|
||||
"version": "1.30.2",
|
||||
"resolved": "https://registry.npmjs.org/lightningcss-freebsd-x64/-/lightningcss-freebsd-x64-1.30.2.tgz",
|
||||
"integrity": "sha512-c2bH6xTrf4BDpK8MoGG4Bd6zAMZDAXS569UxCAGcA7IKbHNMlhGQ89eRmvpIUGfKWNVdbhSbkQaWhEoMGmGslA==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MPL-2.0",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"freebsd"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 12.0.0"
|
||||
},
|
||||
"funding": {
|
||||
"type": "opencollective",
|
||||
"url": "https://opencollective.com/parcel"
|
||||
}
|
||||
},
|
||||
"node_modules/lightningcss-linux-arm-gnueabihf": {
|
||||
"version": "1.30.2",
|
||||
"resolved": "https://registry.npmjs.org/lightningcss-linux-arm-gnueabihf/-/lightningcss-linux-arm-gnueabihf-1.30.2.tgz",
|
||||
"integrity": "sha512-eVdpxh4wYcm0PofJIZVuYuLiqBIakQ9uFZmipf6LF/HRj5Bgm0eb3qL/mr1smyXIS1twwOxNWndd8z0E374hiA==",
|
||||
"cpu": [
|
||||
"arm"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MPL-2.0",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 12.0.0"
|
||||
},
|
||||
"funding": {
|
||||
"type": "opencollective",
|
||||
"url": "https://opencollective.com/parcel"
|
||||
}
|
||||
},
|
||||
"node_modules/lightningcss-linux-arm64-gnu": {
|
||||
"version": "1.30.2",
|
||||
"resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-gnu/-/lightningcss-linux-arm64-gnu-1.30.2.tgz",
|
||||
"integrity": "sha512-UK65WJAbwIJbiBFXpxrbTNArtfuznvxAJw4Q2ZGlU8kPeDIWEX1dg3rn2veBVUylA2Ezg89ktszWbaQnxD/e3A==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MPL-2.0",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 12.0.0"
|
||||
},
|
||||
"funding": {
|
||||
"type": "opencollective",
|
||||
"url": "https://opencollective.com/parcel"
|
||||
}
|
||||
},
|
||||
"node_modules/lightningcss-linux-arm64-musl": {
|
||||
"version": "1.30.2",
|
||||
"resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-musl/-/lightningcss-linux-arm64-musl-1.30.2.tgz",
|
||||
"integrity": "sha512-5Vh9dGeblpTxWHpOx8iauV02popZDsCYMPIgiuw97OJ5uaDsL86cnqSFs5LZkG3ghHoX5isLgWzMs+eD1YzrnA==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MPL-2.0",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 12.0.0"
|
||||
},
|
||||
"funding": {
|
||||
"type": "opencollective",
|
||||
"url": "https://opencollective.com/parcel"
|
||||
}
|
||||
},
|
||||
"node_modules/lightningcss-linux-x64-gnu": {
|
||||
"version": "1.30.2",
|
||||
"resolved": "https://registry.npmjs.org/lightningcss-linux-x64-gnu/-/lightningcss-linux-x64-gnu-1.30.2.tgz",
|
||||
"integrity": "sha512-Cfd46gdmj1vQ+lR6VRTTadNHu6ALuw2pKR9lYq4FnhvgBc4zWY1EtZcAc6EffShbb1MFrIPfLDXD6Xprbnni4w==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MPL-2.0",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 12.0.0"
|
||||
},
|
||||
"funding": {
|
||||
"type": "opencollective",
|
||||
"url": "https://opencollective.com/parcel"
|
||||
}
|
||||
},
|
||||
"node_modules/lightningcss-linux-x64-musl": {
|
||||
"version": "1.30.2",
|
||||
"resolved": "https://registry.npmjs.org/lightningcss-linux-x64-musl/-/lightningcss-linux-x64-musl-1.30.2.tgz",
|
||||
"integrity": "sha512-XJaLUUFXb6/QG2lGIW6aIk6jKdtjtcffUT0NKvIqhSBY3hh9Ch+1LCeH80dR9q9LBjG3ewbDjnumefsLsP6aiA==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MPL-2.0",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 12.0.0"
|
||||
},
|
||||
"funding": {
|
||||
"type": "opencollective",
|
||||
"url": "https://opencollective.com/parcel"
|
||||
}
|
||||
},
|
||||
"node_modules/lightningcss-win32-arm64-msvc": {
|
||||
"version": "1.30.2",
|
||||
"resolved": "https://registry.npmjs.org/lightningcss-win32-arm64-msvc/-/lightningcss-win32-arm64-msvc-1.30.2.tgz",
|
||||
"integrity": "sha512-FZn+vaj7zLv//D/192WFFVA0RgHawIcHqLX9xuWiQt7P0PtdFEVaxgF9rjM/IRYHQXNnk61/H/gb2Ei+kUQ4xQ==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MPL-2.0",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"win32"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 12.0.0"
|
||||
},
|
||||
"funding": {
|
||||
"type": "opencollective",
|
||||
"url": "https://opencollective.com/parcel"
|
||||
}
|
||||
},
|
||||
"node_modules/lightningcss-win32-x64-msvc": {
|
||||
"version": "1.30.2",
|
||||
"resolved": "https://registry.npmjs.org/lightningcss-win32-x64-msvc/-/lightningcss-win32-x64-msvc-1.30.2.tgz",
|
||||
"integrity": "sha512-5g1yc73p+iAkid5phb4oVFMB45417DkRevRbt/El/gKXJk4jid+vPFF/AXbxn05Aky8PapwzZrdJShv5C0avjw==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MPL-2.0",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"win32"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 12.0.0"
|
||||
},
|
||||
"funding": {
|
||||
"type": "opencollective",
|
||||
"url": "https://opencollective.com/parcel"
|
||||
}
|
||||
},
|
||||
"node_modules/long": {
|
||||
"version": "5.3.2",
|
||||
"resolved": "https://registry.npmjs.org/long/-/long-5.3.2.tgz",
|
||||
@@ -2590,16 +1949,6 @@
|
||||
"yallist": "^3.0.2"
|
||||
}
|
||||
},
|
||||
"node_modules/magic-string": {
|
||||
"version": "0.30.21",
|
||||
"resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz",
|
||||
"integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==",
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"@jridgewell/sourcemap-codec": "^1.5.5"
|
||||
}
|
||||
},
|
||||
"node_modules/minimatch": {
|
||||
"version": "9.0.5",
|
||||
"resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz",
|
||||
@@ -2780,13 +2129,6 @@
|
||||
"node": "^10 || ^12 || >=14"
|
||||
}
|
||||
},
|
||||
"node_modules/postcss-value-parser": {
|
||||
"version": "4.2.0",
|
||||
"resolved": "https://registry.npmjs.org/postcss-value-parser/-/postcss-value-parser-4.2.0.tgz",
|
||||
"integrity": "sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==",
|
||||
"dev": true,
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/protobufjs": {
|
||||
"version": "7.5.4",
|
||||
"resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.5.4.tgz",
|
||||
@@ -3077,27 +2419,6 @@
|
||||
"node": ">=8"
|
||||
}
|
||||
},
|
||||
"node_modules/tailwindcss": {
|
||||
"version": "4.1.18",
|
||||
"resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-4.1.18.tgz",
|
||||
"integrity": "sha512-4+Z+0yiYyEtUVCScyfHCxOYP06L5Ne+JiHhY2IjR2KWMIWhJOYZKLSGZaP5HkZ8+bY0cxfzwDE5uOmzFXyIwxw==",
|
||||
"dev": true,
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/tapable": {
|
||||
"version": "2.3.0",
|
||||
"resolved": "https://registry.npmjs.org/tapable/-/tapable-2.3.0.tgz",
|
||||
"integrity": "sha512-g9ljZiwki/LfxmQADO3dEY1CbpmXT5Hm2fJ+QaGKwSXUylMybePR7/67YW7jOrrvjEgL1Fmz5kzyAjWVWLlucg==",
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"engines": {
|
||||
"node": ">=6"
|
||||
},
|
||||
"funding": {
|
||||
"type": "opencollective",
|
||||
"url": "https://opencollective.com/webpack"
|
||||
}
|
||||
},
|
||||
"node_modules/tinyglobby": {
|
||||
"version": "0.2.15",
|
||||
"resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz",
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "skillkit",
|
||||
"private": true,
|
||||
"version": "1.14.0",
|
||||
"version": "0.0.0",
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"dev": "vite",
|
||||
@@ -9,17 +9,13 @@
|
||||
"preview": "vite preview"
|
||||
},
|
||||
"dependencies": {
|
||||
"@google/genai": "^1.38.0",
|
||||
"react": "^19.2.3",
|
||||
"@google/genai": "^1.38.0",
|
||||
"react-dom": "^19.2.3"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@tailwindcss/postcss": "^4.1.18",
|
||||
"@types/node": "^22.14.0",
|
||||
"@vitejs/plugin-react": "^5.0.0",
|
||||
"autoprefixer": "^10.4.23",
|
||||
"postcss": "^8.5.6",
|
||||
"tailwindcss": "^4.1.18",
|
||||
"typescript": "~5.8.2",
|
||||
"vite": "^6.2.0"
|
||||
}
|
||||
|
||||
@@ -1,5 +0,0 @@
|
||||
export default {
|
||||
plugins: {
|
||||
'@tailwindcss/postcss': {},
|
||||
},
|
||||
}
|
||||
@@ -1,354 +0,0 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title>SkillKit API</title>
|
||||
<meta name="description" content="SkillKit REST API — discover and retrieve 15,000+ AI agent skills on demand">
|
||||
<link rel="icon" type="image/svg+xml" href="/favicon.svg">
|
||||
<link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@5/swagger-ui.css">
|
||||
<style>
|
||||
* { margin: 0; padding: 0; box-sizing: border-box; }
|
||||
|
||||
body {
|
||||
background: #0a0a0a;
|
||||
color: #e4e4e7;
|
||||
font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif;
|
||||
}
|
||||
|
||||
.topbar {
|
||||
position: sticky;
|
||||
top: 0;
|
||||
z-index: 50;
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: space-between;
|
||||
height: 56px;
|
||||
padding: 0 24px;
|
||||
border-bottom: 1px solid #27272a;
|
||||
background: rgba(10, 10, 10, 0.95);
|
||||
backdrop-filter: blur(12px);
|
||||
}
|
||||
|
||||
.topbar-left {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 12px;
|
||||
}
|
||||
|
||||
.topbar-logo {
|
||||
width: 16px;
|
||||
height: 16px;
|
||||
background: white;
|
||||
}
|
||||
|
||||
.topbar-title {
|
||||
font-family: 'JetBrains Mono', monospace;
|
||||
font-weight: 700;
|
||||
font-size: 14px;
|
||||
color: white;
|
||||
text-decoration: none;
|
||||
letter-spacing: -0.025em;
|
||||
}
|
||||
|
||||
.topbar-sep {
|
||||
color: #3f3f46;
|
||||
font-size: 18px;
|
||||
}
|
||||
|
||||
.topbar-subtitle {
|
||||
font-family: 'JetBrains Mono', monospace;
|
||||
font-size: 12px;
|
||||
color: #71717a;
|
||||
}
|
||||
|
||||
.topbar-links {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 16px;
|
||||
}
|
||||
|
||||
.topbar-links a {
|
||||
font-family: 'JetBrains Mono', monospace;
|
||||
font-size: 12px;
|
||||
color: #71717a;
|
||||
text-decoration: none;
|
||||
transition: color 0.2s;
|
||||
}
|
||||
|
||||
.topbar-links a:hover { color: white; }
|
||||
|
||||
.topbar-version {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
gap: 6px;
|
||||
padding: 2px 8px;
|
||||
border: 1px solid #27272a;
|
||||
background: rgba(24, 24, 27, 0.5);
|
||||
font-family: 'JetBrains Mono', monospace;
|
||||
font-size: 11px;
|
||||
color: #a1a1aa;
|
||||
}
|
||||
|
||||
.topbar-version .dot {
|
||||
width: 6px;
|
||||
height: 6px;
|
||||
background: #22c55e;
|
||||
border-radius: 50%;
|
||||
}
|
||||
|
||||
#swagger-ui {
|
||||
max-width: 1200px;
|
||||
margin: 0 auto;
|
||||
padding: 0 16px 64px;
|
||||
}
|
||||
|
||||
/* Dark theme overrides */
|
||||
.swagger-ui .topbar { display: none; }
|
||||
|
||||
.swagger-ui,
|
||||
.swagger-ui .wrapper { background: transparent; }
|
||||
|
||||
.swagger-ui .info { margin: 32px 0 16px; }
|
||||
|
||||
.swagger-ui .info .title {
|
||||
font-family: 'JetBrains Mono', monospace;
|
||||
color: white;
|
||||
}
|
||||
|
||||
.swagger-ui .info .description,
|
||||
.swagger-ui .info .description p {
|
||||
font-family: 'Inter', sans-serif;
|
||||
color: #a1a1aa;
|
||||
font-size: 14px;
|
||||
}
|
||||
|
||||
.swagger-ui .info .description code {
|
||||
background: #18181b;
|
||||
border: 1px solid #27272a;
|
||||
padding: 2px 6px;
|
||||
border-radius: 3px;
|
||||
color: #e4e4e7;
|
||||
font-size: 13px;
|
||||
}
|
||||
|
||||
.swagger-ui .info .description pre {
|
||||
background: #18181b;
|
||||
border: 1px solid #27272a;
|
||||
border-radius: 6px;
|
||||
padding: 16px;
|
||||
}
|
||||
|
||||
.swagger-ui .scheme-container {
|
||||
background: #18181b;
|
||||
border: 1px solid #27272a;
|
||||
box-shadow: none;
|
||||
padding: 12px 16px;
|
||||
}
|
||||
|
||||
.swagger-ui .opblock-tag {
|
||||
color: white;
|
||||
border-bottom: 1px solid #27272a;
|
||||
font-family: 'JetBrains Mono', monospace;
|
||||
}
|
||||
|
||||
.swagger-ui .opblock-tag small { color: #71717a; }
|
||||
|
||||
.swagger-ui .opblock {
|
||||
border-color: #27272a;
|
||||
background: #0f0f0f;
|
||||
box-shadow: none;
|
||||
}
|
||||
|
||||
.swagger-ui .opblock .opblock-summary {
|
||||
border-bottom: 1px solid #27272a;
|
||||
}
|
||||
|
||||
.swagger-ui .opblock .opblock-summary-description {
|
||||
color: #a1a1aa;
|
||||
font-family: 'Inter', sans-serif;
|
||||
}
|
||||
|
||||
.swagger-ui .opblock .opblock-summary-path {
|
||||
color: white;
|
||||
font-family: 'JetBrains Mono', monospace;
|
||||
}
|
||||
|
||||
.swagger-ui .opblock .opblock-section-header {
|
||||
background: #18181b;
|
||||
border-bottom: 1px solid #27272a;
|
||||
}
|
||||
|
||||
.swagger-ui .opblock .opblock-section-header h4 {
|
||||
color: #e4e4e7;
|
||||
font-family: 'JetBrains Mono', monospace;
|
||||
}
|
||||
|
||||
.swagger-ui .opblock-body pre.microlight {
|
||||
background: #18181b;
|
||||
border: 1px solid #27272a;
|
||||
border-radius: 4px;
|
||||
color: #e4e4e7;
|
||||
font-family: 'JetBrains Mono', monospace;
|
||||
font-size: 13px;
|
||||
}
|
||||
|
||||
.swagger-ui .opblock.opblock-get {
|
||||
border-color: #27272a;
|
||||
background: rgba(34, 197, 94, 0.05);
|
||||
}
|
||||
|
||||
.swagger-ui .opblock.opblock-get .opblock-summary-method {
|
||||
background: #166534;
|
||||
}
|
||||
|
||||
.swagger-ui .opblock.opblock-post {
|
||||
border-color: #27272a;
|
||||
background: rgba(59, 130, 246, 0.05);
|
||||
}
|
||||
|
||||
.swagger-ui .opblock.opblock-post .opblock-summary-method {
|
||||
background: #1e40af;
|
||||
}
|
||||
|
||||
.swagger-ui .btn {
|
||||
border-color: #3f3f46;
|
||||
color: #e4e4e7;
|
||||
}
|
||||
|
||||
.swagger-ui .btn:hover {
|
||||
background: #27272a;
|
||||
}
|
||||
|
||||
.swagger-ui .btn.execute {
|
||||
background: white;
|
||||
color: black;
|
||||
border-color: white;
|
||||
}
|
||||
|
||||
.swagger-ui .btn.execute:hover {
|
||||
background: #e4e4e7;
|
||||
}
|
||||
|
||||
.swagger-ui table thead tr th,
|
||||
.swagger-ui table thead tr td,
|
||||
.swagger-ui .parameter__name,
|
||||
.swagger-ui .parameter__type {
|
||||
color: #a1a1aa;
|
||||
}
|
||||
|
||||
.swagger-ui .parameter__name.required span { color: #ef4444; }
|
||||
|
||||
.swagger-ui table tbody tr td {
|
||||
color: #e4e4e7;
|
||||
border-bottom: 1px solid #1c1c1e;
|
||||
}
|
||||
|
||||
.swagger-ui input[type=text],
|
||||
.swagger-ui textarea,
|
||||
.swagger-ui select {
|
||||
background: #18181b;
|
||||
border: 1px solid #3f3f46;
|
||||
color: #e4e4e7;
|
||||
}
|
||||
|
||||
.swagger-ui .model-box {
|
||||
background: #18181b;
|
||||
border: 1px solid #27272a;
|
||||
}
|
||||
|
||||
.swagger-ui .model { color: #a1a1aa; }
|
||||
.swagger-ui .model-title { color: white; }
|
||||
.swagger-ui .prop-type { color: #22c55e; }
|
||||
.swagger-ui .prop-format { color: #71717a; }
|
||||
|
||||
.swagger-ui section.models {
|
||||
border: 1px solid #27272a;
|
||||
border-radius: 0;
|
||||
}
|
||||
|
||||
.swagger-ui section.models h4 {
|
||||
color: white;
|
||||
border-bottom: 1px solid #27272a;
|
||||
font-family: 'JetBrains Mono', monospace;
|
||||
}
|
||||
|
||||
.swagger-ui section.models .model-container {
|
||||
border-bottom: 1px solid #27272a;
|
||||
background: transparent;
|
||||
}
|
||||
|
||||
.swagger-ui .response-col_status { color: #22c55e; font-family: 'JetBrains Mono', monospace; }
|
||||
.swagger-ui .response-col_description { color: #a1a1aa; }
|
||||
|
||||
.swagger-ui .responses-inner h4,
|
||||
.swagger-ui .responses-inner h5 {
|
||||
color: #e4e4e7;
|
||||
}
|
||||
|
||||
.swagger-ui .filter .operation-filter-input {
|
||||
background: #18181b;
|
||||
border: 1px solid #3f3f46;
|
||||
color: #e4e4e7;
|
||||
}
|
||||
|
||||
.swagger-ui .loading-container .loading::after {
|
||||
color: #71717a;
|
||||
}
|
||||
|
||||
@media (max-width: 768px) {
|
||||
.topbar { padding: 0 16px; }
|
||||
.topbar-sep, .topbar-subtitle { display: none; }
|
||||
}
|
||||
|
||||
@media (prefers-color-scheme: light) {
|
||||
body { background: #0a0a0a; }
|
||||
}
|
||||
</style>
|
||||
<link rel="preconnect" href="https://fonts.googleapis.com">
|
||||
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
||||
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
|
||||
</head>
|
||||
<body>
|
||||
<div class="topbar">
|
||||
<div class="topbar-left">
|
||||
<a href="/" style="display:flex;align-items:center;gap:8px;text-decoration:none;">
|
||||
<div class="topbar-logo"></div>
|
||||
<span class="topbar-title">SKILLKIT</span>
|
||||
</a>
|
||||
<span class="topbar-sep">/</span>
|
||||
<span class="topbar-subtitle">API Reference</span>
|
||||
</div>
|
||||
<div class="topbar-links">
|
||||
<span class="topbar-version">
|
||||
<span class="dot"></span>
|
||||
v1.12.0
|
||||
</span>
|
||||
<a href="/">Home</a>
|
||||
<a href="/docs">Docs</a>
|
||||
<a href="https://github.com/rohitg00/skillkit" target="_blank" rel="noopener">GitHub</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div id="swagger-ui"></div>
|
||||
|
||||
<script src="https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js"></script>
|
||||
<script>
|
||||
SwaggerUIBundle({
|
||||
url: '/openapi.json',
|
||||
dom_id: '#swagger-ui',
|
||||
deepLinking: true,
|
||||
showExtensions: true,
|
||||
showCommonExtensions: true,
|
||||
defaultModelsExpandDepth: 2,
|
||||
defaultModelExpandDepth: 2,
|
||||
docExpansion: 'list',
|
||||
filter: true,
|
||||
tryItOutEnabled: true,
|
||||
persistAuthorization: true,
|
||||
displayRequestDuration: true,
|
||||
syntaxHighlight: { theme: 'monokai' },
|
||||
});
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
@@ -1,368 +0,0 @@
|
||||
{
|
||||
"openapi": "3.1.0",
|
||||
"info": {
|
||||
"title": "SkillKit",
|
||||
"version": "1.12.0",
|
||||
"description": "Skills shouldn't require pre-installation. This API lets any agent, framework, or tool discover and retrieve skills on demand.\n\n15,000+ skills across 32 AI coding agents. Results ranked by a multi-signal scoring system (content 40pts, query match 30pts, popularity 15pts, references 15pts).\n\n## Quick Start\n\n```bash\nnpx skillkit serve\n```\n\nThe API is now running at http://localhost:3737\n\n## MCP Server\n\nFor agent-native discovery (Claude Desktop, Cursor):\n\n```json\n{\n \"mcpServers\": {\n \"skillkit\": { \"command\": \"npx\", \"args\": [\"@skillkit/mcp\"] }\n }\n}\n```\n\n## Python Client\n\n```bash\npip install skillkit-client\n```",
|
||||
"license": {
|
||||
"name": "Apache-2.0",
|
||||
"url": "https://opensource.org/licenses/Apache-2.0"
|
||||
},
|
||||
"contact": {
|
||||
"name": "SkillKit",
|
||||
"url": "https://github.com/rohitg00/skillkit"
|
||||
}
|
||||
},
|
||||
"servers": [
|
||||
{
|
||||
"url": "http://localhost:3737",
|
||||
"description": "Local development (skillkit serve)"
|
||||
}
|
||||
],
|
||||
"tags": [
|
||||
{ "name": "Search", "description": "Skill search and filtering" },
|
||||
{ "name": "Skills", "description": "Individual skill retrieval" },
|
||||
{ "name": "Discovery", "description": "Trending skills and categories" },
|
||||
{ "name": "System", "description": "Health checks and diagnostics" }
|
||||
],
|
||||
"paths": {
|
||||
"/search": {
|
||||
"get": {
|
||||
"summary": "Search skills",
|
||||
"description": "Find skills matching your query. Results are ranked by relevance: content availability (40pts), query match (30pts), popularity (15pts), and references (15pts). Best matches come first.",
|
||||
"operationId": "searchSkillsGet",
|
||||
"tags": ["Search"],
|
||||
"parameters": [
|
||||
{
|
||||
"name": "q",
|
||||
"in": "query",
|
||||
"required": true,
|
||||
"schema": { "type": "string", "minLength": 1, "maxLength": 200 },
|
||||
"description": "Search query (e.g., 'react performance', 'authentication')",
|
||||
"example": "react hooks"
|
||||
},
|
||||
{
|
||||
"name": "limit",
|
||||
"in": "query",
|
||||
"schema": { "type": "integer", "default": 20, "minimum": 1, "maximum": 100 },
|
||||
"description": "Maximum results to return"
|
||||
},
|
||||
{
|
||||
"name": "include_content",
|
||||
"in": "query",
|
||||
"schema": { "type": "boolean", "default": false },
|
||||
"description": "Include full SKILL.md content in response"
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "Search results ranked by relevance",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": { "$ref": "#/components/schemas/SearchResponse" },
|
||||
"example": {
|
||||
"skills": [
|
||||
{
|
||||
"name": "react-performance",
|
||||
"description": "React app performance optimization patterns",
|
||||
"source": "anthropics/skills",
|
||||
"tags": ["react", "performance"],
|
||||
"category": "frontend"
|
||||
}
|
||||
],
|
||||
"total": 42,
|
||||
"query": "react hooks",
|
||||
"limit": 20
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"400": {
|
||||
"description": "Missing query parameter",
|
||||
"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
|
||||
},
|
||||
"429": {
|
||||
"description": "Rate limit exceeded (60 req/min per IP)",
|
||||
"content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitResponse" } } }
|
||||
}
|
||||
}
|
||||
},
|
||||
"post": {
|
||||
"summary": "Search skills with filters",
|
||||
"description": "Search with filters. Narrow results by tags, category, or source repository.",
|
||||
"operationId": "searchSkillsPost",
|
||||
"tags": ["Search"],
|
||||
"requestBody": {
|
||||
"required": true,
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"type": "object",
|
||||
"required": ["query"],
|
||||
"properties": {
|
||||
"query": { "type": "string", "description": "Search query" },
|
||||
"limit": { "type": "integer", "default": 20, "minimum": 1, "maximum": 100 },
|
||||
"include_content": { "type": "boolean", "default": false },
|
||||
"filters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"tags": { "type": "array", "items": { "type": "string" }, "description": "Filter by tags" },
|
||||
"category": { "type": "string", "description": "Filter by category" },
|
||||
"source": { "type": "string", "description": "Filter by source repository" }
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"example": {
|
||||
"query": "authentication",
|
||||
"limit": 10,
|
||||
"filters": { "tags": ["security"], "category": "backend" }
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "Filtered search results",
|
||||
"content": { "application/json": { "schema": { "$ref": "#/components/schemas/SearchResponse" } } }
|
||||
},
|
||||
"400": {
|
||||
"description": "Invalid request body",
|
||||
"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/skills/{owner}/{repo}/{id}": {
|
||||
"get": {
|
||||
"summary": "Get skill by ID",
|
||||
"description": "Get full details of a specific skill by its source repository and name.",
|
||||
"operationId": "getSkill",
|
||||
"tags": ["Skills"],
|
||||
"parameters": [
|
||||
{
|
||||
"name": "owner",
|
||||
"in": "path",
|
||||
"required": true,
|
||||
"schema": { "type": "string" },
|
||||
"description": "Repository owner",
|
||||
"example": "anthropics"
|
||||
},
|
||||
{
|
||||
"name": "repo",
|
||||
"in": "path",
|
||||
"required": true,
|
||||
"schema": { "type": "string" },
|
||||
"description": "Repository name",
|
||||
"example": "skills"
|
||||
},
|
||||
{
|
||||
"name": "id",
|
||||
"in": "path",
|
||||
"required": true,
|
||||
"schema": { "type": "string" },
|
||||
"description": "Skill name",
|
||||
"example": "pdf-processing"
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "Skill details",
|
||||
"content": { "application/json": { "schema": { "$ref": "#/components/schemas/Skill" } } }
|
||||
},
|
||||
"404": {
|
||||
"description": "Skill not found",
|
||||
"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/trending": {
|
||||
"get": {
|
||||
"summary": "Trending skills",
|
||||
"description": "The most popular skills right now, ranked by relevance score across all sources.",
|
||||
"operationId": "getTrending",
|
||||
"tags": ["Discovery"],
|
||||
"parameters": [
|
||||
{
|
||||
"name": "limit",
|
||||
"in": "query",
|
||||
"schema": { "type": "integer", "default": 20, "minimum": 1, "maximum": 100 },
|
||||
"description": "Maximum results"
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "Trending skills list",
|
||||
"content": { "application/json": { "schema": { "$ref": "#/components/schemas/TrendingResponse" } } }
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/categories": {
|
||||
"get": {
|
||||
"summary": "Skill categories",
|
||||
"description": "Browse all skill categories with counts. See what's available before searching.",
|
||||
"operationId": "getCategories",
|
||||
"tags": ["Discovery"],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "Category list with counts",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": { "$ref": "#/components/schemas/CategoriesResponse" },
|
||||
"example": {
|
||||
"categories": [
|
||||
{ "name": "react", "count": 156 },
|
||||
{ "name": "typescript", "count": 134 },
|
||||
{ "name": "testing", "count": 89 }
|
||||
],
|
||||
"total": 89
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/health": {
|
||||
"get": {
|
||||
"summary": "Health check",
|
||||
"description": "Check if the server is running. Returns version, skill count, and uptime.",
|
||||
"operationId": "getHealth",
|
||||
"tags": ["System"],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "Server health",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": { "$ref": "#/components/schemas/HealthResponse" },
|
||||
"example": {
|
||||
"status": "ok",
|
||||
"version": "1.12.0",
|
||||
"skillCount": 15062,
|
||||
"uptime": 3600
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/cache/stats": {
|
||||
"get": {
|
||||
"summary": "Cache statistics",
|
||||
"description": "See how the cache is performing. Shows hit/miss rates and current size.",
|
||||
"operationId": "getCacheStats",
|
||||
"tags": ["System"],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "Cache statistics",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": { "$ref": "#/components/schemas/CacheStatsResponse" },
|
||||
"example": {
|
||||
"hits": 142,
|
||||
"misses": 38,
|
||||
"size": 45,
|
||||
"maxSize": 500,
|
||||
"hitRate": 0.789
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"components": {
|
||||
"schemas": {
|
||||
"Skill": {
|
||||
"type": "object",
|
||||
"description": "An AI agent skill from the marketplace",
|
||||
"properties": {
|
||||
"name": { "type": "string", "description": "Skill name" },
|
||||
"description": { "type": "string", "description": "What this skill does" },
|
||||
"source": { "type": "string", "description": "Source repository (owner/repo)" },
|
||||
"repo": { "type": "string", "description": "Full repository URL" },
|
||||
"tags": { "type": "array", "items": { "type": "string" }, "description": "Skill tags" },
|
||||
"category": { "type": "string", "description": "Primary category" },
|
||||
"content": { "type": "string", "description": "Full SKILL.md content (when include_content=true)" },
|
||||
"stars": { "type": "integer", "description": "GitHub stars" },
|
||||
"installs": { "type": "integer", "description": "Install count" }
|
||||
},
|
||||
"required": ["name", "source"]
|
||||
},
|
||||
"SearchResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"skills": { "type": "array", "items": { "$ref": "#/components/schemas/Skill" } },
|
||||
"total": { "type": "integer", "description": "Total matching skills (before limit)" },
|
||||
"query": { "type": "string", "description": "Original search query" },
|
||||
"limit": { "type": "integer", "description": "Applied result limit" }
|
||||
},
|
||||
"required": ["skills", "total", "query", "limit"]
|
||||
},
|
||||
"TrendingResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"skills": { "type": "array", "items": { "$ref": "#/components/schemas/Skill" } },
|
||||
"limit": { "type": "integer" }
|
||||
},
|
||||
"required": ["skills", "limit"]
|
||||
},
|
||||
"CategoriesResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"categories": { "type": "array", "items": { "$ref": "#/components/schemas/CategoryCount" } },
|
||||
"total": { "type": "integer" }
|
||||
},
|
||||
"required": ["categories", "total"]
|
||||
},
|
||||
"CategoryCount": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"name": { "type": "string" },
|
||||
"count": { "type": "integer" }
|
||||
},
|
||||
"required": ["name", "count"]
|
||||
},
|
||||
"HealthResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"status": { "type": "string", "enum": ["ok"] },
|
||||
"version": { "type": "string" },
|
||||
"skillCount": { "type": "integer" },
|
||||
"uptime": { "type": "number", "description": "Seconds since server start" }
|
||||
},
|
||||
"required": ["status", "version", "skillCount", "uptime"]
|
||||
},
|
||||
"CacheStatsResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"hits": { "type": "integer" },
|
||||
"misses": { "type": "integer" },
|
||||
"size": { "type": "integer", "description": "Current cached entries" },
|
||||
"maxSize": { "type": "integer", "description": "Maximum cache capacity" },
|
||||
"hitRate": { "type": "number", "description": "Hit rate (0.0 - 1.0)" }
|
||||
},
|
||||
"required": ["hits", "misses", "size", "maxSize", "hitRate"]
|
||||
},
|
||||
"ErrorResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"error": { "type": "string", "description": "Error message" }
|
||||
},
|
||||
"required": ["error"]
|
||||
},
|
||||
"RateLimitResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"error": { "type": "string" },
|
||||
"retryAfter": { "type": "integer", "description": "Seconds until rate limit window resets" }
|
||||
},
|
||||
"required": ["error", "retryAfter"]
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
Binary file not shown.
@@ -1,110 +0,0 @@
|
||||
@import "tailwindcss";
|
||||
|
||||
body {
|
||||
background-color: #000000;
|
||||
color: #e4e4e7;
|
||||
font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
|
||||
}
|
||||
|
||||
h1, h2, h3, h4, h5, h6, .font-mono {
|
||||
font-family: 'JetBrains Mono', 'SF Mono', 'Fira Code', monospace;
|
||||
}
|
||||
|
||||
::selection {
|
||||
background-color: #ffffff;
|
||||
color: #000000;
|
||||
}
|
||||
|
||||
::-webkit-scrollbar {
|
||||
width: 10px;
|
||||
background: #000000;
|
||||
}
|
||||
|
||||
::-webkit-scrollbar-thumb {
|
||||
background: #27272a;
|
||||
border: 1px solid #000000;
|
||||
}
|
||||
|
||||
::-webkit-scrollbar-thumb:hover {
|
||||
background: #3f3f46;
|
||||
}
|
||||
|
||||
/* Smooth scrolling - respects user preferences */
|
||||
html {
|
||||
scroll-behavior: smooth;
|
||||
}
|
||||
|
||||
@media (prefers-reduced-motion: reduce) {
|
||||
html {
|
||||
scroll-behavior: auto;
|
||||
}
|
||||
}
|
||||
|
||||
/* Terminal scanline effect */
|
||||
.terminal-scanline {
|
||||
background: linear-gradient(to bottom, rgba(255,255,255,0), rgba(255,255,255,0) 50%, rgba(0,0,0,0.1) 50%, rgba(0,0,0,0.1));
|
||||
background-size: 100% 4px;
|
||||
position: absolute;
|
||||
top: 0;
|
||||
left: 0;
|
||||
right: 0;
|
||||
bottom: 0;
|
||||
pointer-events: none;
|
||||
z-index: 10;
|
||||
opacity: 0.1;
|
||||
}
|
||||
|
||||
/* Glow effect for important elements */
|
||||
.glow-effect {
|
||||
box-shadow: 0 0 40px rgba(255, 255, 255, 0.03);
|
||||
}
|
||||
|
||||
/* Subtle gradient animation for hero */
|
||||
@keyframes gradient-shift {
|
||||
0%, 100% {
|
||||
background-position: 0% 50%;
|
||||
}
|
||||
50% {
|
||||
background-position: 100% 50%;
|
||||
}
|
||||
}
|
||||
|
||||
.gradient-animate {
|
||||
background-size: 200% 200%;
|
||||
animation: gradient-shift 15s ease infinite;
|
||||
}
|
||||
|
||||
/* Grid pattern overlay */
|
||||
.grid-pattern {
|
||||
background-image:
|
||||
linear-gradient(rgba(255, 255, 255, 0.02) 1px, transparent 1px),
|
||||
linear-gradient(90deg, rgba(255, 255, 255, 0.02) 1px, transparent 1px);
|
||||
background-size: 60px 60px;
|
||||
}
|
||||
|
||||
/* Text shadow for headings */
|
||||
.text-glow {
|
||||
text-shadow: 0 0 60px rgba(255, 255, 255, 0.1);
|
||||
}
|
||||
|
||||
/* Hover scale animation */
|
||||
.hover-lift {
|
||||
transition: transform 0.3s ease, box-shadow 0.3s ease;
|
||||
}
|
||||
|
||||
.hover-lift:hover {
|
||||
transform: translateY(-2px);
|
||||
box-shadow: 0 10px 40px rgba(0, 0, 0, 0.4);
|
||||
}
|
||||
|
||||
/* Border gradient effect */
|
||||
.border-gradient {
|
||||
background: linear-gradient(135deg, rgba(255, 255, 255, 0.1), rgba(255, 255, 255, 0.03));
|
||||
background-clip: padding-box;
|
||||
}
|
||||
|
||||
/* Focus ring for accessibility */
|
||||
*:focus-visible {
|
||||
outline: 2px solid rgba(255, 255, 255, 0.5);
|
||||
outline-offset: 2px;
|
||||
}
|
||||
@@ -1,40 +0,0 @@
|
||||
/** @type {import('tailwindcss').Config} */
|
||||
export default {
|
||||
content: [
|
||||
"./index.html",
|
||||
"./**/*.{js,ts,jsx,tsx}",
|
||||
],
|
||||
darkMode: 'class',
|
||||
theme: {
|
||||
screens: {
|
||||
'xs': '475px',
|
||||
'sm': '640px',
|
||||
'md': '768px',
|
||||
'lg': '1024px',
|
||||
'xl': '1280px',
|
||||
'2xl': '1536px',
|
||||
},
|
||||
extend: {
|
||||
fontFamily: {
|
||||
sans: ['Inter', 'sans-serif'],
|
||||
mono: ['JetBrains Mono', 'monospace'],
|
||||
},
|
||||
colors: {
|
||||
background: '#000000',
|
||||
surface: '#09090b',
|
||||
border: '#27272a',
|
||||
highlight: '#ffffff',
|
||||
},
|
||||
animation: {
|
||||
'cursor-blink': 'blink 1s step-end infinite',
|
||||
},
|
||||
keyframes: {
|
||||
blink: {
|
||||
'0%, 100%': { opacity: '1' },
|
||||
'50%': { opacity: '0' },
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
plugins: [],
|
||||
}
|
||||
@@ -4,14 +4,6 @@
|
||||
"installCommand": "npm install",
|
||||
"framework": "vite",
|
||||
"rewrites": [
|
||||
{
|
||||
"source": "/api",
|
||||
"destination": "/api.html"
|
||||
},
|
||||
{
|
||||
"source": "/_next/:path*",
|
||||
"destination": "https://skillkit-docs.vercel.app/_next/:path*"
|
||||
},
|
||||
{
|
||||
"source": "/docs/:path*",
|
||||
"destination": "https://skillkit-docs.vercel.app/docs/:path*"
|
||||
|
||||
@@ -44,7 +44,7 @@ describe('E2E: Onboarding UI', () => {
|
||||
expect(result.success).toBe(true);
|
||||
});
|
||||
|
||||
it('should display all 32 agents', async () => {
|
||||
it('should display all 17 agents', async () => {
|
||||
const result = await runCli(['init', '--list']);
|
||||
const output = result.stdout + result.stderr;
|
||||
|
||||
@@ -66,21 +66,6 @@ describe('E2E: Onboarding UI', () => {
|
||||
'Antigravity',
|
||||
'Clawdbot',
|
||||
'Universal',
|
||||
'Cline',
|
||||
'CodeBuddy',
|
||||
'CommandCode',
|
||||
'Continue',
|
||||
'Crush',
|
||||
'Factory',
|
||||
'MCPJam',
|
||||
'Mux',
|
||||
'Neovate',
|
||||
'OpenHands',
|
||||
'Pi',
|
||||
'Qoder',
|
||||
'Qwen',
|
||||
'Vercel',
|
||||
'Zencoder',
|
||||
];
|
||||
|
||||
for (const agent of agents) {
|
||||
|
||||
@@ -28,7 +28,7 @@ import {
|
||||
type CrossAgentSkill,
|
||||
} from '@skillkit/core';
|
||||
|
||||
// All 32 supported agents
|
||||
// All 17 supported agents
|
||||
const SUPPORTED_AGENTS = [
|
||||
'claude-code',
|
||||
'cursor',
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
* E2E Tests: Skill Translation Commands
|
||||
*
|
||||
* Tests for: translate, context, recommend
|
||||
* Validates translation to all 32 supported agents
|
||||
* Validates translation to all 17 supported agents
|
||||
*/
|
||||
|
||||
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
|
||||
@@ -16,7 +16,7 @@ import {
|
||||
testFileExists,
|
||||
} from './helpers/cli-runner.js';
|
||||
|
||||
// All 32 supported agents
|
||||
// All 17 supported agents
|
||||
const SUPPORTED_AGENTS = [
|
||||
'claude-code',
|
||||
'cursor',
|
||||
@@ -35,21 +35,6 @@ const SUPPORTED_AGENTS = [
|
||||
'trae',
|
||||
'windsurf',
|
||||
'universal',
|
||||
'cline',
|
||||
'codebuddy',
|
||||
'commandcode',
|
||||
'continue',
|
||||
'crush',
|
||||
'factory',
|
||||
'mcpjam',
|
||||
'mux',
|
||||
'neovate',
|
||||
'openhands',
|
||||
'pi',
|
||||
'qoder',
|
||||
'qwen',
|
||||
'vercel',
|
||||
'zencoder',
|
||||
] as const;
|
||||
|
||||
describe('E2E: Skill Translation', () => {
|
||||
|
||||
+2
-46
@@ -1,8 +1,8 @@
|
||||
{
|
||||
"$schema": "./schema.json",
|
||||
"version": 1,
|
||||
"updatedAt": "2026-02-02",
|
||||
"totalSkills": 15065,
|
||||
"updatedAt": "2026-01-26",
|
||||
"totalSkills": 15062,
|
||||
"curatedCollections": 31,
|
||||
"skills": [
|
||||
{
|
||||
@@ -354,19 +354,6 @@
|
||||
"react"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "rohitg00/skillkit/find-skills",
|
||||
"name": "Find Skills",
|
||||
"description": "Universal skill discovery across all AI agent marketplaces. Search 15K+ skills and install with one command.",
|
||||
"source": "rohitg00/skillkit",
|
||||
"tags": [
|
||||
"meta",
|
||||
"discovery",
|
||||
"marketplace",
|
||||
"skills",
|
||||
"find-skills"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "anthropics/skills/frontend-design",
|
||||
"name": "Frontend Design",
|
||||
@@ -33098,37 +33085,6 @@
|
||||
"source": "oldwinter/skills",
|
||||
"tags": []
|
||||
},
|
||||
{
|
||||
"id": "rohitg00/kubectl-mcp-server/kubernetes-mcp",
|
||||
"name": "Kubernetes MCP Server",
|
||||
"description": "MCP server for Kubernetes with 127+ tools, 8 resources, 8 prompts. Full cluster management via Claude/Cursor.",
|
||||
"source": "rohitg00/kubectl-mcp-server",
|
||||
"tags": [
|
||||
"kubernetes",
|
||||
"mcp",
|
||||
"kubernetes-mcp",
|
||||
"devops",
|
||||
"kubectl",
|
||||
"k8s"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "rohitg00/beautiful-mermaid/beautiful-mermaid",
|
||||
"name": "Beautiful Mermaid",
|
||||
"description": "Render Mermaid diagrams as beautiful SVGs or ASCII art. 5 diagram types, 15 themes, Shiki integration, zero DOM dependencies.",
|
||||
"source": "rohitg00/beautiful-mermaid",
|
||||
"tags": [
|
||||
"mermaid",
|
||||
"diagrams",
|
||||
"visualization",
|
||||
"flowchart",
|
||||
"sequence",
|
||||
"uml",
|
||||
"ascii",
|
||||
"svg",
|
||||
"themes"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "itsmostafa/aws-agent-skills/cognito",
|
||||
"name": "Cognito",
|
||||
|
||||
Generated
+2
-2
@@ -1,12 +1,12 @@
|
||||
{
|
||||
"name": "skillkit-monorepo",
|
||||
"version": "1.14.0",
|
||||
"version": "1.7.2",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "skillkit-monorepo",
|
||||
"version": "1.14.0",
|
||||
"version": "1.7.2",
|
||||
"license": "Apache-2.0",
|
||||
"devDependencies": {
|
||||
"@types/node": "^22.10.5",
|
||||
|
||||
+3
-9
@@ -1,8 +1,8 @@
|
||||
{
|
||||
"name": "skillkit-monorepo",
|
||||
"version": "1.14.0",
|
||||
"version": "1.7.2",
|
||||
"private": true,
|
||||
"description": "The package manager for AI agent skills — install, translate, share across 32 coding agents",
|
||||
"description": "Universal skills loader for AI coding agents - Monorepo",
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"build": "turbo run build",
|
||||
@@ -31,13 +31,7 @@
|
||||
"coding-assistant",
|
||||
"skill-loader",
|
||||
"cli",
|
||||
"monorepo",
|
||||
"skill-md",
|
||||
"package-manager",
|
||||
"plugin",
|
||||
"workflow",
|
||||
"automation",
|
||||
"SKILL.md"
|
||||
"monorepo"
|
||||
],
|
||||
"author": "Rohit Ghumare",
|
||||
"license": "Apache-2.0",
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "@skillkit/agents",
|
||||
"version": "1.14.0",
|
||||
"description": "Agent adapters for SkillKit - supports 32 AI coding agents",
|
||||
"version": "1.7.6",
|
||||
"description": "Agent adapters for SkillKit - supports 17+ AI coding agents",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
"types": "./dist/index.d.ts",
|
||||
|
||||
@@ -81,16 +81,8 @@ export function getAdapter(type: AgentType): AgentAdapter {
|
||||
return adapters[type];
|
||||
}
|
||||
|
||||
export interface AgentAdapterWithType extends AgentAdapter {
|
||||
readonly agentType: AgentType;
|
||||
}
|
||||
|
||||
export function getAllAdapters(): AgentAdapterWithType[] {
|
||||
return Object.entries(adapters).map(([type, adapter]) => ({
|
||||
...adapter,
|
||||
type: type as AgentType,
|
||||
agentType: type as AgentType,
|
||||
}));
|
||||
export function getAllAdapters(): AgentAdapter[] {
|
||||
return Object.values(adapters);
|
||||
}
|
||||
|
||||
export async function detectAgent(): Promise<AgentType> {
|
||||
|
||||
@@ -1,52 +0,0 @@
|
||||
{
|
||||
"name": "@skillkit/api",
|
||||
"version": "1.14.0",
|
||||
"description": "REST API server for SkillKit skill discovery",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
"types": "./dist/index.d.ts",
|
||||
"bin": {
|
||||
"skillkit-api": "./dist/index.js"
|
||||
},
|
||||
"exports": {
|
||||
".": {
|
||||
"import": "./dist/index.js",
|
||||
"types": "./dist/index.d.ts"
|
||||
}
|
||||
},
|
||||
"files": [
|
||||
"dist"
|
||||
],
|
||||
"scripts": {
|
||||
"build": "tsup",
|
||||
"dev": "tsup --watch",
|
||||
"typecheck": "tsc --noEmit",
|
||||
"test": "vitest run",
|
||||
"start": "node dist/index.js"
|
||||
},
|
||||
"dependencies": {
|
||||
"hono": "^4.0.0",
|
||||
"@hono/node-server": "^1.0.0",
|
||||
"@skillkit/core": "workspace:*",
|
||||
"zod": "^3.24.0"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@types/node": "^22.10.5",
|
||||
"tsup": "^8.3.5",
|
||||
"typescript": "^5.7.2",
|
||||
"vitest": "^2.1.8"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=18.0.0"
|
||||
},
|
||||
"license": "Apache-2.0",
|
||||
"keywords": [
|
||||
"skillkit",
|
||||
"api",
|
||||
"rest",
|
||||
"skills",
|
||||
"discovery",
|
||||
"ai",
|
||||
"agents"
|
||||
]
|
||||
}
|
||||
@@ -1,27 +0,0 @@
|
||||
import { describe, it, expect } from 'vitest';
|
||||
import { createApp } from '../server.js';
|
||||
|
||||
describe('Health Routes', () => {
|
||||
const { app } = createApp({ skills: [{ name: 'test', source: 'a/b' }], rateLimitMax: 1000 });
|
||||
|
||||
it('GET /health returns status ok', async () => {
|
||||
const res = await app.request('/health');
|
||||
expect(res.status).toBe(200);
|
||||
const body = await res.json();
|
||||
expect(body.status).toBe('ok');
|
||||
expect(body.skillCount).toBe(1);
|
||||
expect(typeof body.uptime).toBe('number');
|
||||
expect(body.version).toBeDefined();
|
||||
});
|
||||
|
||||
it('GET /cache/stats returns cache statistics', async () => {
|
||||
const res = await app.request('/cache/stats');
|
||||
expect(res.status).toBe(200);
|
||||
const body = await res.json();
|
||||
expect(typeof body.hits).toBe('number');
|
||||
expect(typeof body.misses).toBe('number');
|
||||
expect(typeof body.size).toBe('number');
|
||||
expect(typeof body.maxSize).toBe('number');
|
||||
expect(typeof body.hitRate).toBe('number');
|
||||
});
|
||||
});
|
||||
@@ -1,56 +0,0 @@
|
||||
import { describe, it, expect } from 'vitest';
|
||||
import { createApp } from '../server.js';
|
||||
|
||||
const testSkills = [
|
||||
{ name: 'react-perf', description: 'React performance tips', source: 'owner/repo', tags: ['react', 'performance'] },
|
||||
{ name: 'testing-guide', description: 'Unit testing guide', source: 'owner/repo2', tags: ['testing'] },
|
||||
{ name: 'nextjs-auth', description: 'Next.js authentication', source: 'other/repo', tags: ['nextjs', 'auth'], category: 'framework' },
|
||||
];
|
||||
|
||||
describe('Search Routes', () => {
|
||||
const { app } = createApp({ skills: testSkills, rateLimitMax: 1000 });
|
||||
|
||||
it('GET /search returns results for query', async () => {
|
||||
const res = await app.request('/search?q=react');
|
||||
expect(res.status).toBe(200);
|
||||
const body = await res.json();
|
||||
expect(body.query).toBe('react');
|
||||
expect(body.skills.length).toBeGreaterThan(0);
|
||||
expect(body.total).toBeGreaterThan(0);
|
||||
});
|
||||
|
||||
it('GET /search returns 400 without query', async () => {
|
||||
const res = await app.request('/search');
|
||||
expect(res.status).toBe(400);
|
||||
});
|
||||
|
||||
it('GET /search respects limit parameter', async () => {
|
||||
const res = await app.request('/search?q=test&limit=1');
|
||||
const body = await res.json();
|
||||
expect(body.skills.length).toBeLessThanOrEqual(1);
|
||||
expect(body.limit).toBe(1);
|
||||
});
|
||||
|
||||
it('POST /search with filters', async () => {
|
||||
const res = await app.request('/search', {
|
||||
method: 'POST',
|
||||
headers: { 'Content-Type': 'application/json' },
|
||||
body: JSON.stringify({
|
||||
query: 'auth',
|
||||
filters: { tags: ['nextjs'] },
|
||||
}),
|
||||
});
|
||||
expect(res.status).toBe(200);
|
||||
const body = await res.json();
|
||||
expect(body.skills.length).toBeGreaterThan(0);
|
||||
});
|
||||
|
||||
it('POST /search returns 400 without query', async () => {
|
||||
const res = await app.request('/search', {
|
||||
method: 'POST',
|
||||
headers: { 'Content-Type': 'application/json' },
|
||||
body: JSON.stringify({}),
|
||||
});
|
||||
expect(res.status).toBe(400);
|
||||
});
|
||||
});
|
||||
@@ -1,53 +0,0 @@
|
||||
import { describe, it, expect } from 'vitest';
|
||||
import { createApp } from '../server.js';
|
||||
|
||||
const testSkills = [
|
||||
{ name: 'my-skill', description: 'A test skill', source: 'owner/repo' },
|
||||
];
|
||||
|
||||
describe('Skill Routes', () => {
|
||||
const { app } = createApp({ skills: testSkills, rateLimitMax: 1000 });
|
||||
|
||||
it('GET /skills/:source/:id returns a skill', async () => {
|
||||
const res = await app.request('/skills/owner/repo/my-skill');
|
||||
expect(res.status).toBe(200);
|
||||
const body = await res.json();
|
||||
expect(body.name).toBe('my-skill');
|
||||
expect(body.source).toBe('owner/repo');
|
||||
});
|
||||
|
||||
it('GET /skills/:owner/:repo/:id returns 404 for missing skill', async () => {
|
||||
const res = await app.request('/skills/owner/repo/nonexistent');
|
||||
expect(res.status).toBe(404);
|
||||
});
|
||||
});
|
||||
|
||||
describe('Trending Routes', () => {
|
||||
const { app } = createApp({ skills: testSkills, rateLimitMax: 1000 });
|
||||
|
||||
it('GET /trending returns skills', async () => {
|
||||
const res = await app.request('/trending');
|
||||
expect(res.status).toBe(200);
|
||||
const body = await res.json();
|
||||
expect(body.skills).toBeInstanceOf(Array);
|
||||
expect(body.limit).toBeDefined();
|
||||
});
|
||||
});
|
||||
|
||||
describe('Category Routes', () => {
|
||||
const skills = [
|
||||
{ name: 'a', source: 'x/y', tags: ['react', 'ui'] },
|
||||
{ name: 'b', source: 'x/z', tags: ['react'], category: 'framework' },
|
||||
];
|
||||
const { app } = createApp({ skills, rateLimitMax: 1000 });
|
||||
|
||||
it('GET /categories returns tag counts', async () => {
|
||||
const res = await app.request('/categories');
|
||||
expect(res.status).toBe(200);
|
||||
const body = await res.json();
|
||||
expect(body.categories).toBeInstanceOf(Array);
|
||||
expect(body.total).toBeGreaterThan(0);
|
||||
const react = body.categories.find((c: { name: string }) => c.name === 'react');
|
||||
expect(react?.count).toBe(2);
|
||||
});
|
||||
});
|
||||
@@ -1,11 +0,0 @@
|
||||
export { createApp, startServer } from './server.js';
|
||||
export type { ServerOptions } from './server.js';
|
||||
export type {
|
||||
ApiSkill,
|
||||
SearchResponse,
|
||||
HealthResponse,
|
||||
CacheStatsResponse,
|
||||
TrendingResponse,
|
||||
CategoriesResponse,
|
||||
CategoryCount,
|
||||
} from './types.js';
|
||||
@@ -1,43 +0,0 @@
|
||||
import type { Context, Next } from 'hono';
|
||||
|
||||
interface RateLimitEntry {
|
||||
count: number;
|
||||
resetAt: number;
|
||||
}
|
||||
|
||||
export function rateLimiter(maxRequests = 60, windowMs = 60_000) {
|
||||
const windows = new Map<string, RateLimitEntry>();
|
||||
|
||||
setInterval(() => {
|
||||
const now = Date.now();
|
||||
for (const [key, entry] of windows) {
|
||||
if (now > entry.resetAt) {
|
||||
windows.delete(key);
|
||||
}
|
||||
}
|
||||
}, windowMs).unref();
|
||||
|
||||
return async (c: Context, next: Next): Promise<Response | void> => {
|
||||
const forwardedFor = c.req.header('x-forwarded-for');
|
||||
const ip = (forwardedFor?.split(',')[0]?.trim()) || c.req.header('x-real-ip') || 'unknown';
|
||||
const now = Date.now();
|
||||
|
||||
let entry = windows.get(ip);
|
||||
if (!entry || now > entry.resetAt) {
|
||||
entry = { count: 0, resetAt: now + windowMs };
|
||||
windows.set(ip, entry);
|
||||
}
|
||||
|
||||
entry.count++;
|
||||
|
||||
c.header('X-RateLimit-Limit', String(maxRequests));
|
||||
c.header('X-RateLimit-Remaining', String(Math.max(0, maxRequests - entry.count)));
|
||||
c.header('X-RateLimit-Reset', String(Math.ceil(entry.resetAt / 1000)));
|
||||
|
||||
if (entry.count > maxRequests) {
|
||||
return c.json({ error: 'Too many requests', retryAfter: Math.ceil((entry.resetAt - now) / 1000) }, 429);
|
||||
}
|
||||
|
||||
await next();
|
||||
};
|
||||
}
|
||||
@@ -1,34 +0,0 @@
|
||||
import { Hono } from 'hono';
|
||||
import type { ApiSkill, CategoriesResponse } from '../types.js';
|
||||
|
||||
export function categoryRoutes(skills: ApiSkill[]) {
|
||||
const app = new Hono();
|
||||
|
||||
app.get('/categories', (c) => {
|
||||
const tagCounts = new Map<string, number>();
|
||||
|
||||
for (const skill of skills) {
|
||||
if (skill.tags) {
|
||||
for (const tag of skill.tags) {
|
||||
tagCounts.set(tag, (tagCounts.get(tag) || 0) + 1);
|
||||
}
|
||||
}
|
||||
if (skill.category) {
|
||||
const key = `category:${skill.category}`;
|
||||
tagCounts.set(key, (tagCounts.get(key) || 0) + 1);
|
||||
}
|
||||
}
|
||||
|
||||
const categories = Array.from(tagCounts.entries())
|
||||
.map(([name, count]) => ({ name, count }))
|
||||
.sort((a, b) => b.count - a.count);
|
||||
|
||||
const response: CategoriesResponse = {
|
||||
categories,
|
||||
total: categories.length,
|
||||
};
|
||||
return c.json(response);
|
||||
});
|
||||
|
||||
return app;
|
||||
}
|
||||
@@ -1,294 +0,0 @@
|
||||
import { Hono } from 'hono';
|
||||
|
||||
const OPENAPI_SPEC = {
|
||||
openapi: '3.1.0',
|
||||
info: {
|
||||
title: 'SkillKit',
|
||||
version: '1.12.0',
|
||||
description: 'Skill Discovery API for AI coding agents. Search, browse, and retrieve skills from the SkillKit marketplace (15,000+ skills across 32 agents).',
|
||||
license: { name: 'Apache-2.0', url: 'https://opensource.org/licenses/Apache-2.0' },
|
||||
contact: { name: 'SkillKit', url: 'https://github.com/rohitg00/skillkit' },
|
||||
},
|
||||
servers: [
|
||||
{ url: 'http://localhost:3737', description: 'Local development' },
|
||||
],
|
||||
paths: {
|
||||
'/search': {
|
||||
get: {
|
||||
summary: 'Search skills',
|
||||
description: 'Locate agent skills matching a query, ranked by multi-signal relevance (content, query match, popularity, references).',
|
||||
operationId: 'searchSkillsGet',
|
||||
tags: ['Search'],
|
||||
parameters: [
|
||||
{ name: 'q', in: 'query', required: true, schema: { type: 'string', minLength: 1, maxLength: 200 }, description: 'Search query' },
|
||||
{ name: 'limit', in: 'query', schema: { type: 'integer', default: 20, minimum: 1, maximum: 100 }, description: 'Max results to return' },
|
||||
{ name: 'include_content', in: 'query', schema: { type: 'boolean', default: false }, description: 'Include full skill content in response' },
|
||||
],
|
||||
responses: {
|
||||
'200': { description: 'Search results', content: { 'application/json': { schema: { $ref: '#/components/schemas/SearchResponse' } } } },
|
||||
'400': { description: 'Missing query parameter', content: { 'application/json': { schema: { $ref: '#/components/schemas/ErrorResponse' } } } },
|
||||
'429': { description: 'Rate limit exceeded', content: { 'application/json': { schema: { $ref: '#/components/schemas/RateLimitResponse' } } } },
|
||||
},
|
||||
},
|
||||
post: {
|
||||
summary: 'Search skills with filters',
|
||||
description: 'Search with advanced filters including tags, category, and source.',
|
||||
operationId: 'searchSkillsPost',
|
||||
tags: ['Search'],
|
||||
requestBody: {
|
||||
required: true,
|
||||
content: {
|
||||
'application/json': {
|
||||
schema: {
|
||||
type: 'object',
|
||||
required: ['query'],
|
||||
properties: {
|
||||
query: { type: 'string', description: 'Search query' },
|
||||
limit: { type: 'integer', default: 20, minimum: 1, maximum: 100, description: 'Max results' },
|
||||
include_content: { type: 'boolean', default: false, description: 'Include full content' },
|
||||
filters: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
tags: { type: 'array', items: { type: 'string' }, description: 'Filter by tags' },
|
||||
category: { type: 'string', description: 'Filter by category' },
|
||||
source: { type: 'string', description: 'Filter by source repo' },
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
responses: {
|
||||
'200': { description: 'Filtered search results', content: { 'application/json': { schema: { $ref: '#/components/schemas/SearchResponse' } } } },
|
||||
'400': { description: 'Invalid request', content: { 'application/json': { schema: { $ref: '#/components/schemas/ErrorResponse' } } } },
|
||||
},
|
||||
},
|
||||
},
|
||||
'/skills/{owner}/{repo}/{id}': {
|
||||
get: {
|
||||
summary: 'Get skill by ID',
|
||||
description: 'Retrieve a specific skill by its source repository and name.',
|
||||
operationId: 'getSkill',
|
||||
tags: ['Skills'],
|
||||
parameters: [
|
||||
{ name: 'owner', in: 'path', required: true, schema: { type: 'string' }, description: 'Repository owner' },
|
||||
{ name: 'repo', in: 'path', required: true, schema: { type: 'string' }, description: 'Repository name' },
|
||||
{ name: 'id', in: 'path', required: true, schema: { type: 'string' }, description: 'Skill name' },
|
||||
],
|
||||
responses: {
|
||||
'200': { description: 'Skill details', content: { 'application/json': { schema: { $ref: '#/components/schemas/Skill' } } } },
|
||||
'404': { description: 'Skill not found', content: { 'application/json': { schema: { $ref: '#/components/schemas/ErrorResponse' } } } },
|
||||
},
|
||||
},
|
||||
},
|
||||
'/trending': {
|
||||
get: {
|
||||
summary: 'Trending skills',
|
||||
description: 'Get top skills ranked by multi-signal relevance score (content availability, popularity, references).',
|
||||
operationId: 'getTrending',
|
||||
tags: ['Discovery'],
|
||||
parameters: [
|
||||
{ name: 'limit', in: 'query', schema: { type: 'integer', default: 20, minimum: 1, maximum: 100 }, description: 'Max results' },
|
||||
],
|
||||
responses: {
|
||||
'200': { description: 'Trending skills', content: { 'application/json': { schema: { $ref: '#/components/schemas/TrendingResponse' } } } },
|
||||
},
|
||||
},
|
||||
},
|
||||
'/categories': {
|
||||
get: {
|
||||
summary: 'Skill categories',
|
||||
description: 'List all skill categories and tags with their counts, sorted by popularity.',
|
||||
operationId: 'getCategories',
|
||||
tags: ['Discovery'],
|
||||
responses: {
|
||||
'200': { description: 'Category list', content: { 'application/json': { schema: { $ref: '#/components/schemas/CategoriesResponse' } } } },
|
||||
},
|
||||
},
|
||||
},
|
||||
'/health': {
|
||||
get: {
|
||||
summary: 'Health check',
|
||||
description: 'Server health status including version, skill count, and uptime.',
|
||||
operationId: 'getHealth',
|
||||
tags: ['System'],
|
||||
responses: {
|
||||
'200': { description: 'Server health', content: { 'application/json': { schema: { $ref: '#/components/schemas/HealthResponse' } } } },
|
||||
},
|
||||
},
|
||||
},
|
||||
'/cache/stats': {
|
||||
get: {
|
||||
summary: 'Cache statistics',
|
||||
description: 'Cache hit/miss rates and current size.',
|
||||
operationId: 'getCacheStats',
|
||||
tags: ['System'],
|
||||
responses: {
|
||||
'200': { description: 'Cache stats', content: { 'application/json': { schema: { $ref: '#/components/schemas/CacheStatsResponse' } } } },
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
components: {
|
||||
schemas: {
|
||||
Skill: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
name: { type: 'string', description: 'Skill name' },
|
||||
description: { type: 'string', description: 'Skill description' },
|
||||
source: { type: 'string', description: 'Source repository (owner/repo)' },
|
||||
repo: { type: 'string', description: 'Repository URL' },
|
||||
tags: { type: 'array', items: { type: 'string' }, description: 'Skill tags' },
|
||||
category: { type: 'string', description: 'Skill category' },
|
||||
content: { type: 'string', description: 'Full SKILL.md content (when requested)' },
|
||||
stars: { type: 'integer', description: 'GitHub stars' },
|
||||
installs: { type: 'integer', description: 'Install count' },
|
||||
},
|
||||
required: ['name', 'source'],
|
||||
},
|
||||
SearchResponse: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
skills: { type: 'array', items: { $ref: '#/components/schemas/Skill' } },
|
||||
total: { type: 'integer', description: 'Total matching skills' },
|
||||
query: { type: 'string', description: 'Original query' },
|
||||
limit: { type: 'integer', description: 'Applied limit' },
|
||||
},
|
||||
required: ['skills', 'total', 'query', 'limit'],
|
||||
},
|
||||
TrendingResponse: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
skills: { type: 'array', items: { $ref: '#/components/schemas/Skill' } },
|
||||
limit: { type: 'integer' },
|
||||
},
|
||||
required: ['skills', 'limit'],
|
||||
},
|
||||
CategoriesResponse: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
categories: { type: 'array', items: { $ref: '#/components/schemas/CategoryCount' } },
|
||||
total: { type: 'integer' },
|
||||
},
|
||||
required: ['categories', 'total'],
|
||||
},
|
||||
CategoryCount: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
name: { type: 'string' },
|
||||
count: { type: 'integer' },
|
||||
},
|
||||
required: ['name', 'count'],
|
||||
},
|
||||
HealthResponse: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
status: { type: 'string', enum: ['ok'] },
|
||||
version: { type: 'string' },
|
||||
skillCount: { type: 'integer' },
|
||||
uptime: { type: 'number', description: 'Uptime in seconds' },
|
||||
},
|
||||
required: ['status', 'version', 'skillCount', 'uptime'],
|
||||
},
|
||||
CacheStatsResponse: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
hits: { type: 'integer' },
|
||||
misses: { type: 'integer' },
|
||||
size: { type: 'integer' },
|
||||
maxSize: { type: 'integer' },
|
||||
hitRate: { type: 'number' },
|
||||
},
|
||||
required: ['hits', 'misses', 'size', 'maxSize', 'hitRate'],
|
||||
},
|
||||
ErrorResponse: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
error: { type: 'string' },
|
||||
},
|
||||
required: ['error'],
|
||||
},
|
||||
RateLimitResponse: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
error: { type: 'string' },
|
||||
retryAfter: { type: 'integer', description: 'Seconds until rate limit resets' },
|
||||
},
|
||||
required: ['error', 'retryAfter'],
|
||||
},
|
||||
},
|
||||
},
|
||||
tags: [
|
||||
{ name: 'Search', description: 'Skill search and filtering' },
|
||||
{ name: 'Skills', description: 'Individual skill retrieval' },
|
||||
{ name: 'Discovery', description: 'Trending skills and categories' },
|
||||
{ name: 'System', description: 'Health checks and diagnostics' },
|
||||
],
|
||||
};
|
||||
|
||||
const SWAGGER_HTML = `<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title>SkillKit API Documentation</title>
|
||||
<link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@5/swagger-ui.css">
|
||||
<style>
|
||||
body { margin: 0; background: #1a1a2e; }
|
||||
.swagger-ui .topbar { display: none; }
|
||||
.swagger-ui { max-width: 1200px; margin: 0 auto; }
|
||||
.swagger-ui .info .title { font-family: monospace; }
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<div id="swagger-ui"></div>
|
||||
<script src="https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js"></script>
|
||||
<script>
|
||||
SwaggerUIBundle({
|
||||
url: '/openapi.json',
|
||||
dom_id: '#swagger-ui',
|
||||
deepLinking: true,
|
||||
showExtensions: true,
|
||||
showCommonExtensions: true,
|
||||
defaultModelsExpandDepth: 2,
|
||||
defaultModelExpandDepth: 2,
|
||||
docExpansion: 'list',
|
||||
filter: true,
|
||||
tryItOutEnabled: true,
|
||||
});
|
||||
</script>
|
||||
</body>
|
||||
</html>`;
|
||||
|
||||
export function docsRoutes() {
|
||||
const app = new Hono();
|
||||
|
||||
app.get('/openapi.json', (c) => {
|
||||
return c.json(OPENAPI_SPEC);
|
||||
});
|
||||
|
||||
app.get('/docs', (c) => {
|
||||
return c.html(SWAGGER_HTML);
|
||||
});
|
||||
|
||||
app.get('/', (c) => {
|
||||
return c.json({
|
||||
name: 'SkillKit API',
|
||||
version: '1.12.0',
|
||||
docs: '/docs',
|
||||
openapi: '/openapi.json',
|
||||
endpoints: {
|
||||
search: 'GET /search?q=...',
|
||||
searchFiltered: 'POST /search',
|
||||
skill: 'GET /skills/:owner/:repo/:id',
|
||||
trending: 'GET /trending',
|
||||
categories: 'GET /categories',
|
||||
health: 'GET /health',
|
||||
cache: 'GET /cache/stats',
|
||||
},
|
||||
});
|
||||
});
|
||||
|
||||
return app;
|
||||
}
|
||||
@@ -1,33 +0,0 @@
|
||||
import { Hono } from 'hono';
|
||||
import type { HealthResponse, CacheStatsResponse } from '../types.js';
|
||||
import type { CacheBackend } from '@skillkit/core';
|
||||
|
||||
const startTime = Date.now();
|
||||
|
||||
export function healthRoutes(skillCount: number, cache: CacheBackend) {
|
||||
const app = new Hono();
|
||||
|
||||
app.get('/health', (c) => {
|
||||
const response: HealthResponse = {
|
||||
status: 'ok',
|
||||
version: '1.11.0',
|
||||
skillCount,
|
||||
uptime: Math.floor((Date.now() - startTime) / 1000),
|
||||
};
|
||||
return c.json(response);
|
||||
});
|
||||
|
||||
app.get('/cache/stats', (c) => {
|
||||
const stats = cache.stats();
|
||||
const response: CacheStatsResponse = {
|
||||
hits: stats.hits,
|
||||
misses: stats.misses,
|
||||
size: stats.size,
|
||||
maxSize: stats.maxSize,
|
||||
hitRate: stats.hitRate,
|
||||
};
|
||||
return c.json(response);
|
||||
});
|
||||
|
||||
return app;
|
||||
}
|
||||
@@ -1,128 +0,0 @@
|
||||
import { Hono } from 'hono';
|
||||
import type { ApiSkill, SearchResponse } from '../types.js';
|
||||
import { RelevanceRanker } from '@skillkit/core';
|
||||
import type { MemoryCache } from '@skillkit/core';
|
||||
|
||||
export function searchRoutes(skills: ApiSkill[], cache: MemoryCache<SearchResponse>) {
|
||||
const app = new Hono();
|
||||
const ranker = new RelevanceRanker();
|
||||
|
||||
app.get('/search', (c) => {
|
||||
const query = c.req.query('q') || '';
|
||||
const parsedLimit = parseInt(c.req.query('limit') || '20', 10);
|
||||
const limit = Math.min(Number.isNaN(parsedLimit) ? 20 : parsedLimit, 100);
|
||||
const includeContent = c.req.query('include_content') === 'true';
|
||||
|
||||
if (!query) {
|
||||
return c.json({ error: 'Query parameter "q" is required' }, 400);
|
||||
}
|
||||
|
||||
const cacheKey = `search:${query}:${limit}:${includeContent}`;
|
||||
const cached = cache.get(cacheKey);
|
||||
if (cached) return c.json(cached);
|
||||
|
||||
const skillMap = new Map(skills.map((s) => [`${s.source}:${s.name}`, s]));
|
||||
|
||||
const ranked = ranker.rank(
|
||||
skills.map((s) => ({
|
||||
name: s.name,
|
||||
description: s.description,
|
||||
content: s.content,
|
||||
stars: s.stars,
|
||||
installs: s.installs,
|
||||
source: s.source,
|
||||
})),
|
||||
query,
|
||||
);
|
||||
|
||||
const results: ApiSkill[] = ranked.slice(0, limit).map((r) => {
|
||||
const key = `${(r.skill as Record<string, unknown>).source}:${r.skill.name}`;
|
||||
const original = skillMap.get(key) ?? skills.find((s) => s.name === r.skill.name)!;
|
||||
if (!includeContent) {
|
||||
const { content: _, ...rest } = original;
|
||||
return rest;
|
||||
}
|
||||
return original;
|
||||
});
|
||||
|
||||
const response: SearchResponse = {
|
||||
skills: results,
|
||||
total: ranked.length,
|
||||
query,
|
||||
limit,
|
||||
};
|
||||
|
||||
cache.set(cacheKey, response);
|
||||
return c.json(response);
|
||||
});
|
||||
|
||||
app.post('/search', async (c) => {
|
||||
let body: {
|
||||
query: string;
|
||||
limit?: number;
|
||||
include_content?: boolean;
|
||||
filters?: { tags?: string[]; category?: string; source?: string };
|
||||
};
|
||||
try {
|
||||
body = await c.req.json();
|
||||
} catch {
|
||||
return c.json({ error: 'Invalid JSON body' }, 400);
|
||||
}
|
||||
|
||||
if (!body.query) {
|
||||
return c.json({ error: 'Field "query" is required' }, 400);
|
||||
}
|
||||
|
||||
const limit = Math.min(body.limit ?? 20, 100);
|
||||
let filtered = skills;
|
||||
|
||||
if (body.filters) {
|
||||
if (body.filters.tags?.length) {
|
||||
filtered = filtered.filter((s) =>
|
||||
body.filters!.tags!.some((t) => s.tags?.includes(t)),
|
||||
);
|
||||
}
|
||||
if (body.filters.category) {
|
||||
filtered = filtered.filter((s) => s.category === body.filters!.category);
|
||||
}
|
||||
if (body.filters.source) {
|
||||
filtered = filtered.filter((s) => s.source.includes(body.filters!.source!));
|
||||
}
|
||||
}
|
||||
|
||||
const filteredMap = new Map(filtered.map((s) => [`${s.source}:${s.name}`, s]));
|
||||
|
||||
const ranked = ranker.rank(
|
||||
filtered.map((s) => ({
|
||||
name: s.name,
|
||||
description: s.description,
|
||||
content: s.content,
|
||||
stars: s.stars,
|
||||
installs: s.installs,
|
||||
source: s.source,
|
||||
})),
|
||||
body.query,
|
||||
);
|
||||
|
||||
const results: ApiSkill[] = ranked.slice(0, limit).map((r) => {
|
||||
const key = `${(r.skill as Record<string, unknown>).source}:${r.skill.name}`;
|
||||
const original = filteredMap.get(key) ?? filtered.find((s) => s.name === r.skill.name)!;
|
||||
if (!body.include_content) {
|
||||
const { content: _, ...rest } = original;
|
||||
return rest;
|
||||
}
|
||||
return original;
|
||||
});
|
||||
|
||||
const response: SearchResponse = {
|
||||
skills: results,
|
||||
total: ranked.length,
|
||||
query: body.query,
|
||||
limit,
|
||||
};
|
||||
|
||||
return c.json(response);
|
||||
});
|
||||
|
||||
return app;
|
||||
}
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user