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
|
||||
|
||||
@@ -12,20 +12,15 @@
|
||||
[](https://github.com/rohitg00/skillkit/pkgs/npm/skillkit)
|
||||
[](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
|
||||
[](https://agenstskills.com)
|
||||
[](https://agenstskills.com/docs)
|
||||
[](https://opensource.org/licenses/Apache-2.0)
|
||||
|
||||
## Supercharge Every AI Coding Agent
|
||||
|
||||
**Give your AI agents new abilities with portable, reusable skills.** Install from a curated marketplace, create your own, and use them across Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and 27 more agents (32 total).
|
||||
**Give your AI agents new abilities with portable, reusable skills.** Install from a curated marketplace, create your own, and use them across Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and 27 more agents.
|
||||
|
||||
> **What are AI Agent Skills?** Skills are instruction files that teach AI coding agents how to handle specific tasks - like processing PDFs, following React best practices, or enforcing security patterns. Think of them as plugins for your AI assistant.
|
||||
|
||||
```bash
|
||||
# Quick start (no install required)
|
||||
npx skillkit@latest
|
||||
|
||||
# Or install globally
|
||||
npm install -g skillkit
|
||||
```
|
||||
|
||||
@@ -82,17 +77,22 @@ SkillKit features a polished, interactive CLI with visual feedback:
|
||||
## 5-Minute Quick Start
|
||||
|
||||
```bash
|
||||
# Launch interactive TUI (no install required)
|
||||
npx skillkit@latest
|
||||
|
||||
# Or with specific commands:
|
||||
npx skillkit recommend # Get smart recommendations
|
||||
npx skillkit install anthropics/skills # Install official skills
|
||||
npx skillkit sync # Sync to your AI agent
|
||||
|
||||
# For frequent use, install globally:
|
||||
# 1. Install SkillKit globally
|
||||
npm install -g skillkit
|
||||
skillkit # Launch TUI
|
||||
|
||||
# 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
|
||||
```
|
||||
|
||||
## Core Features
|
||||
@@ -118,7 +118,7 @@ skillkit agent translate --source ./my-skills --to cursor
|
||||
skillkit agent translate --source ./kubernetes-skills --to cursor --recursive
|
||||
```
|
||||
|
||||
**Supported Agents (32):** Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Antigravity, Amp, Clawdbot, Droid, GitHub Copilot, Goose, Kilo, Kiro, Roo, Trae, Windsurf, Universal, Cline, CodeBuddy, CommandCode, Continue, Crush, Factory, MCPJam, Mux, Neovate, OpenHands, Pi, Qoder, Qwen, Vercel, Zencoder
|
||||
**Supported Agents:** Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Antigravity, Amp, Clawdbot, Droid, GitHub Copilot, Goose, Kilo, Kiro, Roo, Trae, Windsurf, Universal
|
||||
|
||||
### Smart Recommendations
|
||||
|
||||
@@ -240,7 +240,7 @@ skillkit cicd gitlab-ci
|
||||
skillkit cicd pre-commit
|
||||
```
|
||||
|
||||
## Supported Agents (32)
|
||||
## Supported Agents (17)
|
||||
|
||||
| Agent | Format | Skills Directory |
|
||||
|-------|--------|------------------|
|
||||
@@ -261,21 +261,6 @@ skillkit cicd pre-commit
|
||||
| Trae | SKILL.md | `.trae/skills/` |
|
||||
| Windsurf | Markdown | `.windsurf/skills/` |
|
||||
| Universal | SKILL.md | `skills/` |
|
||||
| Cline | SKILL.md | `.cline/skills/` |
|
||||
| CodeBuddy | SKILL.md | `.codebuddy/skills/` |
|
||||
| CommandCode | SKILL.md | `.commandcode/skills/` |
|
||||
| Continue | SKILL.md | `.continue/skills/` |
|
||||
| Crush | SKILL.md | `.crush/skills/` |
|
||||
| Factory | SKILL.md | `.factory/skills/` |
|
||||
| MCPJam | SKILL.md | `.mcpjam/skills/` |
|
||||
| Mux | SKILL.md | `.mux/skills/` |
|
||||
| Neovate | SKILL.md | `.neovate/skills/` |
|
||||
| OpenHands | SKILL.md | `.openhands/skills/` |
|
||||
| Pi | SKILL.md | `.pi/skills/` |
|
||||
| Qoder | SKILL.md | `.qoder/skills/` |
|
||||
| Qwen | SKILL.md | `.qwen/skills/` |
|
||||
| Vercel | SKILL.md | `.vercel/skills/` |
|
||||
| Zencoder | SKILL.md | `.zencoder/skills/` |
|
||||
|
||||
## All Commands
|
||||
|
||||
@@ -287,11 +272,9 @@ 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 pause <skills> # Temporarily pause skills
|
||||
skillkit resume <skills> # Resume paused skills
|
||||
skillkit disable <skills> # Disable specific skills
|
||||
skillkit sync # Sync skills to agent config
|
||||
skillkit read <skills> # Read skill content for AI
|
||||
skillkit status # Show skill and agent status
|
||||
```
|
||||
|
||||
### Discovery & Recommendations
|
||||
@@ -300,8 +283,6 @@ skillkit status # Show skill and agent status
|
||||
skillkit recommend # Get smart recommendations
|
||||
skillkit marketplace # Browse skill marketplace
|
||||
skillkit marketplace search # Search marketplace
|
||||
skillkit find <query> # Quick skill search
|
||||
skillkit check # Check skill health and updates
|
||||
```
|
||||
|
||||
### Translation & Context
|
||||
@@ -312,23 +293,6 @@ skillkit context init # Initialize project context
|
||||
skillkit context sync # Sync context to agents
|
||||
```
|
||||
|
||||
### AI Instruction Generation (Primer)
|
||||
|
||||
Generate AI instruction files for all 32 supported agents based on your codebase analysis:
|
||||
|
||||
```bash
|
||||
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 --dry-run # Preview without writing files
|
||||
skillkit primer --analyze-only # Only show codebase analysis
|
||||
skillkit primer --output ./instructions # Write to custom directory
|
||||
skillkit primer --json # Output analysis as JSON (for scripting)
|
||||
skillkit primer --json --analyze-only # Machine-readable analysis
|
||||
```
|
||||
|
||||
Inspired by [primer](https://github.com/pierceboggan/primer) but extended for all SkillKit agents.
|
||||
|
||||
### Custom AI Sub-Agents
|
||||
|
||||
```bash
|
||||
@@ -353,91 +317,20 @@ skillkit memory compress # Compress observations
|
||||
skillkit memory export # Export as skill
|
||||
```
|
||||
|
||||
### Mesh Network
|
||||
|
||||
```bash
|
||||
skillkit mesh init # Initialize mesh network
|
||||
skillkit mesh add <address> # Add a host to mesh
|
||||
skillkit mesh remove <id> # Remove a host from mesh
|
||||
skillkit mesh list # List known hosts
|
||||
skillkit mesh discover # Discover hosts on LAN
|
||||
skillkit mesh health # Check host health
|
||||
skillkit mesh status # Show mesh status
|
||||
|
||||
# Security
|
||||
skillkit mesh security init # Setup encryption keys
|
||||
skillkit mesh security status # Show security status
|
||||
skillkit mesh peer trust <id> # Trust a peer
|
||||
skillkit mesh peer revoke <id># Revoke peer trust
|
||||
skillkit mesh peer list # List trusted peers
|
||||
```
|
||||
|
||||
### Inter-Agent Messaging
|
||||
|
||||
```bash
|
||||
skillkit message send # Send message to agent
|
||||
skillkit message inbox # View inbox
|
||||
skillkit message read <id> # Read a message
|
||||
skillkit message reply <id> # Reply to message
|
||||
skillkit message archive <id> # Archive message
|
||||
skillkit message sent # View sent messages
|
||||
skillkit message status # Messaging status
|
||||
```
|
||||
|
||||
### Quality & Testing
|
||||
### Testing & Workflows
|
||||
|
||||
```bash
|
||||
skillkit test # Run skill tests
|
||||
skillkit validate # Validate skill format
|
||||
skillkit fix # Auto-fix skill issues
|
||||
skillkit audit # Audit skills for security/quality
|
||||
skillkit manifest # Generate skill manifest
|
||||
```
|
||||
|
||||
### Team Collaboration
|
||||
|
||||
```bash
|
||||
skillkit team init # Initialize team workspace
|
||||
skillkit team share # Share skills with team
|
||||
skillkit team import # Import team skills
|
||||
skillkit team sync # Sync team skills
|
||||
skillkit team list # List team members
|
||||
```
|
||||
|
||||
### Workflows & Automation
|
||||
|
||||
```bash
|
||||
skillkit workflow run # Execute workflow
|
||||
skillkit plan create # Create execution plan
|
||||
skillkit plan execute # Execute a plan
|
||||
skillkit cicd init # Generate CI/CD templates
|
||||
skillkit hook register # Register lifecycle hooks
|
||||
skillkit command generate # Generate slash commands
|
||||
skillkit cicd # Generate CI/CD templates
|
||||
```
|
||||
|
||||
### Plugins & Extensions
|
||||
### Utilities
|
||||
|
||||
```bash
|
||||
skillkit plugin list # List available plugins
|
||||
skillkit plugin install # Install a plugin
|
||||
skillkit plugin enable # Enable a plugin
|
||||
skillkit methodology list # List methodologies
|
||||
skillkit methodology load # Load a methodology
|
||||
```
|
||||
|
||||
### Publishing & Sharing
|
||||
|
||||
```bash
|
||||
skillkit publish # Publish skill to marketplace
|
||||
skillkit create # Create new skill
|
||||
skillkit init # Initialize in project
|
||||
```
|
||||
|
||||
### Configuration
|
||||
|
||||
```bash
|
||||
skillkit settings # View/edit settings
|
||||
skillkit settings --set key=value # Update setting
|
||||
skillkit validate # Validate skill format
|
||||
skillkit create # Create new skill
|
||||
```
|
||||
|
||||
## Creating Skills
|
||||
@@ -450,7 +343,7 @@ skillkit create my-skill
|
||||
|
||||
### Manual Creation
|
||||
|
||||
Create a `SKILL.md` file following the [Agent Skills specification](https://agenstskills.com):
|
||||
Create a `SKILL.md` file following the [Agent Skills specification](https://agentskills.io/specification):
|
||||
|
||||
```markdown
|
||||
---
|
||||
@@ -522,43 +415,12 @@ const profile = await analyzeProject('./my-project');
|
||||
const recs = engine.recommend(profile);
|
||||
```
|
||||
|
||||
## Skill Sources & Attribution
|
||||
## Popular Skill Repositories
|
||||
|
||||
SkillKit aggregates skills from trusted sources. We credit and link back to all original creators. Each source retains its original license.
|
||||
|
||||
### Official Partner Sources
|
||||
|
||||
| Repository | Description | License |
|
||||
|------------|-------------|---------|
|
||||
| [anthropics/skills](https://github.com/anthropics/skills) | Official Claude Code skills from Anthropic | Apache 2.0 |
|
||||
| [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | Next.js, React, and Vercel platform skills | MIT |
|
||||
| [expo/skills](https://github.com/expo/skills) | Mobile development with Expo and React Native | MIT |
|
||||
| [remotion-dev/skills](https://github.com/remotion-dev/skills) | Programmatic video creation with React | MIT |
|
||||
| [supabase/agent-skills](https://github.com/supabase/agent-skills) | Database, auth, and backend skills | Apache 2.0 |
|
||||
| [stripe/ai](https://github.com/stripe/ai) | Payment integration and Stripe API patterns | MIT |
|
||||
|
||||
### Community Contributors
|
||||
|
||||
| Repository | Description | License |
|
||||
|------------|-------------|---------|
|
||||
| [trailofbits/skills](https://github.com/trailofbits/skills) | Security analysis and vulnerability detection | Apache 2.0 |
|
||||
| [obra/superpowers](https://github.com/obra/superpowers) | Test-driven development and workflow automation | MIT |
|
||||
| [wshobson/agents](https://github.com/wshobson/agents) | Development patterns and agent configurations (48 agents) | MIT |
|
||||
| [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) | Curated collection of Claude Code skills | MIT |
|
||||
| [travisvn/awesome-claude-skills](https://github.com/travisvn/awesome-claude-skills) | Community-curated skill collection | MIT |
|
||||
| [langgenius/dify](https://github.com/langgenius/dify) | AI application development platform patterns | Apache 2.0 |
|
||||
| [better-auth/skills](https://github.com/better-auth/skills) | Authentication and authorization patterns | MIT |
|
||||
| [onmax/nuxt-skills](https://github.com/onmax/nuxt-skills) | Vue.js and Nuxt framework skills | MIT |
|
||||
| [elysiajs/skills](https://github.com/elysiajs/skills) | Bun runtime and ElysiaJS framework | MIT |
|
||||
| [kadajett/agent-nestjs-skills](https://github.com/kadajett/agent-nestjs-skills) | NestJS backend framework patterns | MIT |
|
||||
| [cloudai-x/threejs-skills](https://github.com/cloudai-x/threejs-skills) | 3D graphics and WebGL development | MIT |
|
||||
| [dimillian/skills](https://github.com/dimillian/skills) | iOS and SwiftUI development patterns | MIT |
|
||||
| [waynesutton/convexskills](https://github.com/waynesutton/convexskills) | Convex backend development | MIT |
|
||||
| [kepano/obsidian-skills](https://github.com/kepano/obsidian-skills) | Obsidian plugin and vault management | MIT |
|
||||
| [giuseppe-trisciuoglio/developer-kit](https://github.com/giuseppe-trisciuoglio/developer-kit) | UI component libraries (Shadcn/Radix) | MIT |
|
||||
| [openrouterteam/agent-skills](https://github.com/openrouterteam/agent-skills) | OpenRouter API integration patterns | MIT |
|
||||
|
||||
**Want to add your skills?** [Submit your repository](https://github.com/rohitg00/skillkit/issues/new?template=add-source.md) to be included in SkillKit
|
||||
| Repository | Description |
|
||||
|------------|-------------|
|
||||
| [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 |
|
||||
|
||||
## Installation Options
|
||||
|
||||
@@ -607,9 +469,7 @@ Contributions welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md
|
||||
|
||||
## Links
|
||||
|
||||
- [Documentation](https://agenstskills.com/docs)
|
||||
- [Website](https://agenstskills.com)
|
||||
- [Agent Skills Specification](https://agenstskills.com)
|
||||
- [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.8.1",
|
||||
"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": {
|
||||
@@ -57,9 +57,6 @@
|
||||
"@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": {
|
||||
|
||||
@@ -26,8 +26,6 @@ import {
|
||||
WorkflowRunCommand,
|
||||
WorkflowListCommand,
|
||||
WorkflowCreateCommand,
|
||||
WorkflowPipelineCommand,
|
||||
WorkflowPipelineListCommand,
|
||||
RunCommand,
|
||||
TestCommand,
|
||||
MarketplaceCommand,
|
||||
@@ -38,13 +36,8 @@ import {
|
||||
PluginCommand,
|
||||
MethodologyCommand,
|
||||
HookCommand,
|
||||
HookTemplateListCommand,
|
||||
HookTemplateApplyCommand,
|
||||
HookTemplateShowCommand,
|
||||
PlanCommand,
|
||||
CommandCmd,
|
||||
CommandAvailableCommand,
|
||||
CommandInstallCommand,
|
||||
AICommand,
|
||||
AuditCommand,
|
||||
PublishCommand,
|
||||
@@ -55,8 +48,7 @@ import {
|
||||
AgentTranslateCommand,
|
||||
AgentSyncCommand,
|
||||
AgentValidateCommand,
|
||||
AgentInstallCommand,
|
||||
AgentAvailableCommand,
|
||||
// New commands (Phase 21)
|
||||
CheckCommand,
|
||||
FindCommand,
|
||||
ManifestCommand,
|
||||
@@ -65,36 +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,
|
||||
} from '@skillkit/cli';
|
||||
|
||||
const __filename = fileURLToPath(import.meta.url);
|
||||
@@ -165,52 +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.runExit(process.argv.slice(2));
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -7,7 +7,7 @@ description: Universal CLI for managing AI agent skills across 32 coding platfor
|
||||
|
||||
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across **32 AI coding platforms**.
|
||||
|
||||
**Current Version:** v1.8.0
|
||||
**Current Version:** v1.7.5
|
||||
|
||||
## The Problem
|
||||
|
||||
@@ -25,80 +25,22 @@ SkillKit provides a **"write once, deploy everywhere"** platform. Maintain a sin
|
||||
## Quick Install
|
||||
|
||||
```bash
|
||||
# Run instantly with npx (no install required)
|
||||
npx skillkit@latest
|
||||
|
||||
# Or install globally for frequent use
|
||||
npm install -g skillkit
|
||||
skillkit init
|
||||
skillkit install anthropics/skills
|
||||
skillkit sync
|
||||
```
|
||||
|
||||
## Core Features
|
||||
## Key Features
|
||||
|
||||
| Feature | Description |
|
||||
|---------|-------------|
|
||||
| **Cross-Platform Translation** | Automatic conversion between 32 agent formats |
|
||||
| **Smart Recommendations** | AI-powered skill suggestions based on your tech stack |
|
||||
| **Session Memory** | Persistent learning that survives across sessions |
|
||||
| **Primer** | Auto-generate agent instructions from your codebase |
|
||||
| **Mesh Network** | Multi-machine agent distribution with encrypted P2P |
|
||||
| **Inter-Agent Messaging** | Send messages between AI agents across your network |
|
||||
| **Skill Discovery** | 15,000+ marketplace skills with AI recommendations |
|
||||
| **Team Collaboration** | Git-based `.skills` manifest for sharing |
|
||||
| **Workflow Orchestration** | Compose skills into multi-step automated workflows |
|
||||
| **Skill Testing** | Built-in test framework with assertions |
|
||||
| **CI/CD Integration** | GitHub Actions, GitLab CI, and pre-commit hooks |
|
||||
| **TypeScript API** | Full programmatic access to all features |
|
||||
| **Interactive TUI** | Beautiful terminal interface with real-time updates |
|
||||
|
||||
## Advanced Capabilities
|
||||
|
||||
### Session Memory System
|
||||
|
||||
Your AI agents learn patterns during sessions—then forget everything. SkillKit captures these learnings and makes them permanent.
|
||||
|
||||
```bash
|
||||
skillkit memory compress # Compress learnings
|
||||
skillkit memory search auth # Search knowledge
|
||||
skillkit memory export auth-patterns # Export as skill
|
||||
```
|
||||
|
||||
[Learn more →](/docs/memory)
|
||||
|
||||
### Primer - Auto-Generate Instructions
|
||||
|
||||
Automatically generate CLAUDE.md, .cursorrules, and agent instructions by analyzing your codebase.
|
||||
|
||||
```bash
|
||||
skillkit primer # Analyze project
|
||||
skillkit primer --all-agents # Generate for all 32 agents
|
||||
```
|
||||
|
||||
[Learn more →](/docs/primer)
|
||||
|
||||
### Mesh Network
|
||||
|
||||
Run agents across multiple machines with encrypted P2P communication.
|
||||
|
||||
```bash
|
||||
skillkit mesh init # Initialize mesh node
|
||||
skillkit mesh discover # Find peers on LAN
|
||||
skillkit mesh security init # Setup Ed25519 encryption
|
||||
```
|
||||
|
||||
[Learn more →](/docs/mesh)
|
||||
|
||||
### Inter-Agent Messaging
|
||||
|
||||
Send messages between AI agents across your mesh network.
|
||||
|
||||
```bash
|
||||
skillkit message send # Send to another agent
|
||||
skillkit message inbox # Check your inbox
|
||||
```
|
||||
|
||||
[Learn more →](/docs/messaging)
|
||||
| **Quality Evaluation** | 0-100 scoring with A-F grades |
|
||||
| **Interactive TUI** | Beautiful terminal interface |
|
||||
| **Memory System** | Persistent learning across sessions |
|
||||
|
||||
## Architecture
|
||||
|
||||
@@ -106,23 +48,18 @@ skillkit message inbox # Check your inbox
|
||||
|------|------------|
|
||||
| **User Interfaces** | CLI (Clipanion v4), TUI (OpenTUI/React), Documentation |
|
||||
| **Business Logic** | @skillkit/core, @skillkit/agents (32 adapters) |
|
||||
| **Data Layer** | @skillkit/memory (CozoDB), @skillkit/mesh (WebSocket/UDP) |
|
||||
| **External Systems** | GitHub/GitLab, Marketplace (15,000+ skills) |
|
||||
|
||||
## Supported Agents (32)
|
||||
## Supported Agents
|
||||
|
||||
Claude Code, Cursor, Codex, Gemini CLI, OpenCode, GitHub Copilot, Windsurf, Antigravity, Amp, Clawdbot, Droid, Goose, Kilo Code, Kiro CLI, Roo Code, Trae, Cline, CodeBuddy, Continue, Crush, Factory, MCPJam, Mux, Neovate, OpenHands, Pi, Qoder, Qwen, Vercel, Zencoder, CommandCode, Universal
|
||||
|
||||
[Full agent details →](/docs/agents)
|
||||
|
||||
## Popular Skill Sources
|
||||
## Popular Sources
|
||||
|
||||
| Repository | Skills |
|
||||
|------------|--------|
|
||||
| anthropics/skills | PDF, XLSX, DOCX processing |
|
||||
| vercel-labs/agent-skills | React/Next.js best practices |
|
||||
| nextlevelbuilder/ui-ux-pro-max-skill | UI/UX design patterns |
|
||||
| superdesigndev/superdesign-skill | Modern design systems |
|
||||
|
||||
## Get Started
|
||||
|
||||
@@ -130,19 +67,3 @@ Claude Code, Cursor, Codex, Gemini CLI, OpenCode, GitHub Copilot, Windsurf, Anti
|
||||
2. [Quick Start](/docs/quickstart) - 5-minute guide
|
||||
3. [Commands](/docs/commands) - Full CLI reference
|
||||
4. [Skills](/docs/skills) - Skill format and lifecycle
|
||||
5. [API Reference](/docs/api-reference) - Programmatic access
|
||||
|
||||
## Use Cases
|
||||
|
||||
- **Multi-Agent Developer** - Write skills once, use across Claude, Cursor, Windsurf, and more
|
||||
- **Team Lead** - Share skills via Git-based manifest, ensure team alignment
|
||||
- **New Project Starter** - Auto-generate agent instructions with Primer
|
||||
- **Enterprise Architect** - Distribute agents across multiple machines with Mesh Network
|
||||
|
||||
## Enterprise Features
|
||||
|
||||
- **Private Registries** - Host internal skills in private repos
|
||||
- **Git-Based Sync** - Skills live in your repo, push to share
|
||||
- **CI/CD Integration** - Auto-validate and deploy skills on every commit
|
||||
- **TypeScript API** - Full programmatic access for custom workflows
|
||||
- **Security** - Ed25519 encryption, XChaCha20-Poly1305, TLS 1.3
|
||||
|
||||
@@ -5,18 +5,7 @@ description: Install SkillKit and set up your first project
|
||||
|
||||
# Installation
|
||||
|
||||
SkillKit is distributed as an npm package. Current version: **v1.8.0**
|
||||
|
||||
## Quick Start (No Install)
|
||||
|
||||
```bash
|
||||
# Run without installing
|
||||
npx skillkit@latest
|
||||
|
||||
# Run specific commands
|
||||
npx skillkit recommend
|
||||
npx skillkit install anthropics/skills
|
||||
```
|
||||
SkillKit is distributed as an npm package. Current version: **v1.7.5**
|
||||
|
||||
## Install Globally
|
||||
|
||||
|
||||
@@ -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
|
||||
@@ -10,17 +10,13 @@
|
||||
"translation",
|
||||
"marketplace",
|
||||
"recommendations",
|
||||
"primer",
|
||||
"memory",
|
||||
"mesh",
|
||||
"messaging",
|
||||
"workflows",
|
||||
"testing",
|
||||
"commands",
|
||||
"configuration",
|
||||
"api-reference",
|
||||
"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
|
||||
@@ -7,18 +7,15 @@ description: Get up and running with SkillKit in 5 minutes
|
||||
|
||||
This guide walks you through installing SkillKit, setting up your first project, and installing skills.
|
||||
|
||||
## 1. Run SkillKit
|
||||
|
||||
No installation required! Use npx:
|
||||
|
||||
```bash
|
||||
npx skillkit@latest
|
||||
```
|
||||
|
||||
Or install globally for frequent use:
|
||||
## 1. Install SkillKit
|
||||
|
||||
```bash
|
||||
npm install -g skillkit
|
||||
```
|
||||
|
||||
Verify installation:
|
||||
|
||||
```bash
|
||||
skillkit --version
|
||||
```
|
||||
|
||||
@@ -136,55 +133,6 @@ skillkit install vercel-labs/agent-skills --agent claude,cursor,windsurf
|
||||
skillkit sync
|
||||
```
|
||||
|
||||
## 7. Advanced Features
|
||||
|
||||
### Auto-Generate Instructions (Primer)
|
||||
|
||||
Let SkillKit analyze your codebase and generate optimized instructions:
|
||||
|
||||
```bash
|
||||
skillkit primer # Analyze and generate
|
||||
skillkit primer --all-agents # Generate for all 32 agents
|
||||
```
|
||||
|
||||
[Learn more about Primer →](/docs/primer)
|
||||
|
||||
### Session Memory
|
||||
|
||||
Capture learnings from your AI sessions:
|
||||
|
||||
```bash
|
||||
skillkit memory compress # Compress learnings
|
||||
skillkit memory search auth # Search knowledge
|
||||
skillkit memory export auth-skill # Export as skill
|
||||
```
|
||||
|
||||
[Learn more about Memory →](/docs/memory)
|
||||
|
||||
### Mesh Network (Multi-Machine)
|
||||
|
||||
Distribute agents across multiple machines:
|
||||
|
||||
```bash
|
||||
skillkit mesh init # Initialize mesh node
|
||||
skillkit mesh discover # Find peers on LAN
|
||||
skillkit mesh security init # Setup encryption
|
||||
```
|
||||
|
||||
[Learn more about Mesh →](/docs/mesh)
|
||||
|
||||
### Inter-Agent Messaging
|
||||
|
||||
Send messages between AI agents:
|
||||
|
||||
```bash
|
||||
skillkit message send # Send to another agent
|
||||
skillkit message inbox # Check your inbox
|
||||
skillkit message reply <id> # Reply to message
|
||||
```
|
||||
|
||||
[Learn more about Messaging →](/docs/messaging)
|
||||
|
||||
## Team Collaboration
|
||||
|
||||
Share skills with your team using manifest files:
|
||||
@@ -203,41 +151,6 @@ skillkit manifest install
|
||||
|
||||
The `.skills` file can be committed to Git for team-wide consistency.
|
||||
|
||||
## Workflows & Automation
|
||||
|
||||
### Workflow Orchestration
|
||||
|
||||
Compose skills into multi-step workflows:
|
||||
|
||||
```bash
|
||||
skillkit workflow create feature-development
|
||||
skillkit workflow run feature-development
|
||||
```
|
||||
|
||||
[Learn more about Workflows →](/docs/workflows)
|
||||
|
||||
### Skill Testing
|
||||
|
||||
Test skills before deployment:
|
||||
|
||||
```bash
|
||||
skillkit test # Run all tests
|
||||
skillkit test --tags unit # Run specific tests
|
||||
```
|
||||
|
||||
[Learn more about Testing →](/docs/testing)
|
||||
|
||||
### CI/CD Integration
|
||||
|
||||
Generate GitHub Actions, GitLab CI configs:
|
||||
|
||||
```bash
|
||||
skillkit cicd init --provider github
|
||||
skillkit cicd init --provider gitlab
|
||||
```
|
||||
|
||||
[Learn more about CI/CD →](/docs/cicd)
|
||||
|
||||
## User Preferences
|
||||
|
||||
Your choices are saved to `~/.skillkit/preferences.json`:
|
||||
@@ -252,44 +165,9 @@ Your choices are saved to `~/.skillkit/preferences.json`:
|
||||
}
|
||||
```
|
||||
|
||||
## Complete Workflow Example
|
||||
|
||||
```bash
|
||||
# 1. Install SkillKit
|
||||
npm install -g skillkit
|
||||
|
||||
# 2. Initialize in your project
|
||||
cd my-project
|
||||
skillkit init
|
||||
|
||||
# 3. Auto-generate base instructions
|
||||
skillkit primer --all-agents
|
||||
|
||||
# 4. Get smart recommendations
|
||||
skillkit recommend
|
||||
|
||||
# 5. Install recommended skills
|
||||
skillkit install anthropics/skills
|
||||
|
||||
# 6. Setup mesh network (optional)
|
||||
skillkit mesh init
|
||||
|
||||
# 7. Setup session memory (optional)
|
||||
skillkit memory compress
|
||||
|
||||
# 8. Sync everything to agents
|
||||
skillkit sync
|
||||
|
||||
# 9. Launch TUI for visual management
|
||||
skillkit
|
||||
```
|
||||
|
||||
## Next Steps
|
||||
|
||||
- **Browse Marketplace** - `skillkit marketplace`
|
||||
- **Create Custom Skills** - `skillkit create my-skill`
|
||||
- **Translate Between Agents** - `skillkit translate skill --to cursor`
|
||||
- **Auto-Generate Instructions** - `skillkit primer`
|
||||
- **Setup Memory System** - `skillkit memory compress`
|
||||
- **View All Commands** - `skillkit --help`
|
||||
- **API Reference** - [Programmatic Access →](/docs/api-reference)
|
||||
@@ -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
|
||||
@@ -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.8.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>
|
||||
|
||||
@@ -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
|
||||
}
|
||||
}
|
||||
}
|
||||
+23
-147
@@ -6,12 +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';
|
||||
|
||||
const GITHUB_ICON = (
|
||||
<svg className="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
|
||||
@@ -19,79 +13,48 @@ 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 {
|
||||
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">
|
||||
<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="#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="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="text-zinc-400 hover:text-white transition-colors p-1"
|
||||
className="text-zinc-400 hover:text-white transition-colors p-2"
|
||||
aria-label="GitHub"
|
||||
>
|
||||
{GITHUB_ICON}
|
||||
@@ -103,97 +66,15 @@ export default function App(): React.ReactElement {
|
||||
|
||||
<main className="pt-14">
|
||||
<Hero />
|
||||
|
||||
<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">1.8.0</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">2.4k</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">66</span>
|
||||
</a>
|
||||
<span className="text-zinc-800 hidden sm:inline">·</span>
|
||||
<a
|
||||
href="https://github.com/rohitg00/skillkit/blob/main/LICENSE"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="text-zinc-500 hover:text-white transition-colors hidden sm:inline"
|
||||
>
|
||||
Apache 2.0
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Agent Support - Quick visual proof */}
|
||||
<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>
|
||||
|
||||
{/* 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>
|
||||
@@ -204,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,212 +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: '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>('memory');
|
||||
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>
|
||||
);
|
||||
}
|
||||
@@ -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,80 +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: 'find <query>', desc: 'Search 15K+ skills' },
|
||||
{ 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: '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' },
|
||||
],
|
||||
},
|
||||
];
|
||||
@@ -99,7 +58,7 @@ export function Commands(): React.ReactElement {
|
||||
</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
|
||||
@@ -109,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>
|
||||
@@ -117,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>
|
||||
|
||||
@@ -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,71 +8,44 @@ interface Feature {
|
||||
|
||||
const FEATURES: Feature[] = [
|
||||
{
|
||||
title: 'Smart Recommendations',
|
||||
description: 'AI analyzes your codebase and suggests perfect 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: 'Write once, deploy to 32 agents. Zero manual conversion.',
|
||||
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: '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: '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" />
|
||||
@@ -80,23 +53,22 @@ const FEATURES: Feature[] = [
|
||||
)
|
||||
},
|
||||
{
|
||||
title: 'TS API',
|
||||
description: 'Programmatic access for custom tooling.',
|
||||
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="M10 20l4-16m4 4l4 4-4 4M6 16l-4-4 4-4" />
|
||||
<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'],
|
||||
['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 {
|
||||
@@ -115,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>
|
||||
@@ -147,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"
|
||||
|
||||
@@ -2,12 +2,11 @@ import React, { useState, useEffect } from 'react';
|
||||
import { Button } from './Button';
|
||||
|
||||
const ASCII_LOGO = `
|
||||
███████╗██╗ ██╗██╗██╗ ██╗ ██╗ ██╗██╗████████╗
|
||||
██╔════╝██║ ██╔╝██║██║ ██║ ██║ ██╔╝██║╚══██╔══╝
|
||||
███████╗█████╔╝ ██║██║ ██║ █████╔╝ ██║ ██║
|
||||
╚════██║██╔═██╗ ██║██║ ██║ ██╔═██╗ ██║ ██║
|
||||
███████║██║ ██╗██║███████╗███████╗██║ ██╗██║ ██║
|
||||
╚══════╝╚═╝ ╚═╝╚═╝╚══════╝╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝
|
||||
███████ ██ ██ ██ ██ ██ ██ ██ ██ ████████
|
||||
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
|
||||
███████ █████ ██ ██ ██ █████ ██ ██
|
||||
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
|
||||
███████ ██ ██ ██ ███████ ███████ ██ ██ ██ ██
|
||||
`.trim();
|
||||
|
||||
interface TerminalLine {
|
||||
@@ -16,17 +15,17 @@ interface TerminalLine {
|
||||
}
|
||||
|
||||
const TERMINAL_LINES: TerminalLine[] = [
|
||||
{ type: 'cmd', text: 'skillkit primer --all-agents' },
|
||||
{ type: 'out', text: '→ Analyzing codebase...' },
|
||||
{ type: 'out', text: ' ✓ Generated CLAUDE.md' },
|
||||
{ type: 'out', text: ' ✓ Generated .cursorrules' },
|
||||
{ type: 'cmd', text: 'skillkit recommend' },
|
||||
{ type: 'out', text: ' 92% vercel-react-best-practices' },
|
||||
{ type: 'out', text: ' 87% typescript-strict-mode' },
|
||||
{ type: 'cmd', text: 'skillkit install anthropics/skills --agent all' },
|
||||
{ type: 'out', text: '→ Installed to 32 agents' },
|
||||
{ type: 'cmd', text: 'skillkit memory compress' },
|
||||
{ type: 'out', text: '→ 12 learnings persisted' },
|
||||
{ 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 = `
|
||||
@@ -117,27 +116,26 @@ 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-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">v1.8.0</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">
|
||||
Write Once.<br />
|
||||
<span className="text-zinc-500">Deploy to 32 Agents.</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 universal skill platform for AI coding agents. Auto-generate instructions
|
||||
with Primer, persist learnings with Memory, distribute across Mesh networks.
|
||||
One CLI for 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-3 mb-4">
|
||||
@@ -164,7 +162,7 @@ export function Hero(): React.ReactElement {
|
||||
</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">
|
||||
@@ -173,7 +171,7 @@ export function Hero(): 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' ? (
|
||||
@@ -206,32 +204,6 @@ export function Hero(): 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>
|
||||
);
|
||||
}
|
||||
+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.8.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': {},
|
||||
},
|
||||
}
|
||||
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,10 +4,6 @@
|
||||
"installCommand": "npm install",
|
||||
"framework": "vite",
|
||||
"rewrites": [
|
||||
{
|
||||
"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', () => {
|
||||
|
||||
+1
-28
@@ -2,7 +2,7 @@
|
||||
"$schema": "./schema.json",
|
||||
"version": 1,
|
||||
"updatedAt": "2026-01-26",
|
||||
"totalSkills": 15064,
|
||||
"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,20 +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": "itsmostafa/aws-agent-skills/cognito",
|
||||
"name": "Cognito",
|
||||
|
||||
Generated
+2
-2
@@ -1,12 +1,12 @@
|
||||
{
|
||||
"name": "skillkit-monorepo",
|
||||
"version": "1.7.10",
|
||||
"version": "1.7.2",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "skillkit-monorepo",
|
||||
"version": "1.7.10",
|
||||
"version": "1.7.2",
|
||||
"license": "Apache-2.0",
|
||||
"devDependencies": {
|
||||
"@types/node": "^22.10.5",
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "skillkit-monorepo",
|
||||
"version": "1.8.0",
|
||||
"version": "1.7.2",
|
||||
"private": true,
|
||||
"description": "Universal skills loader for AI coding agents - Monorepo",
|
||||
"type": "module",
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "@skillkit/agents",
|
||||
"version": "1.8.1",
|
||||
"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> {
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
[](https://www.npmjs.com/package/@skillkit/cli)
|
||||
[](https://opensource.org/licenses/Apache-2.0)
|
||||
|
||||
**Command-line interface for SkillKit** - install, manage, translate, and sync skills across 32 AI coding agents.
|
||||
**Command-line interface for SkillKit** - install, manage, translate, and sync skills across 17 AI coding agents.
|
||||
|
||||
## Installation
|
||||
|
||||
@@ -243,7 +243,7 @@ const recs = await recommendCommand({
|
||||
| Gemini CLI | SKILL.md |
|
||||
| Windsurf | Markdown |
|
||||
| GitHub Copilot | Markdown |
|
||||
| + 26 more | SKILL.md |
|
||||
| + 11 more | SKILL.md |
|
||||
|
||||
## Documentation
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/cli",
|
||||
"version": "1.8.1",
|
||||
"version": "1.7.6",
|
||||
"description": "CLI commands for SkillKit",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
@@ -24,11 +24,7 @@
|
||||
"@clack/prompts": "^0.11.0",
|
||||
"@skillkit/core": "workspace:*",
|
||||
"@skillkit/agents": "workspace:*",
|
||||
"@skillkit/resources": "workspace:*",
|
||||
"@skillkit/tui": "workspace:*",
|
||||
"@skillkit/memory": "workspace:*",
|
||||
"@skillkit/mesh": "workspace:*",
|
||||
"@skillkit/messaging": "workspace:*",
|
||||
"chalk": "^5.3.0",
|
||||
"clipanion": "^4.0.0-rc.4",
|
||||
"got": "^14.4.1",
|
||||
|
||||
@@ -96,11 +96,11 @@ describe('Onboarding Module', () => {
|
||||
it('should generate full logo with version', async () => {
|
||||
const { getFullLogo } = await import('../onboarding/logo.js');
|
||||
|
||||
const logo = getFullLogo('1.7.2', 32);
|
||||
const logo = getFullLogo('1.7.2', 17);
|
||||
// Full logo uses block characters (███), not literal text
|
||||
expect(logo).toContain('\u2588'); // █ block character
|
||||
expect(logo).toContain('v1.7.2');
|
||||
expect(logo).toContain('32 agents');
|
||||
expect(logo).toContain('17 agents');
|
||||
});
|
||||
|
||||
it('should generate compact logo', async () => {
|
||||
|
||||
@@ -20,14 +20,6 @@ import {
|
||||
type CustomAgent,
|
||||
type AgentType,
|
||||
} from '@skillkit/core';
|
||||
import {
|
||||
getBundledAgents,
|
||||
getBundledAgent,
|
||||
getAvailableAgents,
|
||||
installBundledAgent,
|
||||
isAgentInstalled,
|
||||
type BundledAgent,
|
||||
} from '@skillkit/resources';
|
||||
// Agent discovery uses root directories, not skill directories
|
||||
|
||||
export class AgentCommand extends Command {
|
||||
@@ -637,203 +629,3 @@ function formatAgentName(name: string): string {
|
||||
.map(word => word.charAt(0).toUpperCase() + word.slice(1))
|
||||
.join(' ');
|
||||
}
|
||||
|
||||
export class AgentInstallCommand extends Command {
|
||||
static override paths = [['agent', 'install']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Install a bundled agent template',
|
||||
details: `
|
||||
Installs a bundled agent template from @skillkit/resources.
|
||||
These are battle-tested agent configurations for common tasks.
|
||||
|
||||
Use 'agent available' to see agents that can be installed.
|
||||
`,
|
||||
examples: [
|
||||
['Install code-reviewer agent', '$0 agent install code-reviewer'],
|
||||
['Install globally', '$0 agent install architect --global'],
|
||||
['Force overwrite existing', '$0 agent install tdd-guide --force'],
|
||||
['Install all bundled agents', '$0 agent install --all'],
|
||||
],
|
||||
});
|
||||
|
||||
name = Option.String({ required: false });
|
||||
|
||||
global = Option.Boolean('--global,-g', false, {
|
||||
description: 'Install to global agents directory',
|
||||
});
|
||||
|
||||
force = Option.Boolean('--force,-f', false, {
|
||||
description: 'Overwrite if agent already exists',
|
||||
});
|
||||
|
||||
all = Option.Boolean('--all,-a', false, {
|
||||
description: 'Install all bundled agents',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
if (this.all) {
|
||||
return this.installAll();
|
||||
}
|
||||
|
||||
if (!this.name) {
|
||||
console.log(chalk.yellow('Please specify an agent name or use --all'));
|
||||
console.log(chalk.dim('Run `skillkit agent available` to see available agents'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const agent = getBundledAgent(this.name);
|
||||
if (!agent) {
|
||||
console.log(chalk.red(`Bundled agent not found: ${this.name}`));
|
||||
console.log(chalk.dim('Run `skillkit agent available` to see available agents'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const result = installBundledAgent(this.name, {
|
||||
global: this.global,
|
||||
force: this.force,
|
||||
});
|
||||
|
||||
if (result.success) {
|
||||
console.log(chalk.green(`✓ Installed: ${agent.name}`));
|
||||
console.log(chalk.dim(` Path: ${result.path}`));
|
||||
console.log(chalk.dim(` Invoke with: @${agent.id}`));
|
||||
} else {
|
||||
console.log(chalk.red(`✗ Failed: ${result.message}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
|
||||
private async installAll(): Promise<number> {
|
||||
const agents = getBundledAgents();
|
||||
console.log(chalk.cyan(`Installing ${agents.length} bundled agents...\n`));
|
||||
|
||||
let successCount = 0;
|
||||
let skipCount = 0;
|
||||
let errorCount = 0;
|
||||
|
||||
for (const agent of agents) {
|
||||
const result = installBundledAgent(agent.id, {
|
||||
global: this.global,
|
||||
force: this.force,
|
||||
});
|
||||
|
||||
if (result.success) {
|
||||
console.log(chalk.green(` ✓ ${agent.name}`));
|
||||
successCount++;
|
||||
} else if (result.message.includes('already exists')) {
|
||||
console.log(chalk.yellow(` ○ ${agent.name} (already installed)`));
|
||||
skipCount++;
|
||||
} else {
|
||||
console.log(chalk.red(` ✗ ${agent.name}: ${result.message}`));
|
||||
errorCount++;
|
||||
}
|
||||
}
|
||||
|
||||
console.log();
|
||||
console.log(
|
||||
chalk.dim(
|
||||
`Installed: ${successCount}, Skipped: ${skipCount}, Errors: ${errorCount}`
|
||||
)
|
||||
);
|
||||
|
||||
return errorCount > 0 ? 1 : 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class AgentAvailableCommand extends Command {
|
||||
static override paths = [['agent', 'available'], ['agent', 'bundled']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'List bundled agents available for installation',
|
||||
examples: [
|
||||
['List available agents', '$0 agent available'],
|
||||
['Show JSON output', '$0 agent available --json'],
|
||||
['Filter by category', '$0 agent available --category testing'],
|
||||
],
|
||||
});
|
||||
|
||||
json = Option.Boolean('--json,-j', false, {
|
||||
description: 'Output as JSON',
|
||||
});
|
||||
|
||||
category = Option.String('--category,-c', {
|
||||
description: 'Filter by category (planning, development, testing, review, documentation, security, refactoring)',
|
||||
});
|
||||
|
||||
installed = Option.Boolean('--installed,-i', false, {
|
||||
description: 'Show only installed bundled agents',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
let agents: BundledAgent[];
|
||||
|
||||
if (this.installed) {
|
||||
agents = getBundledAgents().filter(a => isAgentInstalled(a.id));
|
||||
} else {
|
||||
agents = getAvailableAgents();
|
||||
}
|
||||
|
||||
if (this.category) {
|
||||
agents = agents.filter(a => a.category === this.category);
|
||||
}
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(agents, null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
if (agents.length === 0) {
|
||||
if (this.installed) {
|
||||
console.log(chalk.yellow('No bundled agents installed'));
|
||||
console.log(chalk.dim('Run `skillkit agent install <name>` to install'));
|
||||
} else {
|
||||
console.log(chalk.green('All bundled agents are already installed!'));
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
|
||||
const title = this.installed
|
||||
? 'Installed Bundled Agents'
|
||||
: 'Available Bundled Agents';
|
||||
|
||||
console.log(chalk.cyan(`${title} (${agents.length}):\n`));
|
||||
|
||||
const categories = new Map<string, BundledAgent[]>();
|
||||
for (const agent of agents) {
|
||||
const cat = agent.category;
|
||||
if (!categories.has(cat)) {
|
||||
categories.set(cat, []);
|
||||
}
|
||||
categories.get(cat)!.push(agent);
|
||||
}
|
||||
|
||||
for (const [category, catAgents] of categories) {
|
||||
console.log(chalk.blue(` ${formatCategoryName(category)}`));
|
||||
for (const agent of catAgents) {
|
||||
const installed = isAgentInstalled(agent.id);
|
||||
const status = installed ? chalk.green('✓') : chalk.dim('○');
|
||||
const model = agent.model ? chalk.blue(`[${agent.model}]`) : '';
|
||||
console.log(` ${status} ${chalk.bold(agent.id)} ${model}`);
|
||||
console.log(` ${chalk.dim(agent.description)}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (!this.installed) {
|
||||
console.log(chalk.dim('Install with: skillkit agent install <name>'));
|
||||
console.log(chalk.dim('Install all: skillkit agent install --all'));
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
function formatCategoryName(category: string): string {
|
||||
return category
|
||||
.split('-')
|
||||
.map(word => word.charAt(0).toUpperCase() + word.slice(1))
|
||||
.join(' ');
|
||||
}
|
||||
|
||||
@@ -17,13 +17,6 @@ import {
|
||||
supportsSlashCommands,
|
||||
} from '@skillkit/core';
|
||||
import type { SlashCommand, AgentType } from '@skillkit/core';
|
||||
import {
|
||||
getCommandTemplates,
|
||||
getCommandTemplate,
|
||||
getCommandTemplatesByCategory,
|
||||
type CommandTemplate,
|
||||
type CommandCategory,
|
||||
} from '@skillkit/resources';
|
||||
|
||||
export class CommandCmd extends Command {
|
||||
static paths = [['command']];
|
||||
@@ -506,132 +499,3 @@ export class CommandCmd extends Command {
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
export class CommandAvailableCommand extends Command {
|
||||
static override paths = [['command', 'available']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
category: 'Commands',
|
||||
description: 'List available bundled command templates',
|
||||
examples: [
|
||||
['List all available', '$0 command available'],
|
||||
['Filter by category', '$0 command available --category testing'],
|
||||
],
|
||||
});
|
||||
|
||||
category = Option.String('--category,-c', {
|
||||
description: 'Filter by category (testing, planning, development, review, workflow, learning)',
|
||||
});
|
||||
|
||||
json = Option.Boolean('--json,-j', false, {
|
||||
description: 'Output as JSON',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const templates = this.category
|
||||
? getCommandTemplatesByCategory(this.category as CommandCategory)
|
||||
: getCommandTemplates();
|
||||
|
||||
if (this.json) {
|
||||
this.context.stdout.write(JSON.stringify(templates, null, 2) + '\n');
|
||||
return 0;
|
||||
}
|
||||
|
||||
this.context.stdout.write(`Available Command Templates (${templates.length}):\n\n`);
|
||||
|
||||
const byCategory = new Map<string, CommandTemplate[]>();
|
||||
for (const template of templates) {
|
||||
const cat = template.category || 'general';
|
||||
if (!byCategory.has(cat)) {
|
||||
byCategory.set(cat, []);
|
||||
}
|
||||
byCategory.get(cat)!.push(template);
|
||||
}
|
||||
|
||||
for (const [category, catTemplates] of byCategory) {
|
||||
this.context.stdout.write(` ${category.toUpperCase()}\n`);
|
||||
for (const template of catTemplates) {
|
||||
const agent = template.agent ? ` [${template.agent}]` : '';
|
||||
this.context.stdout.write(` ${template.trigger}${agent}\n`);
|
||||
this.context.stdout.write(` ${template.description}\n`);
|
||||
}
|
||||
this.context.stdout.write('\n');
|
||||
}
|
||||
|
||||
this.context.stdout.write('Install with: skillkit command install <id>\n');
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class CommandInstallCommand extends Command {
|
||||
static override paths = [['command', 'install']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
category: 'Commands',
|
||||
description: 'Install a bundled command template',
|
||||
examples: [
|
||||
['Install TDD command', '$0 command install tdd'],
|
||||
['Install code review', '$0 command install code-review'],
|
||||
],
|
||||
});
|
||||
|
||||
id = Option.String({ required: true });
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const template = getCommandTemplate(this.id);
|
||||
|
||||
if (!template) {
|
||||
this.context.stderr.write(`Command template not found: ${this.id}\n`);
|
||||
this.context.stderr.write('Run "skillkit command available" to see available templates.\n');
|
||||
return 1;
|
||||
}
|
||||
|
||||
const command: SlashCommand = {
|
||||
name: template.id,
|
||||
description: template.description,
|
||||
skill: `template:${template.id}`,
|
||||
category: template.category,
|
||||
examples: template.examples,
|
||||
metadata: {
|
||||
templateId: template.id,
|
||||
trigger: template.trigger,
|
||||
agent: template.agent,
|
||||
prompt: template.prompt,
|
||||
},
|
||||
};
|
||||
|
||||
const configPath = resolve(process.cwd(), '.skillkit', 'commands.json');
|
||||
let commands: SlashCommand[] = [];
|
||||
|
||||
if (existsSync(configPath)) {
|
||||
const content = await readFile(configPath, 'utf-8');
|
||||
const config = JSON.parse(content);
|
||||
commands = config.commands || [];
|
||||
}
|
||||
|
||||
const existing = commands.findIndex((c) => c.name === template.id);
|
||||
if (existing >= 0) {
|
||||
commands[existing] = command;
|
||||
this.context.stdout.write(`Updated command: ${template.trigger}\n`);
|
||||
} else {
|
||||
commands.push(command);
|
||||
this.context.stdout.write(`Installed command: ${template.trigger}\n`);
|
||||
}
|
||||
|
||||
await mkdir(dirname(configPath), { recursive: true });
|
||||
await writeFile(
|
||||
configPath,
|
||||
JSON.stringify({ version: '1.0.0', commands }, null, 2)
|
||||
);
|
||||
|
||||
this.context.stdout.write(` Name: ${template.name}\n`);
|
||||
this.context.stdout.write(` Description: ${template.description}\n`);
|
||||
if (template.agent) {
|
||||
this.context.stdout.write(` Agent: ${template.agent}\n`);
|
||||
}
|
||||
this.context.stdout.write(`\nSaved to: ${configPath}\n`);
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,277 +0,0 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import chalk from 'chalk';
|
||||
import {
|
||||
getAllGuidelines,
|
||||
getEnabledGuidelines,
|
||||
getGuideline,
|
||||
enableGuideline,
|
||||
disableGuideline,
|
||||
isGuidelineEnabled,
|
||||
isBuiltinGuideline,
|
||||
addCustomGuideline,
|
||||
removeCustomGuideline,
|
||||
type Guideline,
|
||||
type GuidelineCategory,
|
||||
} from '@skillkit/core';
|
||||
|
||||
export class GuidelineCommand extends Command {
|
||||
static override paths = [['guideline'], ['guide']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Manage coding guidelines (always-on rules)',
|
||||
details: `
|
||||
Guidelines are always-on coding standards that guide agent behavior.
|
||||
Enable or disable guidelines based on your project needs.
|
||||
`,
|
||||
examples: [
|
||||
['List guidelines', '$0 guideline list'],
|
||||
['Enable guideline', '$0 guideline enable security'],
|
||||
['Disable guideline', '$0 guideline disable performance'],
|
||||
],
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
console.log(chalk.cyan('Guideline commands:\n'));
|
||||
console.log(' guideline list List all guidelines');
|
||||
console.log(' guideline show <id> Show guideline content');
|
||||
console.log(' guideline enable Enable a guideline');
|
||||
console.log(' guideline disable Disable a guideline');
|
||||
console.log(' guideline create Create custom guideline');
|
||||
console.log();
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class GuidelineListCommand extends Command {
|
||||
static override paths = [['guideline', 'list'], ['guideline', 'ls']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'List all guidelines',
|
||||
examples: [
|
||||
['List all', '$0 guideline list'],
|
||||
['Show only enabled', '$0 guideline list --enabled'],
|
||||
],
|
||||
});
|
||||
|
||||
enabled = Option.Boolean('--enabled,-e', false, {
|
||||
description: 'Show only enabled guidelines',
|
||||
});
|
||||
|
||||
json = Option.Boolean('--json,-j', false, {
|
||||
description: 'Output as JSON',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const guidelines = this.enabled ? getEnabledGuidelines() : getAllGuidelines();
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(guidelines, null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
const title = this.enabled ? 'Enabled Guidelines' : 'All Guidelines';
|
||||
console.log(chalk.cyan(`${title} (${guidelines.length}):\n`));
|
||||
|
||||
const byCategory = new Map<GuidelineCategory, Guideline[]>();
|
||||
for (const guideline of guidelines) {
|
||||
if (!byCategory.has(guideline.category)) {
|
||||
byCategory.set(guideline.category, []);
|
||||
}
|
||||
byCategory.get(guideline.category)!.push(guideline);
|
||||
}
|
||||
|
||||
for (const [category, catGuidelines] of byCategory) {
|
||||
console.log(chalk.blue(` ${formatCategoryName(category)}`));
|
||||
|
||||
for (const guideline of catGuidelines) {
|
||||
const enabled = isGuidelineEnabled(guideline.id);
|
||||
const status = enabled ? chalk.green('●') : chalk.dim('○');
|
||||
const custom = isBuiltinGuideline(guideline.id) ? '' : chalk.dim(' (custom)');
|
||||
const priority = chalk.dim(`[${guideline.priority}]`);
|
||||
|
||||
console.log(` ${status} ${chalk.bold(guideline.id)} ${priority}${custom}`);
|
||||
console.log(` ${chalk.dim(guideline.description)}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
console.log(chalk.dim('Enable with: skillkit guideline enable <id>'));
|
||||
console.log(chalk.dim('Show content: skillkit guideline show <id>'));
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class GuidelineShowCommand extends Command {
|
||||
static override paths = [['guideline', 'show']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Show guideline content',
|
||||
examples: [['Show guideline', '$0 guideline show security']],
|
||||
});
|
||||
|
||||
id = Option.String({ required: true });
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const guideline = getGuideline(this.id);
|
||||
|
||||
if (!guideline) {
|
||||
console.log(chalk.red(`Guideline not found: ${this.id}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const enabled = isGuidelineEnabled(this.id);
|
||||
const status = enabled ? chalk.green('enabled') : chalk.dim('disabled');
|
||||
|
||||
console.log(chalk.cyan(`Guideline: ${guideline.name}\n`));
|
||||
console.log(`ID: ${guideline.id}`);
|
||||
console.log(`Category: ${guideline.category}`);
|
||||
console.log(`Priority: ${guideline.priority}`);
|
||||
console.log(`Status: ${status}`);
|
||||
console.log();
|
||||
console.log(chalk.bold('Content:'));
|
||||
console.log(guideline.content);
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class GuidelineEnableCommand extends Command {
|
||||
static override paths = [['guideline', 'enable']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Enable a guideline',
|
||||
examples: [['Enable security', '$0 guideline enable security']],
|
||||
});
|
||||
|
||||
id = Option.String({ required: true });
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const success = enableGuideline(this.id);
|
||||
|
||||
if (!success) {
|
||||
console.log(chalk.red(`Guideline not found: ${this.id}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
console.log(chalk.green(`✓ Enabled guideline: ${this.id}`));
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class GuidelineDisableCommand extends Command {
|
||||
static override paths = [['guideline', 'disable']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Disable a guideline',
|
||||
examples: [['Disable performance', '$0 guideline disable performance']],
|
||||
});
|
||||
|
||||
id = Option.String({ required: true });
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const success = disableGuideline(this.id);
|
||||
|
||||
if (!success) {
|
||||
console.log(chalk.yellow(`Guideline not found or already disabled: ${this.id}`));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.green(`✓ Disabled guideline: ${this.id}`));
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class GuidelineCreateCommand extends Command {
|
||||
static override paths = [['guideline', 'create']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Create a custom guideline',
|
||||
examples: [
|
||||
['Create guideline', '$0 guideline create --id my-rules --name "My Rules" --category custom'],
|
||||
],
|
||||
});
|
||||
|
||||
id = Option.String('--id', {
|
||||
description: 'Guideline ID',
|
||||
required: true,
|
||||
});
|
||||
|
||||
name = Option.String('--name,-n', {
|
||||
description: 'Guideline name',
|
||||
required: true,
|
||||
});
|
||||
|
||||
description = Option.String('--description,-d', {
|
||||
description: 'Guideline description',
|
||||
});
|
||||
|
||||
category = Option.String('--category,-c', {
|
||||
description: 'Category (security, code-style, testing, git, performance, custom)',
|
||||
});
|
||||
|
||||
priority = Option.String('--priority,-p', {
|
||||
description: 'Priority (1-10, higher = more important)',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
if (isBuiltinGuideline(this.id)) {
|
||||
console.log(chalk.red(`Cannot create: ${this.id} is a built-in guideline`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const guideline: Guideline = {
|
||||
id: this.id,
|
||||
name: this.name,
|
||||
description: this.description || this.name,
|
||||
category: (this.category as GuidelineCategory) || 'custom',
|
||||
priority: this.priority ? parseInt(this.priority) : 5,
|
||||
enabled: true,
|
||||
scope: 'global',
|
||||
content: `## ${this.name}\n\nAdd your guidelines here.`,
|
||||
};
|
||||
|
||||
addCustomGuideline(guideline);
|
||||
enableGuideline(this.id);
|
||||
|
||||
console.log(chalk.green(`✓ Created guideline: ${this.id}`));
|
||||
console.log(chalk.dim('Edit ~/.skillkit/guidelines.yaml to customize content'));
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class GuidelineRemoveCommand extends Command {
|
||||
static override paths = [['guideline', 'remove'], ['guideline', 'rm']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Remove a custom guideline',
|
||||
examples: [['Remove guideline', '$0 guideline remove my-rules']],
|
||||
});
|
||||
|
||||
id = Option.String({ required: true });
|
||||
|
||||
async execute(): Promise<number> {
|
||||
if (isBuiltinGuideline(this.id)) {
|
||||
console.log(chalk.red(`Cannot remove built-in guideline: ${this.id}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const removed = removeCustomGuideline(this.id);
|
||||
|
||||
if (!removed) {
|
||||
console.log(chalk.yellow(`Guideline not found: ${this.id}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
console.log(chalk.green(`✓ Removed guideline: ${this.id}`));
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
function formatCategoryName(category: string): string {
|
||||
return category
|
||||
.split('-')
|
||||
.map(word => word.charAt(0).toUpperCase() + word.slice(1))
|
||||
.join(' ');
|
||||
}
|
||||
@@ -7,13 +7,6 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import chalk from 'chalk';
|
||||
import { createHookManager, type HookEvent, type InjectionMode } from '@skillkit/core';
|
||||
import {
|
||||
getHookTemplates,
|
||||
getHookTemplate,
|
||||
getHookTemplatesByCategory,
|
||||
type HookTemplate,
|
||||
type HookTemplateCategory,
|
||||
} from '@skillkit/resources';
|
||||
|
||||
export class HookCommand extends Command {
|
||||
static override paths = [['hook']];
|
||||
@@ -287,152 +280,3 @@ export class HookCommand extends Command {
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class HookTemplateListCommand extends Command {
|
||||
static override paths = [['hook', 'template', 'list']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'List available hook templates',
|
||||
examples: [
|
||||
['List all templates', '$0 hook template list'],
|
||||
['Filter by category', '$0 hook template list --category quality'],
|
||||
],
|
||||
});
|
||||
|
||||
category = Option.String('--category,-c', {
|
||||
description: 'Filter by category (security, quality, workflow, productivity)',
|
||||
});
|
||||
|
||||
json = Option.Boolean('--json,-j', false, {
|
||||
description: 'Output as JSON',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
let templates = this.category
|
||||
? getHookTemplatesByCategory(this.category as HookTemplateCategory)
|
||||
: getHookTemplates();
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(templates, null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.cyan(`Hook Templates (${templates.length}):\n`));
|
||||
|
||||
const byCategory = new Map<HookTemplateCategory, HookTemplate[]>();
|
||||
for (const template of templates) {
|
||||
if (!byCategory.has(template.category)) {
|
||||
byCategory.set(template.category, []);
|
||||
}
|
||||
byCategory.get(template.category)!.push(template);
|
||||
}
|
||||
|
||||
for (const [category, catTemplates] of byCategory) {
|
||||
console.log(chalk.blue(` ${formatCategory(category)}`));
|
||||
for (const template of catTemplates) {
|
||||
const blocking = template.blocking ? chalk.yellow(' [blocking]') : '';
|
||||
console.log(` ${chalk.bold(template.id)}${blocking}`);
|
||||
console.log(` ${chalk.dim(template.description)}`);
|
||||
console.log(` Event: ${template.event}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
console.log(chalk.dim('Apply with: skillkit hook template apply <id>'));
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class HookTemplateApplyCommand extends Command {
|
||||
static override paths = [['hook', 'template', 'apply']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Apply a hook template',
|
||||
examples: [
|
||||
['Apply typescript-check', '$0 hook template apply typescript-check'],
|
||||
['Apply security-scan', '$0 hook template apply security-scan'],
|
||||
],
|
||||
});
|
||||
|
||||
id = Option.String({ required: true });
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const template = getHookTemplate(this.id);
|
||||
|
||||
if (!template) {
|
||||
console.log(chalk.red(`Template not found: ${this.id}`));
|
||||
console.log(chalk.dim('Run `skillkit hook template list` to see available templates'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const projectPath = process.cwd();
|
||||
const manager = createHookManager({ projectPath });
|
||||
|
||||
const hook = manager.registerHook({
|
||||
event: template.event as HookEvent,
|
||||
skills: [`template:${template.id}`],
|
||||
inject: 'content',
|
||||
matcher: template.matcher,
|
||||
enabled: true,
|
||||
metadata: {
|
||||
templateId: template.id,
|
||||
command: template.command,
|
||||
timeout: template.timeout,
|
||||
blocking: template.blocking,
|
||||
},
|
||||
});
|
||||
|
||||
manager.save();
|
||||
|
||||
console.log(chalk.green(`✓ Applied template: ${template.name}`));
|
||||
console.log(` Hook ID: ${hook.id.slice(0, 8)}`);
|
||||
console.log(` Event: ${template.event}`);
|
||||
console.log(` Command: ${chalk.dim(template.command)}`);
|
||||
if (template.blocking) {
|
||||
console.log(chalk.yellow(` Blocking: yes`));
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class HookTemplateShowCommand extends Command {
|
||||
static override paths = [['hook', 'template', 'show']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Show hook template details',
|
||||
examples: [['Show template', '$0 hook template show typescript-check']],
|
||||
});
|
||||
|
||||
id = Option.String({ required: true });
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const template = getHookTemplate(this.id);
|
||||
|
||||
if (!template) {
|
||||
console.log(chalk.red(`Template not found: ${this.id}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
console.log(chalk.cyan(`Template: ${template.name}\n`));
|
||||
console.log(`ID: ${template.id}`);
|
||||
console.log(`Category: ${template.category}`);
|
||||
console.log(`Description: ${template.description}`);
|
||||
console.log(`Event: ${template.event}`);
|
||||
if (template.matcher) {
|
||||
console.log(`Matcher: ${template.matcher}`);
|
||||
}
|
||||
console.log(`Blocking: ${template.blocking ? 'yes' : 'no'}`);
|
||||
console.log(`Timeout: ${template.timeout || 30000}ms`);
|
||||
console.log();
|
||||
console.log(chalk.bold('Command:'));
|
||||
console.log(` ${template.command}`);
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
function formatCategory(category: string): string {
|
||||
return category.charAt(0).toUpperCase() + category.slice(1);
|
||||
}
|
||||
|
||||
@@ -17,13 +17,7 @@ export { RecommendCommand } from './recommend.js';
|
||||
export { StatusCommand } from './status.js';
|
||||
export { PauseCommand } from './pause.js';
|
||||
export { ResumeCommand } from './resume.js';
|
||||
export {
|
||||
WorkflowRunCommand,
|
||||
WorkflowListCommand,
|
||||
WorkflowCreateCommand,
|
||||
WorkflowPipelineCommand,
|
||||
WorkflowPipelineListCommand,
|
||||
} from './workflow/index.js';
|
||||
export { WorkflowRunCommand, WorkflowListCommand, WorkflowCreateCommand } from './workflow/index.js';
|
||||
export { RunCommand } from './run.js';
|
||||
export { TestCommand } from './test.js';
|
||||
export { MarketplaceCommand } from './marketplace.js';
|
||||
@@ -33,14 +27,9 @@ export { CICDCommand } from './cicd.js';
|
||||
export { TeamCommand } from './team.js';
|
||||
export { PluginCommand } from './plugin.js';
|
||||
export { MethodologyCommand } from './methodology.js';
|
||||
export {
|
||||
HookCommand,
|
||||
HookTemplateListCommand,
|
||||
HookTemplateApplyCommand,
|
||||
HookTemplateShowCommand,
|
||||
} from './hook.js';
|
||||
export { HookCommand } from './hook.js';
|
||||
export { PlanCommand } from './plan.js';
|
||||
export { CommandCmd, CommandAvailableCommand, CommandInstallCommand } from './command.js';
|
||||
export { CommandCmd } from './command.js';
|
||||
export { AICommand } from './ai.js';
|
||||
export { AuditCommand } from './audit.js';
|
||||
export { PublishCommand } from './publish.js';
|
||||
@@ -52,8 +41,6 @@ export {
|
||||
AgentTranslateCommand,
|
||||
AgentSyncCommand,
|
||||
AgentValidateCommand,
|
||||
AgentInstallCommand,
|
||||
AgentAvailableCommand,
|
||||
} from './agent.js';
|
||||
|
||||
export { CheckCommand } from './check.js';
|
||||
@@ -66,41 +53,3 @@ export {
|
||||
ManifestInstallCommand,
|
||||
ManifestGenerateCommand,
|
||||
} from './manifest.js';
|
||||
export { PrimerCommand } from './primer.js';
|
||||
export { MeshCommand } from './mesh.js';
|
||||
export { MessageCommand } from './message.js';
|
||||
export {
|
||||
LearnCommand,
|
||||
PatternStatusCommand,
|
||||
PatternFeedbackCommand,
|
||||
PatternApproveCommand,
|
||||
PatternRejectCommand,
|
||||
PatternExportCommand,
|
||||
PatternImportCommand,
|
||||
PatternClusterCommand,
|
||||
} from './learn.js';
|
||||
export {
|
||||
SessionCommand,
|
||||
SessionStatusCommand,
|
||||
SessionStartCommand,
|
||||
SessionLoadCommand,
|
||||
SessionListCommand,
|
||||
SessionNoteCommand,
|
||||
SessionCompleteCommand,
|
||||
SessionInProgressCommand,
|
||||
} from './session.js';
|
||||
export {
|
||||
ProfileCommand,
|
||||
ProfileListCommand,
|
||||
ProfileCreateCommand,
|
||||
ProfileRemoveCommand,
|
||||
} from './profile.js';
|
||||
export {
|
||||
GuidelineCommand,
|
||||
GuidelineListCommand,
|
||||
GuidelineShowCommand,
|
||||
GuidelineEnableCommand,
|
||||
GuidelineDisableCommand,
|
||||
GuidelineCreateCommand,
|
||||
GuidelineRemoveCommand,
|
||||
} from './guideline.js';
|
||||
|
||||
@@ -34,7 +34,7 @@ import {
|
||||
} from '../onboarding/index.js';
|
||||
|
||||
export class InstallCommand extends Command {
|
||||
static override paths = [['install'], ['i'], ['add']];
|
||||
static override paths = [['install'], ['i']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Install skills from GitHub, GitLab, Bitbucket, or local path',
|
||||
|
||||
@@ -1,491 +0,0 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { resolve } from 'node:path';
|
||||
import chalk from 'chalk';
|
||||
import {
|
||||
analyzeGitHistory,
|
||||
loadPatternStore,
|
||||
addPattern,
|
||||
getAllPatterns,
|
||||
getApprovedPatterns,
|
||||
generateSkillFromPatterns,
|
||||
saveGeneratedSkill,
|
||||
generatePatternReport,
|
||||
exportPatternsAsJson,
|
||||
importPatternsFromJson,
|
||||
recordSuccess,
|
||||
recordFailure,
|
||||
approvePattern,
|
||||
rejectPattern,
|
||||
getPatternStats,
|
||||
clusterPatterns,
|
||||
type LearnedPattern,
|
||||
type GitAnalysisResult,
|
||||
} from '@skillkit/core';
|
||||
import { writeFileSync, readFileSync, existsSync } from 'node:fs';
|
||||
|
||||
export class LearnCommand extends Command {
|
||||
static override paths = [['learn']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Extract learnable patterns from git history or sessions',
|
||||
details: `
|
||||
Analyzes git commit history to extract reusable patterns for error fixes,
|
||||
workarounds, debugging techniques, and project conventions.
|
||||
|
||||
Patterns are stored locally and can be converted into skills.
|
||||
`,
|
||||
examples: [
|
||||
['Analyze git history', '$0 learn'],
|
||||
['Analyze specific number of commits', '$0 learn --commits 50'],
|
||||
['Auto-approve patterns', '$0 learn --approve'],
|
||||
['Show extracted patterns', '$0 learn --show'],
|
||||
],
|
||||
});
|
||||
|
||||
commits = Option.String('--commits,-c', {
|
||||
description: 'Number of commits to analyze (default: 100)',
|
||||
});
|
||||
|
||||
since = Option.String('--since,-s', {
|
||||
description: 'Analyze commits since date (e.g., "2 weeks ago")',
|
||||
});
|
||||
|
||||
approve = Option.Boolean('--approve,-a', false, {
|
||||
description: 'Auto-approve extracted patterns',
|
||||
});
|
||||
|
||||
show = Option.Boolean('--show', false, {
|
||||
description: 'Show existing patterns without analyzing',
|
||||
});
|
||||
|
||||
json = Option.Boolean('--json,-j', false, {
|
||||
description: 'Output as JSON',
|
||||
});
|
||||
|
||||
directory = Option.String('--dir,-d', {
|
||||
description: 'Project directory to analyze (default: current directory)',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const projectPath = resolve(this.directory || process.cwd());
|
||||
|
||||
if (this.show) {
|
||||
return this.showPatterns();
|
||||
}
|
||||
|
||||
console.log(chalk.cyan('Analyzing git history for learnable patterns...\n'));
|
||||
|
||||
const result = analyzeGitHistory(projectPath, {
|
||||
commits: this.commits ? parseInt(this.commits) : 100,
|
||||
since: this.since,
|
||||
});
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(result, null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
this.printAnalysisResult(result);
|
||||
|
||||
if (result.patterns.length === 0) {
|
||||
console.log(chalk.yellow('\nNo learnable patterns found.'));
|
||||
console.log(chalk.dim('Try analyzing more commits or a different date range.'));
|
||||
return 0;
|
||||
}
|
||||
|
||||
loadPatternStore();
|
||||
let added = 0;
|
||||
|
||||
for (const pattern of result.patterns) {
|
||||
if (this.approve) {
|
||||
pattern.approved = true;
|
||||
}
|
||||
addPattern(pattern);
|
||||
added++;
|
||||
}
|
||||
|
||||
console.log();
|
||||
console.log(chalk.green(`✓ Extracted ${added} patterns`));
|
||||
|
||||
if (!this.approve) {
|
||||
console.log(chalk.dim('Patterns are pending approval. Use:'));
|
||||
console.log(chalk.dim(' skillkit pattern approve <id> - to approve'));
|
||||
console.log(chalk.dim(' skillkit pattern status - to view all'));
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
|
||||
private printAnalysisResult(result: GitAnalysisResult): void {
|
||||
const { summary, dateRange, languages, frameworks } = result;
|
||||
|
||||
console.log(chalk.bold('Analysis Summary'));
|
||||
console.log(` Commits analyzed: ${summary.totalCommits}`);
|
||||
console.log(` Files changed: ${summary.totalFilesChanged}`);
|
||||
console.log(` Date range: ${dateRange.from || 'N/A'} to ${dateRange.to || 'N/A'}`);
|
||||
console.log();
|
||||
|
||||
if (languages.length > 0) {
|
||||
console.log(` Languages: ${chalk.cyan(languages.join(', '))}`);
|
||||
}
|
||||
if (frameworks.length > 0) {
|
||||
console.log(` Frameworks: ${chalk.cyan(frameworks.join(', '))}`);
|
||||
}
|
||||
console.log();
|
||||
|
||||
console.log(chalk.bold('Commit Categories'));
|
||||
console.log(` Error fixes: ${summary.errorFixes}`);
|
||||
console.log(` Refactors: ${summary.refactors}`);
|
||||
console.log(` Features: ${summary.features}`);
|
||||
console.log(` Documentation: ${summary.documentation}`);
|
||||
console.log(` Tests: ${summary.tests}`);
|
||||
console.log();
|
||||
|
||||
console.log(chalk.bold(`Patterns Extracted: ${result.patterns.length}`));
|
||||
|
||||
for (const pattern of result.patterns.slice(0, 5)) {
|
||||
const confidence = chalk.blue(`${(pattern.confidence * 100).toFixed(0)}%`);
|
||||
console.log(` ${chalk.dim('○')} ${pattern.title} [${pattern.category}] ${confidence}`);
|
||||
}
|
||||
|
||||
if (result.patterns.length > 5) {
|
||||
console.log(chalk.dim(` ... and ${result.patterns.length - 5} more`));
|
||||
}
|
||||
}
|
||||
|
||||
private showPatterns(): number {
|
||||
const patterns = getAllPatterns();
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(patterns, null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
if (patterns.length === 0) {
|
||||
console.log(chalk.yellow('No patterns stored yet.'));
|
||||
console.log(chalk.dim('Run `skillkit learn` to extract patterns from git history.'));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.cyan(`Stored Patterns (${patterns.length}):\n`));
|
||||
|
||||
const approved = patterns.filter(p => p.approved);
|
||||
const pending = patterns.filter(p => !p.approved);
|
||||
|
||||
if (approved.length > 0) {
|
||||
console.log(chalk.green('Approved:'));
|
||||
for (const pattern of approved) {
|
||||
this.printPattern(pattern);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (pending.length > 0) {
|
||||
console.log(chalk.yellow('Pending Approval:'));
|
||||
for (const pattern of pending) {
|
||||
this.printPattern(pattern);
|
||||
}
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
|
||||
private printPattern(pattern: LearnedPattern): void {
|
||||
const confidence = chalk.blue(`${(pattern.confidence * 100).toFixed(0)}%`);
|
||||
const status = pattern.approved ? chalk.green('✓') : chalk.yellow('○');
|
||||
console.log(` ${status} ${chalk.bold(pattern.id)}`);
|
||||
console.log(` ${pattern.title} [${pattern.category}] ${confidence}`);
|
||||
console.log(chalk.dim(` ${truncate(pattern.problem, 60)}`));
|
||||
}
|
||||
}
|
||||
|
||||
export class PatternStatusCommand extends Command {
|
||||
static override paths = [['pattern', 'status'], ['pattern', 'list']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Show status of learned patterns',
|
||||
examples: [
|
||||
['Show all patterns', '$0 pattern status'],
|
||||
['Show by category', '$0 pattern status --category error_fix'],
|
||||
],
|
||||
});
|
||||
|
||||
category = Option.String('--category,-c', {
|
||||
description: 'Filter by category (error_fix, refactor, workaround, debugging, convention)',
|
||||
});
|
||||
|
||||
json = Option.Boolean('--json,-j', false, {
|
||||
description: 'Output as JSON',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const stats = getPatternStats();
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(stats, null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.cyan('Pattern Statistics\n'));
|
||||
console.log(`Total patterns: ${stats.total}`);
|
||||
console.log();
|
||||
|
||||
console.log(chalk.bold('By Confidence:'));
|
||||
console.log(` High (>70%): ${stats.byConfidenceRange.high}`);
|
||||
console.log(` Medium (40-70%): ${stats.byConfidenceRange.medium}`);
|
||||
console.log(` Low (<40%): ${stats.byConfidenceRange.low}`);
|
||||
console.log();
|
||||
|
||||
if (stats.byDomain.size > 0) {
|
||||
console.log(chalk.bold('By Domain:'));
|
||||
for (const [domain, count] of stats.byDomain) {
|
||||
console.log(` ${domain}: ${count}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (stats.mostUsed) {
|
||||
console.log(chalk.bold('Most Used Pattern:'));
|
||||
console.log(` ${stats.mostUsed.title} (${stats.mostUsed.useCount} uses)`);
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class PatternFeedbackCommand extends Command {
|
||||
static override paths = [['pattern', 'feedback']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Provide feedback on a pattern to evolve its confidence',
|
||||
examples: [
|
||||
['Mark pattern as successful', '$0 pattern feedback <id> --success'],
|
||||
['Mark pattern as failed', '$0 pattern feedback <id> --failure'],
|
||||
],
|
||||
});
|
||||
|
||||
id = Option.String({ required: true });
|
||||
|
||||
success = Option.Boolean('--success,-s', false, {
|
||||
description: 'Pattern was helpful',
|
||||
});
|
||||
|
||||
failure = Option.Boolean('--failure,-f', false, {
|
||||
description: 'Pattern was not helpful',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
if (!this.success && !this.failure) {
|
||||
console.log(chalk.yellow('Please specify --success or --failure'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const result = this.success
|
||||
? recordSuccess(this.id)
|
||||
: recordFailure(this.id);
|
||||
|
||||
if (!result) {
|
||||
console.log(chalk.red(`Pattern not found: ${this.id}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const change = result.change === 'increased' ? chalk.green('↑') : chalk.red('↓');
|
||||
console.log(chalk.green(`✓ Feedback recorded`));
|
||||
console.log(` Confidence: ${(result.previousConfidence * 100).toFixed(0)}% ${change} ${(result.newConfidence * 100).toFixed(0)}%`);
|
||||
console.log(` Total uses: ${result.pattern.useCount}`);
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class PatternApproveCommand extends Command {
|
||||
static override paths = [['pattern', 'approve']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Approve a pending pattern',
|
||||
examples: [['Approve pattern', '$0 pattern approve <id>']],
|
||||
});
|
||||
|
||||
id = Option.String({ required: true });
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const pattern = approvePattern(this.id);
|
||||
|
||||
if (!pattern) {
|
||||
console.log(chalk.red(`Pattern not found: ${this.id}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
console.log(chalk.green(`✓ Approved: ${pattern.title}`));
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class PatternRejectCommand extends Command {
|
||||
static override paths = [['pattern', 'reject']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Reject and remove a pattern',
|
||||
examples: [['Reject pattern', '$0 pattern reject <id>']],
|
||||
});
|
||||
|
||||
id = Option.String({ required: true });
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const removed = rejectPattern(this.id);
|
||||
|
||||
if (!removed) {
|
||||
console.log(chalk.red(`Pattern not found: ${this.id}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
console.log(chalk.green(`✓ Removed pattern: ${this.id}`));
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class PatternExportCommand extends Command {
|
||||
static override paths = [['pattern', 'export']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Export patterns to a file',
|
||||
examples: [
|
||||
['Export as JSON', '$0 pattern export --output patterns.json'],
|
||||
['Export as markdown report', '$0 pattern export --format report'],
|
||||
],
|
||||
});
|
||||
|
||||
output = Option.String('--output,-o', {
|
||||
description: 'Output file path',
|
||||
});
|
||||
|
||||
format = Option.String('--format,-f', {
|
||||
description: 'Format: json or report (default: json)',
|
||||
});
|
||||
|
||||
approvedOnly = Option.Boolean('--approved', false, {
|
||||
description: 'Export only approved patterns',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const patterns = this.approvedOnly ? getApprovedPatterns() : getAllPatterns();
|
||||
|
||||
if (patterns.length === 0) {
|
||||
console.log(chalk.yellow('No patterns to export'));
|
||||
return 0;
|
||||
}
|
||||
|
||||
const format = this.format || 'json';
|
||||
let content: string;
|
||||
|
||||
if (format === 'report') {
|
||||
content = generatePatternReport(patterns);
|
||||
} else {
|
||||
content = exportPatternsAsJson(patterns);
|
||||
}
|
||||
|
||||
if (this.output) {
|
||||
writeFileSync(this.output, content);
|
||||
console.log(chalk.green(`✓ Exported ${patterns.length} patterns to ${this.output}`));
|
||||
} else {
|
||||
console.log(content);
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class PatternImportCommand extends Command {
|
||||
static override paths = [['pattern', 'import']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Import patterns from a file',
|
||||
examples: [['Import patterns', '$0 pattern import patterns.json']],
|
||||
});
|
||||
|
||||
file = Option.String({ required: true });
|
||||
|
||||
async execute(): Promise<number> {
|
||||
if (!existsSync(this.file)) {
|
||||
console.log(chalk.red(`File not found: ${this.file}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const content = readFileSync(this.file, 'utf-8');
|
||||
const patterns = importPatternsFromJson(content);
|
||||
|
||||
if (patterns.length === 0) {
|
||||
console.log(chalk.yellow('No patterns found in file'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
for (const pattern of patterns) {
|
||||
addPattern(pattern);
|
||||
}
|
||||
|
||||
console.log(chalk.green(`✓ Imported ${patterns.length} patterns`));
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class PatternClusterCommand extends Command {
|
||||
static override paths = [['pattern', 'cluster']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Cluster similar patterns and generate skills',
|
||||
examples: [
|
||||
['Cluster patterns', '$0 pattern cluster'],
|
||||
['Cluster and generate skills', '$0 pattern cluster --generate'],
|
||||
],
|
||||
});
|
||||
|
||||
generate = Option.Boolean('--generate,-g', false, {
|
||||
description: 'Generate skills from clusters',
|
||||
});
|
||||
|
||||
minConfidence = Option.String('--min-confidence', {
|
||||
description: 'Minimum confidence for clustering (default: 0.5)',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const patterns = getApprovedPatterns();
|
||||
|
||||
if (patterns.length === 0) {
|
||||
console.log(chalk.yellow('No approved patterns to cluster'));
|
||||
console.log(chalk.dim('Approve patterns first with: skillkit pattern approve <id>'));
|
||||
return 0;
|
||||
}
|
||||
|
||||
const clusters = clusterPatterns(patterns);
|
||||
|
||||
console.log(chalk.cyan(`Pattern Clusters (${clusters.size}):\n`));
|
||||
|
||||
for (const [category, categoryPatterns] of clusters) {
|
||||
console.log(chalk.bold(`${category.replace('_', ' ')} (${categoryPatterns.length}):`));
|
||||
|
||||
for (const pattern of categoryPatterns) {
|
||||
const confidence = chalk.blue(`${(pattern.confidence * 100).toFixed(0)}%`);
|
||||
console.log(` ${chalk.dim('○')} ${pattern.title} ${confidence}`);
|
||||
}
|
||||
console.log();
|
||||
|
||||
if (this.generate && categoryPatterns.length >= 1) {
|
||||
const skill = generateSkillFromPatterns(categoryPatterns, {
|
||||
minConfidence: this.minConfidence ? parseFloat(this.minConfidence) : 0.5,
|
||||
});
|
||||
|
||||
if (skill) {
|
||||
const filepath = saveGeneratedSkill(skill);
|
||||
console.log(chalk.green(` → Generated skill: ${filepath}`));
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
function truncate(str: string, maxLen: number): string {
|
||||
if (str.length <= maxLen) return str;
|
||||
return str.slice(0, maxLen - 3) + '...';
|
||||
}
|
||||
@@ -1,661 +0,0 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import chalk from 'chalk';
|
||||
|
||||
export class MeshCommand extends Command {
|
||||
static override paths = [['mesh']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Manage peer mesh network for multi-machine agent distribution',
|
||||
details: `
|
||||
The mesh command helps you manage a peer-to-peer network of hosts
|
||||
running SkillKit agents across multiple machines.
|
||||
|
||||
Subcommands:
|
||||
- init: Initialize local host for mesh networking
|
||||
- add: Add a peer host to the network
|
||||
- remove: Remove a host from the network
|
||||
- list: List all known hosts and peers
|
||||
- health: Check health of all hosts
|
||||
- discover: Discover hosts on local network
|
||||
- status: Show mesh network status
|
||||
- security: Security management (init, status)
|
||||
- peer: Peer trust management (trust, revoke, list)
|
||||
`,
|
||||
examples: [
|
||||
['Initialize mesh', '$0 mesh init'],
|
||||
['Add a host', '$0 mesh add 192.168.1.100:9876'],
|
||||
['Add with name', '$0 mesh add 192.168.1.100 --name workstation'],
|
||||
['Remove a host', '$0 mesh remove <hostId>'],
|
||||
['List all hosts', '$0 mesh list'],
|
||||
['Check health', '$0 mesh health'],
|
||||
['Discover hosts', '$0 mesh discover'],
|
||||
['Initialize security', '$0 mesh security init'],
|
||||
['Show security status', '$0 mesh security status'],
|
||||
['Trust a peer', '$0 mesh peer trust <fingerprint>'],
|
||||
['Revoke a peer', '$0 mesh peer revoke <fingerprint>'],
|
||||
['List trusted peers', '$0 mesh peer list --trusted'],
|
||||
],
|
||||
});
|
||||
|
||||
action = Option.String({ required: false });
|
||||
arg = Option.String({ required: false });
|
||||
subArg = Option.String({ required: false });
|
||||
name = Option.String('--name,-n', { description: 'Name for the host' });
|
||||
port = Option.String('--port,-p', { description: 'Port number' });
|
||||
tailscale = Option.Boolean('--tailscale,-t', false, { description: 'Include Tailscale peers' });
|
||||
timeout = Option.String('--timeout', { description: 'Timeout in milliseconds' });
|
||||
json = Option.Boolean('--json,-j', false, { description: 'Output in JSON format' });
|
||||
verbose = Option.Boolean('--verbose,-v', false, { description: 'Show detailed output' });
|
||||
trusted = Option.Boolean('--trusted', false, { description: 'Show only trusted peers' });
|
||||
securityLevel = Option.String('--security', { description: 'Security level: development, signed, secure, strict' });
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const action = this.action || 'status';
|
||||
|
||||
switch (action) {
|
||||
case 'init':
|
||||
return this.initMesh();
|
||||
case 'add':
|
||||
return this.addHost();
|
||||
case 'remove':
|
||||
return this.removeHost();
|
||||
case 'list':
|
||||
return this.listHosts();
|
||||
case 'health':
|
||||
return this.checkHealth();
|
||||
case 'discover':
|
||||
return this.discoverHosts();
|
||||
case 'status':
|
||||
return this.showStatus();
|
||||
case 'security':
|
||||
return this.handleSecurity();
|
||||
case 'peer':
|
||||
return this.handlePeer();
|
||||
default:
|
||||
console.error(chalk.red(`Unknown action: ${action}`));
|
||||
console.log(chalk.gray('Available actions: init, add, remove, list, health, discover, status, security, peer'));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async initMesh(): Promise<number> {
|
||||
try {
|
||||
const { initializeHostsFile, getLocalIPAddress, isTailscaleAvailable, getTailscaleIP } = await import('@skillkit/mesh');
|
||||
|
||||
const hostsFile = await initializeHostsFile();
|
||||
const localConfig = hostsFile.localHost;
|
||||
const localIP = getLocalIPAddress();
|
||||
|
||||
console.log(chalk.green('✓ Mesh network initialized\n'));
|
||||
|
||||
console.log(chalk.bold('Local Host Configuration:'));
|
||||
console.log(` ID: ${chalk.cyan(localConfig.id.slice(0, 8))}`);
|
||||
console.log(` Name: ${localConfig.name}`);
|
||||
console.log(` Address: ${localIP}:${localConfig.port}`);
|
||||
|
||||
const hasTailscale = await isTailscaleAvailable();
|
||||
if (hasTailscale) {
|
||||
const tailscaleIP = await getTailscaleIP();
|
||||
if (tailscaleIP) {
|
||||
console.log(` Tailscale: ${tailscaleIP}:${localConfig.port}`);
|
||||
}
|
||||
}
|
||||
|
||||
console.log();
|
||||
console.log(chalk.gray('Other hosts can connect to this machine using:'));
|
||||
console.log(chalk.gray(` skillkit mesh add ${localIP}:${localConfig.port}`));
|
||||
|
||||
return 0;
|
||||
} catch (err: any) {
|
||||
console.error(chalk.red(`Failed to initialize mesh: ${err.message}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async addHost(): Promise<number> {
|
||||
if (!this.arg) {
|
||||
console.error(chalk.red('Error: Host address is required'));
|
||||
console.log(chalk.gray('Usage: skillkit mesh add <address>[:port]'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
try {
|
||||
const { addKnownHost, DEFAULT_PORT } = await import('@skillkit/mesh');
|
||||
const { randomUUID } = await import('node:crypto');
|
||||
|
||||
const [address, portStr] = this.arg.split(':');
|
||||
const portValue = portStr ?? this.port;
|
||||
const port = portValue ? Number(portValue) : DEFAULT_PORT;
|
||||
if (!Number.isInteger(port) || port < 1 || port > 65535) {
|
||||
console.error(chalk.red(`Invalid port: ${portValue}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const host = {
|
||||
id: randomUUID(),
|
||||
name: this.name || address,
|
||||
address,
|
||||
port,
|
||||
status: 'unknown' as const,
|
||||
lastSeen: new Date().toISOString(),
|
||||
};
|
||||
|
||||
await addKnownHost(host);
|
||||
|
||||
console.log(chalk.green(`✓ Added host: ${host.name}`));
|
||||
console.log(` ID: ${chalk.gray(host.id.slice(0, 8))}`);
|
||||
console.log(` Address: ${host.address}:${host.port}`);
|
||||
|
||||
console.log(chalk.gray('\nRun "skillkit mesh health" to verify connectivity.'));
|
||||
|
||||
return 0;
|
||||
} catch (err: any) {
|
||||
console.error(chalk.red(`Failed to add host: ${err.message}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async removeHost(): Promise<number> {
|
||||
if (!this.arg) {
|
||||
console.error(chalk.red('Error: Host ID is required'));
|
||||
console.log(chalk.gray('Usage: skillkit mesh remove <hostId>'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
try {
|
||||
const { removeKnownHost, getKnownHosts } = await import('@skillkit/mesh');
|
||||
|
||||
const hosts = await getKnownHosts();
|
||||
const host = hosts.find(h => h.id === this.arg || h.id.startsWith(this.arg!) || h.name === this.arg);
|
||||
|
||||
if (!host) {
|
||||
console.error(chalk.red(`Host not found: ${this.arg}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const removed = await removeKnownHost(host.id);
|
||||
|
||||
if (removed) {
|
||||
console.log(chalk.green(`✓ Removed host: ${host.name}`));
|
||||
} else {
|
||||
console.error(chalk.red('Failed to remove host'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
return 0;
|
||||
} catch (err: any) {
|
||||
console.error(chalk.red(`Failed to remove host: ${err.message}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async listHosts(): Promise<number> {
|
||||
try {
|
||||
const { getKnownHosts, getLocalHostConfig, getLocalIPAddress, discoverTailscaleHosts, isTailscaleAvailable } = await import('@skillkit/mesh');
|
||||
|
||||
const localConfig = await getLocalHostConfig();
|
||||
const localIP = getLocalIPAddress();
|
||||
const hosts = await getKnownHosts();
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify({ localHost: { ...localConfig, address: localIP }, hosts }, null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.bold('\nLocal Host:\n'));
|
||||
console.log(` ${chalk.cyan('●')} ${localConfig.name} ${chalk.green('[local]')}`);
|
||||
console.log(` ID: ${chalk.gray(localConfig.id.slice(0, 8))}`);
|
||||
console.log(` Address: ${localIP}:${localConfig.port}`);
|
||||
|
||||
console.log(chalk.bold('\nKnown Hosts:\n'));
|
||||
|
||||
if (hosts.length === 0) {
|
||||
console.log(chalk.gray(' No hosts configured.'));
|
||||
console.log(chalk.gray(' Add hosts with: skillkit mesh add <address>'));
|
||||
} else {
|
||||
for (const host of hosts) {
|
||||
const statusIcon = host.status === 'online' ? chalk.green('●') : host.status === 'offline' ? chalk.red('●') : chalk.gray('○');
|
||||
const statusLabel = host.status === 'online' ? chalk.green('[online]') : host.status === 'offline' ? chalk.red('[offline]') : chalk.gray('[unknown]');
|
||||
|
||||
console.log(` ${statusIcon} ${host.name} ${statusLabel}`);
|
||||
console.log(` ID: ${chalk.gray(host.id.slice(0, 8))}`);
|
||||
console.log(` Address: ${host.address}:${host.port}`);
|
||||
if (host.tailscaleIP) {
|
||||
console.log(` Tailscale: ${host.tailscaleIP}`);
|
||||
}
|
||||
if (this.verbose) {
|
||||
console.log(` Last seen: ${new Date(host.lastSeen).toLocaleString()}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if (this.tailscale) {
|
||||
const hasTailscale = await isTailscaleAvailable();
|
||||
if (hasTailscale) {
|
||||
const tailscaleHosts = await discoverTailscaleHosts(localConfig.port);
|
||||
|
||||
if (tailscaleHosts.length > 0) {
|
||||
console.log(chalk.bold('\nTailscale Peers:\n'));
|
||||
for (const host of tailscaleHosts) {
|
||||
console.log(` ${chalk.blue('◆')} ${host.name}`);
|
||||
console.log(` IP: ${host.tailscaleIP}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
console.log();
|
||||
return 0;
|
||||
} catch (err: any) {
|
||||
console.error(chalk.red(`Failed to list hosts: ${err.message}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async checkHealth(): Promise<number> {
|
||||
try {
|
||||
const { checkAllHostsHealth, getKnownHosts } = await import('@skillkit/mesh');
|
||||
|
||||
const hosts = await getKnownHosts();
|
||||
|
||||
if (hosts.length === 0) {
|
||||
console.log(chalk.yellow('No hosts configured.'));
|
||||
console.log(chalk.gray('Add hosts with: skillkit mesh add <address>'));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.bold('\nChecking host health...\n'));
|
||||
|
||||
const timeout = this.timeout ? parseInt(this.timeout, 10) : undefined;
|
||||
const results = await checkAllHostsHealth({ timeout });
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(results, null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
let hasFailures = false;
|
||||
|
||||
for (const result of results) {
|
||||
const host = hosts.find(h => h.id === result.hostId);
|
||||
const name = host?.name || result.hostId.slice(0, 8);
|
||||
|
||||
if (result.status === 'online') {
|
||||
console.log(` ${chalk.green('✓')} ${name} - ${chalk.green('online')} (${result.latencyMs}ms)`);
|
||||
} else {
|
||||
hasFailures = true;
|
||||
console.log(` ${chalk.red('✗')} ${name} - ${chalk.red('offline')} ${result.error ? `(${result.error})` : ''}`);
|
||||
}
|
||||
}
|
||||
|
||||
console.log();
|
||||
|
||||
const online = results.filter(r => r.status === 'online').length;
|
||||
const total = results.length;
|
||||
console.log(`${online}/${total} hosts online`);
|
||||
|
||||
return hasFailures ? 1 : 0;
|
||||
} catch (err: any) {
|
||||
console.error(chalk.red(`Failed to check health: ${err.message}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async discoverHosts(): Promise<number> {
|
||||
try {
|
||||
const { discoverOnce, isTailscaleAvailable, discoverTailscaleHosts, getLocalHostConfig } = await import('@skillkit/mesh');
|
||||
|
||||
console.log(chalk.bold('\nDiscovering hosts on local network...\n'));
|
||||
|
||||
const timeout = this.timeout ? parseInt(this.timeout, 10) : 5000;
|
||||
|
||||
const localHosts = await discoverOnce(timeout);
|
||||
|
||||
if (localHosts.length === 0) {
|
||||
console.log(chalk.gray(' No hosts discovered on local network.'));
|
||||
} else {
|
||||
console.log(chalk.cyan('Local Network:'));
|
||||
for (const host of localHosts) {
|
||||
console.log(` ${chalk.green('●')} ${host.name}`);
|
||||
console.log(` Address: ${host.address}:${host.port}`);
|
||||
}
|
||||
}
|
||||
|
||||
if (this.tailscale) {
|
||||
const hasTailscale = await isTailscaleAvailable();
|
||||
if (hasTailscale) {
|
||||
const localConfig = await getLocalHostConfig();
|
||||
const tailscaleHosts = await discoverTailscaleHosts(localConfig.port);
|
||||
|
||||
if (tailscaleHosts.length > 0) {
|
||||
console.log(chalk.cyan('\nTailscale Network:'));
|
||||
for (const host of tailscaleHosts) {
|
||||
console.log(` ${chalk.blue('◆')} ${host.name}`);
|
||||
console.log(` Tailscale IP: ${host.tailscaleIP}`);
|
||||
}
|
||||
} else {
|
||||
console.log(chalk.gray('\n No Tailscale peers found.'));
|
||||
}
|
||||
} else {
|
||||
console.log(chalk.gray('\n Tailscale not available.'));
|
||||
}
|
||||
}
|
||||
|
||||
console.log();
|
||||
return 0;
|
||||
} catch (err: any) {
|
||||
console.error(chalk.red(`Failed to discover hosts: ${err.message}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async showStatus(): Promise<number> {
|
||||
try {
|
||||
const { getKnownHosts, getLocalHostConfig, getLocalIPAddress, isTailscaleAvailable, getTailscaleIP, getPeerRegistry } = await import('@skillkit/mesh');
|
||||
|
||||
const localConfig = await getLocalHostConfig();
|
||||
const localIP = getLocalIPAddress();
|
||||
const hosts = await getKnownHosts();
|
||||
const registry = await getPeerRegistry();
|
||||
const localPeers = registry.getLocalPeers();
|
||||
|
||||
const onlineHosts = hosts.filter(h => h.status === 'online').length;
|
||||
const hasTailscale = await isTailscaleAvailable();
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify({
|
||||
localHost: { ...localConfig, address: localIP },
|
||||
hosts: hosts.length,
|
||||
onlineHosts,
|
||||
localPeers: localPeers.length,
|
||||
tailscaleAvailable: hasTailscale,
|
||||
}, null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.bold('\nMesh Network Status\n'));
|
||||
|
||||
console.log(chalk.cyan('Local Host:'));
|
||||
console.log(` Name: ${localConfig.name}`);
|
||||
console.log(` ID: ${chalk.gray(localConfig.id.slice(0, 8))}`);
|
||||
console.log(` Address: ${localIP}:${localConfig.port}`);
|
||||
|
||||
if (hasTailscale) {
|
||||
const tailscaleIP = await getTailscaleIP();
|
||||
if (tailscaleIP) {
|
||||
console.log(` Tailscale: ${chalk.blue(tailscaleIP)}`);
|
||||
}
|
||||
}
|
||||
|
||||
console.log();
|
||||
console.log(chalk.cyan('Network:'));
|
||||
console.log(` Known hosts: ${hosts.length}`);
|
||||
console.log(` Online: ${onlineHosts}`);
|
||||
console.log(` Local peers: ${localPeers.length}`);
|
||||
console.log(` Tailscale: ${hasTailscale ? chalk.green('available') : chalk.gray('not available')}`);
|
||||
|
||||
console.log();
|
||||
return 0;
|
||||
} catch (err: any) {
|
||||
console.error(chalk.red(`Failed to get status: ${err.message}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async handleSecurity(): Promise<number> {
|
||||
const subAction = this.arg || 'status';
|
||||
|
||||
switch (subAction) {
|
||||
case 'init':
|
||||
return this.initSecurity();
|
||||
case 'status':
|
||||
return this.showSecurityStatus();
|
||||
default:
|
||||
console.error(chalk.red(`Unknown security action: ${subAction}`));
|
||||
console.log(chalk.gray('Available actions: init, status'));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async initSecurity(): Promise<number> {
|
||||
try {
|
||||
const { SecureKeystore, TLSManager, getLocalHostConfig, describeSecurityLevel, DEFAULT_SECURITY_CONFIG } = await import('@skillkit/mesh');
|
||||
|
||||
console.log(chalk.bold('\nInitializing mesh security...\n'));
|
||||
|
||||
const keystore = new SecureKeystore();
|
||||
const identity = await keystore.loadOrCreateIdentity();
|
||||
|
||||
console.log(chalk.green('✓ Identity created/loaded'));
|
||||
console.log(` Fingerprint: ${chalk.cyan(identity.fingerprint)}`);
|
||||
console.log(` Public Key: ${chalk.gray(identity.publicKeyHex.slice(0, 32))}...`);
|
||||
|
||||
const localConfig = await getLocalHostConfig();
|
||||
const tlsManager = new TLSManager();
|
||||
const certInfo = await tlsManager.loadOrCreateCertificate(localConfig.id, 'localhost');
|
||||
|
||||
console.log(chalk.green('\n✓ TLS certificate generated'));
|
||||
console.log(` Fingerprint: ${chalk.gray(certInfo.fingerprint.slice(0, 16))}...`);
|
||||
console.log(` Valid until: ${certInfo.notAfter.toLocaleDateString()}`);
|
||||
|
||||
console.log(chalk.green('\n✓ Security initialized'));
|
||||
console.log(` Mode: ${chalk.cyan(describeSecurityLevel(DEFAULT_SECURITY_CONFIG))}`);
|
||||
|
||||
console.log(chalk.gray('\nOther hosts can trust this peer using:'));
|
||||
console.log(chalk.gray(` skillkit mesh peer trust ${identity.fingerprint}`));
|
||||
|
||||
console.log();
|
||||
return 0;
|
||||
} catch (err: any) {
|
||||
console.error(chalk.red(`Failed to initialize security: ${err.message}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async showSecurityStatus(): Promise<number> {
|
||||
try {
|
||||
const {
|
||||
SecureKeystore,
|
||||
TLSManager,
|
||||
getLocalHostConfig,
|
||||
describeSecurityLevel,
|
||||
DEFAULT_SECURITY_CONFIG,
|
||||
isSecurityEnabled,
|
||||
} = await import('@skillkit/mesh');
|
||||
|
||||
const keystore = new SecureKeystore();
|
||||
|
||||
console.log(chalk.bold('\nMesh Security Status\n'));
|
||||
|
||||
const hasIdentity = await keystore.hasIdentity();
|
||||
|
||||
if (hasIdentity) {
|
||||
const identity = await keystore.loadOrCreateIdentity();
|
||||
const trustedPeers = await keystore.getTrustedPeers();
|
||||
const revokedPeers = await keystore.getRevokedFingerprints();
|
||||
|
||||
console.log(chalk.cyan('Identity:'));
|
||||
console.log(` Fingerprint: ${chalk.green(identity.fingerprint)}`);
|
||||
console.log(` Public Key: ${chalk.gray(identity.publicKeyHex.slice(0, 32))}...`);
|
||||
|
||||
console.log(chalk.cyan('\nTrust:'));
|
||||
console.log(` Trusted peers: ${trustedPeers.length}`);
|
||||
console.log(` Revoked peers: ${revokedPeers.length}`);
|
||||
|
||||
if (this.verbose && trustedPeers.length > 0) {
|
||||
console.log(chalk.cyan('\nTrusted Peers:'));
|
||||
for (const peer of trustedPeers) {
|
||||
console.log(` ${chalk.green('●')} ${peer.name || peer.fingerprint.slice(0, 16)}`);
|
||||
console.log(` Fingerprint: ${chalk.gray(peer.fingerprint)}`);
|
||||
console.log(` Added: ${new Date(peer.addedAt).toLocaleDateString()}`);
|
||||
}
|
||||
}
|
||||
} else {
|
||||
console.log(chalk.yellow('Identity: Not initialized'));
|
||||
console.log(chalk.gray('Run "skillkit mesh security init" to initialize.'));
|
||||
}
|
||||
|
||||
const localConfig = await getLocalHostConfig();
|
||||
const tlsManager = new TLSManager();
|
||||
const hasCert = await tlsManager.hasCertificate(localConfig.id);
|
||||
|
||||
console.log(chalk.cyan('\nTLS:'));
|
||||
if (hasCert) {
|
||||
const certInfo = await tlsManager.loadCertificate(localConfig.id);
|
||||
console.log(` Certificate: ${chalk.green('Available')}`);
|
||||
if (certInfo) {
|
||||
console.log(` Fingerprint: ${chalk.gray(certInfo.fingerprint.slice(0, 16))}...`);
|
||||
}
|
||||
} else {
|
||||
console.log(` Certificate: ${chalk.yellow('Not generated')}`);
|
||||
}
|
||||
|
||||
console.log(chalk.cyan('\nConfiguration:'));
|
||||
console.log(` Security level: ${chalk.cyan(describeSecurityLevel(DEFAULT_SECURITY_CONFIG))}`);
|
||||
console.log(` Discovery mode: ${DEFAULT_SECURITY_CONFIG.discovery.mode}`);
|
||||
console.log(` Transport encryption: ${DEFAULT_SECURITY_CONFIG.transport.encryption}`);
|
||||
console.log(` Auth required: ${DEFAULT_SECURITY_CONFIG.transport.requireAuth ? chalk.green('yes') : chalk.gray('no')}`);
|
||||
|
||||
if (this.json) {
|
||||
const identity = hasIdentity ? await keystore.loadOrCreateIdentity() : null;
|
||||
console.log(JSON.stringify({
|
||||
hasIdentity,
|
||||
fingerprint: identity?.fingerprint,
|
||||
hasCertificate: hasCert,
|
||||
securityEnabled: isSecurityEnabled(DEFAULT_SECURITY_CONFIG),
|
||||
config: DEFAULT_SECURITY_CONFIG,
|
||||
}, null, 2));
|
||||
}
|
||||
|
||||
console.log();
|
||||
return 0;
|
||||
} catch (err: any) {
|
||||
console.error(chalk.red(`Failed to get security status: ${err.message}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async handlePeer(): Promise<number> {
|
||||
const subAction = this.arg;
|
||||
|
||||
if (!subAction) {
|
||||
console.error(chalk.red('Error: Peer action is required'));
|
||||
console.log(chalk.gray('Usage: skillkit mesh peer <trust|revoke|list> [fingerprint]'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
switch (subAction) {
|
||||
case 'trust':
|
||||
return this.trustPeer();
|
||||
case 'revoke':
|
||||
return this.revokePeer();
|
||||
case 'list':
|
||||
return this.listPeers();
|
||||
default:
|
||||
console.error(chalk.red(`Unknown peer action: ${subAction}`));
|
||||
console.log(chalk.gray('Available actions: trust, revoke, list'));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async trustPeer(): Promise<number> {
|
||||
const fingerprint = this.subArg;
|
||||
|
||||
if (!fingerprint) {
|
||||
console.error(chalk.red('Error: Fingerprint is required'));
|
||||
console.log(chalk.gray('Usage: skillkit mesh peer trust <fingerprint> [--name <name>]'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
try {
|
||||
const { SecureKeystore } = await import('@skillkit/mesh');
|
||||
|
||||
const keystore = new SecureKeystore();
|
||||
|
||||
const isRevoked = await keystore.isRevoked(fingerprint);
|
||||
if (isRevoked) {
|
||||
console.log(chalk.yellow(`Peer ${fingerprint.slice(0, 8)} was previously revoked. Removing from revoked list...`));
|
||||
}
|
||||
|
||||
await keystore.addTrustedPeer(fingerprint, '', this.name);
|
||||
|
||||
console.log(chalk.green(`✓ Trusted peer: ${this.name || fingerprint.slice(0, 16)}`));
|
||||
console.log(` Fingerprint: ${chalk.gray(fingerprint)}`);
|
||||
|
||||
return 0;
|
||||
} catch (err: any) {
|
||||
console.error(chalk.red(`Failed to trust peer: ${err.message}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async revokePeer(): Promise<number> {
|
||||
const fingerprint = this.subArg;
|
||||
|
||||
if (!fingerprint) {
|
||||
console.error(chalk.red('Error: Fingerprint is required'));
|
||||
console.log(chalk.gray('Usage: skillkit mesh peer revoke <fingerprint>'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
try {
|
||||
const { SecureKeystore } = await import('@skillkit/mesh');
|
||||
|
||||
const keystore = new SecureKeystore();
|
||||
await keystore.revokePeer(fingerprint);
|
||||
|
||||
console.log(chalk.green(`✓ Revoked peer: ${fingerprint.slice(0, 16)}`));
|
||||
console.log(chalk.gray('This peer will no longer be trusted for mesh communication.'));
|
||||
|
||||
return 0;
|
||||
} catch (err: any) {
|
||||
console.error(chalk.red(`Failed to revoke peer: ${err.message}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async listPeers(): Promise<number> {
|
||||
try {
|
||||
const { SecureKeystore } = await import('@skillkit/mesh');
|
||||
|
||||
const keystore = new SecureKeystore();
|
||||
const trustedPeers = await keystore.getTrustedPeers();
|
||||
const revokedFingerprints = await keystore.getRevokedFingerprints();
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify({ trusted: trustedPeers, revoked: revokedFingerprints }, null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.bold('\nPeer Trust Status\n'));
|
||||
|
||||
if (this.trusted || trustedPeers.length > 0) {
|
||||
console.log(chalk.cyan('Trusted Peers:'));
|
||||
if (trustedPeers.length === 0) {
|
||||
console.log(chalk.gray(' No trusted peers.'));
|
||||
} else {
|
||||
for (const peer of trustedPeers) {
|
||||
console.log(` ${chalk.green('●')} ${peer.name || 'Unknown'}`);
|
||||
console.log(` Fingerprint: ${chalk.gray(peer.fingerprint)}`);
|
||||
console.log(` Added: ${new Date(peer.addedAt).toLocaleDateString()}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if (!this.trusted && revokedFingerprints.length > 0) {
|
||||
console.log(chalk.cyan('\nRevoked Peers:'));
|
||||
for (const fp of revokedFingerprints) {
|
||||
console.log(` ${chalk.red('●')} ${chalk.gray(fp)}`);
|
||||
}
|
||||
}
|
||||
|
||||
console.log(chalk.gray(`\nTotal: ${trustedPeers.length} trusted, ${revokedFingerprints.length} revoked`));
|
||||
console.log();
|
||||
|
||||
return 0;
|
||||
} catch (err: any) {
|
||||
console.error(chalk.red(`Failed to list peers: ${err.message}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -1,519 +0,0 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import chalk from 'chalk';
|
||||
|
||||
export class MessageCommand extends Command {
|
||||
static override paths = [['message'], ['msg']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Inter-agent messaging system',
|
||||
details: `
|
||||
The message command enables communication between AI agents
|
||||
across the mesh network.
|
||||
|
||||
Subcommands:
|
||||
- send: Send a message to an agent
|
||||
- inbox: View inbox messages
|
||||
- read: Read a specific message
|
||||
- reply: Reply to a message
|
||||
- archive: Archive a message
|
||||
- forward: Forward a message
|
||||
- sent: View sent messages
|
||||
- status: Show messaging status
|
||||
`,
|
||||
examples: [
|
||||
['Send a message', '$0 message send backend-agent --body "API ready"'],
|
||||
['Send with priority', '$0 message send agent --body "Urgent!" --priority high'],
|
||||
['View inbox', '$0 message inbox'],
|
||||
['View unread', '$0 message inbox --unread'],
|
||||
['Read a message', '$0 message read <id>'],
|
||||
['Reply to message', '$0 message reply <id> --body "Thanks!"'],
|
||||
['Archive a message', '$0 message archive <id>'],
|
||||
['Forward a message', '$0 message forward <id> other-agent'],
|
||||
],
|
||||
});
|
||||
|
||||
action = Option.String({ required: false });
|
||||
arg = Option.String({ required: false });
|
||||
arg2 = Option.String({ required: false });
|
||||
body = Option.String('--body,-b', { description: 'Message body' });
|
||||
subject = Option.String('--subject,-s', { description: 'Message subject' });
|
||||
priority = Option.String('--priority,-p', { description: 'Priority: low, normal, high, urgent' });
|
||||
type = Option.String('--type,-t', { description: 'Type: request, response, notification, update' });
|
||||
unread = Option.Boolean('--unread,-u', false, { description: 'Show only unread messages' });
|
||||
limit = Option.String('--limit,-l', { description: 'Maximum number of results' });
|
||||
agent = Option.String('--agent,-a', { description: 'Agent ID (defaults to current agent)' });
|
||||
json = Option.Boolean('--json,-j', false, { description: 'Output in JSON format' });
|
||||
verbose = Option.Boolean('--verbose,-v', false, { description: 'Show detailed output' });
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const action = this.action || 'inbox';
|
||||
|
||||
switch (action) {
|
||||
case 'send':
|
||||
return this.sendMessage();
|
||||
case 'inbox':
|
||||
return this.showInbox();
|
||||
case 'read':
|
||||
return this.readMessage();
|
||||
case 'reply':
|
||||
return this.replyMessage();
|
||||
case 'archive':
|
||||
return this.archiveMessage();
|
||||
case 'forward':
|
||||
return this.forwardMessage();
|
||||
case 'sent':
|
||||
return this.showSent();
|
||||
case 'status':
|
||||
return this.showStatus();
|
||||
default:
|
||||
console.error(chalk.red(`Unknown action: ${action}`));
|
||||
console.log(chalk.gray('Available actions: send, inbox, read, reply, archive, forward, sent, status'));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private getAgentId(): string {
|
||||
return this.agent || process.env.SKILLKIT_AGENT_ID || 'default-agent';
|
||||
}
|
||||
|
||||
private async sendMessage(): Promise<number> {
|
||||
const to = this.arg;
|
||||
if (!to) {
|
||||
console.error(chalk.red('Error: Recipient is required'));
|
||||
console.log(chalk.gray('Usage: skillkit message send <to> --body "..."'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
if (!this.body) {
|
||||
console.error(chalk.red('Error: Message body is required'));
|
||||
console.log(chalk.gray('Usage: skillkit message send <to> --body "..."'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
try {
|
||||
const { createMessagingService } = await import('@skillkit/messaging');
|
||||
|
||||
const agentId = this.getAgentId();
|
||||
const service = await createMessagingService(agentId);
|
||||
|
||||
const result = await service.send({
|
||||
to,
|
||||
subject: this.subject || 'Message from SkillKit',
|
||||
body: this.body,
|
||||
priority: (this.priority as any) || 'normal',
|
||||
type: (this.type as any) || 'notification',
|
||||
});
|
||||
|
||||
if (result.delivered) {
|
||||
console.log(chalk.green(`✓ Message sent to ${to}`));
|
||||
console.log(` ID: ${chalk.gray(result.messageId.slice(0, 8))}`);
|
||||
console.log(` Via: ${result.via}`);
|
||||
} else {
|
||||
console.error(chalk.red(`✗ Failed to deliver message`));
|
||||
if (result.error) {
|
||||
console.error(chalk.gray(` Error: ${result.error}`));
|
||||
}
|
||||
return 1;
|
||||
}
|
||||
|
||||
return 0;
|
||||
} catch (err: any) {
|
||||
console.error(chalk.red(`Failed to send message: ${err.message}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async showInbox(): Promise<number> {
|
||||
try {
|
||||
const { createMessagingService } = await import('@skillkit/messaging');
|
||||
|
||||
const agentId = this.getAgentId();
|
||||
const service = await createMessagingService(agentId);
|
||||
|
||||
const filter: any = {};
|
||||
if (this.unread) {
|
||||
filter.status = 'unread';
|
||||
}
|
||||
if (this.limit) {
|
||||
filter.limit = parseInt(this.limit, 10);
|
||||
}
|
||||
|
||||
const messages = await service.getInbox(filter);
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(messages, null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
const summary = await service.getInboxSummary();
|
||||
|
||||
console.log(chalk.bold(`\nInbox (${summary.unread} unread / ${summary.total} total)\n`));
|
||||
|
||||
if (messages.length === 0) {
|
||||
console.log(chalk.gray(' No messages.'));
|
||||
return 0;
|
||||
}
|
||||
|
||||
for (const message of messages) {
|
||||
const isUnread = message.status === 'unread';
|
||||
const priorityIcon = this.getPriorityIcon(message.priority);
|
||||
const statusIcon = isUnread ? chalk.cyan('●') : chalk.gray('○');
|
||||
|
||||
console.log(`${statusIcon} ${priorityIcon} ${isUnread ? chalk.bold(message.subject) : message.subject}`);
|
||||
console.log(` ID: ${chalk.gray(message.id.slice(0, 8))} | From: ${message.from} | ${this.formatDate(message.createdAt)}`);
|
||||
|
||||
if (this.verbose) {
|
||||
const bodyPreview = typeof message.body === 'string'
|
||||
? message.body.slice(0, 80)
|
||||
: JSON.stringify(message.body).slice(0, 80);
|
||||
console.log(` ${chalk.gray(bodyPreview)}${bodyPreview.length >= 80 ? '...' : ''}`);
|
||||
}
|
||||
}
|
||||
|
||||
console.log();
|
||||
return 0;
|
||||
} catch (err: any) {
|
||||
console.error(chalk.red(`Failed to show inbox: ${err.message}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async readMessage(): Promise<number> {
|
||||
const id = this.arg;
|
||||
if (!id) {
|
||||
console.error(chalk.red('Error: Message ID is required'));
|
||||
console.log(chalk.gray('Usage: skillkit message read <id>'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
try {
|
||||
const { createMessagingService } = await import('@skillkit/messaging');
|
||||
|
||||
const agentId = this.getAgentId();
|
||||
const service = await createMessagingService(agentId);
|
||||
|
||||
const message = await service.markAsRead(id);
|
||||
|
||||
if (!message) {
|
||||
const messages = await service.getInbox();
|
||||
const found = messages.find(m => m.id.startsWith(id));
|
||||
|
||||
if (found) {
|
||||
const marked = await service.markAsRead(found.id);
|
||||
if (marked) {
|
||||
return this.displayMessage(marked);
|
||||
}
|
||||
}
|
||||
|
||||
console.error(chalk.red(`Message not found: ${id}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
return this.displayMessage(message);
|
||||
} catch (err: any) {
|
||||
console.error(chalk.red(`Failed to read message: ${err.message}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private displayMessage(message: any): number {
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(message, null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.bold(`\n${message.subject}\n`));
|
||||
console.log(`From: ${message.from}`);
|
||||
console.log(`To: ${message.to}`);
|
||||
console.log(`Date: ${new Date(message.createdAt).toLocaleString()}`);
|
||||
console.log(`Priority: ${message.priority}`);
|
||||
console.log(`Type: ${message.type}`);
|
||||
console.log(`ID: ${chalk.gray(message.id)}`);
|
||||
|
||||
if (message.replyTo) {
|
||||
console.log(`Reply to: ${chalk.gray(message.replyTo)}`);
|
||||
}
|
||||
if (message.threadId) {
|
||||
console.log(`Thread: ${chalk.gray(message.threadId)}`);
|
||||
}
|
||||
|
||||
console.log(chalk.bold('\nBody:\n'));
|
||||
if (typeof message.body === 'string') {
|
||||
console.log(message.body);
|
||||
} else {
|
||||
console.log(JSON.stringify(message.body, null, 2));
|
||||
}
|
||||
|
||||
console.log();
|
||||
return 0;
|
||||
}
|
||||
|
||||
private async replyMessage(): Promise<number> {
|
||||
const id = this.arg;
|
||||
if (!id) {
|
||||
console.error(chalk.red('Error: Message ID is required'));
|
||||
console.log(chalk.gray('Usage: skillkit message reply <id> --body "..."'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
if (!this.body) {
|
||||
console.error(chalk.red('Error: Reply body is required'));
|
||||
console.log(chalk.gray('Usage: skillkit message reply <id> --body "..."'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
try {
|
||||
const { createMessagingService } = await import('@skillkit/messaging');
|
||||
|
||||
const agentId = this.getAgentId();
|
||||
const service = await createMessagingService(agentId);
|
||||
|
||||
let messageId = id;
|
||||
const message = await service.getMessage(id);
|
||||
if (!message) {
|
||||
const messages = await service.getInbox();
|
||||
const found = messages.find(m => m.id.startsWith(id));
|
||||
if (found) {
|
||||
messageId = found.id;
|
||||
} else {
|
||||
console.error(chalk.red(`Message not found: ${id}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
const result = await service.reply(messageId, this.body);
|
||||
|
||||
if (result.delivered) {
|
||||
console.log(chalk.green('✓ Reply sent'));
|
||||
console.log(` ID: ${chalk.gray(result.messageId.slice(0, 8))}`);
|
||||
} else {
|
||||
console.error(chalk.red('✗ Failed to send reply'));
|
||||
if (result.error) {
|
||||
console.error(chalk.gray(` Error: ${result.error}`));
|
||||
}
|
||||
return 1;
|
||||
}
|
||||
|
||||
return 0;
|
||||
} catch (err: any) {
|
||||
console.error(chalk.red(`Failed to reply: ${err.message}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async archiveMessage(): Promise<number> {
|
||||
const id = this.arg;
|
||||
if (!id) {
|
||||
console.error(chalk.red('Error: Message ID is required'));
|
||||
console.log(chalk.gray('Usage: skillkit message archive <id>'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
try {
|
||||
const { createMessagingService } = await import('@skillkit/messaging');
|
||||
|
||||
const agentId = this.getAgentId();
|
||||
const service = await createMessagingService(agentId);
|
||||
|
||||
let messageId = id;
|
||||
const message = await service.getMessage(id);
|
||||
if (!message) {
|
||||
const messages = await service.getInbox();
|
||||
const found = messages.find(m => m.id.startsWith(id));
|
||||
if (found) {
|
||||
messageId = found.id;
|
||||
} else {
|
||||
console.error(chalk.red(`Message not found: ${id}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
const archived = await service.archive(messageId);
|
||||
|
||||
if (archived) {
|
||||
console.log(chalk.green('✓ Message archived'));
|
||||
} else {
|
||||
console.error(chalk.red('✗ Failed to archive message'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
return 0;
|
||||
} catch (err: any) {
|
||||
console.error(chalk.red(`Failed to archive: ${err.message}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async forwardMessage(): Promise<number> {
|
||||
const id = this.arg;
|
||||
const to = this.arg2;
|
||||
|
||||
if (!id) {
|
||||
console.error(chalk.red('Error: Message ID is required'));
|
||||
console.log(chalk.gray('Usage: skillkit message forward <id> <to>'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
if (!to) {
|
||||
console.error(chalk.red('Error: Recipient is required'));
|
||||
console.log(chalk.gray('Usage: skillkit message forward <id> <to>'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
try {
|
||||
const { createMessagingService } = await import('@skillkit/messaging');
|
||||
|
||||
const agentId = this.getAgentId();
|
||||
const service = await createMessagingService(agentId);
|
||||
|
||||
let messageId = id;
|
||||
const message = await service.getMessage(id);
|
||||
if (!message) {
|
||||
const messages = await service.getInbox();
|
||||
const found = messages.find(m => m.id.startsWith(id));
|
||||
if (found) {
|
||||
messageId = found.id;
|
||||
} else {
|
||||
console.error(chalk.red(`Message not found: ${id}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
const result = await service.forward(messageId, to, this.body);
|
||||
|
||||
if (result.delivered) {
|
||||
console.log(chalk.green(`✓ Message forwarded to ${to}`));
|
||||
console.log(` ID: ${chalk.gray(result.messageId.slice(0, 8))}`);
|
||||
} else {
|
||||
console.error(chalk.red('✗ Failed to forward message'));
|
||||
if (result.error) {
|
||||
console.error(chalk.gray(` Error: ${result.error}`));
|
||||
}
|
||||
return 1;
|
||||
}
|
||||
|
||||
return 0;
|
||||
} catch (err: any) {
|
||||
console.error(chalk.red(`Failed to forward: ${err.message}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async showSent(): Promise<number> {
|
||||
try {
|
||||
const { createMessagingService } = await import('@skillkit/messaging');
|
||||
|
||||
const agentId = this.getAgentId();
|
||||
const service = await createMessagingService(agentId);
|
||||
|
||||
const filter: any = {};
|
||||
if (this.limit) {
|
||||
filter.limit = parseInt(this.limit, 10);
|
||||
}
|
||||
|
||||
const messages = await service.getSent(filter);
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(messages, null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.bold(`\nSent Messages (${messages.length})\n`));
|
||||
|
||||
if (messages.length === 0) {
|
||||
console.log(chalk.gray(' No sent messages.'));
|
||||
return 0;
|
||||
}
|
||||
|
||||
for (const message of messages) {
|
||||
const priorityIcon = this.getPriorityIcon(message.priority);
|
||||
|
||||
console.log(`${chalk.gray('○')} ${priorityIcon} ${message.subject}`);
|
||||
console.log(` ID: ${chalk.gray(message.id.slice(0, 8))} | To: ${message.to} | ${this.formatDate(message.createdAt)}`);
|
||||
}
|
||||
|
||||
console.log();
|
||||
return 0;
|
||||
} catch (err: any) {
|
||||
console.error(chalk.red(`Failed to show sent: ${err.message}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async showStatus(): Promise<number> {
|
||||
try {
|
||||
const { createMessagingService } = await import('@skillkit/messaging');
|
||||
|
||||
const agentId = this.getAgentId();
|
||||
const service = await createMessagingService(agentId);
|
||||
|
||||
const summary = await service.getInboxSummary();
|
||||
const sent = await service.getSent({ limit: 1000 });
|
||||
const archived = await service.getArchived({ limit: 1000 });
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify({
|
||||
agentId,
|
||||
inbox: summary,
|
||||
sentCount: sent.length,
|
||||
archivedCount: archived.length,
|
||||
}, null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.bold('\nMessaging Status\n'));
|
||||
|
||||
console.log(chalk.cyan('Agent:'));
|
||||
console.log(` ID: ${agentId}`);
|
||||
|
||||
console.log();
|
||||
console.log(chalk.cyan('Inbox:'));
|
||||
console.log(` Total: ${summary.total}`);
|
||||
console.log(` Unread: ${summary.unread}`);
|
||||
console.log(` By priority: urgent=${summary.byPriority.urgent}, high=${summary.byPriority.high}, normal=${summary.byPriority.normal}, low=${summary.byPriority.low}`);
|
||||
|
||||
console.log();
|
||||
console.log(chalk.cyan('Storage:'));
|
||||
console.log(` Sent: ${sent.length}`);
|
||||
console.log(` Archived: ${archived.length}`);
|
||||
|
||||
console.log();
|
||||
return 0;
|
||||
} catch (err: any) {
|
||||
console.error(chalk.red(`Failed to get status: ${err.message}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private getPriorityIcon(priority: string): string {
|
||||
switch (priority) {
|
||||
case 'urgent':
|
||||
return chalk.red('!!!!');
|
||||
case 'high':
|
||||
return chalk.yellow('!!!');
|
||||
case 'normal':
|
||||
return chalk.gray('!');
|
||||
case 'low':
|
||||
return chalk.gray('·');
|
||||
default:
|
||||
return '';
|
||||
}
|
||||
}
|
||||
|
||||
private formatDate(dateStr: string): string {
|
||||
const date = new Date(dateStr);
|
||||
const now = new Date();
|
||||
const diffMs = now.getTime() - date.getTime();
|
||||
const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
|
||||
|
||||
if (diffDays === 0) {
|
||||
return date.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
|
||||
} else if (diffDays === 1) {
|
||||
return 'Yesterday';
|
||||
} else if (diffDays < 7) {
|
||||
return `${diffDays} days ago`;
|
||||
} else {
|
||||
return date.toLocaleDateString();
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -1,424 +0,0 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { resolve } from 'node:path';
|
||||
import chalk from 'chalk';
|
||||
import {
|
||||
type AgentType,
|
||||
AgentType as AgentTypeSchema,
|
||||
generatePrimer,
|
||||
analyzePrimer,
|
||||
analyzeGitHistory,
|
||||
addPattern,
|
||||
AGENT_CONFIG,
|
||||
} from '@skillkit/core';
|
||||
|
||||
export class PrimerCommand extends Command {
|
||||
static override paths = [['primer']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Analyze codebase and generate AI instruction files for agents',
|
||||
details: `
|
||||
The primer command analyzes your codebase to detect languages, frameworks,
|
||||
patterns, and conventions, then generates customized instruction files
|
||||
for AI coding agents.
|
||||
|
||||
By default, it generates instructions for detected agents in your project.
|
||||
Use --all-agents to generate for all 32 supported agents.
|
||||
|
||||
Inspired by github.com/pierceboggan/primer but extended for all SkillKit agents.
|
||||
`,
|
||||
examples: [
|
||||
['Generate for detected agents', '$0 primer'],
|
||||
['Generate for all 32 agents', '$0 primer --all-agents'],
|
||||
['Generate for specific agents', '$0 primer --agent claude-code,cursor,github-copilot'],
|
||||
['Custom output directory', '$0 primer --output ./instructions'],
|
||||
['Preview without writing files', '$0 primer --dry-run'],
|
||||
['Only show analysis', '$0 primer --analyze-only'],
|
||||
['Verbose output', '$0 primer --verbose'],
|
||||
],
|
||||
});
|
||||
|
||||
agent = Option.String('--agent,-a', {
|
||||
description: 'Comma-separated list of agents to generate for',
|
||||
});
|
||||
|
||||
allAgents = Option.Boolean('--all-agents,-A', false, {
|
||||
description: 'Generate for all 32 supported agents',
|
||||
});
|
||||
|
||||
output = Option.String('--output,-o', {
|
||||
description: 'Output directory for generated files',
|
||||
});
|
||||
|
||||
dryRun = Option.Boolean('--dry-run,-n', false, {
|
||||
description: 'Preview what would be generated without writing files',
|
||||
});
|
||||
|
||||
analyzeOnly = Option.Boolean('--analyze-only', false, {
|
||||
description: 'Only show codebase analysis, do not generate files',
|
||||
});
|
||||
|
||||
verbose = Option.Boolean('--verbose,-v', false, {
|
||||
description: 'Show detailed output',
|
||||
});
|
||||
|
||||
includeExamples = Option.Boolean('--examples', false, {
|
||||
description: 'Include code examples in generated instructions',
|
||||
});
|
||||
|
||||
json = Option.Boolean('--json,-j', false, {
|
||||
description: 'Output analysis in JSON format',
|
||||
});
|
||||
|
||||
directory = Option.String('--dir,-d', {
|
||||
description: 'Project directory to analyze (default: current directory)',
|
||||
});
|
||||
|
||||
learn = Option.Boolean('--learn,-l', false, {
|
||||
description: 'Extract learnable patterns from git history',
|
||||
});
|
||||
|
||||
commits = Option.String('--commits', {
|
||||
description: 'Number of commits to analyze for learning (default: 100)',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const projectPath = resolve(this.directory || process.cwd());
|
||||
|
||||
if (this.analyzeOnly) {
|
||||
return this.runAnalysis(projectPath);
|
||||
}
|
||||
|
||||
if (this.learn) {
|
||||
return this.runLearn(projectPath);
|
||||
}
|
||||
|
||||
return this.runGenerate(projectPath);
|
||||
}
|
||||
|
||||
private async runLearn(projectPath: string): Promise<number> {
|
||||
console.log(chalk.cyan('Analyzing codebase and extracting patterns...\n'));
|
||||
|
||||
const analysis = analyzePrimer(projectPath);
|
||||
if (this.verbose) {
|
||||
this.printAnalysis(analysis);
|
||||
console.log();
|
||||
}
|
||||
|
||||
console.log(chalk.bold('Analyzing git history for patterns...\n'));
|
||||
|
||||
const gitResult = analyzeGitHistory(projectPath, {
|
||||
commits: this.commits ? parseInt(this.commits) : 100,
|
||||
});
|
||||
|
||||
console.log(` Commits analyzed: ${gitResult.commitCount}`);
|
||||
console.log(` Languages: ${gitResult.languages.join(', ') || 'N/A'}`);
|
||||
console.log(` Frameworks: ${gitResult.frameworks.join(', ') || 'N/A'}`);
|
||||
console.log();
|
||||
|
||||
if (gitResult.patterns.length === 0) {
|
||||
console.log(chalk.yellow('No learnable patterns found.'));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.bold(`Extracted ${gitResult.patterns.length} patterns:\n`));
|
||||
|
||||
for (const pattern of gitResult.patterns.slice(0, 10)) {
|
||||
const confidence = chalk.blue(`${(pattern.confidence * 100).toFixed(0)}%`);
|
||||
console.log(` ${chalk.dim('○')} ${pattern.title} [${pattern.category}] ${confidence}`);
|
||||
addPattern(pattern);
|
||||
}
|
||||
|
||||
if (gitResult.patterns.length > 10) {
|
||||
console.log(chalk.dim(` ... and ${gitResult.patterns.length - 10} more saved`));
|
||||
for (const pattern of gitResult.patterns.slice(10)) {
|
||||
addPattern(pattern);
|
||||
}
|
||||
}
|
||||
|
||||
console.log();
|
||||
console.log(chalk.green(`✓ Saved ${gitResult.patterns.length} patterns`));
|
||||
console.log(chalk.dim('View with: skillkit learn --show'));
|
||||
console.log(chalk.dim('Approve with: skillkit pattern approve <id>'));
|
||||
|
||||
return 0;
|
||||
}
|
||||
|
||||
private async runAnalysis(projectPath: string): Promise<number> {
|
||||
console.log(chalk.cyan('Analyzing codebase...\n'));
|
||||
|
||||
try {
|
||||
const analysis = analyzePrimer(projectPath);
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(analysis, null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
this.printAnalysis(analysis);
|
||||
return 0;
|
||||
} catch (error) {
|
||||
console.error(chalk.red('Analysis failed:'), error instanceof Error ? error.message : error);
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async runGenerate(projectPath: string): Promise<number> {
|
||||
const agents = this.parseAgents();
|
||||
|
||||
console.log(chalk.cyan('Analyzing codebase and generating AI instructions...\n'));
|
||||
|
||||
try {
|
||||
const result = generatePrimer(projectPath, {
|
||||
agents,
|
||||
allAgents: this.allAgents,
|
||||
outputDir: this.output ? resolve(this.output) : undefined,
|
||||
dryRun: this.dryRun,
|
||||
verbose: this.verbose,
|
||||
includeExamples: this.includeExamples,
|
||||
});
|
||||
|
||||
if (this.verbose) {
|
||||
this.printAnalysis(result.analysis);
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (result.generated.length === 0) {
|
||||
console.log(chalk.yellow('No instruction files generated.'));
|
||||
if (result.errors.length > 0) {
|
||||
for (const error of result.errors) {
|
||||
console.log(chalk.red(` Error: ${error}`));
|
||||
}
|
||||
}
|
||||
return 1;
|
||||
}
|
||||
|
||||
console.log(chalk.bold('Generated Instruction Files:\n'));
|
||||
|
||||
for (const instruction of result.generated) {
|
||||
const status = this.dryRun ? chalk.yellow('(dry-run)') : chalk.green('created');
|
||||
console.log(` ${chalk.green('●')} ${chalk.bold(instruction.agent)}`);
|
||||
console.log(` ${chalk.gray(instruction.filepath)} ${status}`);
|
||||
}
|
||||
|
||||
console.log();
|
||||
|
||||
if (result.warnings.length > 0) {
|
||||
console.log(chalk.yellow('Warnings:'));
|
||||
for (const warning of result.warnings) {
|
||||
console.log(` ${chalk.yellow('⚠')} ${warning}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (result.errors.length > 0) {
|
||||
console.log(chalk.red('Errors:'));
|
||||
for (const error of result.errors) {
|
||||
console.log(` ${chalk.red('✗')} ${error}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
const summary = this.dryRun
|
||||
? `Would generate ${result.generated.length} instruction file(s)`
|
||||
: `Generated ${result.generated.length} instruction file(s)`;
|
||||
|
||||
console.log(chalk.bold(summary));
|
||||
|
||||
if (this.dryRun) {
|
||||
console.log(chalk.gray('\n(Dry run - no files were written)'));
|
||||
}
|
||||
|
||||
return result.success ? 0 : 1;
|
||||
} catch (error) {
|
||||
console.error(chalk.red('Generation failed:'), error instanceof Error ? error.message : error);
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private parseAgents(): AgentType[] | undefined {
|
||||
if (!this.agent) return undefined;
|
||||
|
||||
const agents: AgentType[] = [];
|
||||
const parts = this.agent.split(',').map(s => s.trim());
|
||||
|
||||
for (const part of parts) {
|
||||
const result = AgentTypeSchema.safeParse(part);
|
||||
if (result.success) {
|
||||
agents.push(result.data);
|
||||
} else {
|
||||
console.warn(chalk.yellow(`Unknown agent: ${part}`));
|
||||
}
|
||||
}
|
||||
|
||||
return agents.length > 0 ? agents : undefined;
|
||||
}
|
||||
|
||||
private printAnalysis(analysis: ReturnType<typeof analyzePrimer>): void {
|
||||
const { project, languages, packageManagers, stack, structure, conventions, ci, docker, buildCommands, importantFiles } = analysis;
|
||||
|
||||
console.log(chalk.bold('Project Information'));
|
||||
console.log(` Name: ${chalk.cyan(project.name)}`);
|
||||
if (project.description) {
|
||||
console.log(` Description: ${project.description}`);
|
||||
}
|
||||
if (project.type) {
|
||||
console.log(` Type: ${project.type}`);
|
||||
}
|
||||
if (project.version) {
|
||||
console.log(` Version: ${project.version}`);
|
||||
}
|
||||
console.log();
|
||||
|
||||
if (languages.length > 0) {
|
||||
console.log(chalk.bold('Languages'));
|
||||
for (const lang of languages) {
|
||||
const version = lang.version ? ` (${lang.version})` : '';
|
||||
console.log(` ${chalk.green('●')} ${lang.name}${version}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (packageManagers.length > 0) {
|
||||
console.log(chalk.bold('Package Managers'));
|
||||
console.log(` ${chalk.cyan(packageManagers.join(', '))}`);
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (stack.frameworks.length > 0) {
|
||||
console.log(chalk.bold('Frameworks'));
|
||||
for (const fw of stack.frameworks) {
|
||||
const version = fw.version ? ` (${fw.version})` : '';
|
||||
console.log(` ${chalk.green('●')} ${fw.name}${version}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (stack.libraries.length > 0) {
|
||||
console.log(chalk.bold('Libraries'));
|
||||
for (const lib of stack.libraries.slice(0, 10)) {
|
||||
const version = lib.version ? ` (${lib.version})` : '';
|
||||
console.log(` ${chalk.green('●')} ${lib.name}${version}`);
|
||||
}
|
||||
if (stack.libraries.length > 10) {
|
||||
console.log(` ${chalk.gray(`...and ${stack.libraries.length - 10} more`)}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (stack.styling.length > 0) {
|
||||
console.log(chalk.bold('Styling'));
|
||||
for (const style of stack.styling) {
|
||||
console.log(` ${chalk.green('●')} ${style.name}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (stack.testing.length > 0) {
|
||||
console.log(chalk.bold('Testing'));
|
||||
for (const test of stack.testing) {
|
||||
console.log(` ${chalk.green('●')} ${test.name}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (stack.databases.length > 0) {
|
||||
console.log(chalk.bold('Databases'));
|
||||
for (const db of stack.databases) {
|
||||
console.log(` ${chalk.green('●')} ${db.name}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (structure) {
|
||||
console.log(chalk.bold('Project Structure'));
|
||||
if (structure.type) {
|
||||
console.log(` Type: ${structure.type}`);
|
||||
}
|
||||
if (structure.srcDir) {
|
||||
console.log(` Source: ${structure.srcDir}/`);
|
||||
}
|
||||
if (structure.testDir) {
|
||||
console.log(` Tests: ${structure.testDir}/`);
|
||||
}
|
||||
if (structure.hasWorkspaces) {
|
||||
console.log(` Monorepo: Yes`);
|
||||
if (structure.workspaces) {
|
||||
console.log(` Workspaces: ${structure.workspaces.join(', ')}`);
|
||||
}
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (conventions && Object.keys(conventions).some(k => conventions[k as keyof typeof conventions] !== undefined)) {
|
||||
console.log(chalk.bold('Code Conventions'));
|
||||
if (conventions.indentation) {
|
||||
console.log(` Indentation: ${conventions.indentation}`);
|
||||
}
|
||||
if (conventions.quotes) {
|
||||
console.log(` Quotes: ${conventions.quotes}`);
|
||||
}
|
||||
if (conventions.semicolons !== undefined) {
|
||||
console.log(` Semicolons: ${conventions.semicolons ? 'yes' : 'no'}`);
|
||||
}
|
||||
if (conventions.trailingCommas) {
|
||||
console.log(` Trailing Commas: ${conventions.trailingCommas}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (ci && ci.hasCI) {
|
||||
console.log(chalk.bold('CI/CD'));
|
||||
console.log(` Provider: ${ci.provider}`);
|
||||
if (ci.hasCD) {
|
||||
console.log(` Deployment: Yes`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (docker && (docker.hasDockerfile || docker.hasCompose)) {
|
||||
console.log(chalk.bold('Docker'));
|
||||
if (docker.hasDockerfile) {
|
||||
console.log(` Dockerfile: Yes`);
|
||||
if (docker.baseImage) {
|
||||
console.log(` Base Image: ${docker.baseImage}`);
|
||||
}
|
||||
}
|
||||
if (docker.hasCompose) {
|
||||
console.log(` Docker Compose: Yes`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (buildCommands && Object.keys(buildCommands).some(k => buildCommands[k as keyof typeof buildCommands])) {
|
||||
console.log(chalk.bold('Build Commands'));
|
||||
if (buildCommands.install) {
|
||||
console.log(` Install: ${chalk.gray(buildCommands.install)}`);
|
||||
}
|
||||
if (buildCommands.dev) {
|
||||
console.log(` Dev: ${chalk.gray(buildCommands.dev)}`);
|
||||
}
|
||||
if (buildCommands.build) {
|
||||
console.log(` Build: ${chalk.gray(buildCommands.build)}`);
|
||||
}
|
||||
if (buildCommands.test) {
|
||||
console.log(` Test: ${chalk.gray(buildCommands.test)}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (importantFiles.length > 0 && this.verbose) {
|
||||
console.log(chalk.bold('Important Files'));
|
||||
for (const file of importantFiles.slice(0, 15)) {
|
||||
console.log(` ${chalk.gray(file)}`);
|
||||
}
|
||||
if (importantFiles.length > 15) {
|
||||
console.log(` ${chalk.gray(`...and ${importantFiles.length - 15} more`)}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
console.log(chalk.bold('Available Agents'));
|
||||
console.log(chalk.gray(` Use --all-agents to generate for all ${Object.keys(AGENT_CONFIG).length} agents`));
|
||||
console.log(chalk.gray(` Use --agent <name> to generate for specific agents`));
|
||||
}
|
||||
}
|
||||
@@ -1,200 +0,0 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import chalk from 'chalk';
|
||||
import {
|
||||
getActiveProfile,
|
||||
setActiveProfile,
|
||||
getProfile,
|
||||
getAllProfiles,
|
||||
addCustomProfile,
|
||||
removeCustomProfile,
|
||||
isBuiltinProfile,
|
||||
type ProfileName,
|
||||
type OperationalProfile,
|
||||
} from '@skillkit/core';
|
||||
|
||||
export class ProfileCommand extends Command {
|
||||
static override paths = [['profile']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Manage operational profiles (dev, review, research modes)',
|
||||
details: `
|
||||
Profiles adjust agent behavior for different tasks.
|
||||
Switch between modes like development, code review, or research.
|
||||
`,
|
||||
examples: [
|
||||
['Show current profile', '$0 profile'],
|
||||
['Switch to review mode', '$0 profile review'],
|
||||
['List all profiles', '$0 profile list'],
|
||||
],
|
||||
});
|
||||
|
||||
name = Option.String({ required: false });
|
||||
|
||||
async execute(): Promise<number> {
|
||||
if (this.name) {
|
||||
const profile = getProfile(this.name as ProfileName);
|
||||
|
||||
if (!profile) {
|
||||
console.log(chalk.red(`Profile not found: ${this.name}`));
|
||||
console.log(chalk.dim('Run `skillkit profile list` to see available profiles'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
setActiveProfile(this.name as ProfileName);
|
||||
console.log(chalk.green(`✓ Switched to ${profile.name} mode`));
|
||||
console.log(chalk.dim(` Focus: ${profile.focus}`));
|
||||
return 0;
|
||||
}
|
||||
|
||||
const active = getActiveProfile();
|
||||
const profile = getProfile(active);
|
||||
|
||||
console.log(chalk.cyan(`Current Profile: ${active}\n`));
|
||||
|
||||
if (profile) {
|
||||
console.log(`Description: ${profile.description}`);
|
||||
console.log(`Focus: ${profile.focus}`);
|
||||
console.log();
|
||||
console.log(chalk.bold('Behaviors:'));
|
||||
for (const behavior of profile.behaviors) {
|
||||
console.log(` • ${behavior}`);
|
||||
}
|
||||
console.log();
|
||||
console.log(chalk.bold('Priorities:'));
|
||||
console.log(` ${profile.priorities.join(' > ')}`);
|
||||
|
||||
if (profile.preferredTools?.length) {
|
||||
console.log();
|
||||
console.log(chalk.bold('Preferred Tools:'));
|
||||
console.log(` ${profile.preferredTools.join(', ')}`);
|
||||
}
|
||||
|
||||
if (profile.avoidTools?.length) {
|
||||
console.log(chalk.bold('Avoid Tools:'));
|
||||
console.log(` ${profile.avoidTools.join(', ')}`);
|
||||
}
|
||||
}
|
||||
|
||||
console.log();
|
||||
console.log(chalk.dim('Switch with: skillkit profile <name>'));
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class ProfileListCommand extends Command {
|
||||
static override paths = [['profile', 'list'], ['profile', 'ls']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'List available profiles',
|
||||
examples: [['List profiles', '$0 profile list']],
|
||||
});
|
||||
|
||||
json = Option.Boolean('--json,-j', false, {
|
||||
description: 'Output as JSON',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const profiles = getAllProfiles();
|
||||
const active = getActiveProfile();
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify({ active, profiles }, null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.cyan('Available Profiles:\n'));
|
||||
|
||||
for (const profile of profiles) {
|
||||
const isActive = profile.name === active;
|
||||
const marker = isActive ? chalk.green('●') : chalk.dim('○');
|
||||
const name = isActive ? chalk.bold(profile.name) : profile.name;
|
||||
const type = isBuiltinProfile(profile.name) ? '' : chalk.dim(' (custom)');
|
||||
|
||||
console.log(` ${marker} ${name}${type}`);
|
||||
console.log(` ${chalk.dim(profile.description)}`);
|
||||
console.log(` Focus: ${profile.focus}`);
|
||||
console.log();
|
||||
}
|
||||
|
||||
console.log(chalk.dim('Switch with: skillkit profile <name>'));
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class ProfileCreateCommand extends Command {
|
||||
static override paths = [['profile', 'create']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Create a custom profile',
|
||||
examples: [
|
||||
['Create profile', '$0 profile create --name my-profile --description "My custom profile"'],
|
||||
],
|
||||
});
|
||||
|
||||
name = Option.String('--name,-n', {
|
||||
description: 'Profile name',
|
||||
required: true,
|
||||
});
|
||||
|
||||
description = Option.String('--description,-d', {
|
||||
description: 'Profile description',
|
||||
required: true,
|
||||
});
|
||||
|
||||
focus = Option.String('--focus,-f', {
|
||||
description: 'Profile focus',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
if (isBuiltinProfile(this.name as ProfileName)) {
|
||||
console.log(chalk.red(`Cannot create profile: ${this.name} is a built-in profile`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const profile: OperationalProfile = {
|
||||
name: this.name as ProfileName,
|
||||
description: this.description,
|
||||
focus: this.focus || this.description,
|
||||
behaviors: [],
|
||||
priorities: [],
|
||||
};
|
||||
|
||||
addCustomProfile(profile);
|
||||
|
||||
console.log(chalk.green(`✓ Created profile: ${this.name}`));
|
||||
console.log(chalk.dim('Edit ~/.skillkit/profiles.yaml to customize'));
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class ProfileRemoveCommand extends Command {
|
||||
static override paths = [['profile', 'remove'], ['profile', 'rm']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Remove a custom profile',
|
||||
examples: [['Remove profile', '$0 profile remove my-profile']],
|
||||
});
|
||||
|
||||
name = Option.String({ required: true });
|
||||
|
||||
async execute(): Promise<number> {
|
||||
if (isBuiltinProfile(this.name as ProfileName)) {
|
||||
console.log(chalk.red(`Cannot remove built-in profile: ${this.name}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const removed = removeCustomProfile(this.name as ProfileName);
|
||||
|
||||
if (!removed) {
|
||||
console.log(chalk.yellow(`Profile not found: ${this.name}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
console.log(chalk.green(`✓ Removed profile: ${this.name}`));
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
@@ -1,321 +0,0 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import chalk from 'chalk';
|
||||
import {
|
||||
loadSessionFile,
|
||||
saveSessionFile,
|
||||
createSessionFile,
|
||||
updateSessionFile,
|
||||
listSessions,
|
||||
getMostRecentSession,
|
||||
type SessionFile,
|
||||
} from '@skillkit/core';
|
||||
|
||||
export class SessionCommand extends Command {
|
||||
static override paths = [['session']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Manage session state for context preservation',
|
||||
details: `
|
||||
Sessions track context across coding sessions, allowing you to
|
||||
preserve state across compactions and session restarts.
|
||||
`,
|
||||
examples: [
|
||||
['Show current session', '$0 session'],
|
||||
['Start new session', '$0 session start'],
|
||||
['Load specific date', '$0 session load 2026-01-30'],
|
||||
],
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
console.log(chalk.cyan('Session commands:\n'));
|
||||
console.log(' session status Show current session state');
|
||||
console.log(' session start Start a new session');
|
||||
console.log(' session load Load session from specific date');
|
||||
console.log(' session list List recent sessions');
|
||||
console.log(' session note Add note to current session');
|
||||
console.log(' session complete Mark task as completed');
|
||||
console.log();
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class SessionStatusCommand extends Command {
|
||||
static override paths = [['session', 'status']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Show current session state',
|
||||
examples: [['Show status', '$0 session status']],
|
||||
});
|
||||
|
||||
json = Option.Boolean('--json,-j', false, {
|
||||
description: 'Output as JSON',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const session = getMostRecentSession();
|
||||
|
||||
if (!session) {
|
||||
console.log(chalk.yellow('No active session found'));
|
||||
console.log(chalk.dim('Start one with: skillkit session start'));
|
||||
return 0;
|
||||
}
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(session, null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
this.printSession(session);
|
||||
return 0;
|
||||
}
|
||||
|
||||
private printSession(session: SessionFile): void {
|
||||
console.log(chalk.cyan(`Session: ${session.date}\n`));
|
||||
console.log(`Agent: ${session.agent}`);
|
||||
console.log(`Project: ${session.projectPath}`);
|
||||
console.log(`Started: ${session.startedAt}`);
|
||||
console.log(`Last Updated: ${session.lastUpdated}`);
|
||||
console.log();
|
||||
|
||||
if (session.completed.length > 0) {
|
||||
console.log(chalk.green('Completed:'));
|
||||
for (const task of session.completed) {
|
||||
console.log(` ${chalk.green('✓')} ${task}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (session.inProgress.length > 0) {
|
||||
console.log(chalk.yellow('In Progress:'));
|
||||
for (const task of session.inProgress) {
|
||||
console.log(` ${chalk.yellow('○')} ${task}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (session.notes.length > 0) {
|
||||
console.log(chalk.blue('Notes for Next Session:'));
|
||||
for (const note of session.notes) {
|
||||
console.log(` ${chalk.dim('•')} ${note}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (session.contextToLoad.length > 0) {
|
||||
console.log(chalk.dim('Context to Load:'));
|
||||
for (const ctx of session.contextToLoad) {
|
||||
console.log(` ${chalk.dim('•')} ${ctx}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
export class SessionStartCommand extends Command {
|
||||
static override paths = [['session', 'start']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Start a new session',
|
||||
examples: [
|
||||
['Start session', '$0 session start'],
|
||||
['Start with agent', '$0 session start --agent claude-code'],
|
||||
],
|
||||
});
|
||||
|
||||
agent = Option.String('--agent,-a', {
|
||||
description: 'AI agent being used',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const agent = this.agent || 'claude-code';
|
||||
const projectPath = process.cwd();
|
||||
|
||||
const session = createSessionFile(agent, projectPath);
|
||||
const filepath = saveSessionFile(session);
|
||||
|
||||
console.log(chalk.green(`✓ Session started: ${session.date}`));
|
||||
console.log(chalk.dim(` Saved to: ${filepath}`));
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class SessionLoadCommand extends Command {
|
||||
static override paths = [['session', 'load']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Load session from specific date',
|
||||
examples: [['Load session', '$0 session load 2026-01-30']],
|
||||
});
|
||||
|
||||
date = Option.String({ required: false });
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const session = this.date ? loadSessionFile(this.date) : getMostRecentSession();
|
||||
|
||||
if (!session) {
|
||||
console.log(chalk.yellow('Session not found'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
console.log(chalk.green(`✓ Loaded session: ${session.date}`));
|
||||
console.log();
|
||||
|
||||
if (session.notes.length > 0) {
|
||||
console.log(chalk.cyan('Notes from previous session:'));
|
||||
for (const note of session.notes) {
|
||||
console.log(` ${chalk.dim('•')} ${note}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (session.inProgress.length > 0) {
|
||||
console.log(chalk.yellow('Tasks still in progress:'));
|
||||
for (const task of session.inProgress) {
|
||||
console.log(` ${chalk.yellow('○')} ${task}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (session.contextToLoad.length > 0) {
|
||||
console.log(chalk.dim('Context to load:'));
|
||||
for (const ctx of session.contextToLoad) {
|
||||
console.log(` ${ctx}`);
|
||||
}
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class SessionListCommand extends Command {
|
||||
static override paths = [['session', 'list'], ['session', 'ls']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'List recent sessions',
|
||||
examples: [['List sessions', '$0 session list']],
|
||||
});
|
||||
|
||||
limit = Option.String('--limit,-l', {
|
||||
description: 'Number of sessions to show (default: 10)',
|
||||
});
|
||||
|
||||
json = Option.Boolean('--json,-j', false, {
|
||||
description: 'Output as JSON',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const limit = this.limit ? parseInt(this.limit) : 10;
|
||||
const sessions = listSessions(limit);
|
||||
|
||||
if (sessions.length === 0) {
|
||||
console.log(chalk.yellow('No sessions found'));
|
||||
return 0;
|
||||
}
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(sessions, null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.cyan(`Recent Sessions (${sessions.length}):\n`));
|
||||
|
||||
for (const session of sessions) {
|
||||
const progress = `${session.completedCount}/${session.taskCount}`;
|
||||
const notesIndicator = session.hasNotes ? chalk.blue(' [notes]') : '';
|
||||
console.log(` ${chalk.bold(session.date)} - ${session.agent}`);
|
||||
console.log(` ${chalk.dim(session.projectPath)}`);
|
||||
console.log(` Tasks: ${progress}${notesIndicator}`);
|
||||
console.log();
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class SessionNoteCommand extends Command {
|
||||
static override paths = [['session', 'note']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Add note to current session',
|
||||
examples: [['Add note', '$0 session note "Remember to test edge cases"']],
|
||||
});
|
||||
|
||||
note = Option.String({ required: true });
|
||||
|
||||
async execute(): Promise<number> {
|
||||
let session = getMostRecentSession();
|
||||
|
||||
if (!session) {
|
||||
session = createSessionFile('claude-code', process.cwd());
|
||||
}
|
||||
|
||||
const updated = updateSessionFile(session, {
|
||||
notes: [this.note],
|
||||
});
|
||||
|
||||
saveSessionFile(updated);
|
||||
|
||||
console.log(chalk.green('✓ Note added'));
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class SessionCompleteCommand extends Command {
|
||||
static override paths = [['session', 'complete']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Mark task as completed',
|
||||
examples: [['Mark completed', '$0 session complete "Implemented user auth"']],
|
||||
});
|
||||
|
||||
task = Option.String({ required: true });
|
||||
|
||||
async execute(): Promise<number> {
|
||||
let session = getMostRecentSession();
|
||||
|
||||
if (!session) {
|
||||
session = createSessionFile('claude-code', process.cwd());
|
||||
}
|
||||
|
||||
const updated = updateSessionFile(session, {
|
||||
completed: [this.task],
|
||||
});
|
||||
|
||||
if (session.inProgress.includes(this.task)) {
|
||||
updated.inProgress = session.inProgress.filter(t => t !== this.task);
|
||||
}
|
||||
|
||||
saveSessionFile(updated);
|
||||
|
||||
console.log(chalk.green(`✓ Completed: ${this.task}`));
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class SessionInProgressCommand extends Command {
|
||||
static override paths = [['session', 'wip'], ['session', 'progress']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Mark task as in progress',
|
||||
examples: [['Mark in progress', '$0 session wip "Working on auth flow"']],
|
||||
});
|
||||
|
||||
task = Option.String({ required: true });
|
||||
|
||||
async execute(): Promise<number> {
|
||||
let session = getMostRecentSession();
|
||||
|
||||
if (!session) {
|
||||
session = createSessionFile('claude-code', process.cwd());
|
||||
}
|
||||
|
||||
const updated = updateSessionFile(session, {
|
||||
inProgress: [...session.inProgress, this.task],
|
||||
});
|
||||
|
||||
saveSessionFile(updated);
|
||||
|
||||
console.log(chalk.yellow(`○ In progress: ${this.task}`));
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
@@ -14,7 +14,7 @@ export class UICommand extends Command {
|
||||
|
||||
Features:
|
||||
- Browse and discover skills from the marketplace
|
||||
- Manage installed skills across 32 AI coding agents
|
||||
- Manage installed skills across 17+ AI coding agents
|
||||
- Sync skills between agents
|
||||
- AI-powered recommendations
|
||||
- Team collaboration
|
||||
|
||||
@@ -2,4 +2,3 @@
|
||||
export { WorkflowRunCommand } from './run.js';
|
||||
export { WorkflowListCommand } from './list.js';
|
||||
export { WorkflowCreateCommand } from './create.js';
|
||||
export { WorkflowPipelineCommand, WorkflowPipelineListCommand } from './pipeline.js';
|
||||
|
||||
@@ -1,138 +0,0 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import chalk from 'chalk';
|
||||
import {
|
||||
BUILTIN_PIPELINES,
|
||||
getBuiltinPipeline,
|
||||
getBuiltinPipelines,
|
||||
type AgentPipeline,
|
||||
} from '@skillkit/core';
|
||||
|
||||
export class WorkflowPipelineCommand extends Command {
|
||||
static override paths = [['workflow', 'pipeline']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Run a built-in agent pipeline',
|
||||
details: `
|
||||
Pipelines are sequential multi-agent workflows for common development tasks.
|
||||
Each pipeline runs agents in order, passing context between stages.
|
||||
`,
|
||||
examples: [
|
||||
['Run feature pipeline', '$0 workflow pipeline feature'],
|
||||
['Run bugfix pipeline', '$0 workflow pipeline bugfix'],
|
||||
['List available pipelines', '$0 workflow pipeline list'],
|
||||
],
|
||||
});
|
||||
|
||||
pipeline = Option.String({ required: false });
|
||||
|
||||
dryRun = Option.Boolean('--dry-run,-n', false, {
|
||||
description: 'Show what would be done without executing',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
if (!this.pipeline) {
|
||||
console.log(chalk.cyan('Usage: skillkit workflow pipeline <name>\n'));
|
||||
console.log('Available pipelines:');
|
||||
for (const p of BUILTIN_PIPELINES) {
|
||||
console.log(` ${chalk.bold(p.id)} - ${p.description}`);
|
||||
}
|
||||
console.log();
|
||||
console.log(chalk.dim('Run: skillkit workflow pipeline list for details'));
|
||||
return 0;
|
||||
}
|
||||
|
||||
const pipeline = getBuiltinPipeline(this.pipeline);
|
||||
|
||||
if (!pipeline) {
|
||||
console.log(chalk.red(`Pipeline not found: ${this.pipeline}`));
|
||||
console.log(chalk.dim('Run `skillkit workflow pipeline list` to see available pipelines'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
if (this.dryRun) {
|
||||
return this.showPipeline(pipeline);
|
||||
}
|
||||
|
||||
return this.runPipeline(pipeline);
|
||||
}
|
||||
|
||||
private showPipeline(pipeline: AgentPipeline): number {
|
||||
console.log(chalk.cyan(`Pipeline: ${pipeline.name}\n`));
|
||||
console.log(`Description: ${pipeline.description}`);
|
||||
console.log();
|
||||
console.log(chalk.bold('Stages:'));
|
||||
|
||||
for (let i = 0; i < pipeline.stages.length; i++) {
|
||||
const stage = pipeline.stages[i];
|
||||
const arrow = i < pipeline.stages.length - 1 ? '→' : '';
|
||||
console.log(` ${i + 1}. ${chalk.bold(stage.name)} (@${stage.agent})`);
|
||||
console.log(` ${chalk.dim(stage.description)}`);
|
||||
if (arrow) {
|
||||
console.log(` ${chalk.dim(arrow)}`);
|
||||
}
|
||||
}
|
||||
|
||||
console.log();
|
||||
console.log(chalk.dim('(dry-run mode - no execution)'));
|
||||
|
||||
return 0;
|
||||
}
|
||||
|
||||
private async runPipeline(pipeline: AgentPipeline): Promise<number> {
|
||||
console.log(chalk.cyan(`Starting Pipeline: ${pipeline.name}\n`));
|
||||
|
||||
for (let i = 0; i < pipeline.stages.length; i++) {
|
||||
const stage = pipeline.stages[i];
|
||||
const stageNum = `[${i + 1}/${pipeline.stages.length}]`;
|
||||
|
||||
console.log(`${chalk.blue(stageNum)} ${chalk.bold(stage.name)}`);
|
||||
console.log(` Agent: @${stage.agent}`);
|
||||
console.log(` ${chalk.dim(stage.description)}`);
|
||||
console.log();
|
||||
|
||||
console.log(chalk.yellow(` → Invoke @${stage.agent} for: ${stage.description}`));
|
||||
console.log(chalk.dim(' (Manual agent invocation required in current implementation)'));
|
||||
console.log();
|
||||
}
|
||||
|
||||
console.log(chalk.green('✓ Pipeline stages displayed'));
|
||||
console.log(chalk.dim('Execute each stage by invoking the agents in order'));
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class WorkflowPipelineListCommand extends Command {
|
||||
static override paths = [['workflow', 'pipeline', 'list']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'List available pipelines',
|
||||
examples: [['List pipelines', '$0 workflow pipeline list']],
|
||||
});
|
||||
|
||||
json = Option.Boolean('--json,-j', false, {
|
||||
description: 'Output as JSON',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const pipelines = getBuiltinPipelines();
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(pipelines, null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.cyan(`Available Pipelines (${pipelines.length}):\n`));
|
||||
|
||||
for (const pipeline of pipelines) {
|
||||
console.log(chalk.bold(` ${pipeline.id}`));
|
||||
console.log(` ${pipeline.name}: ${pipeline.description}`);
|
||||
console.log(` Stages: ${pipeline.stages.map(s => s.name).join(' → ')}`);
|
||||
console.log();
|
||||
}
|
||||
|
||||
console.log(chalk.dim('Run with: skillkit workflow pipeline <name>'));
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
@@ -88,7 +88,7 @@ import {
|
||||
} from './preferences.js';
|
||||
|
||||
let VERSION = '1.7.6';
|
||||
let AGENT_COUNT = 32;
|
||||
let AGENT_COUNT = 17;
|
||||
|
||||
export function setVersion(version: string): void {
|
||||
VERSION = version;
|
||||
|
||||
@@ -14,7 +14,7 @@ npm install @skillkit/core
|
||||
## Key Features
|
||||
|
||||
- **Skill Discovery**: Find and parse SKILL.md files from any source
|
||||
- **Cross-Agent Translation**: Convert skills between 32 agent formats (Claude Code, Cursor, Windsurf, etc.)
|
||||
- **Cross-Agent Translation**: Convert skills between 17 agent formats (Claude Code, Cursor, Windsurf, etc.)
|
||||
- **Project Context Detection**: Analyze project stack, dependencies, and configurations
|
||||
- **Smart Recommendations**: AI-powered skill suggestions based on project profile
|
||||
- **Session Memory**: Capture and persist learnings across AI coding sessions
|
||||
@@ -278,7 +278,7 @@ await hooks.trigger('pre-commit', { files: ['src/index.ts'] });
|
||||
|
||||
## Supported Agents
|
||||
|
||||
The translator supports all 32 SkillKit-compatible agents:
|
||||
The translator supports all 17 SkillKit-compatible agents:
|
||||
|
||||
| Agent | Format |
|
||||
|-------|--------|
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/core",
|
||||
"version": "1.8.1",
|
||||
"version": "1.7.6",
|
||||
"description": "Core functionality for SkillKit - skill discovery, parsing, and translation",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
@@ -33,10 +33,6 @@
|
||||
"./recommend": {
|
||||
"import": "./dist/recommend/index.js",
|
||||
"types": "./dist/recommend/index.d.ts"
|
||||
},
|
||||
"./learning": {
|
||||
"import": "./dist/learning/index.js",
|
||||
"types": "./dist/learning/index.d.ts"
|
||||
}
|
||||
},
|
||||
"files": [
|
||||
|
||||
@@ -1,2 +0,0 @@
|
||||
export * from './types.js';
|
||||
export * from './manager.js';
|
||||
@@ -1,309 +0,0 @@
|
||||
import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
|
||||
import { join, dirname } from 'node:path';
|
||||
import { homedir } from 'node:os';
|
||||
import yaml from 'yaml';
|
||||
|
||||
import type { Guideline, GuidelineCategory, GuidelineConfig } from './types.js';
|
||||
import { DEFAULT_GUIDELINE_CONFIG } from './types.js';
|
||||
|
||||
const BUILTIN_GUIDELINES: Guideline[] = [
|
||||
{
|
||||
id: 'security',
|
||||
name: 'Security Guidelines',
|
||||
description: 'Security best practices and vulnerability prevention',
|
||||
category: 'security',
|
||||
priority: 10,
|
||||
enabled: true,
|
||||
scope: 'global',
|
||||
content: `## Security Guidelines
|
||||
|
||||
### Input Validation
|
||||
- Validate all user input on the server side
|
||||
- Use allowlists over denylists when possible
|
||||
- Sanitize data before use in queries, commands, or output
|
||||
|
||||
### Authentication & Authorization
|
||||
- Never store passwords in plain text
|
||||
- Use secure session management
|
||||
- Implement proper authorization checks on every endpoint
|
||||
- Use HTTPS for all communications
|
||||
|
||||
### Data Protection
|
||||
- Encrypt sensitive data at rest and in transit
|
||||
- Never log sensitive information
|
||||
- Use environment variables for secrets
|
||||
- Implement proper access controls
|
||||
|
||||
### Common Vulnerabilities to Prevent
|
||||
- SQL Injection: Use parameterized queries
|
||||
- XSS: Encode output, use CSP headers
|
||||
- CSRF: Use anti-CSRF tokens
|
||||
- Command Injection: Avoid shell commands with user input`,
|
||||
},
|
||||
{
|
||||
id: 'code-style',
|
||||
name: 'Code Style Guidelines',
|
||||
description: 'Code formatting and style conventions',
|
||||
category: 'code-style',
|
||||
priority: 7,
|
||||
enabled: true,
|
||||
scope: 'global',
|
||||
content: `## Code Style Guidelines
|
||||
|
||||
### Naming Conventions
|
||||
- Use descriptive, meaningful names
|
||||
- camelCase for variables and functions
|
||||
- PascalCase for classes and types
|
||||
- SCREAMING_SNAKE_CASE for constants
|
||||
|
||||
### Code Organization
|
||||
- One concept per file
|
||||
- Group related code together
|
||||
- Keep files under 300 lines when practical
|
||||
- Use barrel exports (index.ts) for public APIs
|
||||
|
||||
### Functions
|
||||
- Single responsibility principle
|
||||
- Keep functions under 30 lines when practical
|
||||
- Use early returns to reduce nesting
|
||||
- Avoid side effects in pure functions
|
||||
|
||||
### Comments
|
||||
- Don't comment obvious code
|
||||
- Explain "why" not "what"
|
||||
- Keep comments up to date
|
||||
- Use JSDoc for public APIs`,
|
||||
},
|
||||
{
|
||||
id: 'testing',
|
||||
name: 'Testing Guidelines',
|
||||
description: 'Testing best practices and coverage requirements',
|
||||
category: 'testing',
|
||||
priority: 8,
|
||||
enabled: true,
|
||||
scope: 'global',
|
||||
content: `## Testing Guidelines
|
||||
|
||||
### Test Coverage
|
||||
- Aim for 80%+ code coverage
|
||||
- 100% coverage for critical paths
|
||||
- Don't sacrifice quality for coverage metrics
|
||||
|
||||
### Test Structure
|
||||
- Arrange, Act, Assert (AAA) pattern
|
||||
- One concept per test
|
||||
- Descriptive test names that explain behavior
|
||||
- Independent tests (no shared state)
|
||||
|
||||
### Test Types
|
||||
- Unit tests for business logic
|
||||
- Integration tests for component interactions
|
||||
- E2E tests for critical user flows
|
||||
|
||||
### Test Quality
|
||||
- Tests should be deterministic
|
||||
- Fast execution (< 100ms for unit tests)
|
||||
- Easy to understand and maintain
|
||||
- Test behavior, not implementation`,
|
||||
},
|
||||
{
|
||||
id: 'git',
|
||||
name: 'Git Workflow Guidelines',
|
||||
description: 'Version control best practices',
|
||||
category: 'git',
|
||||
priority: 6,
|
||||
enabled: true,
|
||||
scope: 'global',
|
||||
content: `## Git Workflow Guidelines
|
||||
|
||||
### Commits
|
||||
- Write clear, concise commit messages
|
||||
- Use conventional commits format
|
||||
- One logical change per commit
|
||||
- Don't commit generated files or secrets
|
||||
|
||||
### Branches
|
||||
- Use feature branches
|
||||
- Keep branches short-lived
|
||||
- Delete branches after merge
|
||||
- Protect main/master branch
|
||||
|
||||
### Pull Requests
|
||||
- Keep PRs focused and small
|
||||
- Write meaningful descriptions
|
||||
- Request reviews from appropriate people
|
||||
- Address all review comments
|
||||
|
||||
### Commit Message Format
|
||||
\`\`\`
|
||||
<type>(<scope>): <description>
|
||||
|
||||
[optional body]
|
||||
|
||||
[optional footer]
|
||||
\`\`\`
|
||||
|
||||
Types: feat, fix, docs, style, refactor, test, chore`,
|
||||
},
|
||||
{
|
||||
id: 'performance',
|
||||
name: 'Performance Guidelines',
|
||||
description: 'Performance optimization best practices',
|
||||
category: 'performance',
|
||||
priority: 5,
|
||||
enabled: false,
|
||||
scope: 'global',
|
||||
content: `## Performance Guidelines
|
||||
|
||||
### General Principles
|
||||
- Measure before optimizing
|
||||
- Optimize critical paths first
|
||||
- Consider time/space tradeoffs
|
||||
- Profile in production-like environments
|
||||
|
||||
### Database
|
||||
- Use indexes appropriately
|
||||
- Avoid N+1 queries
|
||||
- Paginate large result sets
|
||||
- Cache frequently accessed data
|
||||
|
||||
### Frontend
|
||||
- Minimize bundle size
|
||||
- Lazy load when appropriate
|
||||
- Optimize images and assets
|
||||
- Use efficient rendering patterns
|
||||
|
||||
### Backend
|
||||
- Use connection pooling
|
||||
- Implement appropriate caching
|
||||
- Async operations where beneficial
|
||||
- Monitor and alert on performance`,
|
||||
},
|
||||
];
|
||||
|
||||
function getConfigPath(): string {
|
||||
return join(homedir(), '.skillkit', 'guidelines.yaml');
|
||||
}
|
||||
|
||||
export function loadGuidelineConfig(): GuidelineConfig {
|
||||
const path = getConfigPath();
|
||||
|
||||
if (!existsSync(path)) {
|
||||
return DEFAULT_GUIDELINE_CONFIG;
|
||||
}
|
||||
|
||||
try {
|
||||
const content = readFileSync(path, 'utf-8');
|
||||
return { ...DEFAULT_GUIDELINE_CONFIG, ...yaml.parse(content) };
|
||||
} catch {
|
||||
return DEFAULT_GUIDELINE_CONFIG;
|
||||
}
|
||||
}
|
||||
|
||||
export function saveGuidelineConfig(config: GuidelineConfig): void {
|
||||
const path = getConfigPath();
|
||||
const dir = dirname(path);
|
||||
|
||||
if (!existsSync(dir)) {
|
||||
mkdirSync(dir, { recursive: true });
|
||||
}
|
||||
|
||||
writeFileSync(path, yaml.stringify(config));
|
||||
}
|
||||
|
||||
export function getGuideline(id: string): Guideline | null {
|
||||
const builtin = BUILTIN_GUIDELINES.find(g => g.id === id);
|
||||
if (builtin) return builtin;
|
||||
|
||||
const config = loadGuidelineConfig();
|
||||
return config.customGuidelines.find(g => g.id === id) || null;
|
||||
}
|
||||
|
||||
export function getAllGuidelines(): Guideline[] {
|
||||
const config = loadGuidelineConfig();
|
||||
return [...BUILTIN_GUIDELINES, ...config.customGuidelines];
|
||||
}
|
||||
|
||||
export function getBuiltinGuidelines(): Guideline[] {
|
||||
return BUILTIN_GUIDELINES;
|
||||
}
|
||||
|
||||
export function getEnabledGuidelines(): Guideline[] {
|
||||
const config = loadGuidelineConfig();
|
||||
const all = getAllGuidelines();
|
||||
return all.filter(g => config.enabledGuidelines.includes(g.id));
|
||||
}
|
||||
|
||||
export function getGuidelinesByCategory(category: GuidelineCategory): Guideline[] {
|
||||
return getAllGuidelines().filter(g => g.category === category);
|
||||
}
|
||||
|
||||
export function enableGuideline(id: string): boolean {
|
||||
const guideline = getGuideline(id);
|
||||
if (!guideline) return false;
|
||||
|
||||
const config = loadGuidelineConfig();
|
||||
if (!config.enabledGuidelines.includes(id)) {
|
||||
config.enabledGuidelines.push(id);
|
||||
saveGuidelineConfig(config);
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
export function disableGuideline(id: string): boolean {
|
||||
const config = loadGuidelineConfig();
|
||||
const index = config.enabledGuidelines.indexOf(id);
|
||||
|
||||
if (index < 0) return false;
|
||||
|
||||
config.enabledGuidelines.splice(index, 1);
|
||||
saveGuidelineConfig(config);
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
export function isGuidelineEnabled(id: string): boolean {
|
||||
const config = loadGuidelineConfig();
|
||||
return config.enabledGuidelines.includes(id);
|
||||
}
|
||||
|
||||
export function addCustomGuideline(guideline: Guideline): void {
|
||||
const config = loadGuidelineConfig();
|
||||
const existing = config.customGuidelines.findIndex(g => g.id === guideline.id);
|
||||
|
||||
if (existing >= 0) {
|
||||
config.customGuidelines[existing] = guideline;
|
||||
} else {
|
||||
config.customGuidelines.push(guideline);
|
||||
}
|
||||
|
||||
saveGuidelineConfig(config);
|
||||
}
|
||||
|
||||
export function removeCustomGuideline(id: string): boolean {
|
||||
const config = loadGuidelineConfig();
|
||||
const index = config.customGuidelines.findIndex(g => g.id === id);
|
||||
|
||||
if (index < 0) return false;
|
||||
|
||||
config.customGuidelines.splice(index, 1);
|
||||
config.enabledGuidelines = config.enabledGuidelines.filter(g => g !== id);
|
||||
|
||||
saveGuidelineConfig(config);
|
||||
return true;
|
||||
}
|
||||
|
||||
export function getGuidelineContent(id: string): string | null {
|
||||
const guideline = getGuideline(id);
|
||||
return guideline?.content || null;
|
||||
}
|
||||
|
||||
export function getEnabledGuidelineContent(): string {
|
||||
const enabled = getEnabledGuidelines();
|
||||
return enabled.map(g => g.content).join('\n\n---\n\n');
|
||||
}
|
||||
|
||||
export function isBuiltinGuideline(id: string): boolean {
|
||||
return BUILTIN_GUIDELINES.some(g => g.id === id);
|
||||
}
|
||||
@@ -1,22 +0,0 @@
|
||||
export type GuidelineCategory = 'security' | 'code-style' | 'testing' | 'git' | 'performance' | 'custom';
|
||||
|
||||
export interface Guideline {
|
||||
id: string;
|
||||
name: string;
|
||||
description: string;
|
||||
category: GuidelineCategory;
|
||||
content: string;
|
||||
priority: number;
|
||||
enabled: boolean;
|
||||
scope: 'global' | 'project';
|
||||
}
|
||||
|
||||
export interface GuidelineConfig {
|
||||
enabledGuidelines: string[];
|
||||
customGuidelines: Guideline[];
|
||||
}
|
||||
|
||||
export const DEFAULT_GUIDELINE_CONFIG: GuidelineConfig = {
|
||||
enabledGuidelines: ['security', 'code-style', 'testing', 'git'],
|
||||
customGuidelines: [],
|
||||
};
|
||||
@@ -77,15 +77,3 @@ export * from './skill-translator.js';
|
||||
export * from './manifest/index.js';
|
||||
|
||||
export * from './quality/index.js';
|
||||
|
||||
// Primer (AI Instruction Generator)
|
||||
export * from './primer/index.js';
|
||||
|
||||
// Pattern Learning System
|
||||
export * from './learning/index.js';
|
||||
|
||||
// Operational Profiles
|
||||
export * from './profiles/index.js';
|
||||
|
||||
// Coding Guidelines System
|
||||
export * from './guidelines/index.js';
|
||||
|
||||
@@ -1,134 +0,0 @@
|
||||
import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
|
||||
import { join, dirname } from 'node:path';
|
||||
import { homedir } from 'node:os';
|
||||
import yaml from 'yaml';
|
||||
|
||||
import type { LearningConfig, PatternStore, LearnedPattern, EvolvingPattern } from './types.js';
|
||||
import { DEFAULT_LEARNING_CONFIG } from './types.js';
|
||||
|
||||
export function getDefaultConfigPath(): string {
|
||||
return join(homedir(), '.skillkit', 'learning.yaml');
|
||||
}
|
||||
|
||||
export function getDefaultStorePath(): string {
|
||||
return join(homedir(), '.skillkit', 'learned', 'patterns.json');
|
||||
}
|
||||
|
||||
export function loadLearningConfig(configPath?: string): LearningConfig {
|
||||
const path = configPath || getDefaultConfigPath();
|
||||
|
||||
if (!existsSync(path)) {
|
||||
return DEFAULT_LEARNING_CONFIG;
|
||||
}
|
||||
|
||||
try {
|
||||
const content = readFileSync(path, 'utf-8');
|
||||
const config = yaml.parse(content);
|
||||
return { ...DEFAULT_LEARNING_CONFIG, ...config };
|
||||
} catch {
|
||||
return DEFAULT_LEARNING_CONFIG;
|
||||
}
|
||||
}
|
||||
|
||||
export function saveLearningConfig(config: LearningConfig, configPath?: string): void {
|
||||
const path = configPath || getDefaultConfigPath();
|
||||
const dir = dirname(path);
|
||||
|
||||
if (!existsSync(dir)) {
|
||||
mkdirSync(dir, { recursive: true });
|
||||
}
|
||||
|
||||
const content = yaml.stringify(config);
|
||||
writeFileSync(path, content);
|
||||
}
|
||||
|
||||
export function loadPatternStore(storePath?: string): PatternStore {
|
||||
const path = storePath || getDefaultStorePath();
|
||||
|
||||
if (!existsSync(path)) {
|
||||
return {
|
||||
version: 1,
|
||||
updatedAt: new Date().toISOString(),
|
||||
patterns: [],
|
||||
evolvingPatterns: [],
|
||||
};
|
||||
}
|
||||
|
||||
try {
|
||||
const content = readFileSync(path, 'utf-8');
|
||||
return JSON.parse(content);
|
||||
} catch {
|
||||
return {
|
||||
version: 1,
|
||||
updatedAt: new Date().toISOString(),
|
||||
patterns: [],
|
||||
evolvingPatterns: [],
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
export function savePatternStore(store: PatternStore, storePath?: string): void {
|
||||
const path = storePath || getDefaultStorePath();
|
||||
const dir = dirname(path);
|
||||
|
||||
if (!existsSync(dir)) {
|
||||
mkdirSync(dir, { recursive: true });
|
||||
}
|
||||
|
||||
store.updatedAt = new Date().toISOString();
|
||||
const content = JSON.stringify(store, null, 2);
|
||||
writeFileSync(path, content);
|
||||
}
|
||||
|
||||
export function addPattern(
|
||||
pattern: LearnedPattern,
|
||||
storePath?: string
|
||||
): PatternStore {
|
||||
const store = loadPatternStore(storePath);
|
||||
|
||||
const existingIndex = store.patterns.findIndex(p => p.id === pattern.id);
|
||||
if (existingIndex >= 0) {
|
||||
store.patterns[existingIndex] = pattern;
|
||||
} else {
|
||||
store.patterns.push(pattern);
|
||||
}
|
||||
|
||||
savePatternStore(store, storePath);
|
||||
return store;
|
||||
}
|
||||
|
||||
export function removePattern(patternId: string, storePath?: string): PatternStore {
|
||||
const store = loadPatternStore(storePath);
|
||||
store.patterns = store.patterns.filter(p => p.id !== patternId);
|
||||
store.evolvingPatterns = store.evolvingPatterns.filter(p => p.id !== patternId);
|
||||
savePatternStore(store, storePath);
|
||||
return store;
|
||||
}
|
||||
|
||||
export function getPattern(patternId: string, storePath?: string): LearnedPattern | null {
|
||||
const store = loadPatternStore(storePath);
|
||||
return store.patterns.find(p => p.id === patternId) || null;
|
||||
}
|
||||
|
||||
export function getEvolvingPattern(patternId: string, storePath?: string): EvolvingPattern | null {
|
||||
const store = loadPatternStore(storePath);
|
||||
return store.evolvingPatterns.find(p => p.id === patternId) || null;
|
||||
}
|
||||
|
||||
export function getAllPatterns(storePath?: string): LearnedPattern[] {
|
||||
const store = loadPatternStore(storePath);
|
||||
return store.patterns;
|
||||
}
|
||||
|
||||
export function getPatternsByCategory(
|
||||
category: string,
|
||||
storePath?: string
|
||||
): LearnedPattern[] {
|
||||
const store = loadPatternStore(storePath);
|
||||
return store.patterns.filter(p => p.category === category);
|
||||
}
|
||||
|
||||
export function getApprovedPatterns(storePath?: string): LearnedPattern[] {
|
||||
const store = loadPatternStore(storePath);
|
||||
return store.patterns.filter(p => p.approved);
|
||||
}
|
||||
@@ -1,336 +0,0 @@
|
||||
import type {
|
||||
LearnedPattern,
|
||||
PatternCategory,
|
||||
PatternExtractionResult,
|
||||
} from './types.js';
|
||||
|
||||
export interface SessionMessage {
|
||||
role: 'user' | 'assistant' | 'system';
|
||||
content: string;
|
||||
timestamp?: string;
|
||||
}
|
||||
|
||||
export interface SessionContext {
|
||||
messages: SessionMessage[];
|
||||
projectPath: string;
|
||||
startTime: string;
|
||||
endTime?: string;
|
||||
}
|
||||
|
||||
export function extractPatternsFromSession(
|
||||
session: SessionContext
|
||||
): PatternExtractionResult {
|
||||
const patterns: LearnedPattern[] = [];
|
||||
const skipped: { reason: string; commit?: string }[] = [];
|
||||
const errors: string[] = [];
|
||||
|
||||
if (session.messages.length < 5) {
|
||||
skipped.push({ reason: 'Session too short for pattern extraction' });
|
||||
return { patterns, skipped, errors };
|
||||
}
|
||||
|
||||
try {
|
||||
const errorFixPatterns = findErrorFixPatterns(session);
|
||||
patterns.push(...errorFixPatterns);
|
||||
|
||||
const workaroundPatterns = findWorkaroundPatterns(session);
|
||||
patterns.push(...workaroundPatterns);
|
||||
|
||||
const conventionPatterns = findConventionPatterns(session);
|
||||
patterns.push(...conventionPatterns);
|
||||
|
||||
const debuggingPatterns = findDebuggingPatterns(session);
|
||||
patterns.push(...debuggingPatterns);
|
||||
} catch (error) {
|
||||
errors.push(error instanceof Error ? error.message : 'Unknown extraction error');
|
||||
}
|
||||
|
||||
return { patterns, skipped, errors };
|
||||
}
|
||||
|
||||
function findErrorFixPatterns(session: SessionContext): LearnedPattern[] {
|
||||
const patterns: LearnedPattern[] = [];
|
||||
const messages = session.messages;
|
||||
|
||||
for (let i = 0; i < messages.length - 1; i++) {
|
||||
const current = messages[i];
|
||||
const next = messages[i + 1];
|
||||
|
||||
if (isErrorDescription(current.content) && isSolution(next.content)) {
|
||||
const pattern = createPatternFromErrorFix(
|
||||
current.content,
|
||||
next.content,
|
||||
session,
|
||||
i
|
||||
);
|
||||
if (pattern) {
|
||||
patterns.push(pattern);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return patterns;
|
||||
}
|
||||
|
||||
function findWorkaroundPatterns(session: SessionContext): LearnedPattern[] {
|
||||
const patterns: LearnedPattern[] = [];
|
||||
const messages = session.messages;
|
||||
|
||||
const workaroundKeywords = [
|
||||
'workaround',
|
||||
'instead of',
|
||||
'alternative',
|
||||
'hack',
|
||||
'temporary fix',
|
||||
'for now',
|
||||
'until',
|
||||
];
|
||||
|
||||
for (let i = 0; i < messages.length; i++) {
|
||||
const message = messages[i];
|
||||
if (message.role !== 'assistant') continue;
|
||||
|
||||
const content = message.content.toLowerCase();
|
||||
if (workaroundKeywords.some(kw => content.includes(kw))) {
|
||||
const problem = findPrecedingProblem(messages, i);
|
||||
if (problem) {
|
||||
const pattern = createPattern(
|
||||
'workaround',
|
||||
problem,
|
||||
message.content,
|
||||
session,
|
||||
i
|
||||
);
|
||||
if (pattern) {
|
||||
patterns.push(pattern);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return patterns;
|
||||
}
|
||||
|
||||
function findConventionPatterns(session: SessionContext): LearnedPattern[] {
|
||||
const patterns: LearnedPattern[] = [];
|
||||
const messages = session.messages;
|
||||
|
||||
const conventionKeywords = [
|
||||
'naming convention',
|
||||
'pattern we use',
|
||||
'standard',
|
||||
'best practice',
|
||||
'we always',
|
||||
'convention',
|
||||
'style guide',
|
||||
];
|
||||
|
||||
for (let i = 0; i < messages.length; i++) {
|
||||
const message = messages[i];
|
||||
if (message.role !== 'assistant') continue;
|
||||
|
||||
const content = message.content.toLowerCase();
|
||||
if (conventionKeywords.some(kw => content.includes(kw))) {
|
||||
const pattern = createPattern(
|
||||
'convention',
|
||||
'Project convention discovered',
|
||||
message.content,
|
||||
session,
|
||||
i
|
||||
);
|
||||
if (pattern) {
|
||||
patterns.push(pattern);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return patterns;
|
||||
}
|
||||
|
||||
function findDebuggingPatterns(session: SessionContext): LearnedPattern[] {
|
||||
const patterns: LearnedPattern[] = [];
|
||||
const messages = session.messages;
|
||||
|
||||
const debugKeywords = [
|
||||
'to debug this',
|
||||
'debugging',
|
||||
'to find the issue',
|
||||
'trace',
|
||||
'breakpoint',
|
||||
'logging',
|
||||
'to diagnose',
|
||||
];
|
||||
|
||||
for (let i = 0; i < messages.length; i++) {
|
||||
const message = messages[i];
|
||||
if (message.role !== 'assistant') continue;
|
||||
|
||||
const content = message.content.toLowerCase();
|
||||
if (debugKeywords.some(kw => content.includes(kw))) {
|
||||
const problem = findPrecedingProblem(messages, i);
|
||||
if (problem) {
|
||||
const pattern = createPattern(
|
||||
'debugging',
|
||||
problem,
|
||||
message.content,
|
||||
session,
|
||||
i
|
||||
);
|
||||
if (pattern) {
|
||||
patterns.push(pattern);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return patterns;
|
||||
}
|
||||
|
||||
function isErrorDescription(content: string): boolean {
|
||||
const errorKeywords = [
|
||||
'error',
|
||||
'fail',
|
||||
'exception',
|
||||
'crash',
|
||||
'not working',
|
||||
'broken',
|
||||
'bug',
|
||||
'issue',
|
||||
'problem',
|
||||
'does not',
|
||||
"doesn't",
|
||||
"can't",
|
||||
'cannot',
|
||||
];
|
||||
|
||||
const lower = content.toLowerCase();
|
||||
return errorKeywords.some(kw => lower.includes(kw));
|
||||
}
|
||||
|
||||
function isSolution(content: string): boolean {
|
||||
const solutionKeywords = [
|
||||
'fix',
|
||||
'solution',
|
||||
'resolve',
|
||||
'change',
|
||||
'update',
|
||||
'modify',
|
||||
'replace',
|
||||
'should be',
|
||||
'try this',
|
||||
'use instead',
|
||||
];
|
||||
|
||||
const lower = content.toLowerCase();
|
||||
return solutionKeywords.some(kw => lower.includes(kw));
|
||||
}
|
||||
|
||||
function findPrecedingProblem(
|
||||
messages: SessionMessage[],
|
||||
currentIndex: number
|
||||
): string | null {
|
||||
for (let i = currentIndex - 1; i >= 0 && i > currentIndex - 5; i--) {
|
||||
const message = messages[i];
|
||||
if (message.role === 'user' && message.content.length > 20) {
|
||||
return message.content;
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
function createPatternFromErrorFix(
|
||||
errorDescription: string,
|
||||
solution: string,
|
||||
session: SessionContext,
|
||||
messageIndex: number
|
||||
): LearnedPattern | null {
|
||||
return createPattern('error_fix', errorDescription, solution, session, messageIndex);
|
||||
}
|
||||
|
||||
function createPattern(
|
||||
category: PatternCategory,
|
||||
problem: string,
|
||||
solution: string,
|
||||
session: SessionContext,
|
||||
messageIndex: number
|
||||
): LearnedPattern | null {
|
||||
if (problem.length < 20 || solution.length < 20) {
|
||||
return null;
|
||||
}
|
||||
|
||||
const id = `session-${Date.now()}-${messageIndex}`;
|
||||
const title = extractTitle(problem, category);
|
||||
|
||||
return {
|
||||
id,
|
||||
category,
|
||||
title,
|
||||
problem: truncate(problem, 500),
|
||||
solution: truncate(solution, 1000),
|
||||
context: session.projectPath,
|
||||
extractedAt: new Date().toISOString(),
|
||||
source: 'session',
|
||||
approved: false,
|
||||
confidence: calculateSessionConfidence(problem, solution, session),
|
||||
};
|
||||
}
|
||||
|
||||
function extractTitle(problem: string, category: PatternCategory): string {
|
||||
const firstSentence = problem.split(/[.!?]/)[0].trim();
|
||||
|
||||
if (firstSentence.length > 80) {
|
||||
return `${category.charAt(0).toUpperCase() + category.slice(1).replace('_', ' ')} pattern`;
|
||||
}
|
||||
|
||||
return firstSentence;
|
||||
}
|
||||
|
||||
function truncate(str: string, maxLen: number): string {
|
||||
if (str.length <= maxLen) return str;
|
||||
return str.slice(0, maxLen - 3) + '...';
|
||||
}
|
||||
|
||||
function calculateSessionConfidence(
|
||||
problem: string,
|
||||
solution: string,
|
||||
_session: SessionContext
|
||||
): number {
|
||||
let confidence = 0.4;
|
||||
|
||||
if (problem.length > 50 && problem.length < 500) {
|
||||
confidence += 0.1;
|
||||
}
|
||||
|
||||
if (solution.length > 100 && solution.length < 1000) {
|
||||
confidence += 0.1;
|
||||
}
|
||||
|
||||
if (solution.includes('```')) {
|
||||
confidence += 0.15;
|
||||
}
|
||||
|
||||
return Math.min(0.85, confidence);
|
||||
}
|
||||
|
||||
export function mergePatterns(
|
||||
existing: LearnedPattern[],
|
||||
newPatterns: LearnedPattern[]
|
||||
): LearnedPattern[] {
|
||||
const merged = [...existing];
|
||||
|
||||
for (const pattern of newPatterns) {
|
||||
const existingIndex = merged.findIndex(p =>
|
||||
p.problem === pattern.problem || p.id === pattern.id
|
||||
);
|
||||
|
||||
if (existingIndex >= 0) {
|
||||
if (pattern.confidence > merged[existingIndex].confidence) {
|
||||
merged[existingIndex] = pattern;
|
||||
}
|
||||
} else {
|
||||
merged.push(pattern);
|
||||
}
|
||||
}
|
||||
|
||||
return merged;
|
||||
}
|
||||
@@ -1,248 +0,0 @@
|
||||
import type { LearnedPattern, EvolvingPattern, PatternStore, PatternDomain } from './types.js';
|
||||
import { loadPatternStore, savePatternStore } from './config.js';
|
||||
|
||||
export interface FeedbackResult {
|
||||
pattern: EvolvingPattern;
|
||||
previousConfidence: number;
|
||||
newConfidence: number;
|
||||
change: 'increased' | 'decreased' | 'unchanged';
|
||||
}
|
||||
|
||||
export function recordSuccess(
|
||||
patternId: string,
|
||||
storePath?: string
|
||||
): FeedbackResult | null {
|
||||
const store = loadPatternStore(storePath);
|
||||
const evolving = findOrCreateEvolvingPattern(store, patternId);
|
||||
|
||||
if (!evolving) return null;
|
||||
|
||||
const previousConfidence = evolving.confidence;
|
||||
|
||||
evolving.useCount++;
|
||||
evolving.successCount++;
|
||||
evolving.lastUsed = new Date().toISOString();
|
||||
evolving.confidence = Math.min(0.95, evolving.confidence + 0.05);
|
||||
|
||||
updateEvolvingPattern(store, evolving);
|
||||
savePatternStore(store, storePath);
|
||||
|
||||
return {
|
||||
pattern: evolving,
|
||||
previousConfidence,
|
||||
newConfidence: evolving.confidence,
|
||||
change: 'increased',
|
||||
};
|
||||
}
|
||||
|
||||
export function recordFailure(
|
||||
patternId: string,
|
||||
storePath?: string
|
||||
): FeedbackResult | null {
|
||||
const store = loadPatternStore(storePath);
|
||||
const evolving = findOrCreateEvolvingPattern(store, patternId);
|
||||
|
||||
if (!evolving) return null;
|
||||
|
||||
const previousConfidence = evolving.confidence;
|
||||
|
||||
evolving.useCount++;
|
||||
evolving.failureCount++;
|
||||
evolving.lastUsed = new Date().toISOString();
|
||||
evolving.confidence = Math.max(0.1, evolving.confidence - 0.1);
|
||||
|
||||
updateEvolvingPattern(store, evolving);
|
||||
savePatternStore(store, storePath);
|
||||
|
||||
return {
|
||||
pattern: evolving,
|
||||
previousConfidence,
|
||||
newConfidence: evolving.confidence,
|
||||
change: 'decreased',
|
||||
};
|
||||
}
|
||||
|
||||
function findOrCreateEvolvingPattern(
|
||||
store: PatternStore,
|
||||
patternId: string
|
||||
): EvolvingPattern | null {
|
||||
let evolving = store.evolvingPatterns.find(p => p.id === patternId);
|
||||
|
||||
if (!evolving) {
|
||||
const basePattern = store.patterns.find(p => p.id === patternId);
|
||||
if (!basePattern) return null;
|
||||
|
||||
evolving = {
|
||||
...basePattern,
|
||||
trigger: inferTrigger(basePattern),
|
||||
action: inferAction(basePattern),
|
||||
useCount: 0,
|
||||
successCount: 0,
|
||||
failureCount: 0,
|
||||
};
|
||||
|
||||
store.evolvingPatterns.push(evolving);
|
||||
}
|
||||
|
||||
return evolving;
|
||||
}
|
||||
|
||||
function updateEvolvingPattern(
|
||||
store: PatternStore,
|
||||
evolving: EvolvingPattern
|
||||
): void {
|
||||
const index = store.evolvingPatterns.findIndex(p => p.id === evolving.id);
|
||||
if (index >= 0) {
|
||||
store.evolvingPatterns[index] = evolving;
|
||||
} else {
|
||||
store.evolvingPatterns.push(evolving);
|
||||
}
|
||||
}
|
||||
|
||||
function inferTrigger(pattern: LearnedPattern): string {
|
||||
const problem = pattern.problem.toLowerCase();
|
||||
|
||||
if (problem.includes('error') || problem.includes('exception')) {
|
||||
return 'When encountering similar errors';
|
||||
}
|
||||
if (problem.includes('build') || problem.includes('compile')) {
|
||||
return 'During build/compilation issues';
|
||||
}
|
||||
if (problem.includes('test')) {
|
||||
return 'When tests fail in similar ways';
|
||||
}
|
||||
|
||||
return `When facing: ${pattern.title}`;
|
||||
}
|
||||
|
||||
function inferAction(pattern: LearnedPattern): string {
|
||||
return pattern.solution.split('\n')[0] || 'Apply learned solution';
|
||||
}
|
||||
|
||||
export function getEvolvingPatternsByDomain(
|
||||
domain: PatternDomain,
|
||||
storePath?: string
|
||||
): EvolvingPattern[] {
|
||||
const store = loadPatternStore(storePath);
|
||||
return store.evolvingPatterns.filter(p => p.domain === domain);
|
||||
}
|
||||
|
||||
export function getHighConfidencePatterns(
|
||||
minConfidence = 0.7,
|
||||
storePath?: string
|
||||
): EvolvingPattern[] {
|
||||
const store = loadPatternStore(storePath);
|
||||
return store.evolvingPatterns
|
||||
.filter(p => p.confidence >= minConfidence)
|
||||
.sort((a, b) => b.confidence - a.confidence);
|
||||
}
|
||||
|
||||
export function getLowConfidencePatterns(
|
||||
maxConfidence = 0.3,
|
||||
storePath?: string
|
||||
): EvolvingPattern[] {
|
||||
const store = loadPatternStore(storePath);
|
||||
return store.evolvingPatterns
|
||||
.filter(p => p.confidence <= maxConfidence)
|
||||
.sort((a, b) => a.confidence - b.confidence);
|
||||
}
|
||||
|
||||
export function getMostUsedPatterns(
|
||||
limit = 10,
|
||||
storePath?: string
|
||||
): EvolvingPattern[] {
|
||||
const store = loadPatternStore(storePath);
|
||||
return store.evolvingPatterns
|
||||
.sort((a, b) => b.useCount - a.useCount)
|
||||
.slice(0, limit);
|
||||
}
|
||||
|
||||
export function getPatternStats(storePath?: string): {
|
||||
total: number;
|
||||
byDomain: Map<string, number>;
|
||||
byConfidenceRange: { high: number; medium: number; low: number };
|
||||
mostUsed: EvolvingPattern | null;
|
||||
leastConfident: EvolvingPattern | null;
|
||||
} {
|
||||
const store = loadPatternStore(storePath);
|
||||
const patterns = store.evolvingPatterns;
|
||||
|
||||
const byDomain = new Map<string, number>();
|
||||
let high = 0, medium = 0, low = 0;
|
||||
|
||||
for (const pattern of patterns) {
|
||||
const domain = pattern.domain || 'unknown';
|
||||
byDomain.set(domain, (byDomain.get(domain) || 0) + 1);
|
||||
|
||||
if (pattern.confidence >= 0.7) high++;
|
||||
else if (pattern.confidence >= 0.4) medium++;
|
||||
else low++;
|
||||
}
|
||||
|
||||
const mostUsed = patterns.length > 0
|
||||
? patterns.reduce((max, p) => p.useCount > max.useCount ? p : max)
|
||||
: null;
|
||||
|
||||
const leastConfident = patterns.length > 0
|
||||
? patterns.reduce((min, p) => p.confidence < min.confidence ? p : min)
|
||||
: null;
|
||||
|
||||
return {
|
||||
total: patterns.length,
|
||||
byDomain,
|
||||
byConfidenceRange: { high, medium, low },
|
||||
mostUsed,
|
||||
leastConfident,
|
||||
};
|
||||
}
|
||||
|
||||
export function approvePattern(
|
||||
patternId: string,
|
||||
storePath?: string
|
||||
): LearnedPattern | null {
|
||||
const store = loadPatternStore(storePath);
|
||||
|
||||
const pattern = store.patterns.find(p => p.id === patternId);
|
||||
if (!pattern) return null;
|
||||
|
||||
pattern.approved = true;
|
||||
|
||||
savePatternStore(store, storePath);
|
||||
return pattern;
|
||||
}
|
||||
|
||||
export function rejectPattern(
|
||||
patternId: string,
|
||||
storePath?: string
|
||||
): boolean {
|
||||
const store = loadPatternStore(storePath);
|
||||
|
||||
const index = store.patterns.findIndex(p => p.id === patternId);
|
||||
if (index < 0) return false;
|
||||
|
||||
store.patterns.splice(index, 1);
|
||||
|
||||
const evolvingIndex = store.evolvingPatterns.findIndex(p => p.id === patternId);
|
||||
if (evolvingIndex >= 0) {
|
||||
store.evolvingPatterns.splice(evolvingIndex, 1);
|
||||
}
|
||||
|
||||
savePatternStore(store, storePath);
|
||||
return true;
|
||||
}
|
||||
|
||||
export function clusterPatterns(
|
||||
patterns: LearnedPattern[]
|
||||
): Map<string, LearnedPattern[]> {
|
||||
const clusters = new Map<string, LearnedPattern[]>();
|
||||
|
||||
for (const pattern of patterns) {
|
||||
const key = pattern.category;
|
||||
if (!clusters.has(key)) {
|
||||
clusters.set(key, []);
|
||||
}
|
||||
clusters.get(key)!.push(pattern);
|
||||
}
|
||||
|
||||
return clusters;
|
||||
}
|
||||
@@ -1,237 +0,0 @@
|
||||
import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import { homedir } from 'node:os';
|
||||
|
||||
import type { LearnedPattern, PatternCategory } from './types.js';
|
||||
|
||||
export interface LearnedSkillOutput {
|
||||
id: string;
|
||||
name: string;
|
||||
filename: string;
|
||||
content: string;
|
||||
patterns: LearnedPattern[];
|
||||
}
|
||||
|
||||
export interface PatternGenerateOptions {
|
||||
outputDir?: string;
|
||||
minConfidence?: number;
|
||||
minPatterns?: number;
|
||||
format?: 'skill' | 'markdown' | 'json';
|
||||
}
|
||||
|
||||
export function generateSkillFromPatterns(
|
||||
patterns: LearnedPattern[],
|
||||
options: PatternGenerateOptions = {}
|
||||
): LearnedSkillOutput | null {
|
||||
const minConfidence = options.minConfidence ?? 0.5;
|
||||
const minPatterns = options.minPatterns ?? 1;
|
||||
|
||||
const eligiblePatterns = patterns.filter(p => p.confidence >= minConfidence);
|
||||
|
||||
if (eligiblePatterns.length < minPatterns) {
|
||||
return null;
|
||||
}
|
||||
|
||||
const category = getMostCommonCategory(eligiblePatterns);
|
||||
const id = `learned-${category}-${Date.now()}`;
|
||||
const name = formatSkillName(category, eligiblePatterns);
|
||||
|
||||
const content = generateSkillContent(name, eligiblePatterns, category);
|
||||
const filename = `${id}.md`;
|
||||
|
||||
return {
|
||||
id,
|
||||
name,
|
||||
filename,
|
||||
content,
|
||||
patterns: eligiblePatterns,
|
||||
};
|
||||
}
|
||||
|
||||
function getMostCommonCategory(patterns: LearnedPattern[]): PatternCategory {
|
||||
const counts = new Map<PatternCategory, number>();
|
||||
|
||||
for (const pattern of patterns) {
|
||||
counts.set(pattern.category, (counts.get(pattern.category) || 0) + 1);
|
||||
}
|
||||
|
||||
let maxCategory: PatternCategory = 'error_fix';
|
||||
let maxCount = 0;
|
||||
|
||||
for (const [category, count] of counts) {
|
||||
if (count > maxCount) {
|
||||
maxCount = count;
|
||||
maxCategory = category;
|
||||
}
|
||||
}
|
||||
|
||||
return maxCategory;
|
||||
}
|
||||
|
||||
function formatSkillName(
|
||||
category: PatternCategory,
|
||||
patterns: LearnedPattern[]
|
||||
): string {
|
||||
const categoryNames: Record<PatternCategory, string> = {
|
||||
error_fix: 'Error Fixes',
|
||||
refactor: 'Refactoring Patterns',
|
||||
workaround: 'Workarounds',
|
||||
debugging: 'Debugging Techniques',
|
||||
convention: 'Project Conventions',
|
||||
};
|
||||
|
||||
const baseName = categoryNames[category];
|
||||
const context = patterns[0]?.context || 'Project';
|
||||
|
||||
return `${baseName} - ${context}`;
|
||||
}
|
||||
|
||||
function generateSkillContent(
|
||||
name: string,
|
||||
patterns: LearnedPattern[],
|
||||
category: PatternCategory
|
||||
): string {
|
||||
const lines: string[] = [];
|
||||
|
||||
lines.push('---');
|
||||
lines.push(`name: ${name.toLowerCase().replace(/\s+/g, '-')}`);
|
||||
lines.push(`description: Learned ${category.replace('_', ' ')} patterns from project history`);
|
||||
lines.push(`category: learned`);
|
||||
lines.push(`source: automated`);
|
||||
lines.push(`generated: ${new Date().toISOString()}`);
|
||||
lines.push(`pattern_count: ${patterns.length}`);
|
||||
lines.push('---');
|
||||
lines.push('');
|
||||
lines.push(`# ${name}`);
|
||||
lines.push('');
|
||||
lines.push('> This skill was automatically generated from learned patterns.');
|
||||
lines.push('');
|
||||
lines.push('## Patterns');
|
||||
lines.push('');
|
||||
|
||||
for (const pattern of patterns) {
|
||||
lines.push(`### ${pattern.title}`);
|
||||
lines.push('');
|
||||
lines.push(`**Category:** ${pattern.category.replace('_', ' ')}`);
|
||||
lines.push(`**Confidence:** ${(pattern.confidence * 100).toFixed(0)}%`);
|
||||
lines.push('');
|
||||
lines.push('**Problem:**');
|
||||
lines.push(pattern.problem);
|
||||
lines.push('');
|
||||
lines.push('**Solution:**');
|
||||
lines.push(pattern.solution);
|
||||
lines.push('');
|
||||
|
||||
if (pattern.example) {
|
||||
lines.push('**Example:**');
|
||||
lines.push('```');
|
||||
lines.push(pattern.example);
|
||||
lines.push('```');
|
||||
lines.push('');
|
||||
}
|
||||
|
||||
lines.push('---');
|
||||
lines.push('');
|
||||
}
|
||||
|
||||
return lines.join('\n');
|
||||
}
|
||||
|
||||
export function saveGeneratedSkill(
|
||||
skill: LearnedSkillOutput,
|
||||
outputDir?: string
|
||||
): string {
|
||||
const dir = outputDir || join(homedir(), '.skillkit', 'skills', 'learned');
|
||||
|
||||
if (!existsSync(dir)) {
|
||||
mkdirSync(dir, { recursive: true });
|
||||
}
|
||||
|
||||
const filepath = join(dir, skill.filename);
|
||||
writeFileSync(filepath, skill.content);
|
||||
|
||||
return filepath;
|
||||
}
|
||||
|
||||
export function generatePatternReport(patterns: LearnedPattern[]): string {
|
||||
const lines: string[] = [];
|
||||
|
||||
lines.push('# Learned Patterns Report');
|
||||
lines.push('');
|
||||
lines.push(`Generated: ${new Date().toISOString()}`);
|
||||
lines.push(`Total Patterns: ${patterns.length}`);
|
||||
lines.push('');
|
||||
|
||||
const byCategory = new Map<PatternCategory, LearnedPattern[]>();
|
||||
for (const pattern of patterns) {
|
||||
if (!byCategory.has(pattern.category)) {
|
||||
byCategory.set(pattern.category, []);
|
||||
}
|
||||
byCategory.get(pattern.category)!.push(pattern);
|
||||
}
|
||||
|
||||
lines.push('## Summary by Category');
|
||||
lines.push('');
|
||||
lines.push('| Category | Count | Avg Confidence |');
|
||||
lines.push('|----------|-------|----------------|');
|
||||
|
||||
for (const [category, catPatterns] of byCategory) {
|
||||
const avgConfidence = catPatterns.reduce((sum, p) => sum + p.confidence, 0) / catPatterns.length;
|
||||
lines.push(`| ${category.replace('_', ' ')} | ${catPatterns.length} | ${(avgConfidence * 100).toFixed(0)}% |`);
|
||||
}
|
||||
|
||||
lines.push('');
|
||||
lines.push('## Patterns');
|
||||
lines.push('');
|
||||
|
||||
const approved = patterns.filter(p => p.approved);
|
||||
const pending = patterns.filter(p => !p.approved);
|
||||
|
||||
if (approved.length > 0) {
|
||||
lines.push('### Approved Patterns');
|
||||
lines.push('');
|
||||
for (const pattern of approved) {
|
||||
lines.push(`- **${pattern.title}** (${pattern.category}, ${(pattern.confidence * 100).toFixed(0)}%)`);
|
||||
}
|
||||
lines.push('');
|
||||
}
|
||||
|
||||
if (pending.length > 0) {
|
||||
lines.push('### Pending Approval');
|
||||
lines.push('');
|
||||
for (const pattern of pending) {
|
||||
lines.push(`- **${pattern.title}** (${pattern.category}, ${(pattern.confidence * 100).toFixed(0)}%)`);
|
||||
}
|
||||
lines.push('');
|
||||
}
|
||||
|
||||
return lines.join('\n');
|
||||
}
|
||||
|
||||
export function exportPatternsAsJson(patterns: LearnedPattern[]): string {
|
||||
return JSON.stringify(
|
||||
{
|
||||
version: 1,
|
||||
exportedAt: new Date().toISOString(),
|
||||
count: patterns.length,
|
||||
patterns,
|
||||
},
|
||||
null,
|
||||
2
|
||||
);
|
||||
}
|
||||
|
||||
export function importPatternsFromJson(jsonContent: string): LearnedPattern[] {
|
||||
try {
|
||||
const data = JSON.parse(jsonContent);
|
||||
if (Array.isArray(data.patterns)) {
|
||||
return data.patterns;
|
||||
}
|
||||
if (Array.isArray(data)) {
|
||||
return data;
|
||||
}
|
||||
return [];
|
||||
} catch {
|
||||
return [];
|
||||
}
|
||||
}
|
||||
@@ -1,356 +0,0 @@
|
||||
import { execSync } from 'node:child_process';
|
||||
import { existsSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
|
||||
import type {
|
||||
GitCommit,
|
||||
GitFileChange,
|
||||
GitAnalysisResult,
|
||||
GitAnalysisSummary,
|
||||
LearnedPattern,
|
||||
PatternCategory,
|
||||
} from './types.js';
|
||||
|
||||
export interface GitAnalysisOptions {
|
||||
commits?: number;
|
||||
since?: string;
|
||||
until?: string;
|
||||
branch?: string;
|
||||
author?: string;
|
||||
}
|
||||
|
||||
function runGitCommand(command: string, cwd: string): string {
|
||||
try {
|
||||
return execSync(command, { cwd, encoding: 'utf-8', maxBuffer: 10 * 1024 * 1024 });
|
||||
} catch {
|
||||
return '';
|
||||
}
|
||||
}
|
||||
|
||||
function isGitRepository(path: string): boolean {
|
||||
return existsSync(join(path, '.git'));
|
||||
}
|
||||
|
||||
export function getGitCommits(
|
||||
repoPath: string,
|
||||
options: GitAnalysisOptions = {}
|
||||
): GitCommit[] {
|
||||
if (!isGitRepository(repoPath)) {
|
||||
return [];
|
||||
}
|
||||
|
||||
const limit = options.commits || 100;
|
||||
const args: string[] = [
|
||||
'log',
|
||||
`--max-count=${limit}`,
|
||||
'--format=%H|||%h|||%an|||%aI|||%s|||%b|||END_COMMIT',
|
||||
'--name-status',
|
||||
];
|
||||
|
||||
if (options.since) {
|
||||
args.push(`--since="${options.since}"`);
|
||||
}
|
||||
if (options.until) {
|
||||
args.push(`--until="${options.until}"`);
|
||||
}
|
||||
if (options.branch) {
|
||||
args.push(options.branch);
|
||||
}
|
||||
if (options.author) {
|
||||
args.push(`--author="${options.author}"`);
|
||||
}
|
||||
|
||||
const output = runGitCommand(`git ${args.join(' ')}`, repoPath);
|
||||
if (!output) return [];
|
||||
|
||||
const commits: GitCommit[] = [];
|
||||
const commitBlocks = output.split('END_COMMIT').filter(b => b.trim());
|
||||
|
||||
for (const block of commitBlocks) {
|
||||
const lines = block.trim().split('\n');
|
||||
if (lines.length === 0) continue;
|
||||
|
||||
const headerLine = lines[0];
|
||||
const parts = headerLine.split('|||');
|
||||
if (parts.length < 5) continue;
|
||||
|
||||
const [hash, shortHash, author, date, message, body] = parts;
|
||||
|
||||
const files: GitFileChange[] = [];
|
||||
for (let i = 1; i < lines.length; i++) {
|
||||
const line = lines[i].trim();
|
||||
if (!line) continue;
|
||||
|
||||
const match = line.match(/^([AMDRT])\d*\t(.+?)(?:\t(.+))?$/);
|
||||
if (match) {
|
||||
const [, status, path, oldPath] = match;
|
||||
files.push({
|
||||
path,
|
||||
status: parseFileStatus(status),
|
||||
additions: 0,
|
||||
deletions: 0,
|
||||
oldPath: oldPath || undefined,
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
commits.push({
|
||||
hash,
|
||||
shortHash,
|
||||
author,
|
||||
date,
|
||||
message,
|
||||
body: body || undefined,
|
||||
files,
|
||||
});
|
||||
}
|
||||
|
||||
return commits;
|
||||
}
|
||||
|
||||
function parseFileStatus(status: string): GitFileChange['status'] {
|
||||
switch (status) {
|
||||
case 'A': return 'added';
|
||||
case 'D': return 'deleted';
|
||||
case 'R': return 'renamed';
|
||||
default: return 'modified';
|
||||
}
|
||||
}
|
||||
|
||||
function categorizeCommit(message: string, body?: string): PatternCategory | null {
|
||||
const text = `${message} ${body || ''}`.toLowerCase();
|
||||
|
||||
if (text.includes('fix') || text.includes('bug') || text.includes('error') || text.includes('issue')) {
|
||||
return 'error_fix';
|
||||
}
|
||||
|
||||
if (text.includes('refactor') || text.includes('clean') || text.includes('simplify')) {
|
||||
return 'refactor';
|
||||
}
|
||||
|
||||
if (text.includes('workaround') || text.includes('hack') || text.includes('temporary')) {
|
||||
return 'workaround';
|
||||
}
|
||||
|
||||
if (text.includes('debug') || text.includes('log') || text.includes('trace')) {
|
||||
return 'debugging';
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
function shouldSkipCommit(commit: GitCommit, ignorePatterns: string[]): boolean {
|
||||
const message = commit.message.toLowerCase();
|
||||
|
||||
for (const pattern of ignorePatterns) {
|
||||
if (message.includes(pattern.toLowerCase())) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
if (message.startsWith('merge ') || message.startsWith('wip')) {
|
||||
return true;
|
||||
}
|
||||
|
||||
if (commit.files.length === 0) {
|
||||
return true;
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
function extractPatternFromCommit(commit: GitCommit): LearnedPattern | null {
|
||||
const category = categorizeCommit(commit.message, commit.body);
|
||||
if (!category) return null;
|
||||
|
||||
const id = `git-${commit.shortHash}`;
|
||||
const title = formatTitle(commit.message);
|
||||
const problem = extractProblem(commit);
|
||||
const solution = extractSolution(commit);
|
||||
const context = extractContext(commit);
|
||||
|
||||
if (!problem || !solution) return null;
|
||||
|
||||
return {
|
||||
id,
|
||||
category,
|
||||
title,
|
||||
problem,
|
||||
solution,
|
||||
context,
|
||||
extractedAt: new Date().toISOString(),
|
||||
source: 'git',
|
||||
commitRange: { from: commit.hash, to: commit.hash },
|
||||
approved: false,
|
||||
confidence: calculateConfidence(commit, category),
|
||||
};
|
||||
}
|
||||
|
||||
function formatTitle(message: string): string {
|
||||
return message.charAt(0).toUpperCase() + message.slice(1);
|
||||
}
|
||||
|
||||
function extractProblem(commit: GitCommit): string {
|
||||
const message = commit.message.toLowerCase();
|
||||
|
||||
if (message.includes('fix:') || message.includes('fix(')) {
|
||||
const match = commit.message.match(/fix[:(]\s*([^)]+)/i);
|
||||
if (match) {
|
||||
return `Issue: ${match[1]}`;
|
||||
}
|
||||
}
|
||||
|
||||
if (commit.body) {
|
||||
const problemMatch = commit.body.match(/problem:?\s*(.+)/i);
|
||||
if (problemMatch) {
|
||||
return problemMatch[1].trim();
|
||||
}
|
||||
}
|
||||
|
||||
return `${commit.message} (from commit ${commit.shortHash})`;
|
||||
}
|
||||
|
||||
function extractSolution(commit: GitCommit): string {
|
||||
if (commit.body) {
|
||||
const solutionMatch = commit.body.match(/solution:?\s*(.+)/i);
|
||||
if (solutionMatch) {
|
||||
return solutionMatch[1].trim();
|
||||
}
|
||||
}
|
||||
|
||||
const files = commit.files.map(f => f.path).join(', ');
|
||||
return `Modified: ${files}`;
|
||||
}
|
||||
|
||||
function extractContext(commit: GitCommit): string {
|
||||
const files = commit.files;
|
||||
const extensions = new Set(files.map(f => f.path.split('.').pop() || ''));
|
||||
const directories = new Set(files.map(f => f.path.split('/')[0]));
|
||||
|
||||
const parts: string[] = [];
|
||||
|
||||
if (extensions.size > 0) {
|
||||
parts.push(`Files: ${Array.from(extensions).filter(e => e).join(', ')}`);
|
||||
}
|
||||
|
||||
if (directories.size > 0 && directories.size <= 3) {
|
||||
parts.push(`Areas: ${Array.from(directories).join(', ')}`);
|
||||
}
|
||||
|
||||
return parts.join('. ') || 'General codebase';
|
||||
}
|
||||
|
||||
function calculateConfidence(commit: GitCommit, category: PatternCategory): number {
|
||||
let confidence = 0.5;
|
||||
|
||||
if (commit.body && commit.body.length > 50) {
|
||||
confidence += 0.1;
|
||||
}
|
||||
|
||||
if (commit.message.match(/^(fix|feat|refactor|docs|test|chore)(\(.+\))?:/)) {
|
||||
confidence += 0.1;
|
||||
}
|
||||
|
||||
if (commit.files.length > 0 && commit.files.length < 10) {
|
||||
confidence += 0.1;
|
||||
}
|
||||
|
||||
if (category === 'error_fix' || category === 'workaround') {
|
||||
confidence += 0.05;
|
||||
}
|
||||
|
||||
return Math.min(0.9, confidence);
|
||||
}
|
||||
|
||||
export function analyzeGitHistory(
|
||||
repoPath: string,
|
||||
options: GitAnalysisOptions = {}
|
||||
): GitAnalysisResult {
|
||||
const commits = getGitCommits(repoPath, options);
|
||||
const ignorePatterns = ['merge', 'wip', 'typo'];
|
||||
|
||||
const patterns: LearnedPattern[] = [];
|
||||
const summary: GitAnalysisSummary = {
|
||||
totalCommits: commits.length,
|
||||
totalFilesChanged: 0,
|
||||
errorFixes: 0,
|
||||
refactors: 0,
|
||||
features: 0,
|
||||
documentation: 0,
|
||||
tests: 0,
|
||||
};
|
||||
|
||||
const languages = new Set<string>();
|
||||
const frameworks = new Set<string>();
|
||||
|
||||
for (const commit of commits) {
|
||||
if (shouldSkipCommit(commit, ignorePatterns)) {
|
||||
continue;
|
||||
}
|
||||
|
||||
summary.totalFilesChanged += commit.files.length;
|
||||
|
||||
for (const file of commit.files) {
|
||||
const ext = file.path.split('.').pop()?.toLowerCase();
|
||||
if (ext) {
|
||||
if (['ts', 'tsx'].includes(ext)) languages.add('TypeScript');
|
||||
else if (['js', 'jsx'].includes(ext)) languages.add('JavaScript');
|
||||
else if (ext === 'py') languages.add('Python');
|
||||
else if (ext === 'go') languages.add('Go');
|
||||
else if (ext === 'rs') languages.add('Rust');
|
||||
else if (ext === 'java') languages.add('Java');
|
||||
}
|
||||
|
||||
if (file.path.includes('next')) frameworks.add('Next.js');
|
||||
if (file.path.includes('react')) frameworks.add('React');
|
||||
if (file.path.includes('vue')) frameworks.add('Vue');
|
||||
}
|
||||
|
||||
const category = categorizeCommit(commit.message, commit.body);
|
||||
if (category === 'error_fix') summary.errorFixes++;
|
||||
else if (category === 'refactor') summary.refactors++;
|
||||
|
||||
if (commit.message.toLowerCase().includes('feat')) summary.features++;
|
||||
if (commit.message.toLowerCase().includes('doc')) summary.documentation++;
|
||||
if (commit.message.toLowerCase().includes('test')) summary.tests++;
|
||||
|
||||
const pattern = extractPatternFromCommit(commit);
|
||||
if (pattern) {
|
||||
patterns.push(pattern);
|
||||
}
|
||||
}
|
||||
|
||||
const dates = commits.map(c => c.date).sort();
|
||||
|
||||
return {
|
||||
patterns,
|
||||
commitCount: commits.length,
|
||||
dateRange: {
|
||||
from: dates[0] || '',
|
||||
to: dates[dates.length - 1] || '',
|
||||
},
|
||||
languages: Array.from(languages),
|
||||
frameworks: Array.from(frameworks),
|
||||
summary,
|
||||
};
|
||||
}
|
||||
|
||||
export function getRecentBugFixes(
|
||||
repoPath: string,
|
||||
limit = 20
|
||||
): LearnedPattern[] {
|
||||
const result = analyzeGitHistory(repoPath, { commits: limit * 3 });
|
||||
return result.patterns
|
||||
.filter(p => p.category === 'error_fix')
|
||||
.slice(0, limit);
|
||||
}
|
||||
|
||||
export function getRecentRefactors(
|
||||
repoPath: string,
|
||||
limit = 20
|
||||
): LearnedPattern[] {
|
||||
const result = analyzeGitHistory(repoPath, { commits: limit * 3 });
|
||||
return result.patterns
|
||||
.filter(p => p.category === 'refactor')
|
||||
.slice(0, limit);
|
||||
}
|
||||
@@ -1,6 +0,0 @@
|
||||
export * from './types.js';
|
||||
export * from './config.js';
|
||||
export * from './git-analyzer.js';
|
||||
export * from './extractor.js';
|
||||
export * from './generator.js';
|
||||
export * from './feedback.js';
|
||||
@@ -1,108 +0,0 @@
|
||||
export type PatternCategory =
|
||||
| 'error_fix'
|
||||
| 'refactor'
|
||||
| 'workaround'
|
||||
| 'debugging'
|
||||
| 'convention';
|
||||
|
||||
export type PatternDomain =
|
||||
| 'code-style'
|
||||
| 'testing'
|
||||
| 'git'
|
||||
| 'debugging'
|
||||
| 'workflow'
|
||||
| 'security'
|
||||
| 'performance';
|
||||
|
||||
export interface LearnedPattern {
|
||||
id: string;
|
||||
category: PatternCategory;
|
||||
domain?: PatternDomain;
|
||||
title: string;
|
||||
problem: string;
|
||||
solution: string;
|
||||
example?: string;
|
||||
context: string;
|
||||
extractedAt: string;
|
||||
source: 'git' | 'session' | 'manual';
|
||||
commitRange?: { from: string; to: string };
|
||||
approved: boolean;
|
||||
confidence: number;
|
||||
}
|
||||
|
||||
export interface EvolvingPattern extends LearnedPattern {
|
||||
trigger: string;
|
||||
action: string;
|
||||
useCount: number;
|
||||
successCount: number;
|
||||
failureCount: number;
|
||||
lastUsed?: string;
|
||||
}
|
||||
|
||||
export interface LearningConfig {
|
||||
minSessionLength: number;
|
||||
sensitivity: 'low' | 'medium' | 'high';
|
||||
autoApprove: boolean;
|
||||
outputPath: string;
|
||||
categories: PatternCategory[];
|
||||
ignorePatterns: string[];
|
||||
}
|
||||
|
||||
export interface GitCommit {
|
||||
hash: string;
|
||||
shortHash: string;
|
||||
author: string;
|
||||
date: string;
|
||||
message: string;
|
||||
body?: string;
|
||||
files: GitFileChange[];
|
||||
}
|
||||
|
||||
export interface GitFileChange {
|
||||
path: string;
|
||||
status: 'added' | 'modified' | 'deleted' | 'renamed';
|
||||
additions: number;
|
||||
deletions: number;
|
||||
oldPath?: string;
|
||||
}
|
||||
|
||||
export interface GitAnalysisResult {
|
||||
patterns: LearnedPattern[];
|
||||
commitCount: number;
|
||||
dateRange: { from: string; to: string };
|
||||
languages: string[];
|
||||
frameworks: string[];
|
||||
summary: GitAnalysisSummary;
|
||||
}
|
||||
|
||||
export interface GitAnalysisSummary {
|
||||
totalCommits: number;
|
||||
totalFilesChanged: number;
|
||||
errorFixes: number;
|
||||
refactors: number;
|
||||
features: number;
|
||||
documentation: number;
|
||||
tests: number;
|
||||
}
|
||||
|
||||
export interface PatternExtractionResult {
|
||||
patterns: LearnedPattern[];
|
||||
skipped: { reason: string; commit?: string }[];
|
||||
errors: string[];
|
||||
}
|
||||
|
||||
export interface PatternStore {
|
||||
version: number;
|
||||
updatedAt: string;
|
||||
patterns: LearnedPattern[];
|
||||
evolvingPatterns: EvolvingPattern[];
|
||||
}
|
||||
|
||||
export const DEFAULT_LEARNING_CONFIG: LearningConfig = {
|
||||
minSessionLength: 10,
|
||||
sensitivity: 'medium',
|
||||
autoApprove: false,
|
||||
outputPath: '~/.skillkit/learned/',
|
||||
categories: ['error_fix', 'refactor', 'workaround', 'debugging', 'convention'],
|
||||
ignorePatterns: ['trivial_typo', 'one_off_fix', 'wip', 'merge'],
|
||||
};
|
||||
@@ -7,7 +7,7 @@
|
||||
*
|
||||
* Key features:
|
||||
* - Methodology packs: Collections of related skills (testing, debugging, planning)
|
||||
* - Universal translation: Skills work across all 32 supported agents
|
||||
* - Universal translation: Skills work across all 17 supported agents
|
||||
* - Pack management: Install, uninstall, and sync methodology skills
|
||||
* - Community-driven: Open for custom methodology contributions
|
||||
*/
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user