mirror of
https://github.com/rohitg00/skillkit.git
synced 2026-11-20 12:23:29 +00:00
Compare commits
6
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
54cef27bfe | ||
|
|
1220880462 | ||
|
|
1c946dde06 | ||
|
|
3dfd317867 | ||
|
|
c5aa303043 | ||
|
|
01d816c72a |
@@ -0,0 +1,42 @@
|
||||
---
|
||||
name: Add Skill Source
|
||||
about: Submit your skill repository to be included in SkillKit
|
||||
title: "[Source] Add <repository-name>"
|
||||
labels: skill-source, enhancement
|
||||
assignees: rohitg00
|
||||
---
|
||||
|
||||
## Repository Information
|
||||
|
||||
**Repository URL:** `https://github.com/<owner>/<repo>`
|
||||
|
||||
**Repository Name:**
|
||||
<!-- Short name for display (e.g., "Anthropic Official", "React Patterns") -->
|
||||
|
||||
**Description:**
|
||||
<!-- Brief description of the skills in your repository -->
|
||||
|
||||
**License:**
|
||||
<!-- MIT, Apache 2.0, etc. -->
|
||||
|
||||
## Skill Details
|
||||
|
||||
**Approximate skill count:**
|
||||
<!-- How many skills does your repository contain? -->
|
||||
|
||||
**Categories/Tags:**
|
||||
<!-- What categories do your skills cover? e.g., react, typescript, security, testing -->
|
||||
|
||||
**Target AI Agents:**
|
||||
<!-- Which agents are your skills designed for? e.g., Claude Code, Cursor, all -->
|
||||
|
||||
## Checklist
|
||||
|
||||
- [ ] Repository is public
|
||||
- [ ] Repository contains valid SKILL.md files
|
||||
- [ ] Repository has a clear license
|
||||
- [ ] Skills follow the [Agent Skills specification](https://agenstskills.com)
|
||||
|
||||
## Additional Context
|
||||
|
||||
<!-- Any other information about your repository -->
|
||||
@@ -83,7 +83,7 @@ body:
|
||||
options:
|
||||
- label: Repository is public
|
||||
required: true
|
||||
- label: SKILL.md follows the agentskills.io standard format
|
||||
- label: SKILL.md follows the agenstskills.com standard format
|
||||
required: true
|
||||
- label: Skill has been tested with at least one AI agent
|
||||
required: false
|
||||
|
||||
+1
-1
@@ -206,7 +206,7 @@ To add support for a new AI coding agent:
|
||||
|
||||
If you want to contribute skills to the ecosystem:
|
||||
|
||||
1. Follow the [Agent Skills specification](https://agentskills.io/specification)
|
||||
1. Follow the [Agent Skills specification](https://agenstskills.com)
|
||||
2. Include a `SKILL.md` with proper frontmatter
|
||||
3. Test with multiple agents using `skillkit translate`
|
||||
4. Submit to the appropriate skill repository
|
||||
|
||||
@@ -313,6 +313,23 @@ 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
|
||||
@@ -403,7 +420,7 @@ skillkit create my-skill
|
||||
|
||||
### Manual Creation
|
||||
|
||||
Create a `SKILL.md` file following the [Agent Skills specification](https://agentskills.io/specification):
|
||||
Create a `SKILL.md` file following the [Agent Skills specification](https://agenstskills.com):
|
||||
|
||||
```markdown
|
||||
---
|
||||
@@ -475,12 +492,43 @@ const profile = await analyzeProject('./my-project');
|
||||
const recs = engine.recommend(profile);
|
||||
```
|
||||
|
||||
## Popular Skill Repositories
|
||||
## Skill Sources & Attribution
|
||||
|
||||
| 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 |
|
||||
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
|
||||
|
||||
## Installation Options
|
||||
|
||||
@@ -531,7 +579,7 @@ Contributions welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md
|
||||
|
||||
- [Documentation](https://agenstskills.com/docs)
|
||||
- [Website](https://agenstskills.com)
|
||||
- [Agent Skills Specification](https://agentskills.io/specification)
|
||||
- [Agent Skills Specification](https://agenstskills.com)
|
||||
- [GitHub Repository](https://github.com/rohitg00/skillkit)
|
||||
- [NPM Package](https://www.npmjs.com/package/skillkit)
|
||||
- [GitHub Package](https://github.com/rohitg00/skillkit/pkgs/npm/skillkit)
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "skillkit",
|
||||
"version": "1.7.9",
|
||||
"version": "1.7.11",
|
||||
"description": "Supercharge AI coding agents with portable skills. Install, translate, and share skills across Claude Code, Cursor, Codex, Copilot & 13 more",
|
||||
"type": "module",
|
||||
"bin": {
|
||||
|
||||
@@ -48,7 +48,6 @@ import {
|
||||
AgentTranslateCommand,
|
||||
AgentSyncCommand,
|
||||
AgentValidateCommand,
|
||||
// New commands (Phase 21)
|
||||
CheckCommand,
|
||||
FindCommand,
|
||||
ManifestCommand,
|
||||
@@ -57,6 +56,7 @@ import {
|
||||
ManifestRemoveCommand,
|
||||
ManifestInstallCommand,
|
||||
ManifestGenerateCommand,
|
||||
PrimerCommand,
|
||||
} from '@skillkit/cli';
|
||||
|
||||
const __filename = fileURLToPath(import.meta.url);
|
||||
@@ -127,5 +127,6 @@ cli.register(ManifestAddCommand);
|
||||
cli.register(ManifestRemoveCommand);
|
||||
cli.register(ManifestInstallCommand);
|
||||
cli.register(ManifestGenerateCommand);
|
||||
cli.register(PrimerCommand);
|
||||
|
||||
cli.runExit(process.argv.slice(2));
|
||||
|
||||
+125
-3
@@ -6,6 +6,9 @@ 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">
|
||||
@@ -24,6 +27,15 @@ 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' }}>
|
||||
@@ -34,10 +46,40 @@ export default function App(): React.ReactElement {
|
||||
<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"
|
||||
className="text-zinc-400 hover:text-white transition-colors text-sm font-mono"
|
||||
className="text-zinc-400 hover:text-white transition-colors text-sm font-mono hidden sm:block"
|
||||
>
|
||||
Docs
|
||||
</a>
|
||||
@@ -66,15 +108,91 @@ 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="skills" className="py-12 border-b border-zinc-800">
|
||||
<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' }}>
|
||||
<SkillGenerator />
|
||||
</section>
|
||||
|
||||
<section id="submit" className="py-12 border-b border-zinc-800" style={{ backgroundColor: '#09090b' }}>
|
||||
<section id="submit" className="py-12 border-b border-zinc-800" style={{ backgroundColor: '#09090b', scrollMarginTop: '4rem' }}>
|
||||
<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>
|
||||
@@ -85,6 +203,10 @@ export default function App(): React.ReactElement {
|
||||
<SkillSubmitForm />
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section id="sources" style={{ scrollMarginTop: '4rem' }}>
|
||||
<Attribution />
|
||||
</section>
|
||||
</main>
|
||||
|
||||
<Footer />
|
||||
|
||||
@@ -0,0 +1,280 @@
|
||||
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>
|
||||
);
|
||||
}
|
||||
@@ -7,39 +7,39 @@ interface CommandGroup {
|
||||
|
||||
const COMMAND_GROUPS: CommandGroup[] = [
|
||||
{
|
||||
name: 'Core',
|
||||
name: 'Start',
|
||||
commands: [
|
||||
{ cmd: 'install', desc: 'Install from GitHub/GitLab/local' },
|
||||
{ cmd: 'sync', desc: 'Sync skills across agents' },
|
||||
{ cmd: 'translate', desc: 'Convert between agent formats' },
|
||||
{ cmd: 'update', desc: 'Update installed skills' },
|
||||
{ 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' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Discovery',
|
||||
name: 'Manage',
|
||||
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: 'manifest install', desc: 'Install from manifest' },
|
||||
{ cmd: 'team share', desc: 'Share skills via Git' },
|
||||
{ cmd: 'team share', desc: 'Share via Git' },
|
||||
{ cmd: 'publish', desc: 'Submit to marketplace' },
|
||||
{ cmd: 'cicd init', desc: 'CI/CD templates' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Advanced',
|
||||
commands: [
|
||||
{ cmd: 'ui', desc: 'Launch terminal UI' },
|
||||
{ cmd: 'workflow run', desc: 'Execute skill pipelines' },
|
||||
{ cmd: 'primer', desc: 'Generate CLAUDE.md from code' },
|
||||
{ cmd: 'agent translate', desc: 'Batch convert agents' },
|
||||
{ cmd: 'command generate', desc: 'Create /slash commands' },
|
||||
{ cmd: 'cicd init', desc: 'Generate CI templates' },
|
||||
{ cmd: 'memory export', desc: 'Save session learnings' },
|
||||
],
|
||||
},
|
||||
];
|
||||
@@ -58,7 +58,7 @@ export function Commands(): React.ReactElement {
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div className="flex justify-center gap-2 mb-6">
|
||||
<div className="flex justify-center gap-1.5 sm:gap-2 mb-4 sm:mb-6 flex-wrap">
|
||||
{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-3 py-1.5 text-xs font-mono border transition-colors ${buttonClass}`}
|
||||
className={`px-2 sm:px-3 py-1 sm:py-1.5 text-[10px] sm:text-xs font-mono border transition-colors ${buttonClass}`}
|
||||
>
|
||||
{g.name}
|
||||
</button>
|
||||
@@ -76,24 +76,26 @@ export function Commands(): React.ReactElement {
|
||||
})}
|
||||
</div>
|
||||
|
||||
<div className="border border-zinc-800 bg-black/50 p-4 font-mono text-xs">
|
||||
<div className="grid grid-cols-1 sm:grid-cols-2 gap-2">
|
||||
<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">
|
||||
{group.commands.map((c) => (
|
||||
<div
|
||||
key={c.cmd}
|
||||
className="flex items-center gap-3 p-2 hover:bg-zinc-900/50 transition-colors rounded"
|
||||
key={c.cmd || 'tui'}
|
||||
className="flex items-center gap-2 p-1.5 sm:p-2 hover:bg-zinc-900/50 transition-colors rounded"
|
||||
>
|
||||
<span className="text-zinc-600">$</span>
|
||||
<span className="text-white">skillkit {c.cmd}</span>
|
||||
<span className="text-zinc-600 hidden sm:inline">→</span>
|
||||
<span className="text-zinc-500 hidden sm:inline truncate">{c.desc}</span>
|
||||
<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>
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="mt-4 text-center">
|
||||
<span className="text-zinc-600 text-xs font-mono">
|
||||
<div className="mt-3 sm:mt-4 text-center">
|
||||
<span className="text-zinc-600 text-[10px] sm:text-xs font-mono">
|
||||
Run <span className="text-zinc-400">skillkit --help</span> for all commands
|
||||
</span>
|
||||
</div>
|
||||
|
||||
@@ -46,6 +46,7 @@ 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>
|
||||
@@ -203,6 +204,15 @@ 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
|
||||
|
||||
@@ -7,6 +7,15 @@ 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.',
|
||||
@@ -65,10 +74,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 {
|
||||
|
||||
@@ -18,7 +18,7 @@ export function Footer(): React.ReactElement {
|
||||
</p>
|
||||
<span className="hidden sm:inline text-zinc-700">•</span>
|
||||
<a
|
||||
href="https://agentskills.io"
|
||||
href="https://agenstskills.com"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="text-zinc-600 hover:text-zinc-400 text-xs font-mono transition-colors"
|
||||
|
||||
@@ -16,17 +16,15 @@ interface TerminalLine {
|
||||
}
|
||||
|
||||
const TERMINAL_LINES: TerminalLine[] = [
|
||||
{ type: 'cmd', text: 'skillkit find react' },
|
||||
{ type: 'out', text: ' ■ react-patterns ★★★★★' },
|
||||
{ type: 'out', text: ' ■ react-testing ★★★★☆' },
|
||||
{ type: 'cmd', text: 'skillkit recommend' },
|
||||
{ type: 'out', text: ' 92% react-best-practices' },
|
||||
{ type: 'out', text: ' 87% typescript-strict' },
|
||||
{ type: 'cmd', text: 'skillkit install anthropics/skills' },
|
||||
{ type: 'out', text: '→ 3 skills → 5 agents' },
|
||||
{ type: 'cmd', text: 'skillkit ui' },
|
||||
{ type: 'out', text: '→ Launching TUI...' },
|
||||
{ type: 'cmd', text: 'skillkit check' },
|
||||
{ type: 'out', text: ' ✓ All skills up to date' },
|
||||
{ type: 'cmd', text: 'skillkit manifest install' },
|
||||
{ type: 'out', text: '→ 12 skills from .skills' },
|
||||
{ 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' },
|
||||
];
|
||||
|
||||
const FADE_ANIMATION_STYLES = `
|
||||
@@ -122,11 +120,11 @@ export function Hero(): React.ReactElement {
|
||||
</pre>
|
||||
</div>
|
||||
|
||||
<div className="grid grid-cols-1 lg:grid-cols-2 gap-6 lg:gap-8 items-start">
|
||||
<div className="grid grid-cols-1 md:grid-cols-2 gap-6 lg:gap-8 items-start">
|
||||
<div className="animate-fade-in">
|
||||
<div className="inline-flex items-center space-x-2 border border-zinc-800 bg-zinc-900/50 px-2 py-0.5 mb-3 backdrop-blur-sm">
|
||||
<span className="flex h-1.5 w-1.5 bg-white rounded-full"></span>
|
||||
<span className="text-xs font-mono text-zinc-400">v1.7.5</span>
|
||||
<span className="text-xs font-mono text-zinc-400">v1.7.11</span>
|
||||
</div>
|
||||
|
||||
<h1 className="text-2xl sm:text-3xl lg:text-4xl font-bold tracking-tight text-white mb-3 font-mono">
|
||||
@@ -163,7 +161,7 @@ export function Hero(): React.ReactElement {
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="hidden lg:block relative animate-fade-in-delay w-full">
|
||||
<div className="hidden md: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">
|
||||
@@ -172,7 +170,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-4 font-mono text-xs min-h-[200px] max-h-[280px]">
|
||||
<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]">
|
||||
{TERMINAL_LINES.slice(0, visibleLines).map((line, index) => (
|
||||
<div key={index} className="mb-1">
|
||||
{line.type === 'cmd' ? (
|
||||
|
||||
@@ -490,7 +490,7 @@ ${skillContent.slice(0, 4000)}${skillContent.length > 4000 ? '\n...(truncated)'
|
||||
<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 install {selectedSkill.id.split('/').slice(0, 2).join('/')}
|
||||
npx skillkit@latest install {selectedSkill.id.split('/').slice(0, 2).join('/')}
|
||||
</code>
|
||||
</pre>
|
||||
</div>
|
||||
|
||||
@@ -0,0 +1,233 @@
|
||||
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>
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,155 @@
|
||||
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>
|
||||
);
|
||||
}
|
||||
Generated
+2
-2
@@ -1,12 +1,12 @@
|
||||
{
|
||||
"name": "skillkit-monorepo",
|
||||
"version": "1.7.2",
|
||||
"version": "1.7.10",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "skillkit-monorepo",
|
||||
"version": "1.7.2",
|
||||
"version": "1.7.10",
|
||||
"license": "Apache-2.0",
|
||||
"devDependencies": {
|
||||
"@types/node": "^22.10.5",
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "skillkit-monorepo",
|
||||
"version": "1.7.9",
|
||||
"version": "1.7.11",
|
||||
"private": true,
|
||||
"description": "Universal skills loader for AI coding agents - Monorepo",
|
||||
"type": "module",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/agents",
|
||||
"version": "1.7.9",
|
||||
"version": "1.7.11",
|
||||
"description": "Agent adapters for SkillKit - supports 32 AI coding agents",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -81,8 +81,16 @@ export function getAdapter(type: AgentType): AgentAdapter {
|
||||
return adapters[type];
|
||||
}
|
||||
|
||||
export function getAllAdapters(): AgentAdapter[] {
|
||||
return Object.values(adapters);
|
||||
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 async function detectAgent(): Promise<AgentType> {
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/cli",
|
||||
"version": "1.7.9",
|
||||
"version": "1.7.11",
|
||||
"description": "CLI commands for SkillKit",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -53,3 +53,4 @@ export {
|
||||
ManifestInstallCommand,
|
||||
ManifestGenerateCommand,
|
||||
} from './manifest.js';
|
||||
export { PrimerCommand } from './primer.js';
|
||||
|
||||
@@ -0,0 +1,362 @@
|
||||
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,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/core",
|
||||
"version": "1.7.9",
|
||||
"version": "1.7.11",
|
||||
"description": "Core functionality for SkillKit - skill discovery, parsing, and translation",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -77,3 +77,6 @@ export * from './skill-translator.js';
|
||||
export * from './manifest/index.js';
|
||||
|
||||
export * from './quality/index.js';
|
||||
|
||||
// Primer (AI Instruction Generator)
|
||||
export * from './primer/index.js';
|
||||
|
||||
@@ -0,0 +1,199 @@
|
||||
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');
|
||||
});
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,658 @@
|
||||
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();
|
||||
}
|
||||
@@ -0,0 +1,734 @@
|
||||
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, '&')
|
||||
.replace(/</g, '<')
|
||||
.replace(/>/g, '>')
|
||||
.replace(/"/g, '"')
|
||||
.replace(/'/g, ''');
|
||||
}
|
||||
|
||||
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;
|
||||
}
|
||||
@@ -0,0 +1,27 @@
|
||||
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';
|
||||
@@ -0,0 +1,206 @@
|
||||
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'],
|
||||
},
|
||||
};
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/tui",
|
||||
"version": "2.0.0",
|
||||
"version": "2.0.1",
|
||||
"description": "Unified Terminal UI for SkillKit - Built on OpenTUI",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -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://agentskills.io/specification)",
|
||||
"description": "Schema for SKILL.md frontmatter validation (follows Agent Skills spec: https://agenstskills.com)",
|
||||
"type": "object",
|
||||
"required": ["name", "description"],
|
||||
"properties": {
|
||||
|
||||
@@ -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 (agentskills.io)',
|
||||
description: 'Validate skill(s) against the Agent Skills specification (agenstskills.com)',
|
||||
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://agentskills.io/specification for the complete format'));
|
||||
console.log(chalk.dim('See https://agenstskills.com for the complete format'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user