Compare commits

..
Author SHA1 Message Date
Rohit Ghumare 54cef27bfe chore: bump version to 1.7.11 2026-01-30 12:49:02 +00:00
Rohit Ghumare 1220880462 feat(website): add stack builder, trending, attribution sections (#26)
* feat(website): add stack builder, trending, attribution sections

- Add StackBuilder component for composing skill stacks visually
- Add TrendingSkills component with category browsing
- Add Attribution section crediting 24 skill sources
- Add issue template for submitting new skill repositories
- Update README with full attribution table
- Improve mobile responsiveness across all new components
- Simplify terminal demo (remove primer, focus on core workflow)
- Reorganize Commands section (Start, Manage, Team, Advanced)
- Update install commands to use npx skillkit@latest format
- Add navigation links and badge row to navbar

* fix: correct all domain references to agenstskills.com

Replace all incorrect agentskills.io references with the correct domain
agenstskills.com throughout the codebase.

Files updated:
- src/commands/validate.ts
- schemas/skill.schema.json
- docs/skillkit/components/Footer.tsx
- .github/ISSUE_TEMPLATE/add-source.md
- .github/ISSUE_TEMPLATE/skill-submission.yml
- CONTRIBUTING.md
- README.md

* fix: address CodeRabbit review suggestions

- TrendingSkills: use exact ID matching instead of substring match
- StackBuilder: prevent duplicate skills in preset stack
- StackBuilder: deduplicate repo references in install command
- StackBuilder: make copyCommand async with proper error handling
- StackBuilder: add accessibility labels and focus visibility to remove button
- App: update URL hash on scroll for deep linking
- App: add scrollMarginTop to sections for fixed navbar offset
2026-01-30 12:47:44 +00:00
Rohit Ghumare 1c946dde06 docs(website): update for v1.7.10 with primer command
- Update version from v1.7.5 to v1.7.10 in Hero
- Add primer command to terminal demo animation
- Add primer to core capabilities in Documentation
- Add AI Instruction Generation (Primer) section to CLI Commands
- Add Primer feature card to Features section
- Add Instructions comparison row highlighting Primer
2026-01-30 10:39:12 +00:00
Rohit Ghumare 3dfd317867 chore: bump version to 1.7.10 2026-01-30 10:11:27 +00:00
Rohit Ghumare c5aa303043 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:21:46 +00:00
Rohit Ghumare 01d816c72a feat: add skillkit primer command for AI instruction generation (#25)
* 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.

* 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

* 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

* 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:09:03 +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
29 changed files with 1297 additions and 233 deletions
+42
View File
@@ -0,0 +1,42 @@
---
name: Add Skill Source
about: Submit your skill repository to be included in SkillKit
title: "[Source] Add <repository-name>"
labels: skill-source, enhancement
assignees: rohitg00
---
## Repository Information
**Repository URL:** `https://github.com/<owner>/<repo>`
**Repository Name:**
<!-- Short name for display (e.g., "Anthropic Official", "React Patterns") -->
**Description:**
<!-- Brief description of the skills in your repository -->
**License:**
<!-- MIT, Apache 2.0, etc. -->
## Skill Details
**Approximate skill count:**
<!-- How many skills does your repository contain? -->
**Categories/Tags:**
<!-- What categories do your skills cover? e.g., react, typescript, security, testing -->
**Target AI Agents:**
<!-- Which agents are your skills designed for? e.g., Claude Code, Cursor, all -->
## Checklist
- [ ] Repository is public
- [ ] Repository contains valid SKILL.md files
- [ ] Repository has a clear license
- [ ] Skills follow the [Agent Skills specification](https://agenstskills.com)
## Additional Context
<!-- Any other information about your repository -->
+1 -1
View File
@@ -83,7 +83,7 @@ body:
options:
- label: Repository is public
required: true
- label: SKILL.md follows the agentskills.io standard format
- label: SKILL.md follows the agenstskills.com standard format
required: true
- label: Skill has been tested with at least one AI agent
required: false
+1 -1
View File
@@ -206,7 +206,7 @@ To add support for a new AI coding agent:
If you want to contribute skills to the ecosystem:
1. Follow the [Agent Skills specification](https://agentskills.io/specification)
1. Follow the [Agent Skills specification](https://agenstskills.com)
2. Include a `SKILL.md` with proper frontmatter
3. Test with multiple agents using `skillkit translate`
4. Submit to the appropriate skill repository
+41 -7
View File
@@ -323,6 +323,9 @@ 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.
@@ -417,7 +420,7 @@ skillkit create my-skill
### Manual Creation
Create a `SKILL.md` file following the [Agent Skills specification](https://agentskills.io/specification):
Create a `SKILL.md` file following the [Agent Skills specification](https://agenstskills.com):
```markdown
---
@@ -489,12 +492,43 @@ const profile = await analyzeProject('./my-project');
const recs = engine.recommend(profile);
```
## Popular Skill Repositories
## Skill Sources & Attribution
| Repository | Description |
|------------|-------------|
| [anthropics/skills](https://github.com/anthropics/skills) | Official Claude Code marketplace - PDF, XLSX, DOCX processing |
| [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | React/Next.js best practices, web design guidelines |
SkillKit aggregates skills from trusted sources. We credit and link back to all original creators. Each source retains its original license.
### Official Partner Sources
| Repository | Description | License |
|------------|-------------|---------|
| [anthropics/skills](https://github.com/anthropics/skills) | Official Claude Code skills from Anthropic | Apache 2.0 |
| [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | Next.js, React, and Vercel platform skills | MIT |
| [expo/skills](https://github.com/expo/skills) | Mobile development with Expo and React Native | MIT |
| [remotion-dev/skills](https://github.com/remotion-dev/skills) | Programmatic video creation with React | MIT |
| [supabase/agent-skills](https://github.com/supabase/agent-skills) | Database, auth, and backend skills | Apache 2.0 |
| [stripe/ai](https://github.com/stripe/ai) | Payment integration and Stripe API patterns | MIT |
### Community Contributors
| Repository | Description | License |
|------------|-------------|---------|
| [trailofbits/skills](https://github.com/trailofbits/skills) | Security analysis and vulnerability detection | Apache 2.0 |
| [obra/superpowers](https://github.com/obra/superpowers) | Test-driven development and workflow automation | MIT |
| [wshobson/agents](https://github.com/wshobson/agents) | Development patterns and agent configurations (48 agents) | MIT |
| [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) | Curated collection of Claude Code skills | MIT |
| [travisvn/awesome-claude-skills](https://github.com/travisvn/awesome-claude-skills) | Community-curated skill collection | MIT |
| [langgenius/dify](https://github.com/langgenius/dify) | AI application development platform patterns | Apache 2.0 |
| [better-auth/skills](https://github.com/better-auth/skills) | Authentication and authorization patterns | MIT |
| [onmax/nuxt-skills](https://github.com/onmax/nuxt-skills) | Vue.js and Nuxt framework skills | MIT |
| [elysiajs/skills](https://github.com/elysiajs/skills) | Bun runtime and ElysiaJS framework | MIT |
| [kadajett/agent-nestjs-skills](https://github.com/kadajett/agent-nestjs-skills) | NestJS backend framework patterns | MIT |
| [cloudai-x/threejs-skills](https://github.com/cloudai-x/threejs-skills) | 3D graphics and WebGL development | MIT |
| [dimillian/skills](https://github.com/dimillian/skills) | iOS and SwiftUI development patterns | MIT |
| [waynesutton/convexskills](https://github.com/waynesutton/convexskills) | Convex backend development | MIT |
| [kepano/obsidian-skills](https://github.com/kepano/obsidian-skills) | Obsidian plugin and vault management | MIT |
| [giuseppe-trisciuoglio/developer-kit](https://github.com/giuseppe-trisciuoglio/developer-kit) | UI component libraries (Shadcn/Radix) | MIT |
| [openrouterteam/agent-skills](https://github.com/openrouterteam/agent-skills) | OpenRouter API integration patterns | MIT |
**Want to add your skills?** [Submit your repository](https://github.com/rohitg00/skillkit/issues/new?template=add-source.md) to be included in SkillKit
## Installation Options
@@ -545,7 +579,7 @@ Contributions welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md
- [Documentation](https://agenstskills.com/docs)
- [Website](https://agenstskills.com)
- [Agent Skills Specification](https://agentskills.io/specification)
- [Agent Skills Specification](https://agenstskills.com)
- [GitHub Repository](https://github.com/rohitg00/skillkit)
- [NPM Package](https://www.npmjs.com/package/skillkit)
- [GitHub Package](https://github.com/rohitg00/skillkit/pkgs/npm/skillkit)
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit",
"version": "1.7.9",
"version": "1.7.11",
"description": "Supercharge AI coding agents with portable skills. Install, translate, and share skills across Claude Code, Cursor, Codex, Copilot & 13 more",
"type": "module",
"bin": {
+125 -3
View File
@@ -6,6 +6,9 @@ import { Footer } from './components/Footer';
import { SkillGenerator } from './components/SkillGenerator';
import { SkillSubmitForm } from './components/SkillSubmitForm';
import { Commands } from './components/Commands';
import { StackBuilder } from './components/StackBuilder';
import { TrendingSkills } from './components/TrendingSkills';
import { Attribution } from './components/Attribution';
const GITHUB_ICON = (
<svg className="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
@@ -24,6 +27,15 @@ function scrollToTop(e: React.MouseEvent): void {
window.scrollTo({ top: 0, behavior: 'smooth' });
}
function scrollToSection(e: React.MouseEvent, sectionId: string): void {
e.preventDefault();
const element = document.getElementById(sectionId);
if (element) {
element.scrollIntoView({ behavior: 'smooth' });
history.replaceState(null, '', `#${sectionId}`);
}
}
export default function App(): React.ReactElement {
return (
<div className="min-h-screen text-zinc-100 font-sans selection:bg-white selection:text-black" style={{ backgroundColor: '#000000' }}>
@@ -34,10 +46,40 @@ export default function App(): React.ReactElement {
<div className="w-4 h-4 bg-white"></div>
<span className="text-base font-bold tracking-tight text-white font-mono">SKILLKIT</span>
</a>
<div className="hidden sm:flex items-center gap-4 text-xs font-mono">
<a
href="#stack"
onClick={(e) => scrollToSection(e, 'stack')}
className="text-zinc-500 hover:text-white transition-colors"
>
Stack
</a>
<a
href="#trending"
onClick={(e) => scrollToSection(e, 'trending')}
className="text-zinc-500 hover:text-white transition-colors"
>
Trending
</a>
<a
href="#skills"
onClick={(e) => scrollToSection(e, 'skills')}
className="text-zinc-500 hover:text-white transition-colors"
>
Find Skills
</a>
<a
href="#sources"
onClick={(e) => scrollToSection(e, 'sources')}
className="text-zinc-500 hover:text-white transition-colors"
>
Sources
</a>
</div>
<div className="flex items-center gap-2 sm:gap-4">
<a
href="https://agenstskills.com/docs"
className="text-zinc-400 hover:text-white transition-colors text-sm font-mono"
className="text-zinc-400 hover:text-white transition-colors text-sm font-mono hidden sm:block"
>
Docs
</a>
@@ -66,15 +108,91 @@ export default function App(): React.ReactElement {
<main className="pt-14">
<Hero />
<div className="border-b border-zinc-800 py-4 bg-zinc-950">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="flex flex-wrap items-center justify-center gap-3 sm:gap-4">
<a
href="https://www.npmjs.com/package/skillkit"
target="_blank"
rel="noopener noreferrer"
className="flex items-center"
>
<img
src="https://img.shields.io/npm/v/skillkit.svg?style=flat&color=white&labelColor=000000"
alt="npm version"
className="h-5"
/>
</a>
<a
href="https://www.npmjs.com/package/skillkit"
target="_blank"
rel="noopener noreferrer"
className="flex items-center"
>
<img
src="https://img.shields.io/npm/dt/skillkit.svg?style=flat&color=white&labelColor=000000"
alt="npm downloads"
className="h-5"
/>
</a>
<a
href="https://github.com/rohitg00/skillkit"
target="_blank"
rel="noopener noreferrer"
className="flex items-center"
>
<img
src="https://img.shields.io/github/stars/rohitg00/skillkit?style=flat&color=white&labelColor=000000"
alt="GitHub stars"
className="h-5"
/>
</a>
<a
href="https://github.com/rohitg00/skillkit/blob/main/LICENSE"
target="_blank"
rel="noopener noreferrer"
className="flex items-center"
>
<img
src="https://img.shields.io/badge/License-Apache%202.0-white?style=flat&labelColor=000000"
alt="License"
className="h-5"
/>
</a>
<a
href="https://github.com/rohitg00/skillkit"
target="_blank"
rel="noopener noreferrer"
className="flex items-center"
>
<img
src="https://img.shields.io/badge/PRs-welcome-white?style=flat&labelColor=000000"
alt="PRs Welcome"
className="h-5"
/>
</a>
</div>
</div>
</div>
<Agents />
<Features />
<Commands />
<section id="skills" className="py-12 border-b border-zinc-800">
<section id="stack" style={{ scrollMarginTop: '4rem' }}>
<StackBuilder />
</section>
<section id="trending" style={{ scrollMarginTop: '4rem' }}>
<TrendingSkills />
</section>
<section id="skills" className="py-12 border-b border-zinc-800" style={{ scrollMarginTop: '4rem' }}>
<SkillGenerator />
</section>
<section id="submit" className="py-12 border-b border-zinc-800" style={{ backgroundColor: '#09090b' }}>
<section id="submit" className="py-12 border-b border-zinc-800" style={{ backgroundColor: '#09090b', scrollMarginTop: '4rem' }}>
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="text-center mb-8">
<h2 className="text-2xl font-bold text-white mb-2 font-mono">Submit Your Skill</h2>
@@ -85,6 +203,10 @@ export default function App(): React.ReactElement {
<SkillSubmitForm />
</div>
</section>
<section id="sources" style={{ scrollMarginTop: '4rem' }}>
<Attribution />
</section>
</main>
<Footer />
+280
View File
@@ -0,0 +1,280 @@
import React from 'react';
interface SkillSource {
name: string;
repo: string;
description: string;
official?: boolean;
license?: string;
skillCount?: string;
}
const SKILL_SOURCES: SkillSource[] = [
{
name: 'Anthropic Official',
repo: 'anthropics/skills',
description: 'Official Claude Code skills from Anthropic',
official: true,
license: 'Apache 2.0',
skillCount: '21+',
},
{
name: 'Vercel Labs',
repo: 'vercel-labs/agent-skills',
description: 'Next.js, React, and Vercel platform skills',
official: true,
license: 'MIT',
skillCount: '15+',
},
{
name: 'Expo / React Native',
repo: 'expo/skills',
description: 'Mobile development with Expo and React Native',
official: true,
license: 'MIT',
skillCount: '12+',
},
{
name: 'Remotion Video',
repo: 'remotion-dev/skills',
description: 'Programmatic video creation with React',
official: true,
license: 'MIT',
skillCount: '8+',
},
{
name: 'Supabase',
repo: 'supabase/agent-skills',
description: 'Database, auth, and backend skills',
official: true,
license: 'Apache 2.0',
skillCount: '10+',
},
{
name: 'Stripe Payments',
repo: 'stripe/ai',
description: 'Payment integration and Stripe API patterns',
official: true,
license: 'MIT',
skillCount: '8+',
},
{
name: 'Trail of Bits Security',
repo: 'trailofbits/skills',
description: 'Security analysis, auditing, and vulnerability detection',
license: 'Apache 2.0',
skillCount: '25+',
},
{
name: 'Superpowers TDD',
repo: 'obra/superpowers',
description: 'Test-driven development and workflow automation by Jesse Obra',
license: 'MIT',
skillCount: '14+',
},
{
name: 'Dev Patterns',
repo: 'wshobson/agents',
description: 'Development patterns and agent configurations',
license: 'MIT',
skillCount: '48+',
},
{
name: 'Composio Awesome',
repo: 'ComposioHQ/awesome-claude-skills',
description: 'Curated collection of Claude Code skills',
license: 'MIT',
},
{
name: 'Travis Awesome',
repo: 'travisvn/awesome-claude-skills',
description: 'Community-curated skill collection',
license: 'MIT',
},
{
name: 'Skills Marketplace',
repo: 'mhattingpete/claude-skills-marketplace',
description: 'Community skill marketplace',
license: 'MIT',
},
{
name: 'Dify Frontend',
repo: 'langgenius/dify',
description: 'AI application development platform patterns',
license: 'Apache 2.0',
},
{
name: 'Better Auth',
repo: 'better-auth/skills',
description: 'Authentication and authorization patterns',
license: 'MIT',
},
{
name: 'Nuxt / Vue',
repo: 'onmax/nuxt-skills',
description: 'Vue.js and Nuxt framework skills',
license: 'MIT',
},
{
name: 'ElysiaJS / Bun',
repo: 'elysiajs/skills',
description: 'Bun runtime and ElysiaJS framework',
license: 'MIT',
},
{
name: 'NestJS',
repo: 'kadajett/agent-nestjs-skills',
description: 'NestJS backend framework patterns',
license: 'MIT',
},
{
name: 'Three.js',
repo: 'cloudai-x/threejs-skills',
description: '3D graphics and WebGL development',
license: 'MIT',
},
{
name: 'SwiftUI iOS',
repo: 'dimillian/skills',
description: 'iOS and SwiftUI development patterns',
license: 'MIT',
},
{
name: 'Convex Backend',
repo: 'waynesutton/convexskills',
description: 'Convex backend development',
license: 'MIT',
},
{
name: 'Obsidian Notes',
repo: 'kepano/obsidian-skills',
description: 'Obsidian plugin and vault management',
license: 'MIT',
},
{
name: 'Shadcn / Radix',
repo: 'giuseppe-trisciuoglio/developer-kit',
description: 'UI component libraries and design systems',
license: 'MIT',
},
{
name: 'OpenRouter SDK',
repo: 'openrouterteam/agent-skills',
description: 'OpenRouter API integration patterns',
license: 'MIT',
},
{
name: 'Context7',
repo: 'intellectronica/agent-skills',
description: 'Context management and documentation tools',
license: 'MIT',
},
];
export function Attribution(): React.ReactElement {
const officialSources = SKILL_SOURCES.filter(s => s.official);
const communitySources = SKILL_SOURCES.filter(s => !s.official);
return (
<section className="py-12 border-b border-zinc-800 bg-black">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="text-center mb-6 sm:mb-8">
<h2 className="text-lg sm:text-xl font-bold text-white mb-2 font-mono">Skill Sources</h2>
<p className="text-zinc-500 font-mono text-[10px] sm:text-xs max-w-2xl mx-auto px-2">
SkillKit aggregates skills from trusted sources. We credit and link back to all original creators.
Each source retains its original license.
</p>
</div>
<div className="mb-6 sm:mb-8">
<h3 className="text-xs sm:text-sm font-mono text-zinc-400 uppercase tracking-wider mb-3 sm:mb-4 flex items-center gap-2">
<span className="w-2 h-2 bg-blue-500 rounded-full"></span>
Official Partner Sources
</h3>
<div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-2 sm:gap-3">
{officialSources.map(source => (
<a
key={source.repo}
href={`https://github.com/${source.repo}`}
target="_blank"
rel="noopener noreferrer"
className="group bg-zinc-900/50 border border-zinc-800 p-3 sm:p-4 hover:border-blue-800 hover:bg-blue-950/20 transition-all"
>
<div className="flex items-start justify-between mb-1 sm:mb-2">
<div className="font-mono text-xs sm:text-sm text-white group-hover:text-blue-400 transition-colors">
{source.name}
</div>
{source.skillCount && (
<span className="text-[9px] sm:text-[10px] bg-blue-900/50 text-blue-400 px-1 sm:px-1.5 py-0.5 border border-blue-800/50">
{source.skillCount}
</span>
)}
</div>
<div className="text-[10px] sm:text-xs text-zinc-600 mb-2 line-clamp-2">{source.description}</div>
<div className="flex items-center gap-1 sm:gap-2 text-[9px] sm:text-[10px] text-zinc-700">
<svg className="w-3 h-3 flex-shrink-0" fill="currentColor" viewBox="0 0 24 24">
<path fillRule="evenodd" d="M12 2C6.477 2 2 6.484 2 12.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.531 1.032 1.531 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0112 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.202 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.943.359.309.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482A10.019 10.019 0 0022 12.017C22 6.484 17.522 2 12 2z" clipRule="evenodd" />
</svg>
<span className="font-mono truncate">{source.repo}</span>
{source.license && (
<>
<span className="hidden sm:inline">•</span>
<span className="hidden sm:inline">{source.license}</span>
</>
)}
</div>
</a>
))}
</div>
</div>
<div>
<h3 className="text-xs sm:text-sm font-mono text-zinc-400 uppercase tracking-wider mb-3 sm:mb-4 flex items-center gap-2">
<span className="w-2 h-2 bg-purple-500 rounded-full"></span>
Community Contributors
</h3>
<div className="grid grid-cols-2 sm:grid-cols-2 lg:grid-cols-4 gap-2">
{communitySources.map(source => (
<a
key={source.repo}
href={`https://github.com/${source.repo}`}
target="_blank"
rel="noopener noreferrer"
className="group bg-zinc-900/30 border border-zinc-800 p-2 sm:p-3 hover:border-purple-800/50 hover:bg-purple-950/10 transition-all"
>
<div className="flex items-center justify-between mb-0.5 sm:mb-1">
<div className="font-mono text-[10px] sm:text-xs text-white group-hover:text-purple-400 transition-colors truncate">
{source.name}
</div>
{source.skillCount && (
<span className="text-[8px] sm:text-[9px] bg-purple-900/30 text-purple-500 px-1 py-0.5 flex-shrink-0 ml-1">
{source.skillCount}
</span>
)}
</div>
<div className="text-[9px] sm:text-[10px] text-zinc-600 truncate">{source.repo}</div>
</a>
))}
</div>
</div>
<div className="mt-6 sm:mt-8 pt-4 sm:pt-6 border-t border-zinc-800 text-center">
<p className="text-zinc-600 text-[10px] sm:text-xs font-mono mb-2 sm:mb-3">
Want to add your skills to SkillKit?
</p>
<a
href="https://github.com/rohitg00/skillkit/issues/new?template=add-source.md"
target="_blank"
rel="noopener noreferrer"
className="inline-flex items-center gap-1.5 sm:gap-2 bg-zinc-900 text-zinc-400 px-3 sm:px-4 py-1.5 sm:py-2 font-mono text-[10px] sm:text-xs border border-zinc-800 hover:border-zinc-600 hover:text-white transition-colors"
>
<svg className="w-3 h-3 sm:w-4 sm:h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M12 6v6m0 0v6m0-6h6m-6 0H6" />
</svg>
Add Your Repository
</a>
</div>
</div>
</section>
);
}
+27 -25
View File
@@ -7,39 +7,39 @@ interface CommandGroup {
const COMMAND_GROUPS: CommandGroup[] = [
{
name: 'Core',
name: 'Start',
commands: [
{ cmd: 'install', desc: 'Install from GitHub/GitLab/local' },
{ cmd: 'sync', desc: 'Sync skills across agents' },
{ cmd: 'translate', desc: 'Convert between agent formats' },
{ cmd: 'update', desc: 'Update installed skills' },
{ cmd: '', desc: 'Launch interactive TUI' },
{ cmd: 'install <repo>', desc: 'Install from GitHub' },
{ cmd: 'recommend', desc: 'Get suggestions for your project' },
{ cmd: 'find <query>', desc: 'Search 15K+ skills' },
],
},
{
name: 'Discovery',
name: 'Manage',
commands: [
{ cmd: 'find', desc: 'Search marketplace (15K+ skills)' },
{ cmd: 'recommend', desc: 'AI-powered suggestions' },
{ cmd: 'check', desc: 'Dry-run update check' },
{ cmd: 'list', desc: 'View installed skills' },
{ cmd: 'sync', desc: 'Deploy to all agents' },
{ cmd: 'translate --to <agent>', desc: 'Convert formats' },
{ cmd: 'update', desc: 'Update all skills' },
],
},
{
name: 'Team',
commands: [
{ cmd: 'manifest init', desc: 'Create .skills file' },
{ cmd: 'manifest install', desc: 'Install from manifest' },
{ cmd: 'team share', desc: 'Share skills via Git' },
{ cmd: 'team share', desc: 'Share via Git' },
{ cmd: 'publish', desc: 'Submit to marketplace' },
{ cmd: 'cicd init', desc: 'CI/CD templates' },
],
},
{
name: 'Advanced',
commands: [
{ cmd: 'ui', desc: 'Launch terminal UI' },
{ cmd: 'workflow run', desc: 'Execute skill pipelines' },
{ cmd: 'primer', desc: 'Generate CLAUDE.md from code' },
{ cmd: 'agent translate', desc: 'Batch convert agents' },
{ cmd: 'command generate', desc: 'Create /slash commands' },
{ cmd: 'cicd init', desc: 'Generate CI templates' },
{ cmd: 'memory export', desc: 'Save session learnings' },
],
},
];
@@ -58,7 +58,7 @@ export function Commands(): React.ReactElement {
</p>
</div>
<div className="flex justify-center gap-2 mb-6">
<div className="flex justify-center gap-1.5 sm:gap-2 mb-4 sm:mb-6 flex-wrap">
{COMMAND_GROUPS.map((g, i) => {
const isActive = i === activeGroup;
const buttonClass = isActive
@@ -68,7 +68,7 @@ export function Commands(): React.ReactElement {
<button
key={g.name}
onClick={() => setActiveGroup(i)}
className={`px-3 py-1.5 text-xs font-mono border transition-colors ${buttonClass}`}
className={`px-2 sm:px-3 py-1 sm:py-1.5 text-[10px] sm:text-xs font-mono border transition-colors ${buttonClass}`}
>
{g.name}
</button>
@@ -76,24 +76,26 @@ export function Commands(): React.ReactElement {
})}
</div>
<div className="border border-zinc-800 bg-black/50 p-4 font-mono text-xs">
<div className="grid grid-cols-1 sm:grid-cols-2 gap-2">
<div className="border border-zinc-800 bg-black/50 p-2 sm:p-4 font-mono text-[10px] sm:text-xs">
<div className="grid grid-cols-1 sm:grid-cols-2 gap-1 sm:gap-2">
{group.commands.map((c) => (
<div
key={c.cmd}
className="flex items-center gap-3 p-2 hover:bg-zinc-900/50 transition-colors rounded"
key={c.cmd || 'tui'}
className="flex items-center gap-2 p-1.5 sm:p-2 hover:bg-zinc-900/50 transition-colors rounded"
>
<span className="text-zinc-600">$</span>
<span className="text-white">skillkit {c.cmd}</span>
<span className="text-zinc-600 hidden sm:inline">→</span>
<span className="text-zinc-500 hidden sm:inline truncate">{c.desc}</span>
<span className="text-white text-[10px] sm:text-xs">
{c.cmd ? `skillkit ${c.cmd}` : 'npx skillkit@latest'}
</span>
<span className="text-zinc-600 ml-auto">→</span>
<span className="text-zinc-500 truncate max-w-[80px] sm:max-w-none">{c.desc}</span>
</div>
))}
</div>
</div>
<div className="mt-4 text-center">
<span className="text-zinc-600 text-xs font-mono">
<div className="mt-3 sm:mt-4 text-center">
<span className="text-zinc-600 text-[10px] sm:text-xs font-mono">
Run <span className="text-zinc-400">skillkit --help</span> for all commands
</span>
</div>
@@ -46,6 +46,7 @@ const sections: DocSection[] = [
</p>
<h3 className="text-lg font-semibold text-white mt-6">Core Capabilities</h3>
<ul className="list-disc list-inside space-y-2 text-zinc-400">
<li><span className="text-white">AI Instruction Generation (Primer)</span> - Analyze your codebase and generate customized instruction files for all 32 agents</li>
<li><span className="text-white">Skill Discovery</span> - Browse 15,000+ skills from marketplace with AI-powered recommendations</li>
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 32 agent-specific formats</li>
<li><span className="text-white">Team Collaboration</span> - Share skills via .skills manifest files and publish to marketplace</li>
@@ -203,6 +204,15 @@ skillkit manifest install # Install from manifest
skillkit publish # Publish skill to marketplace
skillkit cicd init # Setup CI/CD integration`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">AI Instruction Generation (Primer)</h3>
<CodeBlock>{`skillkit primer # Analyze codebase, generate for detected agents
skillkit primer --all-agents # Generate for all 32 agents
skillkit primer --agent claude-code,cursor # Specific agents only
skillkit primer --analyze-only # Only show codebase analysis
skillkit primer --dry-run # Preview without writing files
skillkit primer --json # Output analysis as JSON
skillkit primer --output ./dir # Custom output directory`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Advanced</h3>
<CodeBlock>{`skillkit ui # Launch Terminal UI
skillkit workflow # Manage workflows
+10 -1
View File
@@ -7,6 +7,15 @@ interface Feature {
}
const FEATURES: Feature[] = [
{
title: 'Primer',
description: 'Generate AI instructions from codebase analysis.',
icon: (
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9.663 17h4.673M12 3v1m6.364 1.636l-.707.707M21 12h-1M4 12H3m3.343-5.657l-.707-.707m2.828 9.9a5 5 0 117.072 0l-.548.547A3.374 3.374 0 0014 18.469V19a2 2 0 11-4 0v-.531c0-.895-.356-1.754-.988-2.386l-.548-.547z" />
</svg>
)
},
{
title: 'Multi-Agent',
description: 'Deploy to 32 AI coding agents with one command.',
@@ -65,10 +74,10 @@ const FEATURES: Feature[] = [
const COMPARISONS = [
['Agents', '1', '32'],
['Instructions', 'Manual', 'Primer Auto'],
['Translation', 'Manual', 'Auto'],
['Sharing', 'Copy/paste', '.skills manifest'],
['Discovery', 'Forums', 'CLI + AI'],
['CI/CD', 'Custom', 'Templates'],
] as const;
export function Features(): React.ReactElement {
+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"
+12 -14
View File
@@ -16,17 +16,15 @@ interface TerminalLine {
}
const TERMINAL_LINES: TerminalLine[] = [
{ type: 'cmd', text: 'skillkit find react' },
{ type: 'out', text: ' ■ react-patterns ★★★★★' },
{ type: 'out', text: ' ■ react-testing ★★★★☆' },
{ type: 'cmd', text: 'skillkit recommend' },
{ type: 'out', text: ' 92% react-best-practices' },
{ type: 'out', text: ' 87% typescript-strict' },
{ type: 'cmd', text: 'skillkit install anthropics/skills' },
{ type: 'out', text: '→ 3 skills → 5 agents' },
{ type: 'cmd', text: 'skillkit ui' },
{ type: 'out', text: '→ Launching TUI...' },
{ type: 'cmd', text: 'skillkit check' },
{ type: 'out', text: ' ✓ All skills up to date' },
{ type: 'cmd', text: 'skillkit manifest install' },
{ type: 'out', text: '→ 12 skills from .skills' },
{ type: 'out', text: '→ Installed 3 skills' },
{ type: 'cmd', text: 'skillkit sync --agent cursor,claude' },
{ type: 'out', text: ' ✓ Synced to 2 agents' },
{ type: 'cmd', text: 'skillkit translate my-skill --to codex' },
{ type: 'out', text: '→ Converted to SKILL.md format' },
];
const FADE_ANIMATION_STYLES = `
@@ -122,11 +120,11 @@ export function Hero(): React.ReactElement {
</pre>
</div>
<div className="grid grid-cols-1 lg:grid-cols-2 gap-6 lg:gap-8 items-start">
<div className="grid grid-cols-1 md:grid-cols-2 gap-6 lg:gap-8 items-start">
<div className="animate-fade-in">
<div className="inline-flex items-center space-x-2 border border-zinc-800 bg-zinc-900/50 px-2 py-0.5 mb-3 backdrop-blur-sm">
<span className="flex h-1.5 w-1.5 bg-white rounded-full"></span>
<span className="text-xs font-mono text-zinc-400">v1.7.5</span>
<span className="text-xs font-mono text-zinc-400">v1.7.11</span>
</div>
<h1 className="text-2xl sm:text-3xl lg:text-4xl font-bold tracking-tight text-white mb-3 font-mono">
@@ -163,7 +161,7 @@ export function Hero(): React.ReactElement {
</div>
</div>
<div className="hidden lg:block relative animate-fade-in-delay w-full">
<div className="hidden md:block relative animate-fade-in-delay w-full">
<div className="absolute -inset-1 bg-gradient-to-r from-zinc-800 via-zinc-700 to-zinc-800 rounded-lg opacity-20 blur-lg"></div>
<div className="relative border border-zinc-800 bg-black rounded-lg overflow-hidden">
<div className="flex items-center gap-1.5 px-3 py-2 border-b border-zinc-800 bg-zinc-900/50">
@@ -172,7 +170,7 @@ export function Hero(): React.ReactElement {
<div className="w-2.5 h-2.5 rounded-full bg-zinc-700"></div>
<span className="ml-2 text-zinc-500 text-xs font-mono">skillkit</span>
</div>
<div className="p-4 font-mono text-xs min-h-[200px] max-h-[280px]">
<div className="p-3 md:p-4 font-mono text-[10px] md:text-xs min-h-[180px] md:min-h-[200px] max-h-[240px] md:max-h-[280px]">
{TERMINAL_LINES.slice(0, visibleLines).map((line, index) => (
<div key={index} className="mb-1">
{line.type === 'cmd' ? (
+1 -1
View File
@@ -490,7 +490,7 @@ ${skillContent.slice(0, 4000)}${skillContent.length > 4000 ? '\n...(truncated)'
<p className="text-zinc-500 font-mono text-sm mb-3">Install with SkillKit:</p>
<pre className="border border-zinc-800 p-3 sm:p-4 text-sm overflow-x-auto max-w-full" style={{ backgroundColor: '#09090b' }}>
<code className="font-mono text-xs sm:text-sm break-all sm:break-normal" style={{ color: '#d4d4d8' }}>
npx skillkit install {selectedSkill.id.split('/').slice(0, 2).join('/')}
npx skillkit@latest install {selectedSkill.id.split('/').slice(0, 2).join('/')}
</code>
</pre>
</div>
+233
View File
@@ -0,0 +1,233 @@
import React, { useState } from 'react';
import { searchSkills, IndexedSkill, SKILLS_INDEX } from '../data/skills-index';
interface StackItem extends IndexedSkill {
addedAt: number;
}
const POPULAR_STACKS = [
{
name: 'Full Stack TypeScript',
skills: ['react', 'nextjs', 'typescript', 'prisma', 'tailwind'],
icon: '⚡',
},
{
name: 'AI/ML Development',
skills: ['python', 'langchain', 'openai', 'embeddings'],
icon: '🤖',
},
{
name: 'DevOps & Cloud',
skills: ['docker', 'kubernetes', 'terraform', 'github-actions'],
icon: '☁️',
},
{
name: 'Mobile Development',
skills: ['react-native', 'expo', 'ios', 'android'],
icon: '📱',
},
];
export function StackBuilder(): React.ReactElement {
const [stack, setStack] = useState<StackItem[]>([]);
const [searchQuery, setSearchQuery] = useState('');
const [searchResults, setSearchResults] = useState<IndexedSkill[]>([]);
const [copied, setCopied] = useState(false);
function handleSearch(query: string): void {
setSearchQuery(query);
if (query.trim()) {
const results = searchSkills(query).filter(
skill => !stack.some(s => s.id === skill.id)
);
setSearchResults(results);
} else {
setSearchResults([]);
}
}
function addToStack(skill: IndexedSkill): void {
if (!stack.some(s => s.id === skill.id)) {
setStack([...stack, { ...skill, addedAt: Date.now() }]);
setSearchQuery('');
setSearchResults([]);
}
}
function removeFromStack(skillId: string): void {
setStack(stack.filter(s => s.id !== skillId));
}
function loadPresetStack(presetSkills: string[]): void {
const newItems: StackItem[] = [];
presetSkills.forEach(query => {
const results = searchSkills(query);
if (results.length > 0 && !stack.some(s => s.id === results[0].id) && !newItems.some(s => s.id === results[0].id)) {
newItems.push({ ...results[0], addedAt: Date.now() });
}
});
setStack([...stack, ...newItems]);
}
function generateInstallCommand(): string {
if (stack.length === 0) return '';
const skillIds = [...new Set(stack.map(s => s.id.split('/').slice(0, 2).join('/')))];
if (skillIds.length === 1) {
return `npx skillkit@latest install ${skillIds[0]}`;
}
return `npx skillkit@latest install ${skillIds.join(' ')}`;
}
async function copyCommand(): Promise<void> {
const cmd = generateInstallCommand();
if (!cmd) return;
try {
await navigator.clipboard.writeText(cmd);
setCopied(true);
setTimeout(() => setCopied(false), 2000);
} catch {
// Clipboard API failed, silently ignore
}
}
function clearStack(): void {
setStack([]);
}
return (
<section className="py-12 border-b border-zinc-800">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="flex items-center justify-between mb-6">
<div>
<h2 className="text-xl font-bold text-white mb-1 font-mono">Stack Builder</h2>
<p className="text-zinc-500 font-mono text-xs">
Compose your perfect skill stack. Install everything with one command.
</p>
</div>
{stack.length > 0 && (
<button
onClick={clearStack}
className="text-zinc-500 hover:text-red-400 font-mono text-xs transition-colors"
>
Clear All
</button>
)}
</div>
<div className="flex flex-col lg:flex-row gap-6">
<div className="flex-1 space-y-4">
<div className="relative">
<input
type="text"
value={searchQuery}
onChange={(e) => handleSearch(e.target.value)}
placeholder="Search skills to add..."
className="w-full bg-zinc-900 border border-zinc-700 text-white px-4 py-3 focus:ring-2 focus:ring-white focus:border-transparent outline-none font-mono text-sm placeholder-zinc-600"
/>
{searchResults.length > 0 && (
<div className="absolute z-10 w-full mt-1 bg-zinc-900 border border-zinc-700 max-h-60 overflow-y-auto">
{searchResults.slice(0, 8).map(skill => (
<button
key={skill.id}
onClick={() => addToStack(skill)}
className="w-full text-left px-4 py-3 hover:bg-zinc-800 transition-colors border-b border-zinc-800 last:border-b-0"
>
<div className="font-mono text-sm text-white">{skill.name}</div>
<div className="text-xs text-zinc-500 truncate">{skill.description}</div>
</button>
))}
</div>
)}
</div>
<div className="space-y-2">
<span className="text-zinc-500 text-xs font-mono block">Quick add:</span>
<div className="flex flex-wrap gap-2">
{POPULAR_STACKS.map(preset => (
<button
key={preset.name}
onClick={() => loadPresetStack(preset.skills)}
className="text-[10px] sm:text-xs bg-zinc-900 text-zinc-400 px-2 sm:px-3 py-1 sm:py-1.5 border border-zinc-700 hover:border-zinc-500 hover:text-white transition-colors font-mono"
>
{preset.icon} <span className="hidden sm:inline">{preset.name}</span><span className="sm:hidden">{preset.name.split(' ')[0]}</span>
</button>
))}
</div>
</div>
{stack.length > 0 && (
<div className="space-y-2">
<div className="text-xs font-mono text-zinc-500 uppercase tracking-wider">
Your Stack ({stack.length} skills)
</div>
<div className="grid grid-cols-1 sm:grid-cols-2 gap-2">
{stack.map(skill => (
<div
key={skill.id}
className="flex items-center justify-between bg-zinc-900/50 border border-zinc-800 p-3 group"
>
<div className="flex-1 min-w-0">
<div className="font-mono text-sm text-white truncate">{skill.name}</div>
<div className="text-xs text-zinc-600 truncate">{skill.source}</div>
</div>
<button
onClick={() => removeFromStack(skill.id)}
aria-label={`Remove ${skill.name} from stack`}
className="ml-2 text-zinc-600 hover:text-red-400 transition-colors opacity-0 group-hover:opacity-100 focus-visible:opacity-100"
>
<svg className="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M6 18L18 6M6 6l12 12" />
</svg>
</button>
</div>
))}
</div>
</div>
)}
</div>
<div className="lg:w-80 lg:flex-shrink-0">
<div className="lg:sticky lg:top-20 bg-zinc-900/50 border border-zinc-800 p-3 sm:p-4">
<div className="text-xs font-mono text-zinc-500 uppercase tracking-wider mb-3">
Install Command
</div>
{stack.length > 0 ? (
<>
<pre className="bg-black border border-zinc-800 p-3 overflow-x-auto text-xs mb-3">
<code className="font-mono text-green-400 whitespace-pre-wrap break-all">
{generateInstallCommand()}
</code>
</pre>
<button
onClick={copyCommand}
className="w-full bg-white text-black py-2 font-mono text-sm hover:bg-zinc-200 transition-colors flex items-center justify-center gap-2"
>
{copied ? (
<>
<svg className="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M5 13l4 4L19 7" />
</svg>
COPIED!
</>
) : (
<>
<svg className="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z" />
</svg>
COPY COMMAND
</>
)}
</button>
</>
) : (
<div className="text-zinc-600 text-xs font-mono text-center py-6">
Add skills to generate install command
</div>
)}
</div>
</div>
</div>
</div>
</section>
);
}
+155
View File
@@ -0,0 +1,155 @@
import React, { useState } from 'react';
import { SKILLS_INDEX, IndexedSkill, getSkillsByTag } from '../data/skills-index';
const CATEGORIES = [
{ id: 'all', name: 'All', icon: '◆' },
{ id: 'react', name: 'React', icon: '⚛' },
{ id: 'typescript', name: 'TypeScript', icon: '◈' },
{ id: 'python', name: 'Python', icon: '◉' },
{ id: 'ai', name: 'AI/ML', icon: '◎' },
{ id: 'security', name: 'Security', icon: '◐' },
{ id: 'devops', name: 'DevOps', icon: '◑' },
{ id: 'testing', name: 'Testing', icon: '◒' },
] as const;
const TRENDING_SKILLS = [
'anthropics/skills/claude-code-guide',
'anthropics/skills/claude-code-setup',
'obra/superpowers/tdd',
'vercel-labs/agent-skills/nextjs',
'trailofbits/skills/security-review',
'expo/skills/react-native',
'remotion-dev/skills/video',
'supabase/agent-skills/database',
];
function getTrendingSkills(): IndexedSkill[] {
return TRENDING_SKILLS
.map(id => SKILLS_INDEX.find(s => s.id === id))
.filter((s): s is IndexedSkill => s !== undefined)
.slice(0, 8);
}
function getPopularByCategory(category: string): IndexedSkill[] {
if (category === 'all') {
return SKILLS_INDEX.slice(0, 12);
}
return getSkillsByTag(category).slice(0, 12);
}
export function TrendingSkills(): React.ReactElement {
const [activeCategory, setActiveCategory] = useState('all');
const [hoveredSkill, setHoveredSkill] = useState<string | null>(null);
const trendingSkills = getTrendingSkills();
const categorySkills = getPopularByCategory(activeCategory);
return (
<section className="py-12 border-b border-zinc-800 bg-zinc-950">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="flex flex-col sm:flex-row sm:items-center justify-between gap-2 mb-6">
<div>
<h2 className="text-lg sm:text-xl font-bold text-white mb-1 font-mono">Trending Skills</h2>
<p className="text-zinc-500 font-mono text-[10px] sm:text-xs">
Popular skills used by the community.
</p>
</div>
<div className="flex items-center gap-2">
<span className="w-2 h-2 bg-green-500 rounded-full animate-pulse"></span>
<span className="text-[10px] sm:text-xs font-mono text-zinc-500">Updated weekly</span>
</div>
</div>
<div className="grid grid-cols-2 sm:grid-cols-4 gap-2 sm:gap-3 mb-8">
{trendingSkills.map((skill, index) => (
<div
key={skill.id}
className="relative group bg-zinc-900/50 border border-zinc-800 p-2 sm:p-4 hover:border-zinc-600 transition-all cursor-pointer"
onMouseEnter={() => setHoveredSkill(skill.id)}
onMouseLeave={() => setHoveredSkill(null)}
>
<div className="absolute top-1 sm:top-2 right-1 sm:right-2 text-[10px] sm:text-xs font-mono text-zinc-600">
#{index + 1}
</div>
<div className="font-mono text-[11px] sm:text-sm text-white mb-1 truncate pr-4 sm:pr-6">{skill.name}</div>
<div className="text-[10px] sm:text-xs text-zinc-600 truncate">{skill.source}</div>
{skill.tags.length > 0 && (
<div className="hidden sm:flex flex-wrap gap-1 mt-2">
{skill.tags.slice(0, 2).map((tag, idx) => (
<span key={idx} className="text-[10px] bg-zinc-800 text-zinc-500 px-1.5 py-0.5">
{tag}
</span>
))}
</div>
)}
{hoveredSkill === skill.id && (
<div className="absolute inset-0 bg-white/5 pointer-events-none transition-opacity"></div>
)}
</div>
))}
</div>
<div className="border-t border-zinc-800 pt-6 sm:pt-8">
<div className="mb-3 sm:mb-4">
<h3 className="text-xs sm:text-sm font-mono text-zinc-400 uppercase tracking-wider">Browse by Category</h3>
</div>
<div className="flex flex-wrap gap-1.5 sm:gap-2 mb-4 sm:mb-6 overflow-x-auto pb-2 -mx-4 px-4 sm:mx-0 sm:px-0">
{CATEGORIES.map(cat => (
<button
key={cat.id}
onClick={() => setActiveCategory(cat.id)}
className={`px-2 sm:px-3 py-1 sm:py-1.5 font-mono text-[10px] sm:text-xs transition-all whitespace-nowrap flex-shrink-0 ${
activeCategory === cat.id
? 'bg-white text-black'
: 'bg-zinc-900 text-zinc-400 border border-zinc-800 hover:border-zinc-600 hover:text-white'
}`}
>
<span className="mr-1 sm:mr-1.5">{cat.icon}</span>
{cat.name}
</button>
))}
</div>
<div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-2 sm:gap-3">
{categorySkills.map(skill => (
<div
key={skill.id}
className="bg-zinc-900/30 border border-zinc-800 p-4 hover:border-zinc-700 transition-all group"
>
<div className="flex items-start justify-between">
<div className="flex-1 min-w-0">
<div className="font-mono text-sm text-white mb-1 truncate">{skill.name}</div>
<div className="text-xs text-zinc-600 line-clamp-2">{skill.description || 'No description'}</div>
</div>
<svg
className="w-4 h-4 text-zinc-700 group-hover:text-zinc-400 transition-colors flex-shrink-0 ml-2"
fill="none"
viewBox="0 0 24 24"
stroke="currentColor"
>
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5l7 7-7 7" />
</svg>
</div>
<div className="flex items-center justify-between mt-3 pt-3 border-t border-zinc-800">
<div className="text-[10px] text-zinc-600 font-mono truncate">{skill.source}</div>
{skill.tags.length > 0 && (
<span className="text-[10px] bg-zinc-800 text-zinc-500 px-1.5 py-0.5 flex-shrink-0 ml-2">
{skill.tags[0]}
</span>
)}
</div>
</div>
))}
</div>
{categorySkills.length === 0 && (
<div className="text-center py-8 text-zinc-600 font-mono text-sm">
No skills found in this category.
</div>
)}
</div>
</div>
</section>
);
}
+2 -2
View File
@@ -1,12 +1,12 @@
{
"name": "skillkit-monorepo",
"version": "1.7.2",
"version": "1.7.10",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "skillkit-monorepo",
"version": "1.7.2",
"version": "1.7.10",
"license": "Apache-2.0",
"devDependencies": {
"@types/node": "^22.10.5",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit-monorepo",
"version": "1.7.9",
"version": "1.7.11",
"private": true,
"description": "Universal skills loader for AI coding agents - Monorepo",
"type": "module",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/agents",
"version": "1.7.9",
"version": "1.7.11",
"description": "Agent adapters for SkillKit - supports 32 AI coding agents",
"type": "module",
"main": "./dist/index.js",
+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> {
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/cli",
"version": "1.7.9",
"version": "1.7.11",
"description": "CLI commands for SkillKit",
"type": "module",
"main": "./dist/index.js",
-1
View File
@@ -107,7 +107,6 @@ export class PrimerCommand extends Command {
try {
const result = generatePrimer(projectPath, {
projectPath,
agents,
allAgents: this.allAgents,
outputDir: this.output ? resolve(this.output) : undefined,
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/core",
"version": "1.7.9",
"version": "1.7.11",
"description": "Core functionality for SkillKit - skill discovery, parsing, and translation",
"type": "module",
"main": "./dist/index.js",
@@ -173,6 +173,7 @@ describe('Primer', () => {
});
expect(result.success).toBe(true);
expect(result.generated.length).toBeGreaterThan(0);
const instruction = result.generated[0];
expect(instruction.content).toContain('# test-project');
+21 -13
View File
@@ -1,5 +1,5 @@
import { existsSync, readFileSync, readdirSync } from 'node:fs';
import { join, basename } from 'node:path';
import { join, basename, relative, sep } from 'node:path';
import type {
PrimerAnalysis,
PackageManager,
@@ -125,7 +125,8 @@ export class PrimerAnalyzer {
try {
const entries = readdirSync(dir, { withFileTypes: true });
for (const entry of entries) {
const relativePath = join(dir, entry.name).replace(this.projectPath + '/', '');
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);
@@ -137,7 +138,7 @@ export class PrimerAnalyzer {
}
this.files.add(relativePath);
if (entry.isDirectory()) {
scan(join(dir, entry.name), depth + 1);
scan(fullPath, depth + 1);
}
}
} catch {
@@ -231,10 +232,15 @@ export class PrimerAnalyzer {
}
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: 'pyproject.toml',
source,
});
}
@@ -289,8 +295,8 @@ export class PrimerAnalyzer {
return languages;
}
private detectPackageManagers(): string[] {
const managers: Set<string> = new Set();
private detectPackageManagers(): PackageManager[] {
const managers: Set<PackageManager> = new Set();
for (const [file, manager] of Object.entries(PACKAGE_MANAGER_FILES)) {
if (this.hasFile(file)) {
@@ -302,8 +308,8 @@ export class PrimerAnalyzer {
const packageManager = this.packageJson.packageManager;
if (typeof packageManager === 'string') {
const match = packageManager.match(/^(npm|pnpm|yarn|bun)@/);
if (match) {
managers.add(match[1]);
if (match && ['npm', 'pnpm', 'yarn', 'bun'].includes(match[1])) {
managers.add(match[1] as PackageManager);
}
}
}
@@ -316,11 +322,11 @@ export class PrimerAnalyzer {
hasWorkspaces: false,
};
if (this.hasFile('src')) {
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('packages') || this.hasFile('apps')) {
structure.type = 'monorepo';
} else if (this.hasFile('lib')) {
structure.type = 'src-based';
structure.srcDir = 'lib';
@@ -582,7 +588,7 @@ export class PrimerAnalyzer {
let directories = 0;
for (const file of this.files) {
if (file.includes('/')) {
if (file.includes(sep)) {
directories++;
}
files++;
@@ -596,7 +602,9 @@ export class PrimerAnalyzer {
private hasFile(name: string): boolean {
if (name.includes('*')) {
const regex = new RegExp(name.replace(/\*/g, '.*'));
const regex = new RegExp(
name.replace(/[.+?^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '.*')
);
for (const file of this.files) {
if (regex.test(file)) return true;
}
+314 -151
View File
@@ -12,40 +12,121 @@ import type {
import { AGENT_INSTRUCTION_TEMPLATES } from './types.js';
import { analyzePrimer } from './analyzer.js';
const ALL_AGENTS: AgentType[] = [
'claude-code',
'cursor',
'codex',
'gemini-cli',
'opencode',
'antigravity',
'amp',
'clawdbot',
'droid',
'github-copilot',
'goose',
'kilo',
'kiro-cli',
'roo',
'trae',
'windsurf',
'universal',
'cline',
'codebuddy',
'commandcode',
'continue',
'crush',
'factory',
'mcpjam',
'mux',
'neovate',
'openhands',
'pi',
'qoder',
'qwen',
'vercel',
'zencoder',
];
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;
@@ -61,6 +142,7 @@ export class PrimerGenerator {
const warnings: string[] = [];
const errors: string[] = [];
const generated: GeneratedInstruction[] = [];
const seenPaths = new Map<string, string>();
this.analysis = analyzePrimer(this.projectPath);
@@ -80,6 +162,15 @@ export class PrimerGenerator {
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);
}
@@ -162,10 +253,21 @@ export class PrimerGenerator {
}
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: 'markdown',
format,
sectionOrder: ['overview', 'stack', 'commands', 'conventions', 'structure', 'guidelines'],
};
}
@@ -173,10 +275,17 @@ export class PrimerGenerator {
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);
const content = this.generateSection(section, template, renderer);
if (content) {
sections.push(content);
}
@@ -193,271 +302,310 @@ export class PrimerGenerator {
}
if (this.options.customInstructions) {
result += '\n\n## Custom Instructions\n\n' + this.options.customInstructions;
result += '\n\n' + renderer.h2('Custom Instructions') + '\n\n' + this.options.customInstructions;
}
return result;
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 generateSection(section: string, template: AgentInstructionTemplate): string {
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();
return this.generateOverviewSection(renderer);
case 'stack':
return this.generateStackSection();
return this.generateStackSection(renderer);
case 'commands':
return this.generateCommandsSection();
return this.generateCommandsSection(renderer);
case 'conventions':
return this.generateConventionsSection();
return this.generateConventionsSection(renderer);
case 'structure':
return this.generateStructureSection();
return this.generateStructureSection(renderer);
case 'guidelines':
return this.generateGuidelinesSection(template.agent);
return this.generateGuidelinesSection(template.agent, renderer);
default:
return '';
}
}
private generateOverviewSection(): string {
private generateOverviewSection(renderer: FormatRenderer): string {
if (!this.analysis) return '';
const { project, languages } = this.analysis;
const lines: string[] = [];
lines.push(`# ${project.name}`);
lines.push(renderer.h1(project.name));
lines.push('');
if (project.description) {
lines.push(project.description);
lines.push(renderer.paragraph(project.description));
lines.push('');
}
if (project.type) {
lines.push(`**Project Type:** ${this.formatProjectType(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(`**Languages:** ${langNames}`);
lines.push(renderer.keyValue('Languages', langNames));
}
if (project.version) {
lines.push(`**Version:** ${project.version}`);
lines.push(renderer.keyValue('Version', project.version));
}
return lines.join('\n');
}
private generateStackSection(): string {
private generateStackSection(renderer: FormatRenderer): string {
if (!this.analysis) return '';
const { stack, packageManagers } = this.analysis;
const lines: string[] = [];
lines.push('## Technology Stack');
lines.push(renderer.h2('Technology Stack'));
lines.push('');
if (stack.frameworks.length > 0) {
lines.push('### Frameworks');
for (const fw of stack.frameworks) {
lines.push(renderer.h3('Frameworks'));
const items = stack.frameworks.map(fw => {
const version = fw.version ? ` (${fw.version})` : '';
lines.push(`- ${this.capitalize(fw.name)}${version}`);
}
return `${this.capitalize(fw.name)}${version}`;
});
lines.push(renderer.list(items));
lines.push('');
}
if (stack.libraries.length > 0) {
lines.push('### Libraries');
for (const lib of stack.libraries) {
lines.push(renderer.h3('Libraries'));
const items = stack.libraries.map(lib => {
const version = lib.version ? ` (${lib.version})` : '';
lines.push(`- ${this.capitalize(lib.name)}${version}`);
}
return `${this.capitalize(lib.name)}${version}`;
});
lines.push(renderer.list(items));
lines.push('');
}
if (stack.styling.length > 0) {
lines.push('### Styling');
for (const style of stack.styling) {
lines.push(`- ${this.capitalize(style.name)}`);
}
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('### Testing');
for (const test of stack.testing) {
lines.push(`- ${this.capitalize(test.name)}`);
}
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('### Databases');
for (const db of stack.databases) {
lines.push(`- ${this.capitalize(db.name)}`);
}
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('### Package Manager');
lines.push(`- ${packageManagers.map(pm => this.capitalize(pm)).join(', ')}`);
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(): string {
private generateCommandsSection(renderer: FormatRenderer): string {
if (!this.analysis || !this.analysis.buildCommands) return '';
const { buildCommands } = this.analysis;
const lines: string[] = [];
const commands: string[] = [];
lines.push('## Development Commands');
lines.push(renderer.h2('Development Commands'));
lines.push('');
lines.push('```bash');
if (buildCommands.install) {
lines.push(`# Install dependencies`);
lines.push(buildCommands.install);
lines.push('');
commands.push(`# Install dependencies`);
commands.push(buildCommands.install);
commands.push('');
}
if (buildCommands.dev) {
lines.push(`# Start development server`);
lines.push(buildCommands.dev);
lines.push('');
commands.push(`# Start development server`);
commands.push(buildCommands.dev);
commands.push('');
}
if (buildCommands.build) {
lines.push(`# Build for production`);
lines.push(buildCommands.build);
lines.push('');
commands.push(`# Build for production`);
commands.push(buildCommands.build);
commands.push('');
}
if (buildCommands.test) {
lines.push(`# Run tests`);
lines.push(buildCommands.test);
lines.push('');
commands.push(`# Run tests`);
commands.push(buildCommands.test);
commands.push('');
}
if (buildCommands.lint) {
lines.push(`# Run linter`);
lines.push(buildCommands.lint);
lines.push('');
commands.push(`# Run linter`);
commands.push(buildCommands.lint);
commands.push('');
}
if (buildCommands.format) {
lines.push(`# Format code`);
lines.push(buildCommands.format);
commands.push(`# Format code`);
commands.push(buildCommands.format);
}
lines.push('```');
lines.push(renderer.codeBlock(commands.join('\n'), 'bash'));
return lines.join('\n');
}
private generateConventionsSection(): string {
private generateConventionsSection(renderer: FormatRenderer): string {
if (!this.analysis) return '';
const { conventions, patterns } = this.analysis;
const lines: string[] = [];
lines.push('## Code Conventions');
lines.push(renderer.h2('Code Conventions'));
lines.push('');
if (conventions) {
const items: string[] = [];
if (conventions.indentation) {
lines.push(`- **Indentation:** ${conventions.indentation}`);
items.push(`${renderer.bold('Indentation:')} ${conventions.indentation}`);
}
if (conventions.quotes) {
lines.push(`- **Quotes:** ${conventions.quotes}`);
items.push(`${renderer.bold('Quotes:')} ${conventions.quotes}`);
}
if (conventions.semicolons !== undefined) {
lines.push(`- **Semicolons:** ${conventions.semicolons ? 'required' : 'omitted'}`);
items.push(`${renderer.bold('Semicolons:')} ${conventions.semicolons ? 'required' : 'omitted'}`);
}
if (conventions.trailingCommas) {
lines.push(`- **Trailing Commas:** ${conventions.trailingCommas}`);
items.push(`${renderer.bold('Trailing Commas:')} ${conventions.trailingCommas}`);
}
if (conventions.maxLineLength) {
lines.push(`- **Max Line Length:** ${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('### Patterns');
lines.push(renderer.h3('Patterns'));
const items: string[] = [];
if (patterns.components) {
lines.push(`- **Components:** ${patterns.components}`);
items.push(`${renderer.bold('Components:')} ${patterns.components}`);
}
if (patterns.stateManagement) {
lines.push(`- **State Management:** ${patterns.stateManagement}`);
items.push(`${renderer.bold('State Management:')} ${patterns.stateManagement}`);
}
if (patterns.apiStyle) {
lines.push(`- **API Style:** ${patterns.apiStyle}`);
items.push(`${renderer.bold('API Style:')} ${patterns.apiStyle}`);
}
if (patterns.styling) {
lines.push(`- **Styling:** ${patterns.styling}`);
items.push(`${renderer.bold('Styling:')} ${patterns.styling}`);
}
if (patterns.testing) {
lines.push(`- **Testing:** ${patterns.testing}`);
items.push(`${renderer.bold('Testing:')} ${patterns.testing}`);
}
if (patterns.linting) {
lines.push(`- **Linting:** ${patterns.linting}`);
items.push(`${renderer.bold('Linting:')} ${patterns.linting}`);
}
if (patterns.formatting) {
lines.push(`- **Formatting:** ${patterns.formatting}`);
items.push(`${renderer.bold('Formatting:')} ${patterns.formatting}`);
}
if (items.length > 0) {
lines.push(renderer.list(items));
}
}
return lines.join('\n');
}
private generateStructureSection(): string {
private generateStructureSection(renderer: FormatRenderer): string {
if (!this.analysis) return '';
const { structure, importantFiles } = this.analysis;
const lines: string[] = [];
lines.push('## Project Structure');
lines.push(renderer.h2('Project Structure'));
lines.push('');
if (structure) {
if (structure.type) {
lines.push(`**Structure Type:** ${structure.type}`);
lines.push(renderer.keyValue('Structure Type', structure.type));
}
if (structure.srcDir) {
lines.push(`**Source Directory:** \`${structure.srcDir}/\``);
lines.push(renderer.keyValue('Source Directory', renderer.code(`${structure.srcDir}/`)));
}
if (structure.testDir) {
lines.push(`**Test Directory:** \`${structure.testDir}/\``);
lines.push(renderer.keyValue('Test Directory', renderer.code(`${structure.testDir}/`)));
}
if (structure.hasWorkspaces && structure.workspaces) {
lines.push(`**Workspaces:** ${structure.workspaces.join(', ')}`);
lines.push(renderer.keyValue('Workspaces', structure.workspaces.join(', ')));
}
lines.push('');
}
if (importantFiles.length > 0) {
lines.push('### Important Files');
for (const file of importantFiles.slice(0, 15)) {
lines.push(`- \`${file}\``);
}
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): string {
private generateGuidelinesSection(_agent: AgentType, renderer: FormatRenderer): string {
if (!this.analysis) return '';
const { stack, patterns } = this.analysis;
const lines: string[] = [];
lines.push('## Development Guidelines');
lines.push(renderer.h2('Development Guidelines'));
lines.push('');
const hasReact = stack.frameworks.some(f => f.name === 'react' || f.name === 'nextjs');
@@ -468,59 +616,74 @@ export class PrimerGenerator {
const hasZod = stack.libraries.some(l => l.name === 'zod');
if (hasTypeScript) {
lines.push('### TypeScript');
lines.push('- Use strict TypeScript with proper type annotations');
lines.push('- Prefer `interface` for object types, `type` for unions/intersections');
lines.push('- Avoid `any` - use `unknown` when type is uncertain');
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('### React');
lines.push('- Use functional components with hooks');
lines.push('- Prefer composition over inheritance');
lines.push('- Keep components small and focused');
lines.push(renderer.h3('React'));
const reactItems = [
'Use functional components with hooks',
'Prefer composition over inheritance',
'Keep components small and focused',
];
if (patterns?.stateManagement) {
lines.push(`- Use ${patterns.stateManagement} for state management`);
reactItems.push(`Use ${patterns.stateManagement} for state management`);
}
lines.push(renderer.list(reactItems));
lines.push('');
}
if (hasVue) {
lines.push('### Vue');
lines.push('- Use Composition API with `<script setup>`');
lines.push('- Keep components small and focused');
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('### Styling');
lines.push('- Use Tailwind CSS utility classes');
lines.push('- Follow mobile-first responsive design');
lines.push('- Extract repeated patterns to components');
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('### Database');
lines.push('- Use Prisma for database operations');
lines.push('- Keep database queries in dedicated service files');
lines.push('- Use transactions for related operations');
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('### Validation');
lines.push('- Use Zod for runtime validation');
lines.push('- Define schemas alongside types');
lines.push(renderer.h3('Validation'));
lines.push(renderer.list([
'Use Zod for runtime validation',
'Define schemas alongside types',
]));
lines.push('');
}
lines.push('### General');
lines.push('- Follow existing code patterns and conventions');
lines.push('- Write clear, self-documenting code');
lines.push('- Keep functions small and focused');
lines.push('- Add tests for new functionality');
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');
}
+1 -1
View File
@@ -91,7 +91,7 @@ export const PrimerAnalysis = z.object({
repository: z.string().optional(),
}),
languages: z.array(Detection).default([]),
packageManagers: z.array(z.string()).default([]),
packageManagers: z.array(PackageManager).default([]),
stack: ProjectStack,
patterns: ProjectPatterns.optional(),
structure: ProjectStructure.optional(),
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/tui",
"version": "2.0.0",
"version": "2.0.1",
"description": "Unified Terminal UI for SkillKit - Built on OpenTUI",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -2,7 +2,7 @@
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://skillkit.dev/schemas/skill.schema.json",
"title": "Skill Frontmatter",
"description": "Schema for SKILL.md frontmatter validation (follows Agent Skills spec: https://agentskills.io/specification)",
"description": "Schema for SKILL.md frontmatter validation (follows Agent Skills spec: https://agenstskills.com)",
"type": "object",
"required": ["name", "description"],
"properties": {
+2 -2
View File
@@ -8,7 +8,7 @@ export class ValidateCommand extends Command {
static override paths = [['validate'], ['v']];
static override usage = Command.Usage({
description: 'Validate skill(s) against the Agent Skills specification (agentskills.io)',
description: 'Validate skill(s) against the Agent Skills specification (agenstskills.com)',
examples: [
['Validate a skill directory', '$0 validate ./my-skill'],
['Validate all skills in a directory', '$0 validate ./skills --all'],
@@ -77,7 +77,7 @@ export class ValidateCommand extends Command {
if (hasErrors) {
console.log(chalk.red('Validation failed'));
console.log(chalk.dim('See https://agentskills.io/specification for the complete format'));
console.log(chalk.dim('See https://agenstskills.com for the complete format'));
return 1;
}