Compare commits

..
Author SHA1 Message Date
Rohit Ghumare 6eb06f647d fix(agents): getAllAdapters returns correct agent types
Fixed getAllAdapters() to return the correct agent type from the
record keys instead of relying on adapter.type property, which
was returning 'universal' for all UniversalAdapter instances.

This fixes the E2E test that checks for all 32 agents in init --list
output (cline, codebuddy, commandcode, etc. were showing as 'universal').
2026-01-29 19:19:35 +00:00
Rohit Ghumare 2d094fdd71 feat(primer): support multi-format output rendering
Refactored generateContent to properly respect the format field
instead of always producing Markdown output.

- Added FormatRenderer interface with format-specific implementations
- Created renderers for markdown, mdc, json, xml formats
- JSON format generates structured data via generateJsonContent()
- MDC format includes YAML frontmatter via wrap() method
- XML format properly escapes content with escapeXml()
- Updated all section generators to accept and use the renderer
2026-01-29 19:07:59 +00:00
Rohit Ghumare e9b5c647e2 fix: additional CodeRabbit review fixes for primer
- Fix Python detection to use correct source file (pyproject.toml, requirements.txt, or setup.py)
- Escape regex special characters in glob pattern matching (e.g., *.module.css)
- Derive ALL_AGENTS from AGENT_CONFIG to avoid divergence
- Map agent config format to template format based on file extension
2026-01-29 18:45:43 +00:00
Rohit Ghumare 8a51c73f2a fix: address CodeRabbit PR review issues for primer
- Fix OS-agnostic path handling in analyzer using path.relative() and path.sep
- Prevent output collisions when multiple agents produce same filename
- Add defensive check in test before accessing generated[0]
- Remove duplicate projectPath parameter in CLI primer command
- Use PackageManager enum instead of z.string() for type safety
- Detect monorepos before src-based layout to prevent misclassification
- Document --output and --json flags in README examples
2026-01-29 18:34:06 +00:00
Rohit Ghumare db277fedbc feat: add skillkit primer command for AI instruction generation
New feature that analyzes codebases and generates AI instruction files
for all 32 supported agents (inspired by pierceboggan/primer).

## New Module: packages/core/src/primer/
- types.ts: Zod schemas and TypeScript interfaces
- analyzer.ts: Codebase analysis (languages, frameworks, conventions)
- generator.ts: Agent-specific instruction file generation
- index.ts: Barrel exports
- __tests__/primer.test.ts: 15 comprehensive tests

## CLI Command: skillkit primer
- --agent/-a: Generate for specific agents
- --all-agents/-A: Generate for all 32 agents
- --output/-o: Custom output directory
- --dry-run/-n: Preview without writing
- --analyze-only: Show analysis only
- --verbose/-v: Detailed output
- --json/-j: JSON output

