Compare commits

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

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

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

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

Source: https://deepwiki.com/rohitg00/skillkit
2026-01-28 15:41:26 +00:00
69 changed files with 218 additions and 4154 deletions
-42
View File
@@ -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 -->
+1 -1
View File
@@ -83,7 +83,7 @@ body:
options:
- label: Repository is public
required: true
- label: SKILL.md follows the agenstskills.com standard format
- label: SKILL.md follows the agentskills.io standard format
required: true
- label: Skill has been tested with at least one AI agent
required: false
+1 -2
View File
@@ -63,5 +63,4 @@ skillkit.yaml
# Project documentation (not for version control)
CLAUDE.md
prd.md
.vercel
prd.md
+1 -1
View File
@@ -206,7 +206,7 @@ To add support for a new AI coding agent:
If you want to contribute skills to the ecosystem:
1. Follow the [Agent Skills specification](https://agenstskills.com)
1. Follow the [Agent Skills specification](https://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
+16 -126
View File
@@ -12,12 +12,11 @@
[![GitHub Package](https://img.shields.io/badge/GitHub%20Package-@rohitg00/skillkit-blue?logo=github)](https://github.com/rohitg00/skillkit/pkgs/npm/skillkit)
[![CI](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml/badge.svg)](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
[![Website](https://img.shields.io/badge/Website-agenstskills.com-black)](https://agenstskills.com)
[![Docs](https://img.shields.io/badge/Docs-agenstskills.com/docs-blue)](https://agenstskills.com/docs)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](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.
@@ -119,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
@@ -241,7 +240,7 @@ skillkit cicd gitlab-ci
skillkit cicd pre-commit
```
## Supported Agents (32)
## Supported Agents (17)
| Agent | Format | Skills Directory |
|-------|--------|------------------|
@@ -262,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
@@ -288,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
@@ -301,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
@@ -313,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
@@ -354,60 +317,20 @@ skillkit memory compress # Compress observations
skillkit memory export # Export as skill
```
### 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
@@ -420,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
---
@@ -492,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
@@ -577,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)
+3 -5
View File
@@ -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 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit",
"version": "1.7.11",
"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": {
+1 -2
View File
@@ -48,6 +48,7 @@ import {
AgentTranslateCommand,
AgentSyncCommand,
AgentValidateCommand,
// New commands (Phase 21)
CheckCommand,
FindCommand,
ManifestCommand,
@@ -56,7 +57,6 @@ import {
ManifestRemoveCommand,
ManifestInstallCommand,
ManifestGenerateCommand,
PrimerCommand,
} from '@skillkit/cli';
const __filename = fileURLToPath(import.meta.url);
@@ -127,6 +127,5 @@ cli.register(ManifestAddCommand);
cli.register(ManifestRemoveCommand);
cli.register(ManifestInstallCommand);
cli.register(ManifestGenerateCommand);
cli.register(PrimerCommand);
cli.runExit(process.argv.slice(2));
-1
View File
@@ -4,4 +4,3 @@ node_modules/
out/
.turbo/
*.tsbuildinfo
.vercel
-3
View File
@@ -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);
Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.0 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 437 B

-4
View File
@@ -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

-30
View File
@@ -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>
+1 -1
View File
@@ -18,7 +18,7 @@ export function Footer(): React.ReactElement {
</p>
<span className="hidden sm:inline text-zinc-700">•</span>
<a
href="https://agenstskills.com"
href="https://agentskills.io"
target="_blank"
rel="noopener noreferrer"
className="text-zinc-600 hover:text-zinc-400 text-xs font-mono transition-colors"
+6 -6
View File
@@ -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>
+13
View File
@@ -0,0 +1,13 @@
{
"$schema": "https://turbo.build/schema.json",
"extends": [],
"tasks": {
"build": {
"outputs": [".next/**", "!.next/cache/**"]
},
"dev": {
"cache": false,
"persistent": true
}
}
}
+5 -127
View File
@@ -6,9 +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';
const GITHUB_ICON = (
<svg className="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
@@ -27,58 +24,19 @@ function scrollToTop(e: React.MouseEvent): void {
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">
<a
href="#stack"
onClick={(e) => scrollToSection(e, 'stack')}
className="text-zinc-500 hover:text-white transition-colors"
>
Stack
</a>
<a
href="#trending"
onClick={(e) => scrollToSection(e, 'trending')}
className="text-zinc-500 hover:text-white transition-colors"
>
Trending
</a>
<a
href="#skills"
onClick={(e) => scrollToSection(e, 'skills')}
className="text-zinc-500 hover:text-white transition-colors"
>
Find Skills
</a>
<a
href="#sources"
onClick={(e) => scrollToSection(e, 'sources')}
className="text-zinc-500 hover:text-white transition-colors"
>
Sources
</a>
</div>
<div className="flex items-center gap-2 sm:gap-4">
<a
href="https://agenstskills.com/docs"
href="https://agentskills.com/docs"
className="text-zinc-400 hover:text-white transition-colors text-sm font-mono hidden sm:block"
>
Docs
@@ -108,91 +66,15 @@ export default function App(): React.ReactElement {
<main className="pt-14">
<Hero />
<div className="border-b border-zinc-800 py-4 bg-zinc-950">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="flex flex-wrap items-center justify-center gap-3 sm:gap-4">
<a
href="https://www.npmjs.com/package/skillkit"
target="_blank"
rel="noopener noreferrer"
className="flex items-center"
>
<img
src="https://img.shields.io/npm/v/skillkit.svg?style=flat&color=white&labelColor=000000"
alt="npm version"
className="h-5"
/>
</a>
<a
href="https://www.npmjs.com/package/skillkit"
target="_blank"
rel="noopener noreferrer"
className="flex items-center"
>
<img
src="https://img.shields.io/npm/dt/skillkit.svg?style=flat&color=white&labelColor=000000"
alt="npm downloads"
className="h-5"
/>
</a>
<a
href="https://github.com/rohitg00/skillkit"
target="_blank"
rel="noopener noreferrer"
className="flex items-center"
>
<img
src="https://img.shields.io/github/stars/rohitg00/skillkit?style=flat&color=white&labelColor=000000"
alt="GitHub stars"
className="h-5"
/>
</a>
<a
href="https://github.com/rohitg00/skillkit/blob/main/LICENSE"
target="_blank"
rel="noopener noreferrer"
className="flex items-center"
>
<img
src="https://img.shields.io/badge/License-Apache%202.0-white?style=flat&labelColor=000000"
alt="License"
className="h-5"
/>
</a>
<a
href="https://github.com/rohitg00/skillkit"
target="_blank"
rel="noopener noreferrer"
className="flex items-center"
>
<img
src="https://img.shields.io/badge/PRs-welcome-white?style=flat&labelColor=000000"
alt="PRs Welcome"
className="h-5"
/>
</a>
</div>
</div>
</div>
<Agents />
<Features />
<Commands />
<section id="stack" style={{ scrollMarginTop: '4rem' }}>
<StackBuilder />
</section>
<section id="trending" style={{ scrollMarginTop: '4rem' }}>
<TrendingSkills />
</section>
<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>
<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>
@@ -203,10 +85,6 @@ export default function App(): React.ReactElement {
<SkillSubmitForm />
</div>
</section>
<section id="sources" style={{ scrollMarginTop: '4rem' }}>
<Attribution />
</section>
</main>
<Footer />
-280
View File
@@ -1,280 +0,0 @@
import React from 'react';
interface SkillSource {
name: string;
repo: string;
description: string;
official?: boolean;
license?: string;
skillCount?: string;
}
const SKILL_SOURCES: SkillSource[] = [
{
name: 'Anthropic Official',
repo: 'anthropics/skills',
description: 'Official Claude Code skills from Anthropic',
official: true,
license: 'Apache 2.0',
skillCount: '21+',
},
{
name: 'Vercel Labs',
repo: 'vercel-labs/agent-skills',
description: 'Next.js, React, and Vercel platform skills',
official: true,
license: 'MIT',
skillCount: '15+',
},
{
name: 'Expo / React Native',
repo: 'expo/skills',
description: 'Mobile development with Expo and React Native',
official: true,
license: 'MIT',
skillCount: '12+',
},
{
name: 'Remotion Video',
repo: 'remotion-dev/skills',
description: 'Programmatic video creation with React',
official: true,
license: 'MIT',
skillCount: '8+',
},
{
name: 'Supabase',
repo: 'supabase/agent-skills',
description: 'Database, auth, and backend skills',
official: true,
license: 'Apache 2.0',
skillCount: '10+',
},
{
name: 'Stripe Payments',
repo: 'stripe/ai',
description: 'Payment integration and Stripe API patterns',
official: true,
license: 'MIT',
skillCount: '8+',
},
{
name: 'Trail of Bits Security',
repo: 'trailofbits/skills',
description: 'Security analysis, auditing, and vulnerability detection',
license: 'Apache 2.0',
skillCount: '25+',
},
{
name: 'Superpowers TDD',
repo: 'obra/superpowers',
description: 'Test-driven development and workflow automation by Jesse Obra',
license: 'MIT',
skillCount: '14+',
},
{
name: 'Dev Patterns',
repo: 'wshobson/agents',
description: 'Development patterns and agent configurations',
license: 'MIT',
skillCount: '48+',
},
{
name: 'Composio Awesome',
repo: 'ComposioHQ/awesome-claude-skills',
description: 'Curated collection of Claude Code skills',
license: 'MIT',
},
{
name: 'Travis Awesome',
repo: 'travisvn/awesome-claude-skills',
description: 'Community-curated skill collection',
license: 'MIT',
},
{
name: 'Skills Marketplace',
repo: 'mhattingpete/claude-skills-marketplace',
description: 'Community skill marketplace',
license: 'MIT',
},
{
name: 'Dify Frontend',
repo: 'langgenius/dify',
description: 'AI application development platform patterns',
license: 'Apache 2.0',
},
{
name: 'Better Auth',
repo: 'better-auth/skills',
description: 'Authentication and authorization patterns',
license: 'MIT',
},
{
name: 'Nuxt / Vue',
repo: 'onmax/nuxt-skills',
description: 'Vue.js and Nuxt framework skills',
license: 'MIT',
},
{
name: 'ElysiaJS / Bun',
repo: 'elysiajs/skills',
description: 'Bun runtime and ElysiaJS framework',
license: 'MIT',
},
{
name: 'NestJS',
repo: 'kadajett/agent-nestjs-skills',
description: 'NestJS backend framework patterns',
license: 'MIT',
},
{
name: 'Three.js',
repo: 'cloudai-x/threejs-skills',
description: '3D graphics and WebGL development',
license: 'MIT',
},
{
name: 'SwiftUI iOS',
repo: 'dimillian/skills',
description: 'iOS and SwiftUI development patterns',
license: 'MIT',
},
{
name: 'Convex Backend',
repo: 'waynesutton/convexskills',
description: 'Convex backend development',
license: 'MIT',
},
{
name: 'Obsidian Notes',
repo: 'kepano/obsidian-skills',
description: 'Obsidian plugin and vault management',
license: 'MIT',
},
{
name: 'Shadcn / Radix',
repo: 'giuseppe-trisciuoglio/developer-kit',
description: 'UI component libraries and design systems',
license: 'MIT',
},
{
name: 'OpenRouter SDK',
repo: 'openrouterteam/agent-skills',
description: 'OpenRouter API integration patterns',
license: 'MIT',
},
{
name: 'Context7',
repo: 'intellectronica/agent-skills',
description: 'Context management and documentation tools',
license: 'MIT',
},
];
export function Attribution(): React.ReactElement {
const officialSources = SKILL_SOURCES.filter(s => s.official);
const communitySources = SKILL_SOURCES.filter(s => !s.official);
return (
<section className="py-12 border-b border-zinc-800 bg-black">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="text-center mb-6 sm:mb-8">
<h2 className="text-lg sm:text-xl font-bold text-white mb-2 font-mono">Skill Sources</h2>
<p className="text-zinc-500 font-mono text-[10px] sm:text-xs max-w-2xl mx-auto px-2">
SkillKit aggregates skills from trusted sources. We credit and link back to all original creators.
Each source retains its original license.
</p>
</div>
<div className="mb-6 sm:mb-8">
<h3 className="text-xs sm:text-sm font-mono text-zinc-400 uppercase tracking-wider mb-3 sm:mb-4 flex items-center gap-2">
<span className="w-2 h-2 bg-blue-500 rounded-full"></span>
Official Partner Sources
</h3>
<div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-2 sm:gap-3">
{officialSources.map(source => (
<a
key={source.repo}
href={`https://github.com/${source.repo}`}
target="_blank"
rel="noopener noreferrer"
className="group bg-zinc-900/50 border border-zinc-800 p-3 sm:p-4 hover:border-blue-800 hover:bg-blue-950/20 transition-all"
>
<div className="flex items-start justify-between mb-1 sm:mb-2">
<div className="font-mono text-xs sm:text-sm text-white group-hover:text-blue-400 transition-colors">
{source.name}
</div>
{source.skillCount && (
<span className="text-[9px] sm:text-[10px] bg-blue-900/50 text-blue-400 px-1 sm:px-1.5 py-0.5 border border-blue-800/50">
{source.skillCount}
</span>
)}
</div>
<div className="text-[10px] sm:text-xs text-zinc-600 mb-2 line-clamp-2">{source.description}</div>
<div className="flex items-center gap-1 sm:gap-2 text-[9px] sm:text-[10px] text-zinc-700">
<svg className="w-3 h-3 flex-shrink-0" fill="currentColor" viewBox="0 0 24 24">
<path fillRule="evenodd" d="M12 2C6.477 2 2 6.484 2 12.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.531 1.032 1.531 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0112 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.202 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.943.359.309.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482A10.019 10.019 0 0022 12.017C22 6.484 17.522 2 12 2z" clipRule="evenodd" />
</svg>
<span className="font-mono truncate">{source.repo}</span>
{source.license && (
<>
<span className="hidden sm:inline">•</span>
<span className="hidden sm:inline">{source.license}</span>
</>
)}
</div>
</a>
))}
</div>
</div>
<div>
<h3 className="text-xs sm:text-sm font-mono text-zinc-400 uppercase tracking-wider mb-3 sm:mb-4 flex items-center gap-2">
<span className="w-2 h-2 bg-purple-500 rounded-full"></span>
Community Contributors
</h3>
<div className="grid grid-cols-2 sm:grid-cols-2 lg:grid-cols-4 gap-2">
{communitySources.map(source => (
<a
key={source.repo}
href={`https://github.com/${source.repo}`}
target="_blank"
rel="noopener noreferrer"
className="group bg-zinc-900/30 border border-zinc-800 p-2 sm:p-3 hover:border-purple-800/50 hover:bg-purple-950/10 transition-all"
>
<div className="flex items-center justify-between mb-0.5 sm:mb-1">
<div className="font-mono text-[10px] sm:text-xs text-white group-hover:text-purple-400 transition-colors truncate">
{source.name}
</div>
{source.skillCount && (
<span className="text-[8px] sm:text-[9px] bg-purple-900/30 text-purple-500 px-1 py-0.5 flex-shrink-0 ml-1">
{source.skillCount}
</span>
)}
</div>
<div className="text-[9px] sm:text-[10px] text-zinc-600 truncate">{source.repo}</div>
</a>
))}
</div>
</div>
<div className="mt-6 sm:mt-8 pt-4 sm:pt-6 border-t border-zinc-800 text-center">
<p className="text-zinc-600 text-[10px] sm:text-xs font-mono mb-2 sm:mb-3">
Want to add your skills to SkillKit?
</p>
<a
href="https://github.com/rohitg00/skillkit/issues/new?template=add-source.md"
target="_blank"
rel="noopener noreferrer"
className="inline-flex items-center gap-1.5 sm:gap-2 bg-zinc-900 text-zinc-400 px-3 sm:px-4 py-1.5 sm:py-2 font-mono text-[10px] sm:text-xs border border-zinc-800 hover:border-zinc-600 hover:text-white transition-colors"
>
<svg className="w-3 h-3 sm:w-4 sm:h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M12 6v6m0 0v6m0-6h6m-6 0H6" />
</svg>
Add Your Repository
</a>
</div>
</div>
</section>
);
}
+1 -2
View File
@@ -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}
+25 -27
View File
@@ -7,39 +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: 'recommend', desc: 'Get suggestions for your project' },
{ cmd: 'find <query>', desc: 'Search 15K+ 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' },
],
},
{
name: 'Team',
commands: [
{ cmd: 'manifest init', desc: 'Create .skills file' },
{ 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' },
],
},
{
name: 'Advanced',
commands: [
{ cmd: 'primer', desc: 'Generate CLAUDE.md from code' },
{ cmd: 'agent translate', desc: 'Batch convert agents' },
{ cmd: 'ui', desc: 'Launch terminal UI' },
{ cmd: 'workflow run', desc: 'Execute skill pipelines' },
{ cmd: 'command generate', desc: 'Create /slash commands' },
{ cmd: 'memory export', desc: 'Save session learnings' },
{ cmd: 'cicd init', desc: 'Generate CI templates' },
],
},
];
@@ -58,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
@@ -68,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>
@@ -76,26 +76,24 @@ export function Commands(): React.ReactElement {
})}
</div>
<div className="border border-zinc-800 bg-black/50 p-2 sm:p-4 font-mono text-[10px] sm:text-xs">
<div className="grid grid-cols-1 sm:grid-cols-2 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-1.5 sm:p-2 hover:bg-zinc-900/50 transition-colors rounded"
key={c.cmd}
className="flex items-center gap-3 p-2 hover:bg-zinc-900/50 transition-colors rounded"
>
<span className="text-zinc-600">$</span>
<span className="text-white text-[10px] sm:text-xs">
{c.cmd ? `skillkit ${c.cmd}` : 'npx skillkit@latest'}
</span>
<span className="text-zinc-600 ml-auto">→</span>
<span className="text-zinc-500 truncate max-w-[80px] sm:max-w-none">{c.desc}</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
+1 -10
View File
@@ -7,15 +7,6 @@ interface Feature {
}
const FEATURES: Feature[] = [
{
title: 'Primer',
description: 'Generate AI instructions from codebase analysis.',
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" />
</svg>
)
},
{
title: 'Multi-Agent',
description: 'Deploy to 32 AI coding agents with one command.',
@@ -74,10 +65,10 @@ const FEATURES: Feature[] = [
const COMPARISONS = [
['Agents', '1', '32'],
['Instructions', 'Manual', 'Primer Auto'],
['Translation', 'Manual', 'Auto'],
['Sharing', 'Copy/paste', '.skills manifest'],
['Discovery', 'Forums', 'CLI + AI'],
['CI/CD', 'Custom', 'Templates'],
] as const;
export function Features(): React.ReactElement {
+2 -2
View File
@@ -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"
+20 -19
View File
@@ -2,12 +2,11 @@ import React, { useState, useEffect } from 'react';
import { Button } from './Button';
const ASCII_LOGO = `
███████╗██╗ ██╗██╗██╗ ██╗ ██╗ ██╗██╗████████╗
██╔════╝██║ ██╔╝██║██║ ██║ ██║ ██╔╝██║╚══██╔══╝
███████╗█████╔╝ ██║██║ ██║ █████╔╝ ██║ ██║
╚════██║██╔═██╗ ██║██║ ██║ ██╔═██╗ ██║ ██║
███████║██║ ██╗██║███████╗███████╗██║ ██╗██║ ██║
╚══════╝╚═╝ ╚═╝╚═╝╚══════╝╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝
███████ ██ ██ ██ ██ ██ ██ ██ ██ ████████
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
███████ █████ ██ ██ ██ █████ ██ ██
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
███████ ██ ██ ██ ███████ ███████ ██ ██ ██ ██
`.trim();
interface TerminalLine {
@@ -16,15 +15,17 @@ interface TerminalLine {
}
const TERMINAL_LINES: TerminalLine[] = [
{ type: 'cmd', text: 'skillkit recommend' },
{ type: 'out', text: ' 92% react-best-practices' },
{ type: 'out', text: ' 87% typescript-strict' },
{ 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: '→ Installed 3 skills' },
{ type: 'cmd', text: 'skillkit sync --agent cursor,claude' },
{ type: 'out', text: ' ✓ Synced to 2 agents' },
{ type: 'cmd', text: 'skillkit translate my-skill --to codex' },
{ type: 'out', text: '→ Converted to SKILL.md format' },
{ 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 = `
@@ -115,16 +116,16 @@ 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.7.11</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">
@@ -161,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">
@@ -170,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' ? (
+12 -12
View File
@@ -464,11 +464,11 @@ ${skillContent.slice(0, 4000)}${skillContent.length > 4000 ? '\n...(truncated)'
{status === LoadingState.LOADING ? (
<div className="text-zinc-500 font-mono text-sm">Loading content...</div>
) : skillContent ? (
<pre className="border border-zinc-700 p-4 sm:p-6 overflow-x-auto text-xs sm:text-sm max-h-[600px] overflow-y-auto max-w-full" style={{ backgroundColor: '#18181b' }}>
<code className="font-mono whitespace-pre-wrap break-words" style={{ color: '#f4f4f5' }}>{skillContent}</code>
<pre className="bg-zinc-900 border border-zinc-700 p-6 overflow-x-auto text-sm max-h-[600px] overflow-y-auto">
<code className="text-zinc-100 font-mono whitespace-pre-wrap">{skillContent}</code>
</pre>
) : (
<div className="border border-zinc-800 p-6" style={{ backgroundColor: '#09090b' }}>
<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>
@@ -488,9 +488,9 @@ ${skillContent.slice(0, 4000)}${skillContent.length > 4000 ? '\n...(truncated)'
<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="border border-zinc-800 p-3 sm:p-4 text-sm overflow-x-auto max-w-full" style={{ backgroundColor: '#09090b' }}>
<code className="font-mono text-xs sm:text-sm break-all sm:break-normal" style={{ color: '#d4d4d8' }}>
npx skillkit@latest install {selectedSkill.id.split('/').slice(0, 2).join('/')}
<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>
@@ -595,8 +595,8 @@ ${skillContent.slice(0, 4000)}${skillContent.length > 4000 ? '\n...(truncated)'
<Card key={idx} className="hover:border-zinc-600 transition-colors">
<h4 className="text-lg font-semibold text-white mb-2">{pattern.name}</h4>
<p className="text-zinc-400 mb-4">{pattern.description}</p>
<pre className="border border-zinc-700 p-3 sm:p-4 overflow-x-auto text-xs sm:text-sm max-w-full" style={{ backgroundColor: '#18181b' }}>
<code className="font-mono whitespace-pre-wrap break-words" style={{ color: '#f4f4f5' }}>{pattern.example}</code>
<pre className="bg-zinc-900 border border-zinc-700 p-4 overflow-x-auto text-sm">
<code className="text-zinc-100 font-mono">{pattern.example}</code>
</pre>
</Card>
))}
@@ -608,16 +608,16 @@ ${skillContent.slice(0, 4000)}${skillContent.length > 4000 ? '\n...(truncated)'
{ap.badExample && (
<div className="mb-4">
<div className="text-xs font-mono text-red-400 mb-1 uppercase">Bad</div>
<pre className="border border-red-800/50 p-3 sm:p-4 overflow-x-auto text-xs sm:text-sm max-w-full" style={{ backgroundColor: '#450a0a' }}>
<code className="font-mono whitespace-pre-wrap break-words" style={{ color: '#fecaca' }}>{ap.badExample}</code>
<pre className="bg-red-950/50 border border-red-800/50 p-4 overflow-x-auto text-sm">
<code className="text-red-100 font-mono">{ap.badExample}</code>
</pre>
</div>
)}
{ap.goodExample && (
<div>
<div className="text-xs font-mono text-green-400 mb-1 uppercase">Good</div>
<pre className="border border-green-800/50 p-3 sm:p-4 overflow-x-auto text-xs sm:text-sm max-w-full" style={{ backgroundColor: '#052e16' }}>
<code className="font-mono whitespace-pre-wrap break-words" style={{ color: '#bbf7d0' }}>{ap.goodExample}</code>
<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>
)}
-233
View File
@@ -1,233 +0,0 @@
import React, { useState } from 'react';
import { searchSkills, IndexedSkill, SKILLS_INDEX } from '../data/skills-index';
interface StackItem extends IndexedSkill {
addedAt: number;
}
const POPULAR_STACKS = [
{
name: 'Full Stack TypeScript',
skills: ['react', 'nextjs', 'typescript', 'prisma', 'tailwind'],
icon: '⚡',
},
{
name: 'AI/ML Development',
skills: ['python', 'langchain', 'openai', 'embeddings'],
icon: '🤖',
},
{
name: 'DevOps & Cloud',
skills: ['docker', 'kubernetes', 'terraform', 'github-actions'],
icon: '☁️',
},
{
name: 'Mobile Development',
skills: ['react-native', 'expo', 'ios', 'android'],
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);
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-80 lg:flex-shrink-0">
<div className="lg:sticky lg:top-20 bg-zinc-900/50 border border-zinc-800 p-3 sm:p-4">
<div className="text-xs font-mono text-zinc-500 uppercase tracking-wider mb-3">
Install Command
</div>
{stack.length > 0 ? (
<>
<pre className="bg-black border border-zinc-800 p-3 overflow-x-auto text-xs mb-3">
<code className="font-mono text-green-400 whitespace-pre-wrap break-all">
{generateInstallCommand()}
</code>
</pre>
<button
onClick={copyCommand}
className="w-full bg-white text-black py-2 font-mono text-sm hover:bg-zinc-200 transition-colors flex items-center justify-center gap-2"
>
{copied ? (
<>
<svg className="w-4 h-4" 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-4 h-4" 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 COMMAND
</>
)}
</button>
</>
) : (
<div className="text-zinc-600 text-xs font-mono text-center py-6">
Add skills to generate install command
</div>
)}
</div>
</div>
</div>
</div>
</section>
);
}
-155
View File
@@ -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>
);
}
+75
View File
@@ -22,9 +22,84 @@
<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
View File
@@ -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 -1
View File
@@ -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": []
}
-679
View File
@@ -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 -5
View File
@@ -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"
}
-5
View File
@@ -1,5 +0,0 @@
export default {
plugins: {
'@tailwindcss/postcss': {},
},
}
-43
View File
@@ -1,43 +0,0 @@
@import "tailwindcss";
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;
}
-40
View File
@@ -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
View File
@@ -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*"
+1 -16
View File
@@ -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) {
+1 -1
View File
@@ -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 -17
View File
@@ -2,7 +2,7 @@
* E2E Tests: Skill Translation Commands
*
* Tests for: translate, context, recommend
* Validates translation to all 32 supported agents
* Validates translation to all 17 supported agents
*/
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
@@ -16,7 +16,7 @@ import {
testFileExists,
} from './helpers/cli-runner.js';
// All 32 supported agents
// All 17 supported agents
const SUPPORTED_AGENTS = [
'claude-code',
'cursor',
@@ -35,21 +35,6 @@ const SUPPORTED_AGENTS = [
'trae',
'windsurf',
'universal',
'cline',
'codebuddy',
'commandcode',
'continue',
'crush',
'factory',
'mcpjam',
'mux',
'neovate',
'openhands',
'pi',
'qoder',
'qwen',
'vercel',
'zencoder',
] as const;
describe('E2E: Skill Translation', () => {
+2 -2
View File
@@ -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
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit-monorepo",
"version": "1.7.11",
"version": "1.7.2",
"private": true,
"description": "Universal skills loader for AI coding agents - Monorepo",
"type": "module",
+2 -2
View File
@@ -1,7 +1,7 @@
{
"name": "@skillkit/agents",
"version": "1.7.11",
"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",
+2 -10
View File
@@ -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> {
+2 -2
View File
@@ -3,7 +3,7 @@
[![npm version](https://img.shields.io/npm/v/@skillkit/cli.svg)](https://www.npmjs.com/package/@skillkit/cli)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](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 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/cli",
"version": "1.7.11",
"version": "1.7.6",
"description": "CLI commands for SkillKit",
"type": "module",
"main": "./dist/index.js",
@@ -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 () => {
-1
View File
@@ -53,4 +53,3 @@ export {
ManifestInstallCommand,
ManifestGenerateCommand,
} from './manifest.js';
export { PrimerCommand } from './primer.js';
-362
View File
@@ -1,362 +0,0 @@
import { Command, Option } from 'clipanion';
import { resolve } from 'node:path';
import chalk from 'chalk';
import {
type AgentType,
AgentType as AgentTypeSchema,
generatePrimer,
analyzePrimer,
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)',
});
async execute(): Promise<number> {
const projectPath = resolve(this.directory || process.cwd());
if (this.analyzeOnly) {
return this.runAnalysis(projectPath);
}
return this.runGenerate(projectPath);
}
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 -1
View File
@@ -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
+1 -1
View File
@@ -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;
+2 -2
View File
@@ -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 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/core",
"version": "1.7.11",
"version": "1.7.6",
"description": "Core functionality for SkillKit - skill discovery, parsing, and translation",
"type": "module",
"main": "./dist/index.js",
-3
View File
@@ -77,6 +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';
+1 -1
View File
@@ -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
*/
+1 -1
View File
@@ -10,7 +10,7 @@
* - Plan approval workflow
* - Review stages (spec-compliance, code-quality)
* - Inter-agent messaging (direct + broadcast)
* - Universal agent support (32 agents)
* - Universal agent support (17 agents)
*/
// Team Orchestrator
@@ -1,199 +0,0 @@
import { describe, it, expect, beforeAll, afterAll } from 'vitest';
import { mkdirSync, writeFileSync, rmSync, existsSync } from 'node:fs';
import { join } from 'node:path';
import { tmpdir } from 'node:os';
import { PrimerAnalyzer, analyzePrimer } from '../analyzer.js';
import { PrimerGenerator, generatePrimer } from '../generator.js';
const TEST_DIR = join(tmpdir(), 'skillkit-primer-test-' + Date.now());
describe('Primer', () => {
beforeAll(() => {
mkdirSync(TEST_DIR, { recursive: true });
writeFileSync(
join(TEST_DIR, 'package.json'),
JSON.stringify({
name: 'test-project',
version: '1.0.0',
description: 'A test project',
scripts: {
build: 'tsc',
test: 'vitest',
lint: 'eslint .',
},
dependencies: {
react: '^18.0.0',
next: '^14.0.0',
},
devDependencies: {
typescript: '^5.0.0',
tailwindcss: '^3.0.0',
vitest: '^1.0.0',
eslint: '^8.0.0',
prettier: '^3.0.0',
},
})
);
writeFileSync(join(TEST_DIR, 'tsconfig.json'), JSON.stringify({ compilerOptions: {} }));
mkdirSync(join(TEST_DIR, 'src'), { recursive: true });
writeFileSync(join(TEST_DIR, 'src', 'index.ts'), 'export const hello = "world";');
mkdirSync(join(TEST_DIR, '.github', 'workflows'), { recursive: true });
writeFileSync(join(TEST_DIR, '.github', 'workflows', 'ci.yml'), 'name: CI');
writeFileSync(join(TEST_DIR, 'pnpm-lock.yaml'), '');
});
afterAll(() => {
if (existsSync(TEST_DIR)) {
rmSync(TEST_DIR, { recursive: true, force: true });
}
});
describe('PrimerAnalyzer', () => {
it('should detect project info', () => {
const analyzer = new PrimerAnalyzer(TEST_DIR);
const analysis = analyzer.analyze();
expect(analysis.project.name).toBe('test-project');
expect(analysis.project.version).toBe('1.0.0');
expect(analysis.project.description).toBe('A test project');
});
it('should detect languages', () => {
const analysis = analyzePrimer(TEST_DIR);
const typescript = analysis.languages.find(l => l.name === 'typescript');
expect(typescript).toBeDefined();
expect(typescript?.version).toBe('5.0.0');
});
it('should detect package managers', () => {
const analysis = analyzePrimer(TEST_DIR);
expect(analysis.packageManagers).toContain('pnpm');
});
it('should detect frameworks', () => {
const analysis = analyzePrimer(TEST_DIR);
const react = analysis.stack.frameworks.find(f => f.name === 'react');
const nextjs = analysis.stack.frameworks.find(f => f.name === 'nextjs');
expect(react).toBeDefined();
expect(nextjs).toBeDefined();
});
it('should detect styling', () => {
const analysis = analyzePrimer(TEST_DIR);
const tailwind = analysis.stack.styling.find(s => s.name === 'tailwindcss');
expect(tailwind).toBeDefined();
});
it('should detect testing', () => {
const analysis = analyzePrimer(TEST_DIR);
const vitest = analysis.stack.testing.find(t => t.name === 'vitest');
expect(vitest).toBeDefined();
});
it('should detect tools', () => {
const analysis = analyzePrimer(TEST_DIR);
const eslint = analysis.stack.tools.find(t => t.name === 'eslint');
const prettier = analysis.stack.tools.find(t => t.name === 'prettier');
expect(eslint).toBeDefined();
expect(prettier).toBeDefined();
});
it('should detect CI config', () => {
const analysis = analyzePrimer(TEST_DIR);
expect(analysis.ci?.hasCI).toBe(true);
expect(analysis.ci?.provider).toBe('github-actions');
});
it('should detect project structure', () => {
const analysis = analyzePrimer(TEST_DIR);
expect(analysis.structure?.type).toBe('src-based');
expect(analysis.structure?.srcDir).toBe('src');
});
it('should extract build commands', () => {
const analysis = analyzePrimer(TEST_DIR);
expect(analysis.buildCommands?.build).toBe('pnpm build');
expect(analysis.buildCommands?.test).toBe('pnpm test');
expect(analysis.buildCommands?.lint).toBe('pnpm lint');
});
});
describe('PrimerGenerator', () => {
it('should generate instruction files for detected agents', () => {
const result = generatePrimer(TEST_DIR, { dryRun: true });
expect(result.success).toBe(true);
expect(result.generated.length).toBeGreaterThan(0);
expect(result.errors.length).toBe(0);
});
it('should generate for specific agents', () => {
const result = generatePrimer(TEST_DIR, {
agents: ['claude-code', 'cursor'],
dryRun: true,
});
expect(result.success).toBe(true);
expect(result.generated.length).toBe(2);
const agents = result.generated.map(g => g.agent);
expect(agents).toContain('claude-code');
expect(agents).toContain('cursor');
});
it('should analyze only when requested', () => {
const result = generatePrimer(TEST_DIR, { analyzeOnly: true });
expect(result.success).toBe(true);
expect(result.generated.length).toBe(0);
expect(result.analysis).toBeDefined();
expect(result.analysis.project.name).toBe('test-project');
});
it('should generate content with correct sections', () => {
const result = generatePrimer(TEST_DIR, {
agents: ['claude-code'],
dryRun: true,
});
expect(result.success).toBe(true);
expect(result.generated.length).toBeGreaterThan(0);
const instruction = result.generated[0];
expect(instruction.content).toContain('# test-project');
expect(instruction.content).toContain('## Technology Stack');
expect(instruction.content).toContain('## Development Commands');
expect(instruction.content).toContain('## Development Guidelines');
});
it('should respect output directory option', () => {
const outputDir = join(TEST_DIR, 'output');
mkdirSync(outputDir, { recursive: true });
const result = generatePrimer(TEST_DIR, {
agents: ['claude-code'],
outputDir,
dryRun: true,
});
expect(result.success).toBe(true);
expect(result.generated[0].filepath).toContain('output');
});
});
});
-658
View File
@@ -1,658 +0,0 @@
import { existsSync, readFileSync, readdirSync } from 'node:fs';
import { join, basename, relative, sep } from 'node:path';
import type {
PrimerAnalysis,
PackageManager,
CodeConvention,
ProjectStructure,
CIConfig,
EnvConfig,
DockerConfig,
} from './types.js';
import { ProjectDetector } from '../context/detector.js';
import type { Detection } from '../context/types.js';
const PACKAGE_MANAGER_FILES: Record<string, PackageManager> = {
'package-lock.json': 'npm',
'pnpm-lock.yaml': 'pnpm',
'yarn.lock': 'yarn',
'bun.lockb': 'bun',
'requirements.txt': 'pip',
'Pipfile.lock': 'pip',
'poetry.lock': 'poetry',
'uv.lock': 'uv',
'Cargo.lock': 'cargo',
'go.sum': 'go',
'pom.xml': 'maven',
'build.gradle': 'gradle',
'build.gradle.kts': 'gradle',
'composer.lock': 'composer',
'Gemfile.lock': 'bundler',
'Podfile.lock': 'cocoapods',
'Package.resolved': 'swift-package-manager',
'packages.lock.json': 'nuget',
};
const CI_CONFIG_FILES: Record<string, CIConfig['provider']> = {
'.github/workflows': 'github-actions',
'.gitlab-ci.yml': 'gitlab-ci',
'.circleci/config.yml': 'circleci',
'Jenkinsfile': 'jenkins',
'.travis.yml': 'travis',
'azure-pipelines.yml': 'azure-pipelines',
};
const IMPORTANT_CONFIG_FILES = [
'package.json',
'tsconfig.json',
'pyproject.toml',
'Cargo.toml',
'go.mod',
'.eslintrc.js',
'.eslintrc.json',
'eslint.config.js',
'.prettierrc',
'prettier.config.js',
'biome.json',
'tailwind.config.js',
'tailwind.config.ts',
'vite.config.ts',
'next.config.js',
'next.config.mjs',
'webpack.config.js',
'rollup.config.js',
'turbo.json',
'nx.json',
'jest.config.js',
'vitest.config.ts',
'playwright.config.ts',
'.env.example',
'docker-compose.yml',
'Dockerfile',
];
export class PrimerAnalyzer {
private projectPath: string;
private packageJson: Record<string, unknown> | null = null;
private files: Set<string> = new Set();
constructor(projectPath: string) {
this.projectPath = projectPath;
}
analyze(): PrimerAnalysis {
this.loadPackageJson();
this.scanFiles();
const detector = new ProjectDetector(this.projectPath);
const stack = detector.analyze();
const patterns = detector.detectPatterns();
const analysis: PrimerAnalysis = {
project: this.getProjectInfo(),
languages: this.detectLanguages(),
packageManagers: this.detectPackageManagers(),
stack,
patterns,
structure: this.detectProjectStructure(),
conventions: this.detectCodeConventions(),
ci: this.detectCIConfig(),
env: this.detectEnvConfig(),
docker: this.detectDockerConfig(),
buildCommands: this.extractBuildCommands(),
importantFiles: this.findImportantFiles(),
codebaseSize: this.estimateCodebaseSize(),
};
return analysis;
}
private loadPackageJson(): void {
const packageJsonPath = join(this.projectPath, 'package.json');
if (existsSync(packageJsonPath)) {
try {
const content = readFileSync(packageJsonPath, 'utf-8');
this.packageJson = JSON.parse(content);
} catch {
this.packageJson = null;
}
}
}
private scanFiles(maxDepth = 3): void {
const scan = (dir: string, depth: number) => {
if (depth > maxDepth) return;
try {
const entries = readdirSync(dir, { withFileTypes: true });
for (const entry of entries) {
const fullPath = join(dir, entry.name);
const relativePath = relative(this.projectPath, fullPath);
if (entry.name.startsWith('.') && entry.name !== '.github' && entry.name !== '.env.example') {
if (!entry.isDirectory()) {
this.files.add(relativePath);
}
continue;
}
if (entry.name === 'node_modules' || entry.name === 'dist' || entry.name === 'build' || entry.name === '.git') {
continue;
}
this.files.add(relativePath);
if (entry.isDirectory()) {
scan(fullPath, depth + 1);
}
}
} catch {
// Ignore permission errors
}
};
scan(this.projectPath, 0);
}
private getProjectInfo(): PrimerAnalysis['project'] {
const info: PrimerAnalysis['project'] = {
name: basename(this.projectPath),
};
if (this.packageJson) {
if (typeof this.packageJson.name === 'string') {
info.name = this.packageJson.name;
}
if (typeof this.packageJson.description === 'string') {
info.description = this.packageJson.description;
}
if (typeof this.packageJson.version === 'string') {
info.version = this.packageJson.version;
}
if (typeof this.packageJson.license === 'string') {
info.license = this.packageJson.license;
}
const repo = this.packageJson.repository;
if (typeof repo === 'string') {
info.repository = repo;
} else if (repo && typeof repo === 'object' && 'url' in repo) {
info.repository = String(repo.url);
}
}
const pyprojectPath = join(this.projectPath, 'pyproject.toml');
if (!this.packageJson && existsSync(pyprojectPath)) {
try {
const content = readFileSync(pyprojectPath, 'utf-8');
const nameMatch = content.match(/name\s*=\s*["']([^"']+)["']/);
const versionMatch = content.match(/version\s*=\s*["']([^"']+)["']/);
const descMatch = content.match(/description\s*=\s*["']([^"']+)["']/);
if (nameMatch) info.name = nameMatch[1];
if (versionMatch) info.version = versionMatch[1];
if (descMatch) info.description = descMatch[1];
} catch {
// Ignore
}
}
const cargoPath = join(this.projectPath, 'Cargo.toml');
if (!this.packageJson && existsSync(cargoPath)) {
try {
const content = readFileSync(cargoPath, 'utf-8');
const nameMatch = content.match(/name\s*=\s*["']([^"']+)["']/);
const versionMatch = content.match(/version\s*=\s*["']([^"']+)["']/);
const descMatch = content.match(/description\s*=\s*["']([^"']+)["']/);
if (nameMatch) info.name = nameMatch[1];
if (versionMatch) info.version = versionMatch[1];
if (descMatch) info.description = descMatch[1];
} catch {
// Ignore
}
}
const detector = new ProjectDetector(this.projectPath);
info.type = detector.detectProjectType();
return info;
}
private detectLanguages(): Detection[] {
const languages: Detection[] = [];
if (this.hasFile('tsconfig.json')) {
const version = this.getDepVersion('typescript');
languages.push({
name: 'typescript',
version,
confidence: 100,
source: 'tsconfig.json',
});
}
if (this.packageJson && !this.hasFile('tsconfig.json')) {
languages.push({
name: 'javascript',
confidence: 90,
source: 'package.json',
});
}
if (this.hasFile('pyproject.toml') || this.hasFile('requirements.txt') || this.hasFile('setup.py')) {
const source = this.hasFile('pyproject.toml')
? 'pyproject.toml'
: this.hasFile('requirements.txt')
? 'requirements.txt'
: 'setup.py';
languages.push({
name: 'python',
confidence: 100,
source,
});
}
if (this.hasFile('go.mod')) {
languages.push({
name: 'go',
confidence: 100,
source: 'go.mod',
});
}
if (this.hasFile('Cargo.toml')) {
languages.push({
name: 'rust',
confidence: 100,
source: 'Cargo.toml',
});
}
if (this.hasFile('pom.xml') || this.hasFile('build.gradle') || this.hasFile('build.gradle.kts')) {
languages.push({
name: 'java',
confidence: 100,
source: 'pom.xml',
});
}
if (this.hasFile('Package.swift')) {
languages.push({
name: 'swift',
confidence: 100,
source: 'Package.swift',
});
}
if (this.hasFile('Gemfile')) {
languages.push({
name: 'ruby',
confidence: 100,
source: 'Gemfile',
});
}
if (this.hasFile('composer.json')) {
languages.push({
name: 'php',
confidence: 100,
source: 'composer.json',
});
}
return languages;
}
private detectPackageManagers(): PackageManager[] {
const managers: Set<PackageManager> = new Set();
for (const [file, manager] of Object.entries(PACKAGE_MANAGER_FILES)) {
if (this.hasFile(file)) {
managers.add(manager);
}
}
if (this.packageJson) {
const packageManager = this.packageJson.packageManager;
if (typeof packageManager === 'string') {
const match = packageManager.match(/^(npm|pnpm|yarn|bun)@/);
if (match && ['npm', 'pnpm', 'yarn', 'bun'].includes(match[1])) {
managers.add(match[1] as PackageManager);
}
}
}
return Array.from(managers);
}
private detectProjectStructure(): ProjectStructure {
const structure: ProjectStructure = {
hasWorkspaces: false,
};
if (this.hasFile('packages') || this.hasFile('apps')) {
structure.type = 'monorepo';
} else if (this.hasFile('src')) {
structure.type = 'src-based';
structure.srcDir = 'src';
} else if (this.hasFile('lib')) {
structure.type = 'src-based';
structure.srcDir = 'lib';
} else {
structure.type = 'flat';
}
if (this.hasFile('tests') || this.hasFile('test') || this.hasFile('__tests__')) {
structure.testDir = this.hasFile('tests') ? 'tests' : this.hasFile('test') ? 'test' : '__tests__';
}
if (this.hasFile('docs') || this.hasFile('documentation')) {
structure.docsDir = this.hasFile('docs') ? 'docs' : 'documentation';
}
if (this.packageJson) {
const workspaces = this.packageJson.workspaces;
if (Array.isArray(workspaces)) {
structure.hasWorkspaces = true;
structure.workspaces = workspaces.filter(w => typeof w === 'string') as string[];
structure.type = 'monorepo';
} else if (workspaces && typeof workspaces === 'object' && 'packages' in workspaces) {
structure.hasWorkspaces = true;
structure.workspaces = (workspaces.packages as string[]) || [];
structure.type = 'monorepo';
}
}
if (this.hasFile('pnpm-workspace.yaml')) {
structure.hasWorkspaces = true;
structure.type = 'monorepo';
}
if (this.hasFile('turbo.json') || this.hasFile('nx.json')) {
structure.type = 'monorepo';
}
return structure;
}
private detectCodeConventions(): CodeConvention {
const conventions: CodeConvention = {};
const prettierConfig = this.readConfigFile([
'.prettierrc',
'.prettierrc.json',
'prettier.config.js',
]);
const biomeConfig = this.readConfigFile(['biome.json']);
if (prettierConfig) {
try {
const config = typeof prettierConfig === 'string' ? JSON.parse(prettierConfig) : prettierConfig;
if ('semi' in config) conventions.semicolons = config.semi;
if ('singleQuote' in config) conventions.quotes = config.singleQuote ? 'single' : 'double';
if ('tabWidth' in config) {
conventions.indentation = config.useTabs ? 'tabs' : `spaces-${config.tabWidth}` as 'spaces-2' | 'spaces-4';
}
if ('trailingComma' in config) conventions.trailingCommas = config.trailingComma;
if ('printWidth' in config) conventions.maxLineLength = config.printWidth;
} catch {
// Ignore parse errors
}
}
if (biomeConfig) {
try {
const config = typeof biomeConfig === 'string' ? JSON.parse(biomeConfig) : biomeConfig;
const formatter = config.formatter || {};
const js = config.javascript?.formatter || {};
if (formatter.indentStyle) conventions.indentation = formatter.indentStyle === 'tab' ? 'tabs' : 'spaces-2';
if (formatter.lineWidth) conventions.maxLineLength = formatter.lineWidth;
if (js.quoteStyle) conventions.quotes = js.quoteStyle;
if (js.semicolons) conventions.semicolons = js.semicolons !== 'asNeeded';
if (js.trailingCommas) conventions.trailingCommas = js.trailingCommas;
} catch {
// Ignore parse errors
}
}
if (this.hasFile('tsconfig.json')) {
try {
const tsconfigPath = join(this.projectPath, 'tsconfig.json');
const content = readFileSync(tsconfigPath, 'utf-8');
const tsconfig = JSON.parse(content.replace(/\/\/.*$/gm, '').replace(/,\s*}/g, '}'));
const paths = tsconfig.compilerOptions?.paths;
if (paths && Object.keys(paths).some(k => k.startsWith('@'))) {
conventions.namingStyle = 'camelCase';
}
} catch {
// Ignore
}
}
return conventions;
}
private detectCIConfig(): CIConfig {
const ci: CIConfig = {
hasCI: false,
hasCD: false,
};
for (const [file, provider] of Object.entries(CI_CONFIG_FILES)) {
if (this.hasFile(file)) {
ci.hasCI = true;
ci.provider = provider;
ci.configFile = file;
break;
}
}
if (this.hasFile('.github/workflows')) {
ci.hasCI = true;
ci.provider = 'github-actions';
ci.configFile = '.github/workflows';
try {
const workflowsDir = join(this.projectPath, '.github/workflows');
const workflows = readdirSync(workflowsDir);
const deployWorkflows = workflows.filter(f =>
f.includes('deploy') || f.includes('release') || f.includes('publish')
);
if (deployWorkflows.length > 0) {
ci.hasCD = true;
}
} catch {
// Ignore
}
}
return ci;
}
private detectEnvConfig(): EnvConfig {
const env: EnvConfig = {
hasEnvFile: false,
hasEnvExample: false,
};
env.hasEnvFile = this.hasFile('.env');
env.hasEnvExample = this.hasFile('.env.example') || this.hasFile('.env.template') || this.hasFile('.env.sample');
if (env.hasEnvExample) {
const envExamplePath = join(
this.projectPath,
this.hasFile('.env.example') ? '.env.example' : this.hasFile('.env.template') ? '.env.template' : '.env.sample'
);
try {
const content = readFileSync(envExamplePath, 'utf-8');
const variables = content
.split('\n')
.filter(line => line.trim() && !line.startsWith('#'))
.map(line => line.split('=')[0].trim())
.filter(v => v);
env.envVariables = variables;
} catch {
// Ignore
}
}
return env;
}
private detectDockerConfig(): DockerConfig {
const docker: DockerConfig = {
hasDockerfile: false,
hasCompose: false,
};
docker.hasDockerfile = this.hasFile('Dockerfile');
docker.hasCompose = this.hasFile('docker-compose.yml') || this.hasFile('docker-compose.yaml') || this.hasFile('compose.yml');
if (docker.hasDockerfile) {
try {
const dockerfilePath = join(this.projectPath, 'Dockerfile');
const content = readFileSync(dockerfilePath, 'utf-8');
const fromMatch = content.match(/^FROM\s+(\S+)/m);
if (fromMatch) {
docker.baseImage = fromMatch[1];
}
} catch {
// Ignore
}
}
return docker;
}
private extractBuildCommands(): PrimerAnalysis['buildCommands'] {
const commands: PrimerAnalysis['buildCommands'] = {};
if (this.packageJson && this.packageJson.scripts) {
const scripts = this.packageJson.scripts as Record<string, string>;
if (scripts.build) commands.build = this.getRunCommand('build');
if (scripts.test) commands.test = this.getRunCommand('test');
if (scripts.lint) commands.lint = this.getRunCommand('lint');
if (scripts.format) commands.format = this.getRunCommand('format');
if (scripts.dev) commands.dev = this.getRunCommand('dev');
if (scripts.start) commands.start = this.getRunCommand('start');
}
const packageManagers = this.detectPackageManagers();
if (!commands.install) {
if (packageManagers.includes('pnpm')) {
commands.install = 'pnpm install';
} else if (packageManagers.includes('yarn')) {
commands.install = 'yarn install';
} else if (packageManagers.includes('bun')) {
commands.install = 'bun install';
} else if (packageManagers.includes('npm')) {
commands.install = 'npm install';
} else if (packageManagers.includes('pip') || packageManagers.includes('poetry') || packageManagers.includes('uv')) {
if (packageManagers.includes('poetry')) {
commands.install = 'poetry install';
} else if (packageManagers.includes('uv')) {
commands.install = 'uv sync';
} else {
commands.install = 'pip install -r requirements.txt';
}
} else if (packageManagers.includes('cargo')) {
commands.install = 'cargo build';
} else if (packageManagers.includes('go')) {
commands.install = 'go mod download';
}
}
return commands;
}
private findImportantFiles(): string[] {
const important: string[] = [];
for (const file of IMPORTANT_CONFIG_FILES) {
if (this.hasFile(file)) {
important.push(file);
}
}
if (this.hasFile('README.md')) {
important.push('README.md');
}
if (this.hasFile('CONTRIBUTING.md')) {
important.push('CONTRIBUTING.md');
}
if (this.hasFile('LICENSE') || this.hasFile('LICENSE.md')) {
important.push(this.hasFile('LICENSE') ? 'LICENSE' : 'LICENSE.md');
}
return important;
}
private estimateCodebaseSize(): PrimerAnalysis['codebaseSize'] {
let files = 0;
let directories = 0;
for (const file of this.files) {
if (file.includes(sep)) {
directories++;
}
files++;
}
return {
files,
directories: Math.floor(directories / 3),
};
}
private hasFile(name: string): boolean {
if (name.includes('*')) {
const regex = new RegExp(
name.replace(/[.+?^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '.*')
);
for (const file of this.files) {
if (regex.test(file)) return true;
}
return false;
}
return this.files.has(name) || existsSync(join(this.projectPath, name));
}
private getDepVersion(dep: string): string | undefined {
if (!this.packageJson) return undefined;
const deps = this.packageJson.dependencies as Record<string, string> | undefined;
const devDeps = this.packageJson.devDependencies as Record<string, string> | undefined;
const version = deps?.[dep] || devDeps?.[dep];
return version?.replace(/^[\^~>=<]+/, '');
}
private getRunCommand(script: string): string {
const packageManagers = this.detectPackageManagers();
if (packageManagers.includes('pnpm')) {
return `pnpm ${script}`;
} else if (packageManagers.includes('yarn')) {
return `yarn ${script}`;
} else if (packageManagers.includes('bun')) {
return `bun run ${script}`;
}
return `npm run ${script}`;
}
private readConfigFile(files: string[]): unknown | null {
for (const file of files) {
const filePath = join(this.projectPath, file);
if (existsSync(filePath)) {
try {
const content = readFileSync(filePath, 'utf-8');
if (file.endsWith('.json')) {
return JSON.parse(content);
}
return content;
} catch {
// Ignore
}
}
}
return null;
}
}
export function analyzePrimer(projectPath: string): PrimerAnalysis {
const analyzer = new PrimerAnalyzer(projectPath);
return analyzer.analyze();
}
-734
View File
@@ -1,734 +0,0 @@
import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
import { join, dirname } from 'node:path';
import type { AgentType } from '../types.js';
import { AGENT_CONFIG, type AgentDirectoryConfig } from '../agent-config.js';
import type {
PrimerAnalysis,
PrimerOptions,
PrimerResult,
GeneratedInstruction,
AgentInstructionTemplate,
} from './types.js';
import { AGENT_INSTRUCTION_TEMPLATES } from './types.js';
import { analyzePrimer } from './analyzer.js';
const ALL_AGENTS: AgentType[] = Object.keys(AGENT_CONFIG) as AgentType[];
type OutputFormat = 'markdown' | 'mdc' | 'json' | 'xml';
interface FormatRenderer {
h1(text: string): string;
h2(text: string): string;
h3(text: string): string;
bold(text: string): string;
code(text: string): string;
codeBlock(code: string, lang?: string): string;
list(items: string[]): string;
keyValue(key: string, value: string): string;
paragraph(text: string): string;
separator(): string;
wrap(content: string, metadata?: Record<string, unknown>): string;
}
const markdownRenderer: FormatRenderer = {
h1: (text) => `# ${text}`,
h2: (text) => `## ${text}`,
h3: (text) => `### ${text}`,
bold: (text) => `**${text}**`,
code: (text) => `\`${text}\``,
codeBlock: (code, lang = '') => `\`\`\`${lang}\n${code}\n\`\`\``,
list: (items) => items.map(item => `- ${item}`).join('\n'),
keyValue: (key, value) => `**${key}:** ${value}`,
paragraph: (text) => text,
separator: () => '',
wrap: (content) => content,
};
const mdcRenderer: FormatRenderer = {
h1: (text) => `# ${text}`,
h2: (text) => `## ${text}`,
h3: (text) => `### ${text}`,
bold: (text) => `**${text}**`,
code: (text) => `\`${text}\``,
codeBlock: (code, lang = '') => `\`\`\`${lang}\n${code}\n\`\`\``,
list: (items) => items.map(item => `- ${item}`).join('\n'),
keyValue: (key, value) => `**${key}:** ${value}`,
paragraph: (text) => text,
separator: () => '',
wrap: (content, metadata) => {
if (metadata && Object.keys(metadata).length > 0) {
const yaml = Object.entries(metadata)
.map(([k, v]) => `${k}: ${JSON.stringify(v)}`)
.join('\n');
return `---\n${yaml}\n---\n\n${content}`;
}
return content;
},
};
const jsonRenderer: FormatRenderer = {
h1: (text) => text,
h2: (text) => text,
h3: (text) => text,
bold: (text) => text,
code: (text) => text,
codeBlock: (code) => code,
list: (items) => items.join(', '),
keyValue: (key, value) => `${key}: ${value}`,
paragraph: (text) => text,
separator: () => '',
wrap: (content, metadata) => {
try {
const data = { ...metadata, content };
return JSON.stringify(data, null, 2);
} catch {
return content;
}
},
};
const xmlRenderer: FormatRenderer = {
h1: (text) => `<h1>${escapeXml(text)}</h1>`,
h2: (text) => `<h2>${escapeXml(text)}</h2>`,
h3: (text) => `<h3>${escapeXml(text)}</h3>`,
bold: (text) => `<strong>${escapeXml(text)}</strong>`,
code: (text) => `<code>${escapeXml(text)}</code>`,
codeBlock: (code, lang = '') => `<pre${lang ? ` lang="${lang}"` : ''}><code>${escapeXml(code)}</code></pre>`,
list: (items) => `<ul>\n${items.map(item => ` <li>${escapeXml(item)}</li>`).join('\n')}\n</ul>`,
keyValue: (key, value) => `<dt>${escapeXml(key)}</dt><dd>${escapeXml(value)}</dd>`,
paragraph: (text) => `<p>${escapeXml(text)}</p>`,
separator: () => '',
wrap: (content, metadata) => {
const attrs = metadata
? Object.entries(metadata).map(([k, v]) => `${k}="${escapeXml(String(v))}"`).join(' ')
: '';
return `<?xml version="1.0" encoding="UTF-8"?>\n<instructions${attrs ? ' ' + attrs : ''}>\n${content}\n</instructions>`;
},
};
function escapeXml(text: string): string {
return text
.replace(/&/g, '&amp;')
.replace(/</g, '&lt;')
.replace(/>/g, '&gt;')
.replace(/"/g, '&quot;')
.replace(/'/g, '&apos;');
}
function getRenderer(format: OutputFormat): FormatRenderer {
switch (format) {
case 'mdc':
return mdcRenderer;
case 'json':
return jsonRenderer;
case 'xml':
return xmlRenderer;
default:
return markdownRenderer;
}
}
export class PrimerGenerator {
private projectPath: string;
private options: PrimerOptions;
private analysis: PrimerAnalysis | null = null;
constructor(projectPath: string, options: PrimerOptions = {}) {
this.projectPath = projectPath;
this.options = options;
}
generate(): PrimerResult {
const warnings: string[] = [];
const errors: string[] = [];
const generated: GeneratedInstruction[] = [];
const seenPaths = new Map<string, string>();
this.analysis = analyzePrimer(this.projectPath);
if (this.options.analyzeOnly) {
return {
success: true,
analysis: this.analysis,
generated: [],
warnings,
errors,
};
}
const targetAgents = this.getTargetAgents();
for (const agent of targetAgents) {
try {
const instruction = this.generateForAgent(agent);
if (instruction) {
const existingAgent = seenPaths.get(instruction.filepath);
if (existingAgent) {
warnings.push(
`Skipping ${agent}: output path "${instruction.filename}" already used by ${existingAgent}`
);
continue;
}
seenPaths.set(instruction.filepath, agent);
if (!this.options.dryRun) {
this.writeInstruction(instruction);
}
generated.push(instruction);
}
} catch (error) {
const message = error instanceof Error ? error.message : String(error);
errors.push(`Failed to generate for ${agent}: ${message}`);
}
}
return {
success: errors.length === 0,
analysis: this.analysis,
generated,
warnings,
errors,
};
}
private getTargetAgents(): AgentType[] {
if (this.options.allAgents) {
return ALL_AGENTS;
}
if (this.options.agents && this.options.agents.length > 0) {
return this.options.agents;
}
return this.detectInstalledAgents();
}
private detectInstalledAgents(): AgentType[] {
const detected: AgentType[] = [];
for (const [agent, config] of Object.entries(AGENT_CONFIG)) {
const configPath = join(this.projectPath, config.configFile);
const skillsPath = join(this.projectPath, config.skillsDir);
if (existsSync(configPath) || existsSync(skillsPath)) {
detected.push(agent as AgentType);
}
if (config.altSkillsDirs) {
for (const altDir of config.altSkillsDirs) {
if (existsSync(join(this.projectPath, altDir))) {
if (!detected.includes(agent as AgentType)) {
detected.push(agent as AgentType);
}
break;
}
}
}
}
if (detected.length === 0) {
detected.push('claude-code', 'cursor', 'github-copilot');
}
return detected;
}
private generateForAgent(agent: AgentType): GeneratedInstruction | null {
if (!this.analysis) return null;
const config = AGENT_CONFIG[agent];
const template = AGENT_INSTRUCTION_TEMPLATES[agent] || this.getDefaultTemplate(agent, config);
const content = this.generateContent(template);
const outputDir = this.options.outputDir || this.projectPath;
const filepath = join(outputDir, template.filename);
return {
agent,
filename: template.filename,
filepath,
content,
format: template.format,
};
}
private getDefaultTemplate(agent: AgentType, config: AgentDirectoryConfig): AgentInstructionTemplate {
const formatMap: Record<string, OutputFormat> = {
'.md': 'markdown',
'.json': 'json',
'.mdc': 'mdc',
'.xml': 'xml',
};
const ext = config.configFile.includes('.')
? '.' + config.configFile.split('.').pop()
: '.md';
const format = formatMap[ext] || 'markdown';
return {
agent,
filename: config.configFile,
format,
sectionOrder: ['overview', 'stack', 'commands', 'conventions', 'structure', 'guidelines'],
};
}
private generateContent(template: AgentInstructionTemplate): string {
if (!this.analysis) return '';
const format = template.format as OutputFormat;
const renderer = getRenderer(format);
if (format === 'json') {
return this.generateJsonContent(template);
}
const sections: string[] = [];
for (const section of template.sectionOrder) {
const content = this.generateSection(section, template, renderer);
if (content) {
sections.push(content);
}
}
let result = sections.join('\n\n');
if (template.header) {
result = template.header + '\n\n' + result;
}
if (template.footer) {
result = result + '\n\n' + template.footer;
}
if (this.options.customInstructions) {
result += '\n\n' + renderer.h2('Custom Instructions') + '\n\n' + this.options.customInstructions;
}
const metadata = format === 'mdc' ? {
title: this.analysis.project.name,
type: this.analysis.project.type,
generated: new Date().toISOString(),
} : undefined;
return renderer.wrap(result, metadata);
}
private generateJsonContent(template: AgentInstructionTemplate): string {
if (!this.analysis) return '{}';
const data: Record<string, unknown> = {
project: this.analysis.project,
languages: this.analysis.languages.map(l => l.name),
packageManagers: this.analysis.packageManagers,
stack: {
frameworks: this.analysis.stack.frameworks.map(f => ({ name: f.name, version: f.version })),
libraries: this.analysis.stack.libraries.map(l => ({ name: l.name, version: l.version })),
styling: this.analysis.stack.styling.map(s => s.name),
testing: this.analysis.stack.testing.map(t => t.name),
databases: this.analysis.stack.databases.map(d => d.name),
},
commands: this.analysis.buildCommands,
conventions: this.analysis.conventions,
structure: this.analysis.structure,
importantFiles: this.analysis.importantFiles,
generated: {
agent: template.agent,
timestamp: new Date().toISOString(),
},
};
if (this.options.customInstructions) {
data.customInstructions = this.options.customInstructions;
}
return JSON.stringify(data, null, 2);
}
private generateSection(section: string, template: AgentInstructionTemplate, renderer: FormatRenderer): string {
if (!this.analysis) return '';
switch (section) {
case 'overview':
return this.generateOverviewSection(renderer);
case 'stack':
return this.generateStackSection(renderer);
case 'commands':
return this.generateCommandsSection(renderer);
case 'conventions':
return this.generateConventionsSection(renderer);
case 'structure':
return this.generateStructureSection(renderer);
case 'guidelines':
return this.generateGuidelinesSection(template.agent, renderer);
default:
return '';
}
}
private generateOverviewSection(renderer: FormatRenderer): string {
if (!this.analysis) return '';
const { project, languages } = this.analysis;
const lines: string[] = [];
lines.push(renderer.h1(project.name));
lines.push('');
if (project.description) {
lines.push(renderer.paragraph(project.description));
lines.push('');
}
if (project.type) {
lines.push(renderer.keyValue('Project Type', this.formatProjectType(project.type)));
}
if (languages.length > 0) {
const langNames = languages.map(l => this.capitalize(l.name)).join(', ');
lines.push(renderer.keyValue('Languages', langNames));
}
if (project.version) {
lines.push(renderer.keyValue('Version', project.version));
}
return lines.join('\n');
}
private generateStackSection(renderer: FormatRenderer): string {
if (!this.analysis) return '';
const { stack, packageManagers } = this.analysis;
const lines: string[] = [];
lines.push(renderer.h2('Technology Stack'));
lines.push('');
if (stack.frameworks.length > 0) {
lines.push(renderer.h3('Frameworks'));
const items = stack.frameworks.map(fw => {
const version = fw.version ? ` (${fw.version})` : '';
return `${this.capitalize(fw.name)}${version}`;
});
lines.push(renderer.list(items));
lines.push('');
}
if (stack.libraries.length > 0) {
lines.push(renderer.h3('Libraries'));
const items = stack.libraries.map(lib => {
const version = lib.version ? ` (${lib.version})` : '';
return `${this.capitalize(lib.name)}${version}`;
});
lines.push(renderer.list(items));
lines.push('');
}
if (stack.styling.length > 0) {
lines.push(renderer.h3('Styling'));
lines.push(renderer.list(stack.styling.map(s => this.capitalize(s.name))));
lines.push('');
}
if (stack.testing.length > 0) {
lines.push(renderer.h3('Testing'));
lines.push(renderer.list(stack.testing.map(t => this.capitalize(t.name))));
lines.push('');
}
if (stack.databases.length > 0) {
lines.push(renderer.h3('Databases'));
lines.push(renderer.list(stack.databases.map(d => this.capitalize(d.name))));
lines.push('');
}
if (packageManagers.length > 0) {
lines.push(renderer.h3('Package Manager'));
lines.push(renderer.list([packageManagers.map(pm => this.capitalize(pm)).join(', ')]));
lines.push('');
}
return lines.join('\n');
}
private generateCommandsSection(renderer: FormatRenderer): string {
if (!this.analysis || !this.analysis.buildCommands) return '';
const { buildCommands } = this.analysis;
const lines: string[] = [];
const commands: string[] = [];
lines.push(renderer.h2('Development Commands'));
lines.push('');
if (buildCommands.install) {
commands.push(`# Install dependencies`);
commands.push(buildCommands.install);
commands.push('');
}
if (buildCommands.dev) {
commands.push(`# Start development server`);
commands.push(buildCommands.dev);
commands.push('');
}
if (buildCommands.build) {
commands.push(`# Build for production`);
commands.push(buildCommands.build);
commands.push('');
}
if (buildCommands.test) {
commands.push(`# Run tests`);
commands.push(buildCommands.test);
commands.push('');
}
if (buildCommands.lint) {
commands.push(`# Run linter`);
commands.push(buildCommands.lint);
commands.push('');
}
if (buildCommands.format) {
commands.push(`# Format code`);
commands.push(buildCommands.format);
}
lines.push(renderer.codeBlock(commands.join('\n'), 'bash'));
return lines.join('\n');
}
private generateConventionsSection(renderer: FormatRenderer): string {
if (!this.analysis) return '';
const { conventions, patterns } = this.analysis;
const lines: string[] = [];
lines.push(renderer.h2('Code Conventions'));
lines.push('');
if (conventions) {
const items: string[] = [];
if (conventions.indentation) {
items.push(`${renderer.bold('Indentation:')} ${conventions.indentation}`);
}
if (conventions.quotes) {
items.push(`${renderer.bold('Quotes:')} ${conventions.quotes}`);
}
if (conventions.semicolons !== undefined) {
items.push(`${renderer.bold('Semicolons:')} ${conventions.semicolons ? 'required' : 'omitted'}`);
}
if (conventions.trailingCommas) {
items.push(`${renderer.bold('Trailing Commas:')} ${conventions.trailingCommas}`);
}
if (conventions.maxLineLength) {
items.push(`${renderer.bold('Max Line Length:')} ${conventions.maxLineLength}`);
}
if (items.length > 0) {
lines.push(renderer.list(items));
}
}
if (patterns) {
lines.push('');
lines.push(renderer.h3('Patterns'));
const items: string[] = [];
if (patterns.components) {
items.push(`${renderer.bold('Components:')} ${patterns.components}`);
}
if (patterns.stateManagement) {
items.push(`${renderer.bold('State Management:')} ${patterns.stateManagement}`);
}
if (patterns.apiStyle) {
items.push(`${renderer.bold('API Style:')} ${patterns.apiStyle}`);
}
if (patterns.styling) {
items.push(`${renderer.bold('Styling:')} ${patterns.styling}`);
}
if (patterns.testing) {
items.push(`${renderer.bold('Testing:')} ${patterns.testing}`);
}
if (patterns.linting) {
items.push(`${renderer.bold('Linting:')} ${patterns.linting}`);
}
if (patterns.formatting) {
items.push(`${renderer.bold('Formatting:')} ${patterns.formatting}`);
}
if (items.length > 0) {
lines.push(renderer.list(items));
}
}
return lines.join('\n');
}
private generateStructureSection(renderer: FormatRenderer): string {
if (!this.analysis) return '';
const { structure, importantFiles } = this.analysis;
const lines: string[] = [];
lines.push(renderer.h2('Project Structure'));
lines.push('');
if (structure) {
if (structure.type) {
lines.push(renderer.keyValue('Structure Type', structure.type));
}
if (structure.srcDir) {
lines.push(renderer.keyValue('Source Directory', renderer.code(`${structure.srcDir}/`)));
}
if (structure.testDir) {
lines.push(renderer.keyValue('Test Directory', renderer.code(`${structure.testDir}/`)));
}
if (structure.hasWorkspaces && structure.workspaces) {
lines.push(renderer.keyValue('Workspaces', structure.workspaces.join(', ')));
}
lines.push('');
}
if (importantFiles.length > 0) {
lines.push(renderer.h3('Important Files'));
lines.push(renderer.list(importantFiles.slice(0, 15).map(f => renderer.code(f))));
}
return lines.join('\n');
}
private generateGuidelinesSection(_agent: AgentType, renderer: FormatRenderer): string {
if (!this.analysis) return '';
const { stack, patterns } = this.analysis;
const lines: string[] = [];
lines.push(renderer.h2('Development Guidelines'));
lines.push('');
const hasReact = stack.frameworks.some(f => f.name === 'react' || f.name === 'nextjs');
const hasVue = stack.frameworks.some(f => f.name === 'vue' || f.name === 'nuxt');
const hasTypeScript = this.analysis.languages.some(l => l.name === 'typescript');
const hasTailwind = stack.styling.some(s => s.name === 'tailwindcss');
const hasPrisma = stack.databases.some(d => d.name === 'prisma');
const hasZod = stack.libraries.some(l => l.name === 'zod');
if (hasTypeScript) {
lines.push(renderer.h3('TypeScript'));
lines.push(renderer.list([
'Use strict TypeScript with proper type annotations',
'Prefer `interface` for object types, `type` for unions/intersections',
'Avoid `any` - use `unknown` when type is uncertain',
]));
lines.push('');
}
if (hasReact) {
lines.push(renderer.h3('React'));
const reactItems = [
'Use functional components with hooks',
'Prefer composition over inheritance',
'Keep components small and focused',
];
if (patterns?.stateManagement) {
reactItems.push(`Use ${patterns.stateManagement} for state management`);
}
lines.push(renderer.list(reactItems));
lines.push('');
}
if (hasVue) {
lines.push(renderer.h3('Vue'));
lines.push(renderer.list([
'Use Composition API with `<script setup>`',
'Keep components small and focused',
]));
lines.push('');
}
if (hasTailwind) {
lines.push(renderer.h3('Styling'));
lines.push(renderer.list([
'Use Tailwind CSS utility classes',
'Follow mobile-first responsive design',
'Extract repeated patterns to components',
]));
lines.push('');
}
if (hasPrisma) {
lines.push(renderer.h3('Database'));
lines.push(renderer.list([
'Use Prisma for database operations',
'Keep database queries in dedicated service files',
'Use transactions for related operations',
]));
lines.push('');
}
if (hasZod) {
lines.push(renderer.h3('Validation'));
lines.push(renderer.list([
'Use Zod for runtime validation',
'Define schemas alongside types',
]));
lines.push('');
}
lines.push(renderer.h3('General'));
lines.push(renderer.list([
'Follow existing code patterns and conventions',
'Write clear, self-documenting code',
'Keep functions small and focused',
'Add tests for new functionality',
]));
return lines.join('\n');
}
private writeInstruction(instruction: GeneratedInstruction): void {
const dir = dirname(instruction.filepath);
if (!existsSync(dir)) {
mkdirSync(dir, { recursive: true });
}
writeFileSync(instruction.filepath, instruction.content, 'utf-8');
}
private formatProjectType(type: string): string {
const typeMap: Record<string, string> = {
'web-app': 'Web Application',
'api': 'API / Backend',
'cli': 'CLI Tool',
'library': 'Library / Package',
'mobile': 'Mobile Application',
'desktop': 'Desktop Application',
'unknown': 'Project',
};
return typeMap[type] || type;
}
private capitalize(str: string): string {
return str.charAt(0).toUpperCase() + str.slice(1);
}
}
export function generatePrimer(projectPath: string, options: PrimerOptions = {}): PrimerResult {
const generator = new PrimerGenerator(projectPath, options);
return generator.generate();
}
export function generatePrimerForAgent(
projectPath: string,
agent: AgentType,
options: Omit<PrimerOptions, 'agents' | 'allAgents'> = {}
): PrimerResult {
return generatePrimer(projectPath, { ...options, agents: [agent] });
}
export function analyzeForPrimer(projectPath: string): PrimerAnalysis {
const generator = new PrimerGenerator(projectPath, { analyzeOnly: true });
const result = generator.generate();
return result.analysis;
}
-27
View File
@@ -1,27 +0,0 @@
export {
type PrimerLanguage,
type PackageManager,
type CodeConvention,
type ProjectStructure,
type CIConfig,
type EnvConfig,
type DockerConfig,
type PrimerAnalysis,
type PrimerOptions,
type GeneratedInstruction,
type PrimerResult,
type AgentInstructionTemplate,
AGENT_INSTRUCTION_TEMPLATES,
} from './types.js';
export {
PrimerAnalyzer,
analyzePrimer,
} from './analyzer.js';
export {
PrimerGenerator,
generatePrimer,
generatePrimerForAgent,
analyzeForPrimer,
} from './generator.js';
-206
View File
@@ -1,206 +0,0 @@
import { z } from 'zod';
import type { AgentType } from '../types.js';
import { ProjectStack, ProjectPatterns, Detection } from '../context/types.js';
export const PrimerLanguage = z.enum([
'typescript',
'javascript',
'python',
'go',
'rust',
'java',
'kotlin',
'swift',
'ruby',
'php',
'csharp',
'cpp',
]);
export type PrimerLanguage = z.infer<typeof PrimerLanguage>;
export const PackageManager = z.enum([
'npm',
'pnpm',
'yarn',
'bun',
'pip',
'poetry',
'uv',
'cargo',
'go',
'maven',
'gradle',
'composer',
'bundler',
'cocoapods',
'swift-package-manager',
'nuget',
]);
export type PackageManager = z.infer<typeof PackageManager>;
export const CodeConvention = z.object({
namingStyle: z.enum(['camelCase', 'snake_case', 'PascalCase', 'kebab-case']).optional(),
indentation: z.enum(['tabs', 'spaces-2', 'spaces-4']).optional(),
quotes: z.enum(['single', 'double']).optional(),
semicolons: z.boolean().optional(),
trailingCommas: z.enum(['none', 'es5', 'all']).optional(),
maxLineLength: z.number().optional(),
});
export type CodeConvention = z.infer<typeof CodeConvention>;
export const ProjectStructure = z.object({
type: z.enum(['flat', 'src-based', 'monorepo', 'packages']).optional(),
srcDir: z.string().optional(),
testDir: z.string().optional(),
docsDir: z.string().optional(),
configDir: z.string().optional(),
hasWorkspaces: z.boolean().default(false),
workspaces: z.array(z.string()).optional(),
});
export type ProjectStructure = z.infer<typeof ProjectStructure>;
export const CIConfig = z.object({
provider: z.enum(['github-actions', 'gitlab-ci', 'circleci', 'jenkins', 'travis', 'azure-pipelines']).optional(),
hasCI: z.boolean().default(false),
hasCD: z.boolean().default(false),
configFile: z.string().optional(),
});
export type CIConfig = z.infer<typeof CIConfig>;
export const EnvConfig = z.object({
hasEnvFile: z.boolean().default(false),
hasEnvExample: z.boolean().default(false),
envVariables: z.array(z.string()).optional(),
});
export type EnvConfig = z.infer<typeof EnvConfig>;
export const DockerConfig = z.object({
hasDockerfile: z.boolean().default(false),
hasCompose: z.boolean().default(false),
baseImage: z.string().optional(),
});
export type DockerConfig = z.infer<typeof DockerConfig>;
export const PrimerAnalysis = z.object({
project: z.object({
name: z.string(),
description: z.string().optional(),
version: z.string().optional(),
type: z.string().optional(),
license: z.string().optional(),
repository: z.string().optional(),
}),
languages: z.array(Detection).default([]),
packageManagers: z.array(PackageManager).default([]),
stack: ProjectStack,
patterns: ProjectPatterns.optional(),
structure: ProjectStructure.optional(),
conventions: CodeConvention.optional(),
ci: CIConfig.optional(),
env: EnvConfig.optional(),
docker: DockerConfig.optional(),
buildCommands: z.object({
install: z.string().optional(),
build: z.string().optional(),
test: z.string().optional(),
lint: z.string().optional(),
format: z.string().optional(),
dev: z.string().optional(),
start: z.string().optional(),
}).optional(),
importantFiles: z.array(z.string()).default([]),
codebaseSize: z.object({
files: z.number().optional(),
lines: z.number().optional(),
directories: z.number().optional(),
}).optional(),
});
export type PrimerAnalysis = z.infer<typeof PrimerAnalysis>;
export interface PrimerOptions {
projectPath?: string;
agents?: AgentType[];
allAgents?: boolean;
outputDir?: string;
dryRun?: boolean;
analyzeOnly?: boolean;
verbose?: boolean;
includeExamples?: boolean;
customInstructions?: string;
}
export interface GeneratedInstruction {
agent: AgentType;
filename: string;
filepath: string;
content: string;
format: 'markdown' | 'json' | 'mdc' | 'xml';
}
export interface PrimerResult {
success: boolean;
analysis: PrimerAnalysis;
generated: GeneratedInstruction[];
warnings: string[];
errors: string[];
}
export interface AgentInstructionTemplate {
agent: AgentType;
filename: string;
format: 'markdown' | 'json' | 'mdc' | 'xml';
header?: string;
footer?: string;
sectionOrder: string[];
}
export const AGENT_INSTRUCTION_TEMPLATES: Record<string, AgentInstructionTemplate> = {
'claude-code': {
agent: 'claude-code',
filename: 'CLAUDE.md',
format: 'markdown',
sectionOrder: ['overview', 'stack', 'commands', 'conventions', 'structure', 'guidelines'],
},
'cursor': {
agent: 'cursor',
filename: '.cursorrules',
format: 'markdown',
sectionOrder: ['overview', 'stack', 'conventions', 'guidelines'],
},
'github-copilot': {
agent: 'github-copilot',
filename: '.github/copilot-instructions.md',
format: 'markdown',
sectionOrder: ['overview', 'stack', 'commands', 'conventions', 'structure', 'guidelines'],
},
'codex': {
agent: 'codex',
filename: 'AGENTS.md',
format: 'markdown',
sectionOrder: ['overview', 'stack', 'commands', 'conventions', 'structure', 'guidelines'],
},
'gemini-cli': {
agent: 'gemini-cli',
filename: 'GEMINI.md',
format: 'markdown',
sectionOrder: ['overview', 'stack', 'commands', 'conventions', 'structure', 'guidelines'],
},
'windsurf': {
agent: 'windsurf',
filename: '.windsurfrules',
format: 'markdown',
sectionOrder: ['overview', 'stack', 'conventions', 'guidelines'],
},
'opencode': {
agent: 'opencode',
filename: 'AGENTS.md',
format: 'markdown',
sectionOrder: ['overview', 'stack', 'commands', 'conventions', 'structure', 'guidelines'],
},
'trae': {
agent: 'trae',
filename: '.trae/rules/project_rules.md',
format: 'markdown',
sectionOrder: ['overview', 'stack', 'commands', 'conventions', 'guidelines'],
},
};
@@ -329,7 +329,7 @@ Follow these guidelines`;
});
describe('supported agents', () => {
it('should support all 32 agents', () => {
it('should support all 17 agents', () => {
const allAgents = [
'claude-code',
'cursor',
+1 -1
View File
@@ -34,7 +34,7 @@ pnpm ui
- **Animated UI** - Smooth entrance animations and transitions
- **Browse Skills** - Explore skill repositories with search and filtering
- **Smart Recommendations** - AI-powered skill suggestions with match scores
- **Cross-Agent Translation** - Convert skills between 32 agent formats
- **Cross-Agent Translation** - Convert skills between 17+ agent formats
- **Team Collaboration** - Share and sync skills across teams
- **Responsive Design** - Adapts to any terminal size
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/tui",
"version": "2.0.1",
"version": "2.0.0",
"description": "Unified Terminal UI for SkillKit - Built on OpenTUI",
"type": "module",
"main": "./dist/index.js",
-13
View File
@@ -1,6 +1,5 @@
import { useState, useCallback, useEffect } from 'react';
import { useKeyboard } from '@opentui/react';
import { exec } from 'node:child_process';
import { type Screen, NAV_KEYS } from './state/types.js';
import { Sidebar } from './components/Sidebar.js';
import { Splash } from './components/Splash.js';
@@ -10,13 +9,6 @@ import {
Plan, Workflow, Execute, History, Sync, Help,
} from './screens/index.js';
const DOCS_URL = 'https://agenstskills.com/docs';
function openUrl(url: string): void {
const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
exec(`${cmd} ${url}`);
}
interface AppProps {
onExit?: (code?: number) => void;
}
@@ -62,11 +54,6 @@ export function App({ onExit }: AppProps = {}) {
return;
}
if (key.name === 'd') {
openUrl(DOCS_URL);
return;
}
const targetScreen = NAV_KEYS[key.name || ''];
if (targetScreen) {
setScreen(targetScreen);
+2 -4
View File
@@ -17,15 +17,13 @@ const SHORTCUTS = [
{ key: 'r', desc: 'Recommendations' },
{ key: 'i', desc: 'Installed skills' },
{ key: 's', desc: 'Sync settings' },
{ key: 'f', desc: 'Find skills' },
]},
{ section: 'Actions', items: [
{ key: 't', desc: 'Translate skills' },
{ key: 'w', desc: 'Workflows' },
{ key: 'x', desc: 'Execute' },
{ key: 'n', desc: 'Plan' },
{ key: 'v', desc: 'Validate' },
{ key: 'u', desc: 'Publish' },
{ key: 'y', desc: 'History' },
]},
{ section: 'Team & Config', items: [
{ key: 'a', desc: 'Team settings' },
@@ -37,10 +35,10 @@ const SHORTCUTS = [
]},
{ section: 'Global', items: [
{ key: '/', desc: 'This help screen' },
{ key: 'd', desc: 'Open docs' },
{ key: 'esc', desc: 'Go back / Home' },
{ key: 'q', desc: 'Quit application' },
{ key: 'j/k', desc: 'Navigate lists' },
{ key: 'enter', desc: 'Select item' },
]},
];
+1 -1
View File
@@ -2,7 +2,7 @@
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://skillkit.dev/schemas/skill.schema.json",
"title": "Skill Frontmatter",
"description": "Schema for SKILL.md frontmatter validation (follows Agent Skills spec: https://agenstskills.com)",
"description": "Schema for SKILL.md frontmatter validation (follows Agent Skills spec: https://agentskills.io/specification)",
"type": "object",
"required": ["name", "description"],
"properties": {
+2 -2
View File
@@ -8,7 +8,7 @@ export class ValidateCommand extends Command {
static override paths = [['validate'], ['v']];
static override usage = Command.Usage({
description: 'Validate skill(s) against the Agent Skills specification (agenstskills.com)',
description: 'Validate skill(s) against the Agent Skills specification (agentskills.io)',
examples: [
['Validate a skill directory', '$0 validate ./my-skill'],
['Validate all skills in a directory', '$0 validate ./skills --all'],
@@ -77,7 +77,7 @@ export class ValidateCommand extends Command {
if (hasErrors) {
console.log(chalk.red('Validation failed'));
console.log(chalk.dim('See https://agenstskills.com for the complete format'));
console.log(chalk.dim('See https://agentskills.io/specification for the complete format'));
return 1;
}