## Features
- Detects: languages, frameworks, package managers, libraries
- Analyzes: project structure, code conventions, CI/CD, Docker
- Generates: CLAUDE.md, .cursorrules, copilot-instructions.md, etc.
2026-01-29 13:36:00 +00:00
Rohit Ghumare f357c73e97 fix: update agent count from 17 to 32 across codebase (#24)
* fix: update agent count from 17 to 32 across codebase

- Update all documentation files (README.md, package READMEs)
- Update hardcoded AGENT_COUNT constant in onboarding
- Update JSDoc comments in core modules
- Update test files and e2e tests
- SkillKit now supports 32 AI coding agents:
  Primary: claude-code, codex, cursor, antigravity, opencode,
  gemini-cli, amp, clawdbot, droid, github-copilot, goose,
  kilo, kiro-cli, roo, trae, windsurf, universal
  Extended: cline, codebuddy, commandcode, continue, crush,
  factory, mcpjam, mux, neovate, openhands, pi, qoder, qwen,
  vercel, zencoder

* fix: add all 32 agents to documentation and tests

- apps/skillkit/README.md: Split agents into Primary (17) and Extended (15)
- e2e/onboarding-ui.e2e.test.ts: Add 15 extended agents to test array
- e2e/translation.e2e.test.ts: Add 15 extended agents to SUPPORTED_AGENTS
- README.md: Add extended agents to inline list and table
2026-01-29 13:21:58 +00:00
Rohit Ghumare 40e685fabe docs: update README and TUI with new commands and docs link
- Add docs badge and link to README
- Add all new commands: check, find, manifest, fix, audit, publish, status, pause/resume, settings, methodology, plan, plugin, team, hook, command
- Reorganize commands into logical sections
- Update TUI Help screen with new shortcuts
- Add 'd' key to open docs in browser from TUI
2026-01-29 11:58:33 +00:00
Rohit Ghumare 6099c0ad6c chore: bump version to 1.7.9 2026-01-29 11:47:42 +00:00
Rohit Ghumare 6445d72c80 fix: address CodeRabbit PR review issues
- Add noopener to rel="noreferrer" for tabnabbing protection
- Fix standalone skill path handling in readSkillContent and validateSkill
- Derive TOTAL_AGENTS from adapters instead of hardcoded value
- Fix duplicate discovery path for droid/factory agents
- Create dedicated FactoryAdapter instead of using UniversalAdapter
2026-01-29 11:26:40 +00:00
Rohit Ghumare 6d704a47b9 chore: bump version to 1.7.8 2026-01-29 11:25:34 +00:00
Rohit Ghumare dd1c675e15 chore: bump version to 1.7.7 2026-01-28 22:08:58 +00:00
Rohit Ghumare def3b01524 fix: mobile responsiveness for navbar docs link and skill generator
- Show Docs link on mobile (removed hidden sm:block)
- Add proper overflow handling for all code blocks on mobile
- Use smaller padding/text sizes on mobile screens
- Add break-words and whitespace-pre-wrap to prevent overflow
2026-01-28 22:07:09 +00:00
Rohit Ghumare b1d1ea3d24 correct website 2026-01-28 19:44:48 +00:00
Rohit Ghumare 7644de462a fix: add assetPrefix for absolute static asset URLs 2026-01-28 19:43:09 +00:00
Rohit Ghumare a0b34e076e fix: add rewrite for Next.js static assets from docs site 2026-01-28 19:42:34 +00:00
Rohit Ghumare 0a16de05c9 fix: correct domain from agentskills.com to agenstskills.com 2026-01-28 19:40:40 +00:00
Rohit Ghumare 750a6f206a fix: skip trailing slash redirect for proxy compatibility 2026-01-28 19:37:06 +00:00
Rohit Ghumare f73e043e87 fix: restore block-style ASCII logo with proper font 2026-01-28 19:03:03 +00:00
Rohit Ghumare 5dac9f0543 fix: remove root vercel.json to let Vercel use docs/skillkit config 2026-01-28 18:57:48 +00:00
Rohit Ghumare e38d132506 fix: update root vercel.json to deploy docs/skillkit 2026-01-28 18:57:06 +00:00
Rohit Ghumare ff52654549 fix: install Tailwind as build dependency instead of CDN for reliable styling 2026-01-28 18:53:00 +00:00
Rohit Ghumare dced3cecf3 fix: add inline styles for dark backgrounds to ensure proper rendering 2026-01-28 18:48:18 +00:00
Rohit Ghumare 7cedc53d68 fix: use standard ASCII characters for logo instead of Unicode blocks 2026-01-28 18:43:41 +00:00
Rohit Ghumare d4ad9096b7 feat: add favicon and metadata to fumadocs 2026-01-28 18:40:51 +00:00
Rohit Ghumare da434ccec1 chore: add root vercel.json for Vercel deployment 2026-01-28 18:37:41 +00:00
Rohit Ghumare 14c319e90e chore: add .vercel to gitignore 2026-01-28 18:37:07 +00:00
Rohit Ghumare 2d2e8aaace fix: use npm instead of pnpm in vercel.json to avoid workspace detection 2026-01-28 18:31:48 +00:00
Rohit Ghumare d1fcf0355f docs: add comprehensive documentation section to website (#23)
* docs: add comprehensive documentation section to website

- Create Documentation.tsx component with DeepWiki-sourced content
- Add sections: Overview, Installation, Architecture, Agents, Commands
- Add sections: Configuration, API Reference, Skill Format, Tech Stack
- Include interactive sidebar navigation
- Add Docs link to navbar
- Reference DeepWiki as documentation source

Source: https://deepwiki.com/rohitg00/skillkit

* feat(docs): add Fumadocs documentation site and update website

- Add Fumadocs-based documentation site at /docs
  - Complete MDX documentation for all features
  - TUI section with keyboard navigation
  - Installation, quickstart, commands reference
  - API reference and configuration guides

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

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

- Configure Vercel rewrites for /docs proxy to Fumadocs

* fix: resolve TypeScript build errors in fumadocs

- Remove createRelativeLink from docs page (not compatible with current fumadocs)
- Remove redundant isLoading prop in SkillGenerator (status already narrowed)
- Fix lucide-react icon type casting in Card component
- Fix MDXComponents return type in mdx-components

* fix: resolve /docs 404 and show docs link on mobile

- Handle undefined slug by defaulting to empty array for index page
- Remove hidden class from Docs link so it shows on mobile

* fix: address CodeRabbit review suggestions

- Move Gemini API key to server-side route (security)
- Add default type='button' to Button component
- Use dynamic agent count instead of hardcoded 32
- Add 'use client' directive to Documentation
- Fix stale closure in SkillSubmitForm with useCallback
- Add URL validation for external references
- Add noopener to external links for security
- Fix Clawdbot path in agents.mdx
- Update cicd.mdx with correct CLI commands
- Capitalize proper nouns (Markdown, provider names)
- Add text language to README code block
- Update date example in quickstart.mdx

* fix: add noopener to external links and improve nav accessibility

- Add noopener to rel attributes on external links for tabnabbing protection
- Add aria-label to nav element for screen readers
- Add type="button" and aria-current to nav buttons

* fix: add vercel.json for fumadocs deployment

* fix: disable turbo detection in Vercel deployment

* fix: clean up ASCII logo for better rendering

* fix: improve code block contrast in SkillGenerator

* fix: sync ASCII logo and code block contrast fixes to old Vite components

* fix: improve mobile responsiveness for tabs and header buttons

* fix: address CodeRabbit security and code quality suggestions

- Add rate limiting to API route (10 requests/min per IP)
- Add proper type validation for topic parameter
- Move API key check after input validation
- Add 'use client' directive to SkillGenerator
- Add YAML escape helper to prevent frontmatter injection
- Change vercel.json to use pnpm instead of npm
2026-01-28 18:29:14 +00:00
56 changed files with 3216 additions and 162 deletions
+2 -1
View File
@@ -63,4 +63,5 @@ skillkit.yaml
# Project documentation (not for version control)
CLAUDE.md
prd.md
prd.md
.vercel
+89 -10
View File
@@ -12,11 +12,12 @@
[![GitHub Package](https://img.shields.io/badge/GitHub%20Package-@rohitg00/skillkit-blue?logo=github)](https://github.com/rohitg00/skillkit/pkgs/npm/skillkit)
[![CI](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml/badge.svg)](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
[![Website](https://img.shields.io/badge/Website-agenstskills.com-black)](https://agenstskills.com)
[![Docs](https://img.shields.io/badge/Docs-agenstskills.com/docs-blue)](https://agenstskills.com/docs)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
## Supercharge Every AI Coding Agent
**Give your AI agents new abilities with portable, reusable skills.** Install from a curated marketplace, create your own, and use them across Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and 27 more agents.
**Give your AI agents new abilities with portable, reusable skills.** Install from a curated marketplace, create your own, and use them across Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and 27 more agents (32 total).
> **What are AI Agent Skills?** Skills are instruction files that teach AI coding agents how to handle specific tasks - like processing PDFs, following React best practices, or enforcing security patterns. Think of them as plugins for your AI assistant.
@@ -118,7 +119,7 @@ skillkit agent translate --source ./my-skills --to cursor
skillkit agent translate --source ./kubernetes-skills --to cursor --recursive
```
**Supported Agents:** Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Antigravity, Amp, Clawdbot, Droid, GitHub Copilot, Goose, Kilo, Kiro, Roo, Trae, Windsurf, Universal
**Supported Agents (32):** Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Antigravity, Amp, Clawdbot, Droid, GitHub Copilot, Goose, Kilo, Kiro, Roo, Trae, Windsurf, Universal, Cline, CodeBuddy, CommandCode, Continue, Crush, Factory, MCPJam, Mux, Neovate, OpenHands, Pi, Qoder, Qwen, Vercel, Zencoder
### Smart Recommendations
@@ -240,7 +241,7 @@ skillkit cicd gitlab-ci
skillkit cicd pre-commit
```
## Supported Agents (17)
## Supported Agents (32)
| Agent | Format | Skills Directory |
|-------|--------|------------------|
@@ -261,6 +262,21 @@ skillkit cicd pre-commit
| Trae | SKILL.md | `.trae/skills/` |
| Windsurf | Markdown | `.windsurf/skills/` |
| Universal | SKILL.md | `skills/` |
| Cline | SKILL.md | `.cline/skills/` |
| CodeBuddy | SKILL.md | `.codebuddy/skills/` |
| CommandCode | SKILL.md | `.commandcode/skills/` |
| Continue | SKILL.md | `.continue/skills/` |
| Crush | SKILL.md | `.crush/skills/` |
| Factory | SKILL.md | `.factory/skills/` |
| MCPJam | SKILL.md | `.mcpjam/skills/` |
| Mux | SKILL.md | `.mux/skills/` |
| Neovate | SKILL.md | `.neovate/skills/` |
| OpenHands | SKILL.md | `.openhands/skills/` |
| Pi | SKILL.md | `.pi/skills/` |
| Qoder | SKILL.md | `.qoder/skills/` |
| Qwen | SKILL.md | `.qwen/skills/` |
| Vercel | SKILL.md | `.vercel/skills/` |
| Zencoder | SKILL.md | `.zencoder/skills/` |
## All Commands
@@ -272,9 +288,11 @@ skillkit remove <skills> # Remove installed skills
skillkit update [skills] # Update skills from source
skillkit list # List installed skills
skillkit enable <skills> # Enable specific skills
skillkit disable <skills> # Disable specific skills
skillkit pause <skills> # Temporarily pause skills
skillkit resume <skills> # Resume paused skills
skillkit sync # Sync skills to agent config
skillkit read <skills> # Read skill content for AI
skillkit status # Show skill and agent status
```
### Discovery & Recommendations
@@ -283,6 +301,8 @@ skillkit read <skills> # Read skill content for AI
skillkit recommend # Get smart recommendations
skillkit marketplace # Browse skill marketplace
skillkit marketplace search # Search marketplace
skillkit find <query> # Quick skill search
skillkit check # Check skill health and updates
```
### Translation & Context
@@ -293,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
@@ -317,20 +354,60 @@ skillkit memory compress # Compress observations
skillkit memory export # Export as skill
```
### Testing & Workflows
### Quality & Testing
```bash
skillkit test # Run skill tests
skillkit workflow run # Execute workflow
skillkit cicd # Generate CI/CD templates
skillkit validate # Validate skill format
skillkit fix # Auto-fix skill issues
skillkit audit # Audit skills for security/quality
skillkit manifest # Generate skill manifest
```
### Utilities
### Team Collaboration
```bash
skillkit init # Initialize in project
skillkit validate # Validate skill format
skillkit team init # Initialize team workspace
skillkit team share # Share skills with team
skillkit team import # Import team skills
skillkit team sync # Sync team skills
skillkit team list # List team members
```
### Workflows & Automation
```bash
skillkit workflow run # Execute workflow
skillkit plan create # Create execution plan
skillkit plan execute # Execute a plan
skillkit cicd init # Generate CI/CD templates
skillkit hook register # Register lifecycle hooks
skillkit command generate # Generate slash commands
```
### Plugins & Extensions
```bash
skillkit plugin list # List available plugins
skillkit plugin install # Install a plugin
skillkit plugin enable # Enable a plugin
skillkit methodology list # List methodologies
skillkit methodology load # Load a methodology
```
### Publishing & Sharing
```bash
skillkit publish # Publish skill to marketplace
skillkit create # Create new skill
skillkit init # Initialize in project
```
### Configuration
```bash
skillkit settings # View/edit settings
skillkit settings --set key=value # Update setting
```
## Creating Skills
@@ -469,6 +546,8 @@ Contributions welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md
## Links
- [Documentation](https://agenstskills.com/docs)
- [Website](https://agenstskills.com)
- [Agent Skills Specification](https://agentskills.io/specification)
- [GitHub Repository](https://github.com/rohitg00/skillkit)
- [NPM Package](https://www.npmjs.com/package/skillkit)
+5 -3
View File
@@ -1,6 +1,6 @@
# SkillKit
Universal skills manager for AI coding agents. Install, manage, and sync skills across 17+ AI agents including Claude Code, Cursor, Codex, Gemini CLI, and more.
Universal skills manager for AI coding agents. Install, manage, and sync skills across 32 AI agents including Claude Code, Cursor, Codex, Gemini CLI, and more.
## Installation
@@ -150,9 +150,11 @@ skillkit memory compress
skillkit memory export auth-insight --output auth-skill.md
```
## Supported Agents (17)
## Supported Agents (32)
Claude Code, Cursor, Codex, Gemini CLI, Windsurf, GitHub Copilot, OpenCode, Antigravity, Amp, Clawdbot, Droid, Goose, Kilo, Kiro, Roo, Trae, Universal
**Primary (17):** Claude Code, Cursor, Codex, Gemini CLI, Windsurf, GitHub Copilot, OpenCode, Antigravity, Amp, Clawdbot, Droid, Goose, Kilo, Kiro, Roo, Trae, Universal
**Extended (15):** Cline, CodeBuddy, CommandCode, Continue, Crush, Factory, MCPJam, Mux, Neovate, OpenHands, Pi, Qoder, Qwen, Vercel, Zencoder
## Usage Examples
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit",
"version": "1.7.6",
"version": "1.7.9",
"description": "Supercharge AI coding agents with portable skills. Install, translate, and share skills across Claude Code, Cursor, Codex, Copilot & 13 more",
"type": "module",
"bin": {
+2 -1
View File
@@ -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));
+1
View File
@@ -4,3 +4,4 @@ node_modules/
out/
.turbo/
*.tsbuildinfo
.vercel
+3
View File
@@ -5,6 +5,9 @@ const withMDX = createMDX();
/** @type {import('next').NextConfig} */
const config = {
reactStrictMode: true,
trailingSlash: false,
skipTrailingSlashRedirect: true,
assetPrefix: 'https://skillkit-docs.vercel.app',
};
export default withMDX(config);
Binary file not shown.

After

Width:  |  Height:  |  Size: 1.0 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 437 B

+4
View File
@@ -0,0 +1,4 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">
<rect width="32" height="32" fill="#000000"/>
<rect x="8" y="8" width="16" height="16" fill="#ffffff"/>
</svg>

After

Width:  |  Height:  |  Size: 176 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 158 KiB

+30
View File
@@ -1,12 +1,42 @@
import { RootProvider } from 'fumadocs-ui/provider/next'
import './global.css'
import { Inter } from 'next/font/google'
import type { Metadata } from 'next'
const inter = Inter({
subsets: ['latin'],
weight: ['400', '500', '600', '700'],
})
export const metadata: Metadata = {
title: {
default: 'SkillKit - Universal Skills for AI Coding Agents',
template: '%s | SkillKit',
},
description: 'One CLI to install, sync, and manage skills across Claude Code, Cursor, Windsurf, Copilot, and 28 more agents. 15,000+ skills ready to use.',
icons: {
icon: [
{ url: '/favicon.svg', type: 'image/svg+xml' },
{ url: '/favicon-32.png', sizes: '32x32', type: 'image/png' },
],
apple: '/apple-touch-icon.png',
},
openGraph: {
title: 'SkillKit - Universal Skills for AI Coding Agents',
description: 'One CLI to install, sync, and manage skills across Claude Code, Cursor, Windsurf, Copilot, and 28 more agents.',
url: 'https://agenstskills.com',
siteName: 'SkillKit',
images: [{ url: '/og-image.png', width: 1200, height: 630 }],
type: 'website',
},
twitter: {
card: 'summary_large_image',
title: 'SkillKit - Universal Skills for AI Coding Agents',
description: 'One CLI to install, sync, and manage skills across Claude Code, Cursor, Windsurf, Copilot, and 28 more agents.',
images: ['/og-image.png'],
},
}
export default function Layout({ children }: { children: React.ReactNode }) {
return (
<html lang="en" className={inter.className} suppressHydrationWarning>
+1 -1
View File
@@ -18,7 +18,7 @@ export function Footer(): React.ReactElement {
</p>
<span className="hidden sm:inline text-zinc-700">•</span>
<a
href="https://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"
+6 -6
View File
@@ -2,11 +2,11 @@ import React, { useState, useEffect } from 'react';
import { Button } from './Button';
const ASCII_LOGO = `
███████ ██ ██ ██ ██ ██ ██ ██ ██ ████████
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
███████ █████ ██ ██ ██ █████ ██ ██
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
███████ ██ ██ ██ ███████ ███████ ██ ██ ██ ██
____ _ __ _ _ _ _ __ _ _____
/ ___|| |/ /| || | | | | |/ /| ||_ _|
\\___ \\| ' / | || | | | | ' / | | | |
___) | . \\ | || |___ | |___ | . \\ | | | |
|____/|_|\\_\\|_||_____||_____||_|\\_\\|_| |_|
`.trim();
interface TerminalLine {
@@ -116,7 +116,7 @@ export function Hero(): React.ReactElement {
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8 pt-8 pb-10 relative">
<div className="hidden lg:block mb-6 overflow-hidden">
<pre className="text-zinc-700 text-[10px] leading-tight font-mono select-none whitespace-pre">
<pre className="text-zinc-500 text-[11px] leading-tight font-mono select-none whitespace-pre">
{ASCII_LOGO}
</pre>
</div>
-13
View File
@@ -1,13 +0,0 @@
{
"$schema": "https://turbo.build/schema.json",
"extends": [],
"tasks": {
"build": {
"outputs": [".next/**", "!.next/cache/**"]
},
"dev": {
"cache": false,
"persistent": true
}
}
}
+5 -5
View File
@@ -26,8 +26,8 @@ function scrollToTop(e: React.MouseEvent): void {
export default function App(): React.ReactElement {
return (
<div className="min-h-screen bg-background text-zinc-100 font-sans selection:bg-white selection:text-black">
<nav className="fixed top-0 left-0 right-0 z-50 border-b border-zinc-800 bg-background/90 backdrop-blur-md">
<div className="min-h-screen text-zinc-100 font-sans selection:bg-white selection:text-black" style={{ backgroundColor: '#000000' }}>
<nav className="fixed top-0 left-0 right-0 z-50 border-b border-zinc-800 backdrop-blur-md" style={{ backgroundColor: 'rgba(0,0,0,0.9)' }}>
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="flex h-14 items-center justify-between">
<a href="#" onClick={scrollToTop} className="flex items-center gap-2 cursor-pointer">
@@ -36,8 +36,8 @@ export default function App(): React.ReactElement {
</a>
<div className="flex items-center gap-2 sm:gap-4">
<a
href="https://agentskills.com/docs"
className="text-zinc-400 hover:text-white transition-colors text-sm font-mono hidden sm:block"
href="https://agenstskills.com/docs"
className="text-zinc-400 hover:text-white transition-colors text-sm font-mono"
>
Docs
</a>
@@ -74,7 +74,7 @@ export default function App(): React.ReactElement {
<SkillGenerator />
</section>
<section id="submit" className="py-12 border-b border-zinc-800 bg-surface">
<section id="submit" className="py-12 border-b border-zinc-800" style={{ backgroundColor: '#09090b' }}>
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="text-center mb-8">
<h2 className="text-2xl font-bold text-white mb-2 font-mono">Submit Your Skill</h2>
+2 -1
View File
@@ -34,7 +34,8 @@ export function Card({
return (
<div
className={`relative bg-black border border-zinc-800 transition-colors duration-300 ${paddingClass} ${clickableClass} ${className}`}
className={`relative border border-zinc-800 transition-colors duration-300 ${paddingClass} ${clickableClass} ${className}`}
style={{ backgroundColor: '#000000' }}
onClick={onClick}
role={onClick ? 'button' : undefined}
tabIndex={onClick ? 0 : undefined}
+1 -1
View File
@@ -10,7 +10,7 @@ export function Footer(): React.ReactElement {
const currentYear = new Date().getFullYear();
return (
<footer className="border-t border-border py-6 bg-black">
<footer className="border-t border-border py-6" style={{ backgroundColor: '#000000' }}>
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8 flex flex-col sm:flex-row justify-between items-center gap-3">
<div className="flex flex-col sm:flex-row items-center gap-2 sm:gap-4 text-center sm:text-left">
<p className="text-zinc-500 text-xs font-mono">
+7 -6
View File
@@ -2,11 +2,12 @@ import React, { useState, useEffect } from 'react';
import { Button } from './Button';
const ASCII_LOGO = `
███████ ██ ██ ██ ██ ██ ██ ██ ██ ████████
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
███████ █████ ██ ██ ██ █████ ██ ██
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
███████ ██ ██ ██ ███████ ███████ ██ ██ ██ ██
███████╗██╗ ██╗██╗██╗ ██╗ ██╗ ██╗██╗████████╗
██╔════╝██║ ██╔╝██║██║ ██║ ██║ ██╔╝██║╚══██╔══╝
███████╗█████╔╝ ██║██║ ██║ █████╔╝ ██║ ██║
╚════██║██╔═██╗ ██║██║ ██║ ██╔═██╗ ██║ ██║
███████║██║ ██╗██║███████╗███████╗██║ ██╗██║ ██║
╚══════╝╚═╝ ╚═╝╚═╝╚══════╝╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝
`.trim();
interface TerminalLine {
@@ -116,7 +117,7 @@ export function Hero(): React.ReactElement {
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8 pt-8 pb-10 relative">
<div className="hidden lg:block mb-6 overflow-hidden">
<pre className="text-zinc-800 text-[8px] leading-none font-mono select-none animate-pulse">
<pre className="text-zinc-600 text-[10px] leading-none font-mono select-none whitespace-pre" style={{ fontFamily: 'JetBrains Mono, Consolas, monospace' }}>
{ASCII_LOGO}
</pre>
</div>
+11 -11
View File
@@ -464,11 +464,11 @@ ${skillContent.slice(0, 4000)}${skillContent.length > 4000 ? '\n...(truncated)'
{status === LoadingState.LOADING ? (
<div className="text-zinc-500 font-mono text-sm">Loading content...</div>
) : skillContent ? (
<pre className="bg-zinc-900 border border-zinc-700 p-6 overflow-x-auto text-sm max-h-[600px] overflow-y-auto">
<code className="text-zinc-100 font-mono whitespace-pre-wrap">{skillContent}</code>
<pre className="border border-zinc-700 p-4 sm:p-6 overflow-x-auto text-xs sm:text-sm max-h-[600px] overflow-y-auto max-w-full" style={{ backgroundColor: '#18181b' }}>
<code className="font-mono whitespace-pre-wrap break-words" style={{ color: '#f4f4f5' }}>{skillContent}</code>
</pre>
) : (
<div className="bg-zinc-950 border border-zinc-800 p-6">
<div className="border border-zinc-800 p-6" style={{ backgroundColor: '#09090b' }}>
<p className="text-zinc-400 font-mono text-sm mb-4">
Skill content not available for direct preview.
</p>
@@ -488,8 +488,8 @@ ${skillContent.slice(0, 4000)}${skillContent.length > 4000 ? '\n...(truncated)'
<div className="mt-6 pt-6 border-t border-zinc-800">
<p className="text-zinc-500 font-mono text-sm mb-3">Install with SkillKit:</p>
<pre className="bg-zinc-950 border border-zinc-800 p-4 text-sm overflow-x-auto">
<code className="text-zinc-300 font-mono text-xs sm:text-sm whitespace-nowrap">
<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('/')}
</code>
</pre>
@@ -595,8 +595,8 @@ ${skillContent.slice(0, 4000)}${skillContent.length > 4000 ? '\n...(truncated)'
<Card key={idx} className="hover:border-zinc-600 transition-colors">
<h4 className="text-lg font-semibold text-white mb-2">{pattern.name}</h4>
<p className="text-zinc-400 mb-4">{pattern.description}</p>
<pre className="bg-zinc-900 border border-zinc-700 p-4 overflow-x-auto text-sm">
<code className="text-zinc-100 font-mono">{pattern.example}</code>
<pre className="border border-zinc-700 p-3 sm:p-4 overflow-x-auto text-xs sm:text-sm max-w-full" style={{ backgroundColor: '#18181b' }}>
<code className="font-mono whitespace-pre-wrap break-words" style={{ color: '#f4f4f5' }}>{pattern.example}</code>
</pre>
</Card>
))}
@@ -608,16 +608,16 @@ ${skillContent.slice(0, 4000)}${skillContent.length > 4000 ? '\n...(truncated)'
{ap.badExample && (
<div className="mb-4">
<div className="text-xs font-mono text-red-400 mb-1 uppercase">Bad</div>
<pre className="bg-red-950/50 border border-red-800/50 p-4 overflow-x-auto text-sm">
<code className="text-red-100 font-mono">{ap.badExample}</code>
<pre className="border border-red-800/50 p-3 sm:p-4 overflow-x-auto text-xs sm:text-sm max-w-full" style={{ backgroundColor: '#450a0a' }}>
<code className="font-mono whitespace-pre-wrap break-words" style={{ color: '#fecaca' }}>{ap.badExample}</code>
</pre>
</div>
)}
{ap.goodExample && (
<div>
<div className="text-xs font-mono text-green-400 mb-1 uppercase">Good</div>
<pre className="bg-green-950/30 border border-green-800/50 p-4 overflow-x-auto text-sm">
<code className="text-green-100 font-mono">{ap.goodExample}</code>
<pre className="border border-green-800/50 p-3 sm:p-4 overflow-x-auto text-xs sm:text-sm max-w-full" style={{ backgroundColor: '#052e16' }}>
<code className="font-mono whitespace-pre-wrap break-words" style={{ color: '#bbf7d0' }}>{ap.goodExample}</code>
</pre>
</div>
)}
-75
View File
@@ -22,84 +22,9 @@
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32.png" />
<link rel="apple-touch-icon" href="/apple-touch-icon.png" />
<script src="https://cdn.tailwindcss.com"></script>
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
<script>
tailwind.config = {
darkMode: 'class',
theme: {
screens: {
'xs': '475px',
'sm': '640px',
'md': '768px',
'lg': '1024px',
'xl': '1280px',
'2xl': '1536px',
},
extend: {
fontFamily: {
sans: ['Inter', 'sans-serif'],
mono: ['JetBrains Mono', 'monospace'],
},
colors: {
background: '#000000',
surface: '#09090b',
border: '#27272a',
highlight: '#ffffff',
},
animation: {
'cursor-blink': 'blink 1s step-end infinite',
},
keyframes: {
blink: {
'0%, 100%': { opacity: '1' },
'50%': { opacity: '0' },
}
}
}
}
}
</script>
<style>
body {
background-color: #000000;
color: #e4e4e7;
font-family: 'Inter', sans-serif;
}
h1, h2, h3, h4, h5, h6, .font-mono {
font-family: 'JetBrains Mono', monospace;
}
::selection {
background-color: #ffffff;
color: #000000;
}
::-webkit-scrollbar {
width: 10px;
background: #000000;
}
::-webkit-scrollbar-thumb {
background: #27272a;
border: 1px solid #000000;
}
::-webkit-scrollbar-thumb:hover {
background: #3f3f46;
}
.terminal-scanline {
background: linear-gradient(to bottom, rgba(255,255,255,0), rgba(255,255,255,0) 50%, rgba(0,0,0,0.1) 50%, rgba(0,0,0,0.1));
background-size: 100% 4px;
position: absolute;
top: 0;
left: 0;
right: 0;
bottom: 0;
pointer-events: none;
z-index: 10;
opacity: 0.1;
}
</style>
<script type="importmap">
{
"imports": {
+1
View File
@@ -1,5 +1,6 @@
import React from 'react';
import ReactDOM from 'react-dom/client';
import './styles.css';
import App from './App';
const rootElement = document.getElementById('root');
+1 -1
View File
@@ -1,5 +1,5 @@
{
"name": "SkillKit",
"description": "Supercharge Every AI Coding Agent. Translate, manage, and sync skills across Claude, Cursor, Windsurf, and 17+ agents.",
"description": "Supercharge Every AI Coding Agent. Translate, manage, and sync skills across Claude, Cursor, Windsurf, and 32 agents.",
"requestFramePermissions": []
}
+679
View File
@@ -13,12 +13,29 @@
"react-dom": "^19.2.3"
},
"devDependencies": {
"@tailwindcss/postcss": "^4.1.18",
"@types/node": "^22.14.0",
"@vitejs/plugin-react": "^5.0.0",
"autoprefixer": "^10.4.23",
"postcss": "^8.5.6",
"tailwindcss": "^4.1.18",
"typescript": "~5.8.2",
"vite": "^6.2.0"
}
},
"node_modules/@alloc/quick-lru": {
"version": "5.2.0",
"resolved": "https://registry.npmjs.org/@alloc/quick-lru/-/quick-lru-5.2.0.tgz",
"integrity": "sha512-UrcABB+4bUrFABwbluTIBErXwvbsU/V7TZWfmbgJfbkwiBuziS9gxdODUyuiecfdGQ85jglMW6juS3+z5TsKLw==",
"dev": true,
"license": "MIT",
"engines": {
"node": ">=10"
},
"funding": {
"url": "https://github.com/sponsors/sindresorhus"
}
},
"node_modules/@babel/code-frame": {
"version": "7.28.6",
"resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.28.6.tgz",
@@ -1263,6 +1280,277 @@
"win32"
]
},
"node_modules/@tailwindcss/node": {
"version": "4.1.18",
"resolved": "https://registry.npmjs.org/@tailwindcss/node/-/node-4.1.18.tgz",
"integrity": "sha512-DoR7U1P7iYhw16qJ49fgXUlry1t4CpXeErJHnQ44JgTSKMaZUdf17cfn5mHchfJ4KRBZRFA/Coo+MUF5+gOaCQ==",
"dev": true,
"license": "MIT",
"dependencies": {
"@jridgewell/remapping": "^2.3.4",
"enhanced-resolve": "^5.18.3",
"jiti": "^2.6.1",
"lightningcss": "1.30.2",
"magic-string": "^0.30.21",
"source-map-js": "^1.2.1",
"tailwindcss": "4.1.18"
}
},
"node_modules/@tailwindcss/oxide": {
"version": "4.1.18",
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide/-/oxide-4.1.18.tgz",
"integrity": "sha512-EgCR5tTS5bUSKQgzeMClT6iCY3ToqE1y+ZB0AKldj809QXk1Y+3jB0upOYZrn9aGIzPtUsP7sX4QQ4XtjBB95A==",
"dev": true,
"license": "MIT",
"engines": {
"node": ">= 10"
},
"optionalDependencies": {
"@tailwindcss/oxide-android-arm64": "4.1.18",
"@tailwindcss/oxide-darwin-arm64": "4.1.18",
"@tailwindcss/oxide-darwin-x64": "4.1.18",
"@tailwindcss/oxide-freebsd-x64": "4.1.18",
"@tailwindcss/oxide-linux-arm-gnueabihf": "4.1.18",
"@tailwindcss/oxide-linux-arm64-gnu": "4.1.18",
"@tailwindcss/oxide-linux-arm64-musl": "4.1.18",
"@tailwindcss/oxide-linux-x64-gnu": "4.1.18",
"@tailwindcss/oxide-linux-x64-musl": "4.1.18",
"@tailwindcss/oxide-wasm32-wasi": "4.1.18",
"@tailwindcss/oxide-win32-arm64-msvc": "4.1.18",
"@tailwindcss/oxide-win32-x64-msvc": "4.1.18"
}
},
"node_modules/@tailwindcss/oxide-android-arm64": {
"version": "4.1.18",
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-android-arm64/-/oxide-android-arm64-4.1.18.tgz",
"integrity": "sha512-dJHz7+Ugr9U/diKJA0W6N/6/cjI+ZTAoxPf9Iz9BFRF2GzEX8IvXxFIi/dZBloVJX/MZGvRuFA9rqwdiIEZQ0Q==",
"cpu": [
"arm64"
],
"dev": true,
"license": "MIT",
"optional": true,
"os": [
"android"
],
"engines": {
"node": ">= 10"
}
},
"node_modules/@tailwindcss/oxide-darwin-arm64": {
"version": "4.1.18",
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-darwin-arm64/-/oxide-darwin-arm64-4.1.18.tgz",
"integrity": "sha512-Gc2q4Qhs660bhjyBSKgq6BYvwDz4G+BuyJ5H1xfhmDR3D8HnHCmT/BSkvSL0vQLy/nkMLY20PQ2OoYMO15Jd0A==",
"cpu": [
"arm64"
],
"dev": true,
"license": "MIT",
"optional": true,
"os": [
"darwin"
],
"engines": {
"node": ">= 10"
}
},
"node_modules/@tailwindcss/oxide-darwin-x64": {
"version": "4.1.18",
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-darwin-x64/-/oxide-darwin-x64-4.1.18.tgz",
"integrity": "sha512-FL5oxr2xQsFrc3X9o1fjHKBYBMD1QZNyc1Xzw/h5Qu4XnEBi3dZn96HcHm41c/euGV+GRiXFfh2hUCyKi/e+yw==",
"cpu": [
"x64"
],
"dev": true,
"license": "MIT",
"optional": true,
"os": [
"darwin"
],
"engines": {
"node": ">= 10"
}
},
"node_modules/@tailwindcss/oxide-freebsd-x64": {
"version": "4.1.18",
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-freebsd-x64/-/oxide-freebsd-x64-4.1.18.tgz",
"integrity": "sha512-Fj+RHgu5bDodmV1dM9yAxlfJwkkWvLiRjbhuO2LEtwtlYlBgiAT4x/j5wQr1tC3SANAgD+0YcmWVrj8R9trVMA==",
"cpu": [
"x64"
],
"dev": true,
"license": "MIT",
"optional": true,
"os": [
"freebsd"
],
"engines": {
"node": ">= 10"
}
},
"node_modules/@tailwindcss/oxide-linux-arm-gnueabihf": {
"version": "4.1.18",
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm-gnueabihf/-/oxide-linux-arm-gnueabihf-4.1.18.tgz",
"integrity": "sha512-Fp+Wzk/Ws4dZn+LV2Nqx3IilnhH51YZoRaYHQsVq3RQvEl+71VGKFpkfHrLM/Li+kt5c0DJe/bHXK1eHgDmdiA==",
"cpu": [
"arm"
],
"dev": true,
"license": "MIT",
"optional": true,
"os": [
"linux"
],
"engines": {
"node": ">= 10"
}
},
"node_modules/@tailwindcss/oxide-linux-arm64-gnu": {
"version": "4.1.18",
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm64-gnu/-/oxide-linux-arm64-gnu-4.1.18.tgz",
"integrity": "sha512-S0n3jboLysNbh55Vrt7pk9wgpyTTPD0fdQeh7wQfMqLPM/Hrxi+dVsLsPrycQjGKEQk85Kgbx+6+QnYNiHalnw==",
"cpu": [
"arm64"
],
"dev": true,
"license": "MIT",
"optional": true,
"os": [
"linux"
],
"engines": {
"node": ">= 10"
}
},
"node_modules/@tailwindcss/oxide-linux-arm64-musl": {
"version": "4.1.18",
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm64-musl/-/oxide-linux-arm64-musl-4.1.18.tgz",
"integrity": "sha512-1px92582HkPQlaaCkdRcio71p8bc8i/ap5807tPRDK/uw953cauQBT8c5tVGkOwrHMfc2Yh6UuxaH4vtTjGvHg==",
"cpu": [
"arm64"
],
"dev": true,
"license": "MIT",
"optional": true,
"os": [
"linux"
],
"engines": {
"node": ">= 10"
}
},
"node_modules/@tailwindcss/oxide-linux-x64-gnu": {
"version": "4.1.18",
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-x64-gnu/-/oxide-linux-x64-gnu-4.1.18.tgz",
"integrity": "sha512-v3gyT0ivkfBLoZGF9LyHmts0Isc8jHZyVcbzio6Wpzifg/+5ZJpDiRiUhDLkcr7f/r38SWNe7ucxmGW3j3Kb/g==",
"cpu": [
"x64"
],
"dev": true,
"license": "MIT",
"optional": true,
"os": [
"linux"
],
"engines": {
"node": ">= 10"
}
},
"node_modules/@tailwindcss/oxide-linux-x64-musl": {
"version": "4.1.18",
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-x64-musl/-/oxide-linux-x64-musl-4.1.18.tgz",
"integrity": "sha512-bhJ2y2OQNlcRwwgOAGMY0xTFStt4/wyU6pvI6LSuZpRgKQwxTec0/3Scu91O8ir7qCR3AuepQKLU/kX99FouqQ==",
"cpu": [
"x64"
],
"dev": true,
"license": "MIT",
"optional": true,
"os": [
"linux"
],
"engines": {
"node": ">= 10"
}
},
"node_modules/@tailwindcss/oxide-wasm32-wasi": {
"version": "4.1.18",
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-wasm32-wasi/-/oxide-wasm32-wasi-4.1.18.tgz",
"integrity": "sha512-LffYTvPjODiP6PT16oNeUQJzNVyJl1cjIebq/rWWBF+3eDst5JGEFSc5cWxyRCJ0Mxl+KyIkqRxk1XPEs9x8TA==",
"bundleDependencies": [
"@napi-rs/wasm-runtime",
"@emnapi/core",
"@emnapi/runtime",
"@tybys/wasm-util",
"@emnapi/wasi-threads",
"tslib"
],
"cpu": [
"wasm32"
],
"dev": true,
"license": "MIT",
"optional": true,
"dependencies": {
"@emnapi/core": "^1.7.1",
"@emnapi/runtime": "^1.7.1",
"@emnapi/wasi-threads": "^1.1.0",
"@napi-rs/wasm-runtime": "^1.1.0",
"@tybys/wasm-util": "^0.10.1",
"tslib": "^2.4.0"
},
"engines": {
"node": ">=14.0.0"
}
},
"node_modules/@tailwindcss/oxide-win32-arm64-msvc": {
"version": "4.1.18",
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-win32-arm64-msvc/-/oxide-win32-arm64-msvc-4.1.18.tgz",
"integrity": "sha512-HjSA7mr9HmC8fu6bdsZvZ+dhjyGCLdotjVOgLA2vEqxEBZaQo9YTX4kwgEvPCpRh8o4uWc4J/wEoFzhEmjvPbA==",
"cpu": [
"arm64"
],
"dev": true,
"license": "MIT",
"optional": true,
"os": [
"win32"
],
"engines": {
"node": ">= 10"
}
},
"node_modules/@tailwindcss/oxide-win32-x64-msvc": {
"version": "4.1.18",
"resolved": "https://registry.npmjs.org/@tailwindcss/oxide-win32-x64-msvc/-/oxide-win32-x64-msvc-4.1.18.tgz",
"integrity": "sha512-bJWbyYpUlqamC8dpR7pfjA0I7vdF6t5VpUGMWRkXVE3AXgIZjYUYAK7II1GNaxR8J1SSrSrppRar8G++JekE3Q==",
"cpu": [
"x64"
],
"dev": true,
"license": "MIT",
"optional": true,
"os": [
"win32"
],
"engines": {
"node": ">= 10"
}
},
"node_modules/@tailwindcss/postcss": {
"version": "4.1.18",
"resolved": "https://registry.npmjs.org/@tailwindcss/postcss/-/postcss-4.1.18.tgz",
"integrity": "sha512-Ce0GFnzAOuPyfV5SxjXGn0CubwGcuDB0zcdaPuCSzAa/2vII24JTkH+I6jcbXLb1ctjZMZZI6OjDaLPJQL1S0g==",
"dev": true,
"license": "MIT",
"dependencies": {
"@alloc/quick-lru": "^5.2.0",
"@tailwindcss/node": "4.1.18",
"@tailwindcss/oxide": "4.1.18",
"postcss": "^8.4.41",
"tailwindcss": "4.1.18"
}
},
"node_modules/@types/babel__core": {
"version": "7.20.5",
"resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.20.5.tgz",
@@ -1378,6 +1666,43 @@
"url": "https://github.com/chalk/ansi-styles?sponsor=1"
}
},
"node_modules/autoprefixer": {
"version": "10.4.23",
"resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-10.4.23.tgz",
"integrity": "sha512-YYTXSFulfwytnjAPlw8QHncHJmlvFKtczb8InXaAx9Q0LbfDnfEYDE55omerIJKihhmU61Ft+cAOSzQVaBUmeA==",
"dev": true,
"funding": [
{
"type": "opencollective",
"url": "https://opencollective.com/postcss/"
},
{
"type": "tidelift",
"url": "https://tidelift.com/funding/github/npm/autoprefixer"
},
{
"type": "github",
"url": "https://github.com/sponsors/ai"
}
],
"license": "MIT",
"dependencies": {
"browserslist": "^4.28.1",
"caniuse-lite": "^1.0.30001760",
"fraction.js": "^5.3.4",
"picocolors": "^1.1.1",
"postcss-value-parser": "^4.2.0"
},
"bin": {
"autoprefixer": "bin/autoprefixer"
},
"engines": {
"node": "^10 || ^12 || >=14"
},
"peerDependencies": {
"postcss": "^8.1.0"
}
},
"node_modules/balanced-match": {
"version": "1.0.2",
"resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
@@ -1558,6 +1883,16 @@
}
}
},
"node_modules/detect-libc": {
"version": "2.1.2",
"resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
"integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",
"dev": true,
"license": "Apache-2.0",
"engines": {
"node": ">=8"
}
},
"node_modules/eastasianwidth": {
"version": "0.2.0",
"resolved": "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz",
@@ -1586,6 +1921,20 @@
"integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==",
"license": "MIT"
},
"node_modules/enhanced-resolve": {
"version": "5.18.4",
"resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.18.4.tgz",
"integrity": "sha512-LgQMM4WXU3QI+SYgEc2liRgznaD5ojbmY3sb8LxyguVkIg5FxdpTkvk72te2R38/TGKxH634oLxXRGY6d7AP+Q==",
"dev": true,
"license": "MIT",
"dependencies": {
"graceful-fs": "^4.2.4",
"tapable": "^2.2.0"
},
"engines": {
"node": ">=10.13.0"
}
},
"node_modules/esbuild": {
"version": "0.25.12",
"resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.12.tgz",
@@ -1713,6 +2062,20 @@
"node": ">=12.20.0"
}
},
"node_modules/fraction.js": {
"version": "5.3.4",
"resolved": "https://registry.npmjs.org/fraction.js/-/fraction.js-5.3.4.tgz",
"integrity": "sha512-1X1NTtiJphryn/uLQz3whtY6jK3fTqoE3ohKs0tT+Ujr1W59oopxmoEh7Lu5p6vBaPbgoM0bzveAW4Qi5RyWDQ==",
"dev": true,
"license": "MIT",
"engines": {
"node": "*"
},
"funding": {
"type": "github",
"url": "https://github.com/sponsors/rawify"
}
},
"node_modules/fsevents": {
"version": "2.3.3",
"resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
@@ -1814,6 +2177,13 @@
"node": ">=14"
}
},
"node_modules/graceful-fs": {
"version": "4.2.11",
"resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
"integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
"dev": true,
"license": "ISC"
},
"node_modules/gtoken": {
"version": "8.0.0",
"resolved": "https://registry.npmjs.org/gtoken/-/gtoken-8.0.0.tgz",
@@ -1870,6 +2240,16 @@
"@pkgjs/parseargs": "^0.11.0"
}
},
"node_modules/jiti": {
"version": "2.6.1",
"resolved": "https://registry.npmjs.org/jiti/-/jiti-2.6.1.tgz",
"integrity": "sha512-ekilCSN1jwRvIbgeg/57YFh8qQDNbwDb9xT/qu2DAHbFFZUicIl4ygVaAvzveMhMVr3LnpSKTNnwt8PoOfmKhQ==",
"dev": true,
"license": "MIT",
"bin": {
"jiti": "lib/jiti-cli.mjs"
}
},
"node_modules/js-tokens": {
"version": "4.0.0",
"resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
@@ -1933,6 +2313,267 @@
"safe-buffer": "^5.0.1"
}
},
"node_modules/lightningcss": {
"version": "1.30.2",
"resolved": "https://registry.npmjs.org/lightningcss/-/lightningcss-1.30.2.tgz",
"integrity": "sha512-utfs7Pr5uJyyvDETitgsaqSyjCb2qNRAtuqUeWIAKztsOYdcACf2KtARYXg2pSvhkt+9NfoaNY7fxjl6nuMjIQ==",
"dev": true,
"license": "MPL-2.0",
"dependencies": {
"detect-libc": "^2.0.3"
},
"engines": {
"node": ">= 12.0.0"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/parcel"
},
"optionalDependencies": {
"lightningcss-android-arm64": "1.30.2",
"lightningcss-darwin-arm64": "1.30.2",
"lightningcss-darwin-x64": "1.30.2",
"lightningcss-freebsd-x64": "1.30.2",
"lightningcss-linux-arm-gnueabihf": "1.30.2",
"lightningcss-linux-arm64-gnu": "1.30.2",
"lightningcss-linux-arm64-musl": "1.30.2",
"lightningcss-linux-x64-gnu": "1.30.2",
"lightningcss-linux-x64-musl": "1.30.2",
"lightningcss-win32-arm64-msvc": "1.30.2",
"lightningcss-win32-x64-msvc": "1.30.2"
}
},
"node_modules/lightningcss-android-arm64": {
"version": "1.30.2",
"resolved": "https://registry.npmjs.org/lightningcss-android-arm64/-/lightningcss-android-arm64-1.30.2.tgz",
"integrity": "sha512-BH9sEdOCahSgmkVhBLeU7Hc9DWeZ1Eb6wNS6Da8igvUwAe0sqROHddIlvU06q3WyXVEOYDZ6ykBZQnjTbmo4+A==",
"cpu": [
"arm64"
],
"dev": true,
"license": "MPL-2.0",
"optional": true,
"os": [
"android"
],
"engines": {
"node": ">= 12.0.0"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/parcel"
}
},
"node_modules/lightningcss-darwin-arm64": {
"version": "1.30.2",
"resolved": "https://registry.npmjs.org/lightningcss-darwin-arm64/-/lightningcss-darwin-arm64-1.30.2.tgz",
"integrity": "sha512-ylTcDJBN3Hp21TdhRT5zBOIi73P6/W0qwvlFEk22fkdXchtNTOU4Qc37SkzV+EKYxLouZ6M4LG9NfZ1qkhhBWA==",
"cpu": [
"arm64"
],
"dev": true,
"license": "MPL-2.0",
"optional": true,
"os": [
"darwin"
],
"engines": {
"node": ">= 12.0.0"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/parcel"
}
},
"node_modules/lightningcss-darwin-x64": {
"version": "1.30.2",
"resolved": "https://registry.npmjs.org/lightningcss-darwin-x64/-/lightningcss-darwin-x64-1.30.2.tgz",
"integrity": "sha512-oBZgKchomuDYxr7ilwLcyms6BCyLn0z8J0+ZZmfpjwg9fRVZIR5/GMXd7r9RH94iDhld3UmSjBM6nXWM2TfZTQ==",
"cpu": [
"x64"
],
"dev": true,
"license": "MPL-2.0",
"optional": true,
"os": [
"darwin"
],
"engines": {
"node": ">= 12.0.0"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/parcel"
}
},
"node_modules/lightningcss-freebsd-x64": {
"version": "1.30.2",
"resolved": "https://registry.npmjs.org/lightningcss-freebsd-x64/-/lightningcss-freebsd-x64-1.30.2.tgz",
"integrity": "sha512-c2bH6xTrf4BDpK8MoGG4Bd6zAMZDAXS569UxCAGcA7IKbHNMlhGQ89eRmvpIUGfKWNVdbhSbkQaWhEoMGmGslA==",
"cpu": [
"x64"
],
"dev": true,
"license": "MPL-2.0",
"optional": true,
"os": [
"freebsd"
],
"engines": {
"node": ">= 12.0.0"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/parcel"
}
},
"node_modules/lightningcss-linux-arm-gnueabihf": {
"version": "1.30.2",
"resolved": "https://registry.npmjs.org/lightningcss-linux-arm-gnueabihf/-/lightningcss-linux-arm-gnueabihf-1.30.2.tgz",
"integrity": "sha512-eVdpxh4wYcm0PofJIZVuYuLiqBIakQ9uFZmipf6LF/HRj5Bgm0eb3qL/mr1smyXIS1twwOxNWndd8z0E374hiA==",
"cpu": [
"arm"
],
"dev": true,
"license": "MPL-2.0",
"optional": true,
"os": [
"linux"
],
"engines": {
"node": ">= 12.0.0"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/parcel"
}
},
"node_modules/lightningcss-linux-arm64-gnu": {
"version": "1.30.2",
"resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-gnu/-/lightningcss-linux-arm64-gnu-1.30.2.tgz",
"integrity": "sha512-UK65WJAbwIJbiBFXpxrbTNArtfuznvxAJw4Q2ZGlU8kPeDIWEX1dg3rn2veBVUylA2Ezg89ktszWbaQnxD/e3A==",
"cpu": [
"arm64"
],
"dev": true,
"license": "MPL-2.0",
"optional": true,
"os": [
"linux"
],
"engines": {
"node": ">= 12.0.0"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/parcel"
}
},
"node_modules/lightningcss-linux-arm64-musl": {
"version": "1.30.2",
"resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-musl/-/lightningcss-linux-arm64-musl-1.30.2.tgz",
"integrity": "sha512-5Vh9dGeblpTxWHpOx8iauV02popZDsCYMPIgiuw97OJ5uaDsL86cnqSFs5LZkG3ghHoX5isLgWzMs+eD1YzrnA==",
"cpu": [
"arm64"
],
"dev": true,
"license": "MPL-2.0",
"optional": true,
"os": [
"linux"
],
"engines": {
"node": ">= 12.0.0"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/parcel"
}
},
"node_modules/lightningcss-linux-x64-gnu": {
"version": "1.30.2",
"resolved": "https://registry.npmjs.org/lightningcss-linux-x64-gnu/-/lightningcss-linux-x64-gnu-1.30.2.tgz",
"integrity": "sha512-Cfd46gdmj1vQ+lR6VRTTadNHu6ALuw2pKR9lYq4FnhvgBc4zWY1EtZcAc6EffShbb1MFrIPfLDXD6Xprbnni4w==",
"cpu": [
"x64"
],
"dev": true,
"license": "MPL-2.0",
"optional": true,
"os": [
"linux"
],
"engines": {
"node": ">= 12.0.0"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/parcel"
}
},
"node_modules/lightningcss-linux-x64-musl": {
"version": "1.30.2",
"resolved": "https://registry.npmjs.org/lightningcss-linux-x64-musl/-/lightningcss-linux-x64-musl-1.30.2.tgz",
"integrity": "sha512-XJaLUUFXb6/QG2lGIW6aIk6jKdtjtcffUT0NKvIqhSBY3hh9Ch+1LCeH80dR9q9LBjG3ewbDjnumefsLsP6aiA==",
"cpu": [
"x64"
],
"dev": true,
"license": "MPL-2.0",
"optional": true,
"os": [
"linux"
],
"engines": {
"node": ">= 12.0.0"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/parcel"
}
},
"node_modules/lightningcss-win32-arm64-msvc": {
"version": "1.30.2",
"resolved": "https://registry.npmjs.org/lightningcss-win32-arm64-msvc/-/lightningcss-win32-arm64-msvc-1.30.2.tgz",
"integrity": "sha512-FZn+vaj7zLv//D/192WFFVA0RgHawIcHqLX9xuWiQt7P0PtdFEVaxgF9rjM/IRYHQXNnk61/H/gb2Ei+kUQ4xQ==",
"cpu": [
"arm64"
],
"dev": true,
"license": "MPL-2.0",
"optional": true,
"os": [
"win32"
],
"engines": {
"node": ">= 12.0.0"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/parcel"
}
},
"node_modules/lightningcss-win32-x64-msvc": {
"version": "1.30.2",
"resolved": "https://registry.npmjs.org/lightningcss-win32-x64-msvc/-/lightningcss-win32-x64-msvc-1.30.2.tgz",
"integrity": "sha512-5g1yc73p+iAkid5phb4oVFMB45417DkRevRbt/El/gKXJk4jid+vPFF/AXbxn05Aky8PapwzZrdJShv5C0avjw==",
"cpu": [
"x64"
],
"dev": true,
"license": "MPL-2.0",
"optional": true,
"os": [
"win32"
],
"engines": {
"node": ">= 12.0.0"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/parcel"
}
},
"node_modules/long": {
"version": "5.3.2",
"resolved": "https://registry.npmjs.org/long/-/long-5.3.2.tgz",
@@ -1949,6 +2590,16 @@
"yallist": "^3.0.2"
}
},
"node_modules/magic-string": {
"version": "0.30.21",
"resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz",
"integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==",
"dev": true,
"license": "MIT",
"dependencies": {
"@jridgewell/sourcemap-codec": "^1.5.5"
}
},
"node_modules/minimatch": {
"version": "9.0.5",
"resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz",
@@ -2129,6 +2780,13 @@
"node": "^10 || ^12 || >=14"
}
},
"node_modules/postcss-value-parser": {
"version": "4.2.0",
"resolved": "https://registry.npmjs.org/postcss-value-parser/-/postcss-value-parser-4.2.0.tgz",
"integrity": "sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==",
"dev": true,
"license": "MIT"
},
"node_modules/protobufjs": {
"version": "7.5.4",
"resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.5.4.tgz",
@@ -2419,6 +3077,27 @@
"node": ">=8"
}
},
"node_modules/tailwindcss": {
"version": "4.1.18",
"resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-4.1.18.tgz",
"integrity": "sha512-4+Z+0yiYyEtUVCScyfHCxOYP06L5Ne+JiHhY2IjR2KWMIWhJOYZKLSGZaP5HkZ8+bY0cxfzwDE5uOmzFXyIwxw==",
"dev": true,
"license": "MIT"
},
"node_modules/tapable": {
"version": "2.3.0",
"resolved": "https://registry.npmjs.org/tapable/-/tapable-2.3.0.tgz",
"integrity": "sha512-g9ljZiwki/LfxmQADO3dEY1CbpmXT5Hm2fJ+QaGKwSXUylMybePR7/67YW7jOrrvjEgL1Fmz5kzyAjWVWLlucg==",
"dev": true,
"license": "MIT",
"engines": {
"node": ">=6"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/webpack"
}
},
"node_modules/tinyglobby": {
"version": "0.2.15",
"resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz",
+5 -1
View File
@@ -9,13 +9,17 @@
"preview": "vite preview"
},
"dependencies": {
"react": "^19.2.3",
"@google/genai": "^1.38.0",
"react": "^19.2.3",
"react-dom": "^19.2.3"
},
"devDependencies": {
"@tailwindcss/postcss": "^4.1.18",
"@types/node": "^22.14.0",
"@vitejs/plugin-react": "^5.0.0",
"autoprefixer": "^10.4.23",
"postcss": "^8.5.6",
"tailwindcss": "^4.1.18",
"typescript": "~5.8.2",
"vite": "^6.2.0"
}
+5
View File
@@ -0,0 +1,5 @@
export default {
plugins: {
'@tailwindcss/postcss': {},
},
}
+43
View File
@@ -0,0 +1,43 @@
@import "tailwindcss";
body {
background-color: #000000;
color: #e4e4e7;
font-family: 'Inter', sans-serif;
}
h1, h2, h3, h4, h5, h6, .font-mono {
font-family: 'JetBrains Mono', monospace;
}
::selection {
background-color: #ffffff;
color: #000000;
}
::-webkit-scrollbar {
width: 10px;
background: #000000;
}
::-webkit-scrollbar-thumb {
background: #27272a;
border: 1px solid #000000;
}
::-webkit-scrollbar-thumb:hover {
background: #3f3f46;
}
.terminal-scanline {
background: linear-gradient(to bottom, rgba(255,255,255,0), rgba(255,255,255,0) 50%, rgba(0,0,0,0.1) 50%, rgba(0,0,0,0.1));
background-size: 100% 4px;
position: absolute;
top: 0;
left: 0;
right: 0;
bottom: 0;
pointer-events: none;
z-index: 10;
opacity: 0.1;
}
+40
View File
@@ -0,0 +1,40 @@
/** @type {import('tailwindcss').Config} */
export default {
content: [
"./index.html",
"./**/*.{js,ts,jsx,tsx}",
],
darkMode: 'class',
theme: {
screens: {
'xs': '475px',
'sm': '640px',
'md': '768px',
'lg': '1024px',
'xl': '1280px',
'2xl': '1536px',
},
extend: {
fontFamily: {
sans: ['Inter', 'sans-serif'],
mono: ['JetBrains Mono', 'monospace'],
},
colors: {
background: '#000000',
surface: '#09090b',
border: '#27272a',
highlight: '#ffffff',
},
animation: {
'cursor-blink': 'blink 1s step-end infinite',
},
keyframes: {
blink: {
'0%, 100%': { opacity: '1' },
'50%': { opacity: '0' },
}
}
}
},
plugins: [],
}
+4
View File
@@ -4,6 +4,10 @@
"installCommand": "npm install",
"framework": "vite",
"rewrites": [
{
"source": "/_next/:path*",
"destination": "https://skillkit-docs.vercel.app/_next/:path*"
},
{
"source": "/docs/:path*",
"destination": "https://skillkit-docs.vercel.app/docs/:path*"
+16 -1
View File
@@ -44,7 +44,7 @@ describe('E2E: Onboarding UI', () => {
expect(result.success).toBe(true);
});
it('should display all 17 agents', async () => {
it('should display all 32 agents', async () => {
const result = await runCli(['init', '--list']);
const output = result.stdout + result.stderr;
@@ -66,6 +66,21 @@ describe('E2E: Onboarding UI', () => {
'Antigravity',
'Clawdbot',
'Universal',
'Cline',
'CodeBuddy',
'CommandCode',
'Continue',
'Crush',
'Factory',
'MCPJam',
'Mux',
'Neovate',
'OpenHands',
'Pi',
'Qoder',
'Qwen',
'Vercel',
'Zencoder',
];
for (const agent of agents) {
+1 -1
View File
@@ -28,7 +28,7 @@ import {
type CrossAgentSkill,
} from '@skillkit/core';
// All 17 supported agents
// All 32 supported agents
const SUPPORTED_AGENTS = [
'claude-code',
'cursor',
+17 -2
View File
@@ -2,7 +2,7 @@
* E2E Tests: Skill Translation Commands
*
* Tests for: translate, context, recommend
* Validates translation to all 17 supported agents
* Validates translation to all 32 supported agents
*/
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
@@ -16,7 +16,7 @@ import {
testFileExists,
} from './helpers/cli-runner.js';
// All 17 supported agents
// All 32 supported agents
const SUPPORTED_AGENTS = [
'claude-code',
'cursor',
@@ -35,6 +35,21 @@ const SUPPORTED_AGENTS = [
'trae',
'windsurf',
'universal',
'cline',
'codebuddy',
'commandcode',
'continue',
'crush',
'factory',
'mcpjam',
'mux',
'neovate',
'openhands',
'pi',
'qoder',
'qwen',
'vercel',
'zencoder',
] as const;
describe('E2E: Skill Translation', () => {
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit-monorepo",
"version": "1.7.2",
"version": "1.7.9",
"private": true,
"description": "Universal skills loader for AI coding agents - Monorepo",
"type": "module",
+2 -2
View File
@@ -1,7 +1,7 @@
{
"name": "@skillkit/agents",
"version": "1.7.6",
"description": "Agent adapters for SkillKit - supports 17+ AI coding agents",
"version": "1.7.9",
"description": "Agent adapters for SkillKit - supports 32 AI coding agents",
"type": "module",
"main": "./dist/index.js",
"types": "./dist/index.d.ts",
+10 -2
View File
@@ -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> {
+2 -2
View File
@@ -3,7 +3,7 @@
[![npm version](https://img.shields.io/npm/v/@skillkit/cli.svg)](https://www.npmjs.com/package/@skillkit/cli)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
**Command-line interface for SkillKit** - install, manage, translate, and sync skills across 17 AI coding agents.
**Command-line interface for SkillKit** - install, manage, translate, and sync skills across 32 AI coding agents.
## Installation
@@ -243,7 +243,7 @@ const recs = await recommendCommand({
| Gemini CLI | SKILL.md |
| Windsurf | Markdown |
| GitHub Copilot | Markdown |
| + 11 more | SKILL.md |
| + 26 more | SKILL.md |
## Documentation
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/cli",
"version": "1.7.6",
"version": "1.7.9",
"description": "CLI commands for SkillKit",
"type": "module",
"main": "./dist/index.js",
@@ -96,11 +96,11 @@ describe('Onboarding Module', () => {
it('should generate full logo with version', async () => {
const { getFullLogo } = await import('../onboarding/logo.js');
const logo = getFullLogo('1.7.2', 17);
const logo = getFullLogo('1.7.2', 32);
// Full logo uses block characters (███), not literal text
expect(logo).toContain('\u2588'); // █ block character
expect(logo).toContain('v1.7.2');
expect(logo).toContain('17 agents');
expect(logo).toContain('32 agents');
});
it('should generate compact logo', async () => {
+1
View File
@@ -53,3 +53,4 @@ export {
ManifestInstallCommand,
ManifestGenerateCommand,
} from './manifest.js';
export { PrimerCommand } from './primer.js';
+362
View File
@@ -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 -1
View File
@@ -14,7 +14,7 @@ export class UICommand extends Command {
Features:
- Browse and discover skills from the marketplace
- Manage installed skills across 17+ AI coding agents
- Manage installed skills across 32 AI coding agents
- Sync skills between agents
- AI-powered recommendations
- Team collaboration
+1 -1
View File
@@ -88,7 +88,7 @@ import {
} from './preferences.js';
let VERSION = '1.7.6';
let AGENT_COUNT = 17;
let AGENT_COUNT = 32;
export function setVersion(version: string): void {
VERSION = version;
+2 -2
View File
@@ -14,7 +14,7 @@ npm install @skillkit/core
## Key Features
- **Skill Discovery**: Find and parse SKILL.md files from any source
- **Cross-Agent Translation**: Convert skills between 17 agent formats (Claude Code, Cursor, Windsurf, etc.)
- **Cross-Agent Translation**: Convert skills between 32 agent formats (Claude Code, Cursor, Windsurf, etc.)
- **Project Context Detection**: Analyze project stack, dependencies, and configurations
- **Smart Recommendations**: AI-powered skill suggestions based on project profile
- **Session Memory**: Capture and persist learnings across AI coding sessions
@@ -278,7 +278,7 @@ await hooks.trigger('pre-commit', { files: ['src/index.ts'] });
## Supported Agents
The translator supports all 17 SkillKit-compatible agents:
The translator supports all 32 SkillKit-compatible agents:
| Agent | Format |
|-------|--------|
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/core",
"version": "1.7.6",
"version": "1.7.9",
"description": "Core functionality for SkillKit - skill discovery, parsing, and translation",
"type": "module",
"main": "./dist/index.js",
+3
View File
@@ -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';
+1 -1
View File
@@ -7,7 +7,7 @@
*
* Key features:
* - Methodology packs: Collections of related skills (testing, debugging, planning)
* - Universal translation: Skills work across all 17 supported agents
* - Universal translation: Skills work across all 32 supported agents
* - Pack management: Install, uninstall, and sync methodology skills
* - Community-driven: Open for custom methodology contributions
*/
+1 -1
View File
@@ -10,7 +10,7 @@
* - Plan approval workflow
* - Review stages (spec-compliance, code-quality)
* - Inter-agent messaging (direct + broadcast)
* - Universal agent support (17 agents)
* - Universal agent support (32 agents)
*/
// Team Orchestrator
@@ -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');
});
});
});
+658
View File
@@ -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();
}
+734
View File
@@ -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, '&amp;')
.replace(/</g, '&lt;')
.replace(/>/g, '&gt;')
.replace(/"/g, '&quot;')
.replace(/'/g, '&apos;');
}
function getRenderer(format: OutputFormat): FormatRenderer {
switch (format) {
case 'mdc':
return mdcRenderer;
case 'json':
return jsonRenderer;
case 'xml':
return xmlRenderer;
default:
return markdownRenderer;
}
}
export class PrimerGenerator {
private projectPath: string;
private options: PrimerOptions;
private analysis: PrimerAnalysis | null = null;
constructor(projectPath: string, options: PrimerOptions = {}) {
this.projectPath = projectPath;
this.options = options;
}
generate(): PrimerResult {
const warnings: string[] = [];
const errors: string[] = [];
const generated: GeneratedInstruction[] = [];
const seenPaths = new Map<string, string>();
this.analysis = analyzePrimer(this.projectPath);
if (this.options.analyzeOnly) {
return {
success: true,
analysis: this.analysis,
generated: [],
warnings,
errors,
};
}
const targetAgents = this.getTargetAgents();
for (const agent of targetAgents) {
try {
const instruction = this.generateForAgent(agent);
if (instruction) {
const existingAgent = seenPaths.get(instruction.filepath);
if (existingAgent) {
warnings.push(
`Skipping ${agent}: output path "${instruction.filename}" already used by ${existingAgent}`
);
continue;
}
seenPaths.set(instruction.filepath, agent);
if (!this.options.dryRun) {
this.writeInstruction(instruction);
}
generated.push(instruction);
}
} catch (error) {
const message = error instanceof Error ? error.message : String(error);
errors.push(`Failed to generate for ${agent}: ${message}`);
}
}
return {
success: errors.length === 0,
analysis: this.analysis,
generated,
warnings,
errors,
};
}
private getTargetAgents(): AgentType[] {
if (this.options.allAgents) {
return ALL_AGENTS;
}
if (this.options.agents && this.options.agents.length > 0) {
return this.options.agents;
}
return this.detectInstalledAgents();
}
private detectInstalledAgents(): AgentType[] {
const detected: AgentType[] = [];
for (const [agent, config] of Object.entries(AGENT_CONFIG)) {
const configPath = join(this.projectPath, config.configFile);
const skillsPath = join(this.projectPath, config.skillsDir);
if (existsSync(configPath) || existsSync(skillsPath)) {
detected.push(agent as AgentType);
}
if (config.altSkillsDirs) {
for (const altDir of config.altSkillsDirs) {
if (existsSync(join(this.projectPath, altDir))) {
if (!detected.includes(agent as AgentType)) {
detected.push(agent as AgentType);
}
break;
}
}
}
}
if (detected.length === 0) {
detected.push('claude-code', 'cursor', 'github-copilot');
}
return detected;
}
private generateForAgent(agent: AgentType): GeneratedInstruction | null {
if (!this.analysis) return null;
const config = AGENT_CONFIG[agent];
const template = AGENT_INSTRUCTION_TEMPLATES[agent] || this.getDefaultTemplate(agent, config);
const content = this.generateContent(template);
const outputDir = this.options.outputDir || this.projectPath;
const filepath = join(outputDir, template.filename);
return {
agent,
filename: template.filename,
filepath,
content,
format: template.format,
};
}
private getDefaultTemplate(agent: AgentType, config: AgentDirectoryConfig): AgentInstructionTemplate {
const formatMap: Record<string, OutputFormat> = {
'.md': 'markdown',
'.json': 'json',
'.mdc': 'mdc',
'.xml': 'xml',
};
const ext = config.configFile.includes('.')
? '.' + config.configFile.split('.').pop()
: '.md';
const format = formatMap[ext] || 'markdown';
return {
agent,
filename: config.configFile,
format,
sectionOrder: ['overview', 'stack', 'commands', 'conventions', 'structure', 'guidelines'],
};
}
private generateContent(template: AgentInstructionTemplate): string {
if (!this.analysis) return '';
const format = template.format as OutputFormat;
const renderer = getRenderer(format);
if (format === 'json') {
return this.generateJsonContent(template);
}
const sections: string[] = [];
for (const section of template.sectionOrder) {
const content = this.generateSection(section, template, renderer);
if (content) {
sections.push(content);
}
}
let result = sections.join('\n\n');
if (template.header) {
result = template.header + '\n\n' + result;
}
if (template.footer) {
result = result + '\n\n' + template.footer;
}
if (this.options.customInstructions) {
result += '\n\n' + renderer.h2('Custom Instructions') + '\n\n' + this.options.customInstructions;
}
const metadata = format === 'mdc' ? {
title: this.analysis.project.name,
type: this.analysis.project.type,
generated: new Date().toISOString(),
} : undefined;
return renderer.wrap(result, metadata);
}
private generateJsonContent(template: AgentInstructionTemplate): string {
if (!this.analysis) return '{}';
const data: Record<string, unknown> = {
project: this.analysis.project,
languages: this.analysis.languages.map(l => l.name),
packageManagers: this.analysis.packageManagers,
stack: {
frameworks: this.analysis.stack.frameworks.map(f => ({ name: f.name, version: f.version })),
libraries: this.analysis.stack.libraries.map(l => ({ name: l.name, version: l.version })),
styling: this.analysis.stack.styling.map(s => s.name),
testing: this.analysis.stack.testing.map(t => t.name),
databases: this.analysis.stack.databases.map(d => d.name),
},
commands: this.analysis.buildCommands,
conventions: this.analysis.conventions,
structure: this.analysis.structure,
importantFiles: this.analysis.importantFiles,
generated: {
agent: template.agent,
timestamp: new Date().toISOString(),
},
};
if (this.options.customInstructions) {
data.customInstructions = this.options.customInstructions;
}
return JSON.stringify(data, null, 2);
}
private generateSection(section: string, template: AgentInstructionTemplate, renderer: FormatRenderer): string {
if (!this.analysis) return '';
switch (section) {
case 'overview':
return this.generateOverviewSection(renderer);
case 'stack':
return this.generateStackSection(renderer);
case 'commands':
return this.generateCommandsSection(renderer);
case 'conventions':
return this.generateConventionsSection(renderer);
case 'structure':
return this.generateStructureSection(renderer);
case 'guidelines':
return this.generateGuidelinesSection(template.agent, renderer);
default:
return '';
}
}
private generateOverviewSection(renderer: FormatRenderer): string {
if (!this.analysis) return '';
const { project, languages } = this.analysis;
const lines: string[] = [];
lines.push(renderer.h1(project.name));
lines.push('');
if (project.description) {
lines.push(renderer.paragraph(project.description));
lines.push('');
}
if (project.type) {
lines.push(renderer.keyValue('Project Type', this.formatProjectType(project.type)));
}
if (languages.length > 0) {
const langNames = languages.map(l => this.capitalize(l.name)).join(', ');
lines.push(renderer.keyValue('Languages', langNames));
}
if (project.version) {
lines.push(renderer.keyValue('Version', project.version));
}
return lines.join('\n');
}
private generateStackSection(renderer: FormatRenderer): string {
if (!this.analysis) return '';
const { stack, packageManagers } = this.analysis;
const lines: string[] = [];
lines.push(renderer.h2('Technology Stack'));
lines.push('');
if (stack.frameworks.length > 0) {
lines.push(renderer.h3('Frameworks'));
const items = stack.frameworks.map(fw => {
const version = fw.version ? ` (${fw.version})` : '';
return `${this.capitalize(fw.name)}${version}`;
});
lines.push(renderer.list(items));
lines.push('');
}
if (stack.libraries.length > 0) {
lines.push(renderer.h3('Libraries'));
const items = stack.libraries.map(lib => {
const version = lib.version ? ` (${lib.version})` : '';
return `${this.capitalize(lib.name)}${version}`;
});
lines.push(renderer.list(items));
lines.push('');
}
if (stack.styling.length > 0) {
lines.push(renderer.h3('Styling'));
lines.push(renderer.list(stack.styling.map(s => this.capitalize(s.name))));
lines.push('');
}
if (stack.testing.length > 0) {
lines.push(renderer.h3('Testing'));
lines.push(renderer.list(stack.testing.map(t => this.capitalize(t.name))));
lines.push('');
}
if (stack.databases.length > 0) {
lines.push(renderer.h3('Databases'));
lines.push(renderer.list(stack.databases.map(d => this.capitalize(d.name))));
lines.push('');
}
if (packageManagers.length > 0) {
lines.push(renderer.h3('Package Manager'));
lines.push(renderer.list([packageManagers.map(pm => this.capitalize(pm)).join(', ')]));
lines.push('');
}
return lines.join('\n');
}
private generateCommandsSection(renderer: FormatRenderer): string {
if (!this.analysis || !this.analysis.buildCommands) return '';
const { buildCommands } = this.analysis;
const lines: string[] = [];
const commands: string[] = [];
lines.push(renderer.h2('Development Commands'));
lines.push('');
if (buildCommands.install) {
commands.push(`# Install dependencies`);
commands.push(buildCommands.install);
commands.push('');
}
if (buildCommands.dev) {
commands.push(`# Start development server`);
commands.push(buildCommands.dev);
commands.push('');
}
if (buildCommands.build) {
commands.push(`# Build for production`);
commands.push(buildCommands.build);
commands.push('');
}
if (buildCommands.test) {
commands.push(`# Run tests`);
commands.push(buildCommands.test);
commands.push('');
}
if (buildCommands.lint) {
commands.push(`# Run linter`);
commands.push(buildCommands.lint);
commands.push('');
}
if (buildCommands.format) {
commands.push(`# Format code`);
commands.push(buildCommands.format);
}
lines.push(renderer.codeBlock(commands.join('\n'), 'bash'));
return lines.join('\n');
}
private generateConventionsSection(renderer: FormatRenderer): string {
if (!this.analysis) return '';
const { conventions, patterns } = this.analysis;
const lines: string[] = [];
lines.push(renderer.h2('Code Conventions'));
lines.push('');
if (conventions) {
const items: string[] = [];
if (conventions.indentation) {
items.push(`${renderer.bold('Indentation:')} ${conventions.indentation}`);
}
if (conventions.quotes) {
items.push(`${renderer.bold('Quotes:')} ${conventions.quotes}`);
}
if (conventions.semicolons !== undefined) {
items.push(`${renderer.bold('Semicolons:')} ${conventions.semicolons ? 'required' : 'omitted'}`);
}
if (conventions.trailingCommas) {
items.push(`${renderer.bold('Trailing Commas:')} ${conventions.trailingCommas}`);
}
if (conventions.maxLineLength) {
items.push(`${renderer.bold('Max Line Length:')} ${conventions.maxLineLength}`);
}
if (items.length > 0) {
lines.push(renderer.list(items));
}
}
if (patterns) {
lines.push('');
lines.push(renderer.h3('Patterns'));
const items: string[] = [];
if (patterns.components) {
items.push(`${renderer.bold('Components:')} ${patterns.components}`);
}
if (patterns.stateManagement) {
items.push(`${renderer.bold('State Management:')} ${patterns.stateManagement}`);
}
if (patterns.apiStyle) {
items.push(`${renderer.bold('API Style:')} ${patterns.apiStyle}`);
}
if (patterns.styling) {
items.push(`${renderer.bold('Styling:')} ${patterns.styling}`);
}
if (patterns.testing) {
items.push(`${renderer.bold('Testing:')} ${patterns.testing}`);
}
if (patterns.linting) {
items.push(`${renderer.bold('Linting:')} ${patterns.linting}`);
}
if (patterns.formatting) {
items.push(`${renderer.bold('Formatting:')} ${patterns.formatting}`);
}
if (items.length > 0) {
lines.push(renderer.list(items));
}
}
return lines.join('\n');
}
private generateStructureSection(renderer: FormatRenderer): string {
if (!this.analysis) return '';
const { structure, importantFiles } = this.analysis;
const lines: string[] = [];
lines.push(renderer.h2('Project Structure'));
lines.push('');
if (structure) {
if (structure.type) {
lines.push(renderer.keyValue('Structure Type', structure.type));
}
if (structure.srcDir) {
lines.push(renderer.keyValue('Source Directory', renderer.code(`${structure.srcDir}/`)));
}
if (structure.testDir) {
lines.push(renderer.keyValue('Test Directory', renderer.code(`${structure.testDir}/`)));
}
if (structure.hasWorkspaces && structure.workspaces) {
lines.push(renderer.keyValue('Workspaces', structure.workspaces.join(', ')));
}
lines.push('');
}
if (importantFiles.length > 0) {
lines.push(renderer.h3('Important Files'));
lines.push(renderer.list(importantFiles.slice(0, 15).map(f => renderer.code(f))));
}
return lines.join('\n');
}
private generateGuidelinesSection(_agent: AgentType, renderer: FormatRenderer): string {
if (!this.analysis) return '';
const { stack, patterns } = this.analysis;
const lines: string[] = [];
lines.push(renderer.h2('Development Guidelines'));
lines.push('');
const hasReact = stack.frameworks.some(f => f.name === 'react' || f.name === 'nextjs');
const hasVue = stack.frameworks.some(f => f.name === 'vue' || f.name === 'nuxt');
const hasTypeScript = this.analysis.languages.some(l => l.name === 'typescript');
const hasTailwind = stack.styling.some(s => s.name === 'tailwindcss');
const hasPrisma = stack.databases.some(d => d.name === 'prisma');
const hasZod = stack.libraries.some(l => l.name === 'zod');
if (hasTypeScript) {
lines.push(renderer.h3('TypeScript'));
lines.push(renderer.list([
'Use strict TypeScript with proper type annotations',
'Prefer `interface` for object types, `type` for unions/intersections',
'Avoid `any` - use `unknown` when type is uncertain',
]));
lines.push('');
}
if (hasReact) {
lines.push(renderer.h3('React'));
const reactItems = [
'Use functional components with hooks',
'Prefer composition over inheritance',
'Keep components small and focused',
];
if (patterns?.stateManagement) {
reactItems.push(`Use ${patterns.stateManagement} for state management`);
}
lines.push(renderer.list(reactItems));
lines.push('');
}
if (hasVue) {
lines.push(renderer.h3('Vue'));
lines.push(renderer.list([
'Use Composition API with `<script setup>`',
'Keep components small and focused',
]));
lines.push('');
}
if (hasTailwind) {
lines.push(renderer.h3('Styling'));
lines.push(renderer.list([
'Use Tailwind CSS utility classes',
'Follow mobile-first responsive design',
'Extract repeated patterns to components',
]));
lines.push('');
}
if (hasPrisma) {
lines.push(renderer.h3('Database'));
lines.push(renderer.list([
'Use Prisma for database operations',
'Keep database queries in dedicated service files',
'Use transactions for related operations',
]));
lines.push('');
}
if (hasZod) {
lines.push(renderer.h3('Validation'));
lines.push(renderer.list([
'Use Zod for runtime validation',
'Define schemas alongside types',
]));
lines.push('');
}
lines.push(renderer.h3('General'));
lines.push(renderer.list([
'Follow existing code patterns and conventions',
'Write clear, self-documenting code',
'Keep functions small and focused',
'Add tests for new functionality',
]));
return lines.join('\n');
}
private writeInstruction(instruction: GeneratedInstruction): void {
const dir = dirname(instruction.filepath);
if (!existsSync(dir)) {
mkdirSync(dir, { recursive: true });
}
writeFileSync(instruction.filepath, instruction.content, 'utf-8');
}
private formatProjectType(type: string): string {
const typeMap: Record<string, string> = {
'web-app': 'Web Application',
'api': 'API / Backend',
'cli': 'CLI Tool',
'library': 'Library / Package',
'mobile': 'Mobile Application',
'desktop': 'Desktop Application',
'unknown': 'Project',
};
return typeMap[type] || type;
}
private capitalize(str: string): string {
return str.charAt(0).toUpperCase() + str.slice(1);
}
}
export function generatePrimer(projectPath: string, options: PrimerOptions = {}): PrimerResult {
const generator = new PrimerGenerator(projectPath, options);
return generator.generate();
}
export function generatePrimerForAgent(
projectPath: string,
agent: AgentType,
options: Omit<PrimerOptions, 'agents' | 'allAgents'> = {}
): PrimerResult {
return generatePrimer(projectPath, { ...options, agents: [agent] });
}
export function analyzeForPrimer(projectPath: string): PrimerAnalysis {
const generator = new PrimerGenerator(projectPath, { analyzeOnly: true });
const result = generator.generate();
return result.analysis;
}
+27
View File
@@ -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';
+206
View File
@@ -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'],
},
};
@@ -329,7 +329,7 @@ Follow these guidelines`;
});
describe('supported agents', () => {
it('should support all 17 agents', () => {
it('should support all 32 agents', () => {
const allAgents = [
'claude-code',
'cursor',
+1 -1
View File
@@ -34,7 +34,7 @@ pnpm ui
- **Animated UI** - Smooth entrance animations and transitions
- **Browse Skills** - Explore skill repositories with search and filtering
- **Smart Recommendations** - AI-powered skill suggestions with match scores
- **Cross-Agent Translation** - Convert skills between 17+ agent formats
- **Cross-Agent Translation** - Convert skills between 32 agent formats
- **Team Collaboration** - Share and sync skills across teams
- **Responsive Design** - Adapts to any terminal size
+13
View File
@@ -1,5 +1,6 @@
import { useState, useCallback, useEffect } from 'react';
import { useKeyboard } from '@opentui/react';
import { exec } from 'node:child_process';
import { type Screen, NAV_KEYS } from './state/types.js';
import { Sidebar } from './components/Sidebar.js';
import { Splash } from './components/Splash.js';
@@ -9,6 +10,13 @@ import {
Plan, Workflow, Execute, History, Sync, Help,
} from './screens/index.js';
const DOCS_URL = 'https://agenstskills.com/docs';
function openUrl(url: string): void {
const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
exec(`${cmd} ${url}`);
}
interface AppProps {
onExit?: (code?: number) => void;
}
@@ -54,6 +62,11 @@ export function App({ onExit }: AppProps = {}) {
return;
}
if (key.name === 'd') {
openUrl(DOCS_URL);
return;
}
const targetScreen = NAV_KEYS[key.name || ''];
if (targetScreen) {
setScreen(targetScreen);
+4 -2
View File
@@ -17,13 +17,15 @@ const SHORTCUTS = [
{ key: 'r', desc: 'Recommendations' },
{ key: 'i', desc: 'Installed skills' },
{ key: 's', desc: 'Sync settings' },
{ key: 'f', desc: 'Find skills' },
]},
{ section: 'Actions', items: [
{ key: 't', desc: 'Translate skills' },
{ key: 'w', desc: 'Workflows' },
{ key: 'x', desc: 'Execute' },
{ key: 'n', desc: 'Plan' },
{ key: 'y', desc: 'History' },
{ key: 'v', desc: 'Validate' },
{ key: 'u', desc: 'Publish' },
]},
{ section: 'Team & Config', items: [
{ key: 'a', desc: 'Team settings' },
@@ -35,10 +37,10 @@ const SHORTCUTS = [
]},
{ section: 'Global', items: [
{ key: '/', desc: 'This help screen' },
{ key: 'd', desc: 'Open docs' },
{ key: 'esc', desc: 'Go back / Home' },
{ key: 'q', desc: 'Quit application' },
{ key: 'j/k', desc: 'Navigate lists' },
{ key: 'enter', desc: 'Select item' },
]},
];