mirror of
https://github.com/rohitg00/skillkit.git
synced 2026-11-19 02:13:58 +00:00
Compare commits
25
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
79656339c9 | ||
|
|
03d6610e7c | ||
|
|
c22e1b3caf | ||
|
|
dd3bd07296 | ||
|
|
d6b76f3abd | ||
|
|
28c2c0a936 | ||
|
|
0a59bcf314 | ||
|
|
3f03d0690d | ||
|
|
96f83fdc2e | ||
|
|
b9a724012a | ||
|
|
02989b4021 | ||
|
|
b559a2acbf | ||
|
|
5cf9178a9f | ||
|
|
279bc1cd06 | ||
|
|
7092e9a0b8 | ||
|
|
8a0e1f586e | ||
|
|
235130c6ae | ||
|
|
da5a17960d | ||
|
|
fceb23843d | ||
|
|
91ef4b63f4 | ||
|
|
7aa566d9b5 | ||
|
|
803ff5692a | ||
|
|
f036104c6d | ||
|
|
257fe9fbb6 | ||
|
|
a5efe29a6c |
@@ -11,7 +11,7 @@
|
||||
[](https://www.npmjs.com/package/skillkit)
|
||||
[](https://github.com/rohitg00/skillkit/pkgs/npm/skillkit)
|
||||
[](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
|
||||
[](https://rohitg00.github.io/skillkit/)
|
||||
[](https://agenstskills.com)
|
||||
[](https://opensource.org/licenses/Apache-2.0)
|
||||
|
||||
## Supercharge Every AI Coding Agent
|
||||
@@ -32,6 +32,10 @@ npm install -g skillkit
|
||||
|
||||
## See It In Action
|
||||
|
||||
<video src="https://raw.githubusercontent.com/rohitg00/skillkit/main/docs/video/skillkit.mp4" controls width="100%"></video>
|
||||
|
||||
> **Note:** If the video doesn't play above, [watch it here](https://raw.githubusercontent.com/rohitg00/skillkit/main/docs/video/skillkit.mp4)
|
||||
|
||||
```bash
|
||||
# Install a skill for ALL your agents at once
|
||||
skillkit install anthropics/skills --agent claude-code,cursor,windsurf
|
||||
@@ -46,7 +50,17 @@ skillkit recommend
|
||||
# > 85% match: nextjs-app-router
|
||||
```
|
||||
|
||||

|
||||
## Beautiful CLI Experience
|
||||
|
||||
SkillKit features a polished, interactive CLI with visual feedback:
|
||||
|
||||

|
||||
|
||||
- **Adaptive Logo** - Full ASCII art on wide terminals, compact on narrow
|
||||
- **Agent Icons** - Visual indicators: ⟁ Claude · ◫ Cursor · ◎ Codex · ✦ Gemini · ⬡ OpenCode
|
||||
- **Interactive Selection** - Multi-select skills and agents with visual feedback
|
||||
- **Progress Indicators** - Step trails, spinners, and progress bars
|
||||
- **Smart Defaults** - Remembers your last selected agents
|
||||
|
||||
## What Makes SkillKit Different
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "skillkit",
|
||||
"version": "1.7.2",
|
||||
"version": "1.7.6",
|
||||
"description": "Supercharge AI coding agents with portable skills. Install, translate, and share skills across Claude Code, Cursor, Codex, Copilot & 13 more",
|
||||
"type": "module",
|
||||
"bin": {
|
||||
|
||||
@@ -14,6 +14,7 @@ import {
|
||||
RemoveCommand,
|
||||
InitCommand,
|
||||
ValidateCommand,
|
||||
FixCommand,
|
||||
CreateCommand,
|
||||
UICommand,
|
||||
TranslateCommand,
|
||||
@@ -47,6 +48,15 @@ import {
|
||||
AgentTranslateCommand,
|
||||
AgentSyncCommand,
|
||||
AgentValidateCommand,
|
||||
// New commands (Phase 21)
|
||||
CheckCommand,
|
||||
FindCommand,
|
||||
ManifestCommand,
|
||||
ManifestInitCommand,
|
||||
ManifestAddCommand,
|
||||
ManifestRemoveCommand,
|
||||
ManifestInstallCommand,
|
||||
ManifestGenerateCommand,
|
||||
} from '@skillkit/cli';
|
||||
|
||||
const __filename = fileURLToPath(import.meta.url);
|
||||
@@ -74,6 +84,7 @@ cli.register(UpdateCommand);
|
||||
cli.register(RemoveCommand);
|
||||
cli.register(InitCommand);
|
||||
cli.register(ValidateCommand);
|
||||
cli.register(FixCommand);
|
||||
cli.register(CreateCommand);
|
||||
cli.register(UICommand);
|
||||
cli.register(TranslateCommand);
|
||||
@@ -108,4 +119,13 @@ cli.register(AgentTranslateCommand);
|
||||
cli.register(AgentSyncCommand);
|
||||
cli.register(AgentValidateCommand);
|
||||
|
||||
cli.register(CheckCommand);
|
||||
cli.register(FindCommand);
|
||||
cli.register(ManifestCommand);
|
||||
cli.register(ManifestInitCommand);
|
||||
cli.register(ManifestAddCommand);
|
||||
cli.register(ManifestRemoveCommand);
|
||||
cli.register(ManifestInstallCommand);
|
||||
cli.register(ManifestGenerateCommand);
|
||||
|
||||
cli.runExit(process.argv.slice(2));
|
||||
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 99 KiB |
@@ -5,6 +5,8 @@ import { Agents } from './components/Agents';
|
||||
import { Footer } from './components/Footer';
|
||||
import { SkillGenerator } from './components/SkillGenerator';
|
||||
import { SkillSubmitForm } from './components/SkillSubmitForm';
|
||||
import { Commands } from './components/Commands';
|
||||
import { Documentation } from './components/Documentation';
|
||||
|
||||
const GITHUB_ICON = (
|
||||
<svg className="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
|
||||
@@ -34,6 +36,12 @@ export default function App(): React.ReactElement {
|
||||
<span className="text-base font-bold tracking-tight text-white font-mono">SKILLKIT</span>
|
||||
</a>
|
||||
<div className="flex items-center gap-2 sm:gap-4">
|
||||
<a
|
||||
href="#docs"
|
||||
className="text-zinc-400 hover:text-white transition-colors text-sm font-mono hidden sm:block"
|
||||
>
|
||||
Docs
|
||||
</a>
|
||||
<a
|
||||
href="https://www.npmjs.com/package/skillkit"
|
||||
target="_blank"
|
||||
@@ -61,6 +69,11 @@ export default function App(): React.ReactElement {
|
||||
<Hero />
|
||||
<Agents />
|
||||
<Features />
|
||||
<Commands />
|
||||
|
||||
<section id="docs" className="py-12 border-b border-zinc-800 bg-surface">
|
||||
<Documentation />
|
||||
</section>
|
||||
|
||||
<section id="skills" className="py-12 border-b border-zinc-800">
|
||||
<SkillGenerator />
|
||||
|
||||
@@ -0,0 +1,103 @@
|
||||
import React, { useState } from 'react';
|
||||
|
||||
interface CommandGroup {
|
||||
name: string;
|
||||
commands: Array<{ cmd: string; desc: string }>;
|
||||
}
|
||||
|
||||
const COMMAND_GROUPS: CommandGroup[] = [
|
||||
{
|
||||
name: 'Core',
|
||||
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' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Discovery',
|
||||
commands: [
|
||||
{ cmd: 'find', desc: 'Search marketplace (15K+ skills)' },
|
||||
{ cmd: 'recommend', desc: 'AI-powered suggestions' },
|
||||
{ cmd: 'check', desc: 'Dry-run update check' },
|
||||
{ cmd: 'list', desc: 'View installed skills' },
|
||||
],
|
||||
},
|
||||
{
|
||||
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: 'publish', desc: 'Submit to marketplace' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Advanced',
|
||||
commands: [
|
||||
{ cmd: 'ui', desc: 'Launch terminal UI' },
|
||||
{ cmd: 'workflow run', desc: 'Execute skill pipelines' },
|
||||
{ cmd: 'command generate', desc: 'Create /slash commands' },
|
||||
{ cmd: 'cicd init', desc: 'Generate CI templates' },
|
||||
],
|
||||
},
|
||||
];
|
||||
|
||||
export function Commands(): React.ReactElement {
|
||||
const [activeGroup, setActiveGroup] = useState(0);
|
||||
const group = COMMAND_GROUPS[activeGroup];
|
||||
|
||||
return (
|
||||
<section className="py-12 border-b border-zinc-800">
|
||||
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
|
||||
<div className="text-center mb-8">
|
||||
<h2 className="text-xl font-bold text-white mb-2 font-mono">30+ Commands</h2>
|
||||
<p className="text-zinc-500 font-mono text-sm">
|
||||
Everything you need from the terminal.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div className="flex justify-center gap-2 mb-6">
|
||||
{COMMAND_GROUPS.map((g, i) => {
|
||||
const isActive = i === activeGroup;
|
||||
const buttonClass = isActive
|
||||
? 'border-white text-white bg-zinc-900'
|
||||
: 'border-zinc-800 text-zinc-500 hover:border-zinc-600 hover:text-zinc-300';
|
||||
return (
|
||||
<button
|
||||
key={g.name}
|
||||
onClick={() => setActiveGroup(i)}
|
||||
className={`px-3 py-1.5 text-xs font-mono border transition-colors ${buttonClass}`}
|
||||
>
|
||||
{g.name}
|
||||
</button>
|
||||
);
|
||||
})}
|
||||
</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">
|
||||
{group.commands.map((c) => (
|
||||
<div
|
||||
key={c.cmd}
|
||||
className="flex items-center gap-3 p-2 hover:bg-zinc-900/50 transition-colors rounded"
|
||||
>
|
||||
<span className="text-zinc-600">$</span>
|
||||
<span className="text-white">skillkit {c.cmd}</span>
|
||||
<span className="text-zinc-600 hidden sm:inline">→</span>
|
||||
<span className="text-zinc-500 hidden sm:inline truncate">{c.desc}</span>
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="mt-4 text-center">
|
||||
<span className="text-zinc-600 text-xs font-mono">
|
||||
Run <span className="text-zinc-400">skillkit --help</span> for all commands
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,479 @@
|
||||
import React, { useState } from 'react';
|
||||
|
||||
interface DocSection {
|
||||
id: string;
|
||||
title: string;
|
||||
content: React.ReactNode;
|
||||
}
|
||||
|
||||
const CodeBlock = ({ children, language = 'bash' }: { children: string; language?: string }) => (
|
||||
<pre className="bg-zinc-900 border border-zinc-800 rounded-lg p-4 overflow-x-auto text-sm font-mono">
|
||||
<code className="text-zinc-300">{children}</code>
|
||||
</pre>
|
||||
);
|
||||
|
||||
const Table = ({ headers, rows }: { headers: string[]; rows: string[][] }) => (
|
||||
<div className="overflow-x-auto">
|
||||
<table className="w-full text-sm border-collapse">
|
||||
<thead>
|
||||
<tr className="border-b border-zinc-700">
|
||||
{headers.map((h, i) => (
|
||||
<th key={i} className="text-left py-2 px-3 text-zinc-300 font-mono font-semibold">{h}</th>
|
||||
))}
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
{rows.map((row, i) => (
|
||||
<tr key={i} className="border-b border-zinc-800 hover:bg-zinc-900/50">
|
||||
{row.map((cell, j) => (
|
||||
<td key={j} className="py-2 px-3 text-zinc-400 font-mono">{cell}</td>
|
||||
))}
|
||||
</tr>
|
||||
))}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
);
|
||||
|
||||
const sections: DocSection[] = [
|
||||
{
|
||||
id: 'overview',
|
||||
title: 'Overview',
|
||||
content: (
|
||||
<div className="space-y-4">
|
||||
<p className="text-zinc-300">
|
||||
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 17+ AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
|
||||
</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">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 17 agent-specific formats</li>
|
||||
<li><span className="text-white">Team Collaboration</span> - Share skills via .skills manifest files and publish to marketplace</li>
|
||||
</ul>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
id: 'installation',
|
||||
title: 'Installation',
|
||||
content: (
|
||||
<div className="space-y-4">
|
||||
<h3 className="text-lg font-semibold text-white">Quick Start</h3>
|
||||
<CodeBlock>{`# Install globally via npm
|
||||
npm install -g skillkit
|
||||
|
||||
# Or use npx directly
|
||||
npx skillkit --help
|
||||
|
||||
# Or install via pnpm
|
||||
pnpm add -g skillkit`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Verify Installation</h3>
|
||||
<CodeBlock>{`skillkit --version
|
||||
skillkit --help`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">First Steps</h3>
|
||||
<CodeBlock>{`# Initialize SkillKit in your project
|
||||
skillkit init
|
||||
|
||||
# Browse available skills
|
||||
skillkit marketplace
|
||||
|
||||
# Get AI-powered recommendations
|
||||
skillkit recommend
|
||||
|
||||
# Install skills from a source
|
||||
skillkit install anthropics/skills`}</CodeBlock>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
id: 'architecture',
|
||||
title: 'Architecture',
|
||||
content: (
|
||||
<div className="space-y-4">
|
||||
<p className="text-zinc-300">
|
||||
SkillKit employs a three-tier design with clean separation of concerns:
|
||||
</p>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">System Tiers</h3>
|
||||
<ul className="list-disc list-inside space-y-2 text-zinc-400">
|
||||
<li><span className="text-white">UI Tier</span> - CLI commands, Terminal UI (OpenTUI-based), and documentation website</li>
|
||||
<li><span className="text-white">Core Logic Tier</span> - @skillkit/core for business logic; @skillkit/agents for adapter implementations</li>
|
||||
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 17+ AI agents</li>
|
||||
</ul>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Monorepo Structure</h3>
|
||||
<CodeBlock language="text">{`skillkit-monorepo (pnpm workspace + Turbo)
|
||||
├── apps/skillkit/ → Main CLI application (bin: skillkit, sk)
|
||||
├── packages/core/ → Core business logic (no internal dependencies)
|
||||
├── packages/agents/ → Agent adapters (depends on core)
|
||||
├── packages/cli/ → Command implementations (depends on core, agents, tui)
|
||||
├── packages/tui/ → Terminal UI (depends on core, agents)
|
||||
└── docs/skillkit/ → Documentation website`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Dependency Hierarchy</h3>
|
||||
<ul className="list-disc list-inside space-y-2 text-zinc-400">
|
||||
<li><code className="text-emerald-400">@skillkit/core</code> → Foundation (no SkillKit dependencies)</li>
|
||||
<li><code className="text-emerald-400">@skillkit/agents</code> → Adapters (depends on core)</li>
|
||||
<li><code className="text-emerald-400">@skillkit/cli</code>, <code className="text-emerald-400">@skillkit/tui</code> → UIs (depend on core and agents)</li>
|
||||
<li><code className="text-emerald-400">skillkit</code> app → Orchestrates all packages</li>
|
||||
</ul>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
id: 'agents',
|
||||
title: 'Supported Agents',
|
||||
content: (
|
||||
<div className="space-y-4">
|
||||
<p className="text-zinc-300">
|
||||
SkillKit supports 17+ AI coding agents with automatic format translation:
|
||||
</p>
|
||||
|
||||
<Table
|
||||
headers={['Agent', 'Directory', 'Format']}
|
||||
rows={[
|
||||
['Claude Code', '.claude/skills/', 'SKILL.md'],
|
||||
['Cursor', '.cursor/skills/', '.mdc'],
|
||||
['GitHub Copilot', '.github/skills/', 'Markdown'],
|
||||
['Gemini CLI', '.gemini/skills/', 'SKILL.md'],
|
||||
['Windsurf', '.windsurf/skills/', 'Markdown'],
|
||||
['Codex', '.codex/skills/', 'SKILL.md'],
|
||||
['OpenCode', '.opencode/skills/', 'SKILL.md'],
|
||||
['Antigravity', '.antigravity/skills/', 'SKILL.md'],
|
||||
['Amp', '.amp/skills/', 'SKILL.md'],
|
||||
['Clawdbot', '.clawdbot/skills/', 'SKILL.md'],
|
||||
['Droid', '.droid/skills/', 'SKILL.md'],
|
||||
['Goose', '.goose/skills/', 'SKILL.md'],
|
||||
['Kilo', '.kilo/skills/', 'SKILL.md'],
|
||||
['Kiro CLI', '.kiro/skills/', 'SKILL.md'],
|
||||
['Roo', '.roo/skills/', 'SKILL.md'],
|
||||
['Trae', '.trae/skills/', 'SKILL.md'],
|
||||
['Universal', 'skills/', 'SKILL.md'],
|
||||
]}
|
||||
/>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
id: 'commands',
|
||||
title: 'CLI Commands',
|
||||
content: (
|
||||
<div className="space-y-4">
|
||||
<h3 className="text-lg font-semibold text-white">Skill Management</h3>
|
||||
<CodeBlock>{`skillkit install <source> # Install skills from source
|
||||
skillkit remove <skill> # Remove installed skill
|
||||
skillkit update [skill] # Update skills
|
||||
skillkit list # List installed skills
|
||||
skillkit sync # Sync skills across agents
|
||||
skillkit enable <skill> # Enable a skill
|
||||
skillkit disable <skill> # Disable a skill`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Discovery</h3>
|
||||
<CodeBlock>{`skillkit recommend # AI-powered skill recommendations
|
||||
skillkit marketplace # Browse marketplace skills
|
||||
skillkit find <query> # Search for skills
|
||||
skillkit search <term> # Search skill content`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Translation</h3>
|
||||
<CodeBlock>{`skillkit translate --from claude --to cursor <skill>
|
||||
skillkit agent translate <skill> --target cursor
|
||||
skillkit context sync # Sync context across agents`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Team Collaboration</h3>
|
||||
<CodeBlock>{`skillkit manifest init # Initialize .skills manifest
|
||||
skillkit manifest add <source> # Add source to manifest
|
||||
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">Advanced</h3>
|
||||
<CodeBlock>{`skillkit ui # Launch Terminal UI
|
||||
skillkit workflow # Manage workflows
|
||||
skillkit memory compress # Compress memory
|
||||
skillkit memory export # Export memory
|
||||
skillkit test # Run skill tests
|
||||
skillkit validate # Validate skill format & quality`}</CodeBlock>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
id: 'configuration',
|
||||
title: 'Configuration',
|
||||
content: (
|
||||
<div className="space-y-4">
|
||||
<h3 className="text-lg font-semibold text-white">Project Configuration (skillkit.yaml)</h3>
|
||||
<CodeBlock language="yaml">{`version: 1
|
||||
agent: cursor
|
||||
autoSync: true
|
||||
enabledSkills:
|
||||
- pdf
|
||||
- xlsx
|
||||
disabledSkills:
|
||||
- deprecated-skill`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Team Manifest (.skills)</h3>
|
||||
<CodeBlock>{`# Team-wide skill sources
|
||||
anthropics/skills
|
||||
vercel-labs/agent-skills
|
||||
./local-skills
|
||||
owner/repo@v1.2.3`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">User Preferences (~/.skillkit/preferences.json)</h3>
|
||||
<CodeBlock language="json">{`{
|
||||
"lastSelectedAgents": ["claude", "cursor"],
|
||||
"autoSync": true,
|
||||
"marketplace": {
|
||||
"lastRefresh": "2024-01-01T00:00:00Z"
|
||||
}
|
||||
}`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">File System Layout</h3>
|
||||
<CodeBlock language="text">{`project/
|
||||
├── .skillkit/ # Project config & memory
|
||||
├── .claude/skills/ # Claude Code skills
|
||||
├── .cursor/skills/ # Cursor AI skills
|
||||
├── .github/skills/ # GitHub Copilot skills
|
||||
├── skills/ # Universal format
|
||||
└── .skills # Team manifest file
|
||||
|
||||
~/.skillkit/ # Global user config
|
||||
├── preferences.json
|
||||
├── memory/
|
||||
└── cache/`}</CodeBlock>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
id: 'api',
|
||||
title: 'API Reference',
|
||||
content: (
|
||||
<div className="space-y-4">
|
||||
<h3 className="text-lg font-semibold text-white">Package Exports</h3>
|
||||
<p className="text-zinc-300">@skillkit/core provides multiple entry points for programmatic use:</p>
|
||||
|
||||
<CodeBlock language="typescript">{`import { findAllSkills, findSkill } from '@skillkit/core/discovery';
|
||||
import { parseSkillFile } from '@skillkit/core/parser';
|
||||
import { translateSkill } from '@skillkit/core/translator';
|
||||
import { syncContext } from '@skillkit/core/context';
|
||||
import { getRecommendations } from '@skillkit/core/recommend';
|
||||
import { evaluateSkillContent, getQualityGrade } from '@skillkit/core/quality';`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Core Functions</h3>
|
||||
<CodeBlock language="typescript">{`// Discovery
|
||||
findAllSkills(searchDirs: string[]): SkillInfo[]
|
||||
findSkill(name: string, searchDirs: string[]): SkillInfo | null
|
||||
|
||||
// Parsing
|
||||
parseSkillFile(filePath: string): ParsedSkill
|
||||
parseSkillContent(content: string): ParsedSkill
|
||||
|
||||
// Translation
|
||||
translateSkill(skill: ParsedSkill, targetAgent: AgentType): string
|
||||
getAgentAdapter(agent: AgentType): AgentAdapter
|
||||
|
||||
// Quality Evaluation
|
||||
evaluateSkillContent(content: string): QualityScore
|
||||
evaluateSkillFile(filePath: string): QualityScore
|
||||
getQualityGrade(score: number): 'A' | 'B' | 'C' | 'D' | 'F'
|
||||
isHighQuality(score: QualityScore): boolean
|
||||
|
||||
// Recommendations
|
||||
getRecommendations(context: ProjectContext): Recommendation[]`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Type Definitions</h3>
|
||||
<CodeBlock language="typescript">{`interface SkillInfo {
|
||||
name: string;
|
||||
path: string;
|
||||
agent: AgentType;
|
||||
enabled: boolean;
|
||||
}
|
||||
|
||||
interface ParsedSkill {
|
||||
name: string;
|
||||
description?: string;
|
||||
globs?: string[];
|
||||
triggers?: string[];
|
||||
content: string;
|
||||
frontmatter: Record<string, unknown>;
|
||||
}
|
||||
|
||||
interface QualityScore {
|
||||
overall: number;
|
||||
structure: StructureScore;
|
||||
clarity: ClarityScore;
|
||||
specificity: SpecificityScore;
|
||||
advanced: AdvancedScore;
|
||||
warnings: string[];
|
||||
suggestions: string[];
|
||||
}
|
||||
|
||||
type AgentType =
|
||||
| 'claude-code' | 'cursor' | 'codex' | 'gemini-cli'
|
||||
| 'opencode' | 'antigravity' | 'amp' | 'clawdbot'
|
||||
| 'droid' | 'github-copilot' | 'goose' | 'kilo'
|
||||
| 'kiro-cli' | 'roo' | 'trae' | 'windsurf' | 'universal';`}</CodeBlock>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
id: 'skill-format',
|
||||
title: 'Skill Format',
|
||||
content: (
|
||||
<div className="space-y-4">
|
||||
<h3 className="text-lg font-semibold text-white">SKILL.md Structure</h3>
|
||||
<p className="text-zinc-300">Skills use YAML frontmatter followed by markdown content:</p>
|
||||
|
||||
<CodeBlock language="markdown">{`---
|
||||
name: my-skill
|
||||
description: A helpful skill for coding tasks
|
||||
globs:
|
||||
- "**/*.ts"
|
||||
- "**/*.tsx"
|
||||
triggers:
|
||||
- "when working with TypeScript"
|
||||
- "when creating React components"
|
||||
---
|
||||
|
||||
# My Skill
|
||||
|
||||
## When to Use
|
||||
|
||||
Use this skill when:
|
||||
- Working with TypeScript files
|
||||
- Creating React components
|
||||
|
||||
## Instructions
|
||||
|
||||
Follow these guidelines:
|
||||
|
||||
1. Always use TypeScript strict mode
|
||||
2. Prefer functional components
|
||||
|
||||
\`\`\`typescript
|
||||
function Example(): JSX.Element {
|
||||
return <div>Hello</div>;
|
||||
}
|
||||
\`\`\`
|
||||
|
||||
## Boundaries
|
||||
|
||||
This skill should NOT:
|
||||
- Modify configuration files without asking
|
||||
- Delete existing code without confirmation`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Quality Scoring</h3>
|
||||
<p className="text-zinc-300">Skills are evaluated on four dimensions:</p>
|
||||
<Table
|
||||
headers={['Dimension', 'Weight', 'Criteria']}
|
||||
rows={[
|
||||
['Structure', '35%', 'Metadata, description, triggers, examples, boundaries'],
|
||||
['Clarity', '25%', 'Line count, token count, headers, readability'],
|
||||
['Specificity', '25%', 'Concrete commands, file patterns, code examples'],
|
||||
['Advanced', '15%', 'No deprecated patterns, security issues, completeness'],
|
||||
]}
|
||||
/>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Grade Scale</h3>
|
||||
<Table
|
||||
headers={['Grade', 'Score Range', 'Description']}
|
||||
rows={[
|
||||
['A', '90-100', 'Excellent - Production ready'],
|
||||
['B', '80-89', 'Good - Minor improvements possible'],
|
||||
['C', '70-79', 'Acceptable - Some issues to address'],
|
||||
['D', '60-69', 'Poor - Significant improvements needed'],
|
||||
['F', '0-59', 'Failing - Major revision required'],
|
||||
]}
|
||||
/>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
id: 'tech-stack',
|
||||
title: 'Technology Stack',
|
||||
content: (
|
||||
<div className="space-y-4">
|
||||
<Table
|
||||
headers={['Layer', 'Technology']}
|
||||
rows={[
|
||||
['CLI Framework', 'Clipanion v4'],
|
||||
['TUI Framework', '@opentui/react v0.1.75'],
|
||||
['Validation', 'Zod v3.24'],
|
||||
['YAML Parsing', 'yaml v2.6'],
|
||||
['Git Operations', 'isomorphic-git v1.27'],
|
||||
['HTTP Client', 'got v14.4'],
|
||||
['Build System', 'Turbo v2.3, tsup v8.3, pnpm v9.0'],
|
||||
['Testing', 'Vitest v2.1'],
|
||||
['Runtime', 'Node.js 18+, Bun 1.2+ (for TUI)'],
|
||||
]}
|
||||
/>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Build Commands</h3>
|
||||
<CodeBlock>{`pnpm build # Build all packages via Turbo
|
||||
pnpm dev # Watch mode development
|
||||
pnpm test # Unit tests via Vitest
|
||||
pnpm test:e2e # End-to-end tests
|
||||
pnpm typecheck # Type checking
|
||||
pnpm clean # Remove build artifacts`}</CodeBlock>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
];
|
||||
|
||||
export function Documentation(): React.ReactElement {
|
||||
const [activeSection, setActiveSection] = useState('overview');
|
||||
|
||||
const currentSection = sections.find(s => s.id === activeSection) || sections[0];
|
||||
|
||||
return (
|
||||
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
|
||||
<div className="text-center mb-8">
|
||||
<h2 className="text-2xl font-bold text-white mb-2 font-mono">Documentation</h2>
|
||||
<p className="text-zinc-400 font-mono text-sm">
|
||||
Complete guide to using SkillKit
|
||||
</p>
|
||||
<a
|
||||
href="https://deepwiki.com/rohitg00/skillkit"
|
||||
target="_blank"
|
||||
rel="noreferrer"
|
||||
className="inline-flex items-center gap-2 mt-2 text-xs text-zinc-500 hover:text-zinc-300 transition-colors"
|
||||
>
|
||||
<span>Powered by DeepWiki</span>
|
||||
<svg className="w-3 h-3" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M10 6H6a2 2 0 00-2 2v10a2 2 0 002 2h10a2 2 0 002-2v-4M14 4h6m0 0v6m0-6L10 14" />
|
||||
</svg>
|
||||
</a>
|
||||
</div>
|
||||
|
||||
<div className="flex flex-col lg:flex-row gap-8">
|
||||
<nav className="lg:w-48 flex-shrink-0">
|
||||
<div className="sticky top-20 space-y-1">
|
||||
{sections.map(section => (
|
||||
<button
|
||||
key={section.id}
|
||||
onClick={() => setActiveSection(section.id)}
|
||||
className={`w-full text-left px-3 py-2 text-sm font-mono rounded transition-colors ${
|
||||
activeSection === section.id
|
||||
? 'bg-white text-black'
|
||||
: 'text-zinc-400 hover:text-white hover:bg-zinc-800'
|
||||
}`}
|
||||
>
|
||||
{section.title}
|
||||
</button>
|
||||
))}
|
||||
</div>
|
||||
</nav>
|
||||
|
||||
<div className="flex-1 min-w-0">
|
||||
<div className="bg-surface border border-zinc-800 rounded-lg p-6">
|
||||
<h2 className="text-xl font-bold text-white mb-6 font-mono">{currentSection.title}</h2>
|
||||
<div className="prose prose-invert prose-zinc max-w-none">
|
||||
{currentSection.content}
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -9,7 +9,7 @@ interface Feature {
|
||||
const FEATURES: Feature[] = [
|
||||
{
|
||||
title: 'Multi-Agent',
|
||||
description: 'Write once, deploy to 17+ AI coding agents automatically.',
|
||||
description: 'Deploy to 17 AI coding agents with one command.',
|
||||
icon: (
|
||||
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M19 11H5m14 0a2 2 0 012 2v6a2 2 0 01-2 2H5a2 2 0 01-2-2v-6a2 2 0 012-2m14 0V9a2 2 0 00-2-2M5 11V9a2 2 0 012-2m0 0V5a2 2 0 012-2h6a2 2 0 012 2v2M7 7h10" />
|
||||
@@ -17,57 +17,58 @@ const FEATURES: Feature[] = [
|
||||
)
|
||||
},
|
||||
{
|
||||
title: 'Smart Discovery',
|
||||
description: 'AI analyzes your stack and recommends skills.',
|
||||
title: 'Terminal UI',
|
||||
description: 'Beautiful interactive TUI for browsing & installing.',
|
||||
icon: (
|
||||
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z" />
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M8 9l3 3-3 3m5 0h3M5 20h14a2 2 0 002-2V6a2 2 0 00-2-2H5a2 2 0 00-2 2v12a2 2 0 002 2z" />
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
title: 'Persistent Memory',
|
||||
description: 'Save learnings as reusable skills.',
|
||||
title: 'Plugins',
|
||||
description: 'Extend with custom plugins & hooks.',
|
||||
icon: (
|
||||
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9 3v2m6-2v2M9 19v2m6-2v2M5 9H3m2 6H3m18-6h-2m2 6h-2M7 19h10a2 2 0 002-2V7a2 2 0 00-2-2H7a2 2 0 00-2 2v10a2 2 0 002 2zM9 9h6v6H9V9z" />
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M17 14v6m-3-3h6M6 10h2a2 2 0 002-2V6a2 2 0 00-2-2H6a2 2 0 00-2 2v2a2 2 0 002 2zm10 0h2a2 2 0 002-2V6a2 2 0 00-2-2h-2a2 2 0 00-2 2v2a2 2 0 002 2zM6 20h2a2 2 0 002-2v-2a2 2 0 00-2-2H6a2 2 0 00-2 2v2a2 2 0 002 2z" />
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
title: 'Team Sync',
|
||||
description: 'Share skills via Git across your team.',
|
||||
title: 'Manifest',
|
||||
description: '.skills file for team-wide consistency.',
|
||||
icon: (
|
||||
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M17 20h5v-2a3 3 0 00-5.356-1.857M17 20H7m10 0v-2c0-.656-.126-1.283-.356-1.857M7 20H2v-2a3 3 0 015.356-1.857M7 20v-2c0-.656.126-1.283.356-1.857m0 0a5.002 5.002 0 019.288 0M15 7a3 3 0 11-6 0 3 3 0 016 0zm6 3a2 2 0 11-4 0 2 2 0 014 0zM7 10a2 2 0 11-4 0 2 2 0 014 0z" />
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z" />
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
title: 'Testing',
|
||||
description: 'Built-in framework for skill validation.',
|
||||
title: 'CI/CD',
|
||||
description: 'GitHub, GitLab, CircleCI templates included.',
|
||||
icon: (
|
||||
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z" />
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15" />
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
title: 'Workflows',
|
||||
description: 'Compose multi-step automated pipelines.',
|
||||
title: 'Slash Commands',
|
||||
description: 'Generate /commands for Claude, Cursor & more.',
|
||||
icon: (
|
||||
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M13 10V3L4 14h7v7l9-11h-7z" />
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M7 20l4-16m2 16l4-16M6 9h14M4 15h14" />
|
||||
</svg>
|
||||
)
|
||||
}
|
||||
];
|
||||
|
||||
const COMPARISONS = [
|
||||
['Agents', '1', '17+'],
|
||||
['Agents', '1', '17'],
|
||||
['Translation', 'Manual', 'Auto'],
|
||||
['Sharing', 'Copy/paste', 'Git sync'],
|
||||
['Discovery', 'Forums', 'AI-powered'],
|
||||
['Sharing', 'Copy/paste', '.skills manifest'],
|
||||
['Discovery', 'Forums', 'CLI + AI'],
|
||||
['CI/CD', 'Custom', 'Templates'],
|
||||
] as const;
|
||||
|
||||
export function Features(): React.ReactElement {
|
||||
@@ -82,15 +83,15 @@ export function Features(): React.ReactElement {
|
||||
</p>
|
||||
<div className="flex gap-6 sm:gap-8">
|
||||
<div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">17+</div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">17</div>
|
||||
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Agents</div>
|
||||
</div>
|
||||
<div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">1</div>
|
||||
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Command</div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">30+</div>
|
||||
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Commands</div>
|
||||
</div>
|
||||
<div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">∞</div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">15K</div>
|
||||
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Skills</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -14,16 +14,17 @@ interface TerminalLine {
|
||||
}
|
||||
|
||||
const TERMINAL_LINES: TerminalLine[] = [
|
||||
{ type: 'cmd', text: 'skillkit init' },
|
||||
{ type: 'out', text: '→ Next.js + TypeScript detected' },
|
||||
{ type: 'cmd', text: 'skillkit find react' },
|
||||
{ type: 'out', text: ' ■ react-patterns ★★★★★' },
|
||||
{ type: 'out', text: ' ■ react-testing ★★★★☆' },
|
||||
{ type: 'cmd', text: 'skillkit install anthropics/skills' },
|
||||
{ type: 'out', text: '→ Installed 3 skills' },
|
||||
{ type: 'cmd', text: 'skillkit sync --all' },
|
||||
{ type: 'out', text: ' .claude/skills/' },
|
||||
{ type: 'out', text: ' .cursor/skills/' },
|
||||
{ type: 'out', text: ' .windsurf/skills/' },
|
||||
{ type: 'cmd', text: 'skillkit translate --to codex,copilot' },
|
||||
{ type: 'out', text: '→ 2 formats generated' },
|
||||
{ type: 'out', text: '→ 3 skills → 5 agents' },
|
||||
{ type: 'cmd', text: 'skillkit ui' },
|
||||
{ type: 'out', text: '→ Launching TUI...' },
|
||||
{ type: 'cmd', text: 'skillkit check' },
|
||||
{ type: 'out', text: ' ✓ All skills up to date' },
|
||||
{ type: 'cmd', text: 'skillkit manifest install' },
|
||||
{ type: 'out', text: '→ 12 skills from .skills' },
|
||||
];
|
||||
|
||||
const FADE_ANIMATION_STYLES = `
|
||||
@@ -123,7 +124,7 @@ export function Hero(): React.ReactElement {
|
||||
<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.1</span>
|
||||
<span className="text-xs font-mono text-zinc-400">v1.7.5</span>
|
||||
</div>
|
||||
|
||||
<h1 className="text-2xl sm:text-3xl lg:text-4xl font-bold tracking-tight text-white mb-3 font-mono">
|
||||
@@ -132,8 +133,8 @@ export function Hero(): React.ReactElement {
|
||||
</h1>
|
||||
|
||||
<p className="text-sm text-zinc-400 mb-5 max-w-lg font-mono leading-relaxed">
|
||||
Portable, reusable skills that work across Claude Code, Cursor, Codex,
|
||||
Windsurf, GitHub Copilot, and 12 more agents.
|
||||
One CLI to install, sync, and manage skills across Claude Code, Cursor,
|
||||
Windsurf, Copilot, and 13 more agents. 15,000+ skills ready to use.
|
||||
</p>
|
||||
|
||||
<div className="flex flex-wrap items-center gap-3 mb-4">
|
||||
|
||||
Binary file not shown.
Binary file not shown.
@@ -0,0 +1,271 @@
|
||||
/**
|
||||
* E2E Tests: Onboarding UI
|
||||
*
|
||||
* Tests for the new @clack/prompts based CLI onboarding experience
|
||||
*/
|
||||
|
||||
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
|
||||
import { join } from 'node:path';
|
||||
import { mkdirSync, writeFileSync } from 'node:fs';
|
||||
import {
|
||||
runCli,
|
||||
createTestDir,
|
||||
cleanupTestDir,
|
||||
createTestSkill,
|
||||
testFileExists,
|
||||
} from './helpers/cli-runner.js';
|
||||
|
||||
describe('E2E: Onboarding UI', () => {
|
||||
let testDir: string;
|
||||
|
||||
beforeEach(() => {
|
||||
testDir = createTestDir();
|
||||
});
|
||||
|
||||
afterEach(() => {
|
||||
cleanupTestDir(testDir);
|
||||
});
|
||||
|
||||
describe('skillkit init --list', () => {
|
||||
it('should display agents with icons', async () => {
|
||||
const result = await runCli(['init', '--list']);
|
||||
const output = result.stdout + result.stderr;
|
||||
|
||||
// Should show agent icons
|
||||
expect(output).toContain('Claude Code');
|
||||
expect(output).toContain('Cursor');
|
||||
expect(output).toContain('Codex');
|
||||
|
||||
// Should show Skills dir info
|
||||
expect(output).toContain('Skills dir');
|
||||
expect(output).toContain('Config');
|
||||
|
||||
// Should complete successfully
|
||||
expect(result.success).toBe(true);
|
||||
});
|
||||
|
||||
it('should display all 17 agents', async () => {
|
||||
const result = await runCli(['init', '--list']);
|
||||
const output = result.stdout + result.stderr;
|
||||
|
||||
const agents = [
|
||||
'Claude Code',
|
||||
'Cursor',
|
||||
'Codex',
|
||||
'Gemini',
|
||||
'OpenCode',
|
||||
'Copilot',
|
||||
'Windsurf',
|
||||
'Droid',
|
||||
'Goose',
|
||||
'Amp',
|
||||
'Kilo',
|
||||
'Kiro',
|
||||
'Roo',
|
||||
'Trae',
|
||||
'Antigravity',
|
||||
'Clawdbot',
|
||||
'Universal',
|
||||
];
|
||||
|
||||
for (const agent of agents) {
|
||||
expect(output.toLowerCase()).toContain(agent.toLowerCase());
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
describe('skillkit install --list', () => {
|
||||
it('should list skills with visual formatting', async () => {
|
||||
// Create a test repo-like structure
|
||||
const skillsDir = join(testDir, 'test-skills');
|
||||
mkdirSync(skillsDir, { recursive: true });
|
||||
createTestSkill(skillsDir, 'skill-one');
|
||||
createTestSkill(skillsDir, 'skill-two');
|
||||
|
||||
const result = await runCli(['install', testDir, '--list'], { cwd: testDir });
|
||||
const output = result.stdout + result.stderr;
|
||||
|
||||
// Should show skills found
|
||||
expect(output.toLowerCase()).toMatch(/skill|found|available/);
|
||||
});
|
||||
});
|
||||
|
||||
describe('skillkit marketplace', () => {
|
||||
it('should display marketplace header', async () => {
|
||||
const result = await runCli(['marketplace', '--json']);
|
||||
const output = result.stdout + result.stderr;
|
||||
|
||||
// JSON output should contain marketplace data
|
||||
if (result.success) {
|
||||
try {
|
||||
const data = JSON.parse(result.stdout.trim().split('\n').pop() || '{}');
|
||||
expect(data).toHaveProperty('totalSkills');
|
||||
expect(data).toHaveProperty('sources');
|
||||
} catch {
|
||||
// Non-JSON output is also acceptable
|
||||
}
|
||||
}
|
||||
});
|
||||
|
||||
it('should show popular tags with progress bars', async () => {
|
||||
const result = await runCli(['marketplace', 'tags', '--json']);
|
||||
|
||||
if (result.success && result.stdout.trim().startsWith('[')) {
|
||||
const tags = JSON.parse(result.stdout);
|
||||
expect(Array.isArray(tags)).toBe(true);
|
||||
if (tags.length > 0) {
|
||||
expect(tags[0]).toHaveProperty('tag');
|
||||
expect(tags[0]).toHaveProperty('count');
|
||||
}
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
describe('skillkit sync', () => {
|
||||
it('should sync with formatted output', async () => {
|
||||
// Create skills to sync
|
||||
const skillsDir = join(testDir, 'skills');
|
||||
mkdirSync(skillsDir, { recursive: true });
|
||||
createTestSkill(skillsDir, 'sync-skill-1');
|
||||
createTestSkill(skillsDir, 'sync-skill-2');
|
||||
|
||||
const result = await runCli(['sync', '--agent', 'claude-code', '-y'], { cwd: testDir });
|
||||
const output = result.stdout + result.stderr;
|
||||
|
||||
// Should show sync operation
|
||||
expect(output.toLowerCase()).toMatch(/sync|skill|claude/);
|
||||
});
|
||||
|
||||
it('should show skill status indicators', async () => {
|
||||
const skillsDir = join(testDir, 'skills');
|
||||
mkdirSync(skillsDir, { recursive: true });
|
||||
createTestSkill(skillsDir, 'enabled-skill');
|
||||
|
||||
const result = await runCli(['sync', '--agent', 'claude-code', '-y'], { cwd: testDir });
|
||||
const output = result.stdout + result.stderr;
|
||||
|
||||
// Should complete without error
|
||||
expect(result.exitCode).toBeDefined();
|
||||
});
|
||||
});
|
||||
|
||||
describe('skillkit recommend', () => {
|
||||
it('should show project analysis with spinner', async () => {
|
||||
// Create a node project
|
||||
writeFileSync(
|
||||
join(testDir, 'package.json'),
|
||||
JSON.stringify({ name: 'test-project', version: '1.0.0' }, null, 2)
|
||||
);
|
||||
|
||||
const result = await runCli(['recommend', '--quiet'], { cwd: testDir });
|
||||
const output = result.stdout + result.stderr;
|
||||
|
||||
// Should show some output about recommendations or project
|
||||
expect(
|
||||
output.toLowerCase().includes('project') ||
|
||||
output.toLowerCase().includes('skill') ||
|
||||
output.toLowerCase().includes('recommend') ||
|
||||
output.toLowerCase().includes('index') ||
|
||||
result.exitCode !== undefined
|
||||
).toBe(true);
|
||||
});
|
||||
|
||||
it('should format scores with progress bars', async () => {
|
||||
// Create a TypeScript project
|
||||
writeFileSync(
|
||||
join(testDir, 'package.json'),
|
||||
JSON.stringify({
|
||||
name: 'test-project',
|
||||
dependencies: { typescript: '^5.0.0' },
|
||||
}, null, 2)
|
||||
);
|
||||
writeFileSync(join(testDir, 'tsconfig.json'), '{}');
|
||||
|
||||
const result = await runCli(['recommend', '--json'], { cwd: testDir });
|
||||
|
||||
if (result.success && result.stdout.includes('"recommendations"')) {
|
||||
const data = JSON.parse(result.stdout);
|
||||
expect(data).toHaveProperty('recommendations');
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
describe('Non-interactive mode', () => {
|
||||
it('should work with --yes flag', async () => {
|
||||
const skillsDir = join(testDir, 'skills');
|
||||
mkdirSync(skillsDir, { recursive: true });
|
||||
createTestSkill(skillsDir, 'test-skill');
|
||||
|
||||
const result = await runCli(['sync', '--agent', 'claude-code', '-y'], { cwd: testDir });
|
||||
// Should complete without prompting
|
||||
expect(result.exitCode).toBeDefined();
|
||||
});
|
||||
|
||||
it('should work with --quiet flag', async () => {
|
||||
const result = await runCli(['init', '--list', '-q']);
|
||||
const output = result.stdout + result.stderr;
|
||||
|
||||
// Should still show content but without extra formatting
|
||||
expect(output).toContain('Claude Code');
|
||||
});
|
||||
|
||||
it('should work with --json flag', async () => {
|
||||
const result = await runCli(['marketplace', '--json']);
|
||||
|
||||
// Should output valid JSON
|
||||
if (result.success) {
|
||||
const jsonLine = result.stdout.trim().split('\n').pop() || '';
|
||||
if (jsonLine.startsWith('{') || jsonLine.startsWith('[')) {
|
||||
expect(() => JSON.parse(jsonLine)).not.toThrow();
|
||||
}
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
describe('Error handling', () => {
|
||||
it('should show formatted errors', async () => {
|
||||
const result = await runCli(['install', 'nonexistent-source-12345']);
|
||||
const output = result.stdout + result.stderr;
|
||||
|
||||
// Should show some error message
|
||||
expect(
|
||||
output.toLowerCase().includes('error') ||
|
||||
output.toLowerCase().includes('fail') ||
|
||||
output.toLowerCase().includes('not found') ||
|
||||
!result.success
|
||||
).toBe(true);
|
||||
});
|
||||
|
||||
it('should handle missing skills gracefully', async () => {
|
||||
const result = await runCli(['read', 'nonexistent-skill'], { cwd: testDir });
|
||||
// Should not crash
|
||||
expect(result.exitCode).toBeDefined();
|
||||
});
|
||||
});
|
||||
|
||||
describe('Visual elements', () => {
|
||||
it('should use Unicode symbols in output', async () => {
|
||||
const result = await runCli(['init', '--list']);
|
||||
const output = result.stdout + result.stderr;
|
||||
|
||||
// Should contain Unicode agent icons (any of the defined icons)
|
||||
const unicodePatterns = [
|
||||
/[\u2500-\u257F]/, // Box drawing
|
||||
/[\u25A0-\u25FF]/, // Geometric shapes
|
||||
/[\u2700-\u27BF]/, // Dingbats
|
||||
];
|
||||
|
||||
const hasUnicode = unicodePatterns.some(pattern => pattern.test(output));
|
||||
// Unicode support depends on terminal, so just check it doesn't crash
|
||||
expect(result.exitCode).toBe(0);
|
||||
});
|
||||
|
||||
it('should handle narrow terminal gracefully', async () => {
|
||||
// Even with narrow output, should not crash
|
||||
const result = await runCli(['init', '--list'], {
|
||||
env: { COLUMNS: '40' },
|
||||
});
|
||||
expect(result.exitCode).toBeDefined();
|
||||
});
|
||||
});
|
||||
});
|
||||
@@ -92,6 +92,12 @@
|
||||
]
|
||||
},
|
||||
"description": "Compatible AI agents (omit for universal compatibility)"
|
||||
},
|
||||
"quality": {
|
||||
"type": "integer",
|
||||
"minimum": 0,
|
||||
"maximum": 100,
|
||||
"description": "Pre-computed quality score (0-100). Verified sources default to 85."
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/agents",
|
||||
"version": "1.7.1",
|
||||
"version": "1.7.6",
|
||||
"description": "Agent adapters for SkillKit - supports 17+ AI coding agents",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/cli",
|
||||
"version": "1.7.1",
|
||||
"version": "1.7.6",
|
||||
"description": "CLI commands for SkillKit",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
@@ -21,6 +21,7 @@
|
||||
"test": "vitest run"
|
||||
},
|
||||
"dependencies": {
|
||||
"@clack/prompts": "^0.11.0",
|
||||
"@skillkit/core": "workspace:*",
|
||||
"@skillkit/agents": "workspace:*",
|
||||
"@skillkit/tui": "workspace:*",
|
||||
@@ -29,6 +30,7 @@
|
||||
"got": "^14.4.1",
|
||||
"isomorphic-git": "^1.27.1",
|
||||
"ora": "^8.1.0",
|
||||
"picocolors": "^1.1.1",
|
||||
"yaml": "^2.7.0"
|
||||
},
|
||||
"devDependencies": {
|
||||
|
||||
@@ -0,0 +1,326 @@
|
||||
/**
|
||||
* Unit Tests: Onboarding Module
|
||||
*
|
||||
* Tests for the CLI onboarding experience components
|
||||
*/
|
||||
|
||||
import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
|
||||
import { existsSync, mkdirSync, rmSync, readFileSync, writeFileSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import { tmpdir } from 'node:os';
|
||||
import { mkdtempSync } from 'node:fs';
|
||||
|
||||
describe('Onboarding Module', () => {
|
||||
describe('theme', () => {
|
||||
it('should export agent icons', async () => {
|
||||
const { AGENT_ICONS, AGENT_NAMES } = await import('../onboarding/theme.js');
|
||||
|
||||
expect(AGENT_ICONS).toBeDefined();
|
||||
expect(AGENT_ICONS['claude-code']).toBe('\u27c1'); // ⟁
|
||||
expect(AGENT_ICONS['cursor']).toBe('\u25eb'); // ◫
|
||||
expect(AGENT_ICONS['codex']).toBe('\u25ce'); // ◎
|
||||
|
||||
expect(AGENT_NAMES).toBeDefined();
|
||||
expect(AGENT_NAMES['claude-code']).toBe('Claude Code');
|
||||
expect(AGENT_NAMES['cursor']).toBe('Cursor');
|
||||
});
|
||||
|
||||
it('should export symbols', async () => {
|
||||
const { symbols } = await import('../onboarding/theme.js');
|
||||
|
||||
expect(symbols).toBeDefined();
|
||||
expect(symbols.stepPending).toBe('\u25cb'); // ○
|
||||
expect(symbols.stepActive).toBe('\u25cf'); // ●
|
||||
expect(symbols.success).toBe('\u2713'); // ✓
|
||||
expect(symbols.error).toBe('\u2717'); // ✗
|
||||
});
|
||||
|
||||
it('should export color utilities', async () => {
|
||||
const { colors } = await import('../onboarding/theme.js');
|
||||
|
||||
expect(colors).toBeDefined();
|
||||
expect(typeof colors.accent).toBe('function');
|
||||
expect(typeof colors.primary).toBe('function');
|
||||
expect(typeof colors.success).toBe('function');
|
||||
expect(typeof colors.error).toBe('function');
|
||||
});
|
||||
|
||||
it('should format agent with icon', async () => {
|
||||
const { formatAgent, getAgentIcon } = await import('../onboarding/theme.js');
|
||||
|
||||
const formatted = formatAgent('claude-code');
|
||||
expect(formatted).toContain('\u27c1'); // ⟁
|
||||
expect(formatted).toContain('Claude Code');
|
||||
|
||||
const icon = getAgentIcon('cursor');
|
||||
expect(icon).toBe('\u25eb'); // ◫
|
||||
});
|
||||
|
||||
it('should generate progress bars', async () => {
|
||||
const { progressBar } = await import('../onboarding/theme.js');
|
||||
|
||||
const bar50 = progressBar(50, 100, 10);
|
||||
expect(bar50).toContain('\u2588'); // █ (filled)
|
||||
expect(bar50).toContain('\u2591'); // ░ (empty)
|
||||
expect(bar50.length).toBe(10);
|
||||
|
||||
const bar100 = progressBar(100, 100, 6);
|
||||
expect(bar100).toBe('\u2588'.repeat(6));
|
||||
|
||||
const bar0 = progressBar(0, 100, 6);
|
||||
expect(bar0).toBe('\u2591'.repeat(6));
|
||||
});
|
||||
|
||||
it('should format score with visual bar', async () => {
|
||||
const { formatScore } = await import('../onboarding/theme.js');
|
||||
|
||||
const score = formatScore(75);
|
||||
expect(score).toContain('75%');
|
||||
expect(score).toContain('\u2588'); // progress bar
|
||||
});
|
||||
});
|
||||
|
||||
describe('logo', () => {
|
||||
it('should export logo functions', async () => {
|
||||
const { getLogo, getFullLogo, getCompactLogo, getMinimalLogo, getHeader, getDivider } =
|
||||
await import('../onboarding/logo.js');
|
||||
|
||||
expect(typeof getLogo).toBe('function');
|
||||
expect(typeof getFullLogo).toBe('function');
|
||||
expect(typeof getCompactLogo).toBe('function');
|
||||
expect(typeof getMinimalLogo).toBe('function');
|
||||
expect(typeof getHeader).toBe('function');
|
||||
expect(typeof getDivider).toBe('function');
|
||||
});
|
||||
|
||||
it('should generate full logo with version', async () => {
|
||||
const { getFullLogo } = await import('../onboarding/logo.js');
|
||||
|
||||
const logo = getFullLogo('1.7.2', 17);
|
||||
// Full logo uses block characters (███), not literal text
|
||||
expect(logo).toContain('\u2588'); // █ block character
|
||||
expect(logo).toContain('v1.7.2');
|
||||
expect(logo).toContain('17 agents');
|
||||
});
|
||||
|
||||
it('should generate compact logo', async () => {
|
||||
const { getCompactLogo } = await import('../onboarding/logo.js');
|
||||
|
||||
const logo = getCompactLogo('1.7.2');
|
||||
// Compact logo has spaced letters: S K I L L K I T
|
||||
expect(logo).toContain('S K I L L K I T');
|
||||
expect(logo).toContain('v1.7.2');
|
||||
});
|
||||
|
||||
it('should generate minimal logo', async () => {
|
||||
const { getMinimalLogo } = await import('../onboarding/logo.js');
|
||||
|
||||
const logo = getMinimalLogo('1.7.2');
|
||||
expect(logo).toContain('SKILLKIT');
|
||||
expect(logo).toContain('\u25c7'); // ◇ diamond
|
||||
});
|
||||
|
||||
it('should generate header', async () => {
|
||||
const { getHeader } = await import('../onboarding/logo.js');
|
||||
|
||||
const header = getHeader('Test Title');
|
||||
expect(header).toContain('SkillKit');
|
||||
expect(header).toContain('Test Title');
|
||||
});
|
||||
|
||||
it('should generate divider', async () => {
|
||||
const { getDivider } = await import('../onboarding/logo.js');
|
||||
|
||||
const divider = getDivider(20);
|
||||
expect(divider).toContain('\u2500'); // ─
|
||||
});
|
||||
});
|
||||
|
||||
describe('preferences', () => {
|
||||
let testDir: string;
|
||||
let originalHome: string | undefined;
|
||||
let originalUserProfile: string | undefined;
|
||||
|
||||
beforeEach(() => {
|
||||
vi.resetModules();
|
||||
testDir = mkdtempSync(join(tmpdir(), 'skillkit-prefs-test-'));
|
||||
originalHome = process.env.HOME;
|
||||
originalUserProfile = process.env.USERPROFILE;
|
||||
process.env.HOME = testDir;
|
||||
process.env.USERPROFILE = testDir;
|
||||
});
|
||||
|
||||
afterEach(() => {
|
||||
if (existsSync(testDir)) {
|
||||
rmSync(testDir, { recursive: true, force: true });
|
||||
}
|
||||
if (originalHome === undefined) {
|
||||
delete process.env.HOME;
|
||||
} else {
|
||||
process.env.HOME = originalHome;
|
||||
}
|
||||
if (originalUserProfile === undefined) {
|
||||
delete process.env.USERPROFILE;
|
||||
} else {
|
||||
process.env.USERPROFILE = originalUserProfile;
|
||||
}
|
||||
vi.resetModules();
|
||||
});
|
||||
|
||||
it('should export preference functions', async () => {
|
||||
const {
|
||||
loadPreferences,
|
||||
savePreferences,
|
||||
isOnboardingComplete,
|
||||
completeOnboarding,
|
||||
saveLastAgents,
|
||||
getLastAgents,
|
||||
saveInstallMethod,
|
||||
getInstallMethod,
|
||||
} = await import('../onboarding/preferences.js');
|
||||
|
||||
expect(typeof loadPreferences).toBe('function');
|
||||
expect(typeof savePreferences).toBe('function');
|
||||
expect(typeof isOnboardingComplete).toBe('function');
|
||||
expect(typeof completeOnboarding).toBe('function');
|
||||
expect(typeof saveLastAgents).toBe('function');
|
||||
expect(typeof getLastAgents).toBe('function');
|
||||
expect(typeof saveInstallMethod).toBe('function');
|
||||
expect(typeof getInstallMethod).toBe('function');
|
||||
});
|
||||
|
||||
it('should return default preferences when file does not exist', async () => {
|
||||
const { loadPreferences } = await import('../onboarding/preferences.js');
|
||||
|
||||
const prefs = loadPreferences();
|
||||
expect(prefs).toBeDefined();
|
||||
expect(prefs.onboardingComplete).toBe(false);
|
||||
expect(prefs.lastSelectedAgents).toEqual([]);
|
||||
expect(prefs.defaultInstallMethod).toBe('symlink');
|
||||
});
|
||||
});
|
||||
|
||||
describe('summary', () => {
|
||||
it('should export summary functions', async () => {
|
||||
const {
|
||||
showInstallSummary,
|
||||
showNextSteps,
|
||||
showAgentSummary,
|
||||
showProjectSummary,
|
||||
showSyncSummary,
|
||||
showSkillList,
|
||||
showMarketplaceInfo,
|
||||
} = await import('../onboarding/summary.js');
|
||||
|
||||
expect(typeof showInstallSummary).toBe('function');
|
||||
expect(typeof showNextSteps).toBe('function');
|
||||
expect(typeof showAgentSummary).toBe('function');
|
||||
expect(typeof showProjectSummary).toBe('function');
|
||||
expect(typeof showSyncSummary).toBe('function');
|
||||
expect(typeof showSkillList).toBe('function');
|
||||
expect(typeof showMarketplaceInfo).toBe('function');
|
||||
});
|
||||
});
|
||||
|
||||
describe('prompts', () => {
|
||||
it('should export prompt functions', async () => {
|
||||
const {
|
||||
isCancel,
|
||||
intro,
|
||||
outro,
|
||||
cancel,
|
||||
note,
|
||||
log,
|
||||
step,
|
||||
success,
|
||||
warn,
|
||||
error,
|
||||
spinner,
|
||||
text,
|
||||
password,
|
||||
confirm,
|
||||
select,
|
||||
agentMultiselect,
|
||||
skillMultiselect,
|
||||
stepTrail,
|
||||
selectInstallMethod,
|
||||
} = await import('../onboarding/prompts.js');
|
||||
|
||||
expect(typeof isCancel).toBe('function');
|
||||
expect(typeof intro).toBe('function');
|
||||
expect(typeof outro).toBe('function');
|
||||
expect(typeof cancel).toBe('function');
|
||||
expect(typeof note).toBe('function');
|
||||
expect(typeof log).toBe('function');
|
||||
expect(typeof step).toBe('function');
|
||||
expect(typeof success).toBe('function');
|
||||
expect(typeof warn).toBe('function');
|
||||
expect(typeof error).toBe('function');
|
||||
expect(typeof spinner).toBe('function');
|
||||
expect(typeof text).toBe('function');
|
||||
expect(typeof password).toBe('function');
|
||||
expect(typeof confirm).toBe('function');
|
||||
expect(typeof select).toBe('function');
|
||||
expect(typeof agentMultiselect).toBe('function');
|
||||
expect(typeof skillMultiselect).toBe('function');
|
||||
expect(typeof stepTrail).toBe('function');
|
||||
expect(typeof selectInstallMethod).toBe('function');
|
||||
});
|
||||
|
||||
it('should generate step trail', async () => {
|
||||
const { stepTrail } = await import('../onboarding/prompts.js');
|
||||
|
||||
const trail = stepTrail([
|
||||
{ label: 'Step 1', status: 'complete' },
|
||||
{ label: 'Step 2', status: 'active' },
|
||||
{ label: 'Step 3', status: 'pending' },
|
||||
]);
|
||||
|
||||
expect(trail).toContain('Step 1');
|
||||
expect(trail).toContain('Step 2');
|
||||
expect(trail).toContain('Step 3');
|
||||
expect(trail).toContain('\u25cf'); // ● (filled circle)
|
||||
expect(trail).toContain('\u25cb'); // ○ (empty circle)
|
||||
});
|
||||
});
|
||||
|
||||
describe('index exports', () => {
|
||||
it('should re-export all modules', async () => {
|
||||
const onboarding = await import('../onboarding/index.js');
|
||||
|
||||
// Theme exports
|
||||
expect(onboarding.AGENT_ICONS).toBeDefined();
|
||||
expect(onboarding.AGENT_NAMES).toBeDefined();
|
||||
expect(onboarding.symbols).toBeDefined();
|
||||
expect(onboarding.colors).toBeDefined();
|
||||
expect(onboarding.formatAgent).toBeDefined();
|
||||
expect(onboarding.getAgentIcon).toBeDefined();
|
||||
expect(onboarding.progressBar).toBeDefined();
|
||||
expect(onboarding.formatScore).toBeDefined();
|
||||
|
||||
// Logo exports
|
||||
expect(onboarding.getLogo).toBeDefined();
|
||||
expect(onboarding.getHeader).toBeDefined();
|
||||
expect(onboarding.getDivider).toBeDefined();
|
||||
|
||||
// Prompts exports
|
||||
expect(onboarding.isCancel).toBeDefined();
|
||||
expect(onboarding.spinner).toBeDefined();
|
||||
expect(onboarding.agentMultiselect).toBeDefined();
|
||||
expect(onboarding.skillMultiselect).toBeDefined();
|
||||
|
||||
// Summary exports
|
||||
expect(onboarding.showInstallSummary).toBeDefined();
|
||||
expect(onboarding.showNextSteps).toBeDefined();
|
||||
|
||||
// Preferences exports
|
||||
expect(onboarding.loadPreferences).toBeDefined();
|
||||
expect(onboarding.savePreferences).toBeDefined();
|
||||
|
||||
// Main functions
|
||||
expect(onboarding.welcome).toBeDefined();
|
||||
expect(onboarding.header).toBeDefined();
|
||||
expect(onboarding.showCompletion).toBeDefined();
|
||||
});
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,211 @@
|
||||
import { existsSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { findAllSkills, findSkill, detectProvider, isLocalPath } from '@skillkit/core';
|
||||
import { getSearchDirs, loadSkillMetadata } from '../helpers.js';
|
||||
import {
|
||||
colors,
|
||||
symbols,
|
||||
spinner,
|
||||
step,
|
||||
success,
|
||||
warn,
|
||||
header,
|
||||
} from '../onboarding/index.js';
|
||||
|
||||
interface UpdateInfo {
|
||||
name: string;
|
||||
currentVersion?: string;
|
||||
hasUpdate: boolean;
|
||||
error?: string;
|
||||
}
|
||||
|
||||
export class CheckCommand extends Command {
|
||||
static override paths = [['check']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Check for available skill updates (dry-run)',
|
||||
details: `
|
||||
Checks if installed skills have updates available from their sources.
|
||||
Does not modify any files - just reports what would be updated.
|
||||
`,
|
||||
examples: [
|
||||
['Check all skills for updates', '$0 check'],
|
||||
['Check specific skills', '$0 check pdf xlsx'],
|
||||
['Show detailed output', '$0 check --verbose'],
|
||||
],
|
||||
});
|
||||
|
||||
skills = Option.Rest();
|
||||
|
||||
verbose = Option.Boolean('--verbose,-v', false, {
|
||||
description: 'Show detailed information',
|
||||
});
|
||||
|
||||
quiet = Option.Boolean('--quiet,-q', false, {
|
||||
description: 'Minimal output',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const searchDirs = getSearchDirs();
|
||||
const s = spinner();
|
||||
|
||||
if (!this.quiet) {
|
||||
header('Check Updates');
|
||||
}
|
||||
|
||||
let skillsToCheck;
|
||||
|
||||
if (this.skills.length > 0) {
|
||||
const foundSkills = this.skills.map(name => ({
|
||||
name,
|
||||
skill: findSkill(name, searchDirs),
|
||||
}));
|
||||
|
||||
skillsToCheck = foundSkills
|
||||
.filter((s): s is { name: string; skill: NonNullable<typeof s.skill> } => s.skill !== null)
|
||||
.map(s => s.skill);
|
||||
|
||||
const notFound = foundSkills.filter(s => s.skill === null).map(s => s.name);
|
||||
if (notFound.length > 0) {
|
||||
warn(`Skills not found: ${notFound.join(', ')}`);
|
||||
}
|
||||
} else {
|
||||
skillsToCheck = findAllSkills(searchDirs);
|
||||
}
|
||||
|
||||
if (skillsToCheck.length === 0) {
|
||||
warn('No skills to check');
|
||||
return 0;
|
||||
}
|
||||
|
||||
if (!this.quiet) {
|
||||
step(`Checking ${skillsToCheck.length} skill(s) for updates...`);
|
||||
console.log('');
|
||||
}
|
||||
|
||||
const results: UpdateInfo[] = [];
|
||||
let updatesAvailable = 0;
|
||||
|
||||
for (const skill of skillsToCheck) {
|
||||
const metadata = loadSkillMetadata(skill.path);
|
||||
|
||||
if (!metadata) {
|
||||
results.push({
|
||||
name: skill.name,
|
||||
hasUpdate: false,
|
||||
error: 'No metadata (reinstall needed)',
|
||||
});
|
||||
continue;
|
||||
}
|
||||
|
||||
if (this.verbose) {
|
||||
s.start(`Checking ${skill.name}...`);
|
||||
}
|
||||
|
||||
try {
|
||||
if (isLocalPath(metadata.source)) {
|
||||
const localPath = metadata.subpath
|
||||
? join(metadata.source, metadata.subpath)
|
||||
: metadata.source;
|
||||
|
||||
if (!existsSync(localPath)) {
|
||||
results.push({
|
||||
name: skill.name,
|
||||
hasUpdate: false,
|
||||
error: 'Local source missing',
|
||||
});
|
||||
if (this.verbose) s.stop(`${skill.name}: source missing`);
|
||||
continue;
|
||||
}
|
||||
|
||||
const sourceSkillMd = join(localPath, 'SKILL.md');
|
||||
const installedSkillMd = join(skill.path, 'SKILL.md');
|
||||
|
||||
if (existsSync(sourceSkillMd) && existsSync(installedSkillMd)) {
|
||||
const { statSync } = await import('node:fs');
|
||||
const sourceTime = statSync(sourceSkillMd).mtime;
|
||||
const installedTime = statSync(installedSkillMd).mtime;
|
||||
|
||||
if (sourceTime > installedTime) {
|
||||
results.push({ name: skill.name, hasUpdate: true });
|
||||
updatesAvailable++;
|
||||
if (this.verbose) s.stop(`${skill.name}: update available`);
|
||||
} else {
|
||||
results.push({ name: skill.name, hasUpdate: false });
|
||||
if (this.verbose) s.stop(`${skill.name}: up to date`);
|
||||
}
|
||||
} else {
|
||||
results.push({ name: skill.name, hasUpdate: false });
|
||||
if (this.verbose) s.stop(`${skill.name}: up to date`);
|
||||
}
|
||||
} else {
|
||||
const provider = detectProvider(metadata.source);
|
||||
|
||||
if (!provider) {
|
||||
results.push({
|
||||
name: skill.name,
|
||||
hasUpdate: false,
|
||||
error: 'Unknown provider',
|
||||
});
|
||||
if (this.verbose) s.stop(`${skill.name}: unknown provider`);
|
||||
continue;
|
||||
}
|
||||
|
||||
results.push({
|
||||
name: skill.name,
|
||||
hasUpdate: false,
|
||||
currentVersion: metadata.updatedAt || metadata.installedAt,
|
||||
});
|
||||
if (this.verbose) s.stop(`${skill.name}: remote source (run update to sync)`);
|
||||
}
|
||||
} catch (err) {
|
||||
results.push({
|
||||
name: skill.name,
|
||||
hasUpdate: false,
|
||||
error: err instanceof Error ? err.message : 'Check failed',
|
||||
});
|
||||
if (this.verbose) s.stop(`${skill.name}: error`);
|
||||
}
|
||||
}
|
||||
|
||||
console.log('');
|
||||
|
||||
const withUpdates = results.filter(r => r.hasUpdate);
|
||||
const upToDate = results.filter(r => !r.hasUpdate && !r.error);
|
||||
const withErrors = results.filter(r => r.error);
|
||||
|
||||
if (withUpdates.length > 0) {
|
||||
console.log(colors.primary('Updates available:'));
|
||||
for (const r of withUpdates) {
|
||||
console.log(` ${colors.success(symbols.arrowUp)} ${colors.primary(r.name)}`);
|
||||
}
|
||||
console.log('');
|
||||
}
|
||||
|
||||
if (upToDate.length > 0 && this.verbose) {
|
||||
console.log(colors.muted('Up to date:'));
|
||||
for (const r of upToDate) {
|
||||
console.log(` ${colors.muted(symbols.success)} ${colors.muted(r.name)}`);
|
||||
}
|
||||
console.log('');
|
||||
}
|
||||
|
||||
if (withErrors.length > 0) {
|
||||
console.log(colors.warning('Could not check:'));
|
||||
for (const r of withErrors) {
|
||||
console.log(` ${colors.warning(symbols.warning)} ${r.name}: ${colors.muted(r.error || 'unknown')}`);
|
||||
}
|
||||
console.log('');
|
||||
}
|
||||
|
||||
if (updatesAvailable > 0) {
|
||||
success(`${updatesAvailable} update(s) available`);
|
||||
console.log(colors.muted('Run `skillkit update` to install updates'));
|
||||
} else {
|
||||
success('All skills are up to date');
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,181 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import {
|
||||
colors,
|
||||
symbols,
|
||||
spinner,
|
||||
step,
|
||||
isCancel,
|
||||
select,
|
||||
header,
|
||||
} from '../onboarding/index.js';
|
||||
|
||||
interface SkillResult {
|
||||
name: string;
|
||||
description?: string;
|
||||
source: string;
|
||||
repoName: string;
|
||||
}
|
||||
|
||||
import skillsData from '../../../../marketplace/skills.json' with { type: 'json' };
|
||||
import sourcesData from '../../../../marketplace/sources.json' with { type: 'json' };
|
||||
|
||||
export class FindCommand extends Command {
|
||||
static override paths = [['find'], ['search']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Search for skills in the marketplace',
|
||||
details: `
|
||||
Quickly find and install skills from the marketplace.
|
||||
Interactive mode lets you browse and install in one step.
|
||||
`,
|
||||
examples: [
|
||||
['Interactive search', '$0 find'],
|
||||
['Search for specific skill', '$0 find pdf'],
|
||||
['Search with keyword', '$0 find "nextjs"'],
|
||||
['List top skills', '$0 find --top'],
|
||||
],
|
||||
});
|
||||
|
||||
query = Option.String({ required: false });
|
||||
|
||||
top = Option.Boolean('--top,-t', false, {
|
||||
description: 'Show top/featured skills',
|
||||
});
|
||||
|
||||
limit = Option.String('--limit,-l', '10', {
|
||||
description: 'Maximum results to show',
|
||||
});
|
||||
|
||||
install = Option.Boolean('--install,-i', false, {
|
||||
description: 'Prompt to install after finding',
|
||||
});
|
||||
|
||||
quiet = Option.Boolean('--quiet,-q', false, {
|
||||
description: 'Minimal output (just list skills)',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const s = spinner();
|
||||
const limit = parseInt(this.limit, 10) || 10;
|
||||
|
||||
if (!this.quiet) {
|
||||
header('Find Skills');
|
||||
}
|
||||
|
||||
const allSkills: SkillResult[] = (skillsData.skills || []).map((skill: { name: string; description?: string; source?: string; repo?: string }) => ({
|
||||
name: skill.name,
|
||||
description: skill.description,
|
||||
source: skill.source || '',
|
||||
repoName: skill.repo || skill.source?.split('/').pop() || '',
|
||||
}));
|
||||
|
||||
let results: SkillResult[];
|
||||
|
||||
if (this.top) {
|
||||
const featured = sourcesData.sources
|
||||
.filter((s: { official?: boolean }) => s.official)
|
||||
.slice(0, 5);
|
||||
|
||||
results = allSkills
|
||||
.filter(skill => featured.some((f: { source: string }) => skill.source.includes(f.source)))
|
||||
.slice(0, limit);
|
||||
|
||||
if (!this.quiet) {
|
||||
step('Showing featured skills');
|
||||
}
|
||||
} else if (this.query) {
|
||||
const query = this.query.toLowerCase();
|
||||
|
||||
s.start('Searching...');
|
||||
|
||||
results = allSkills.filter(skill =>
|
||||
skill.name.toLowerCase().includes(query) ||
|
||||
skill.description?.toLowerCase().includes(query) ||
|
||||
skill.source.toLowerCase().includes(query) ||
|
||||
skill.repoName.toLowerCase().includes(query)
|
||||
).slice(0, limit);
|
||||
|
||||
s.stop(`Found ${results.length} skill(s)`);
|
||||
} else {
|
||||
if (!this.quiet) {
|
||||
step('Enter a search term or browse featured skills');
|
||||
}
|
||||
|
||||
const { text } = await import('../onboarding/prompts.js');
|
||||
|
||||
const searchResult = await text({
|
||||
message: 'Search skills',
|
||||
placeholder: 'e.g., pdf, nextjs, testing',
|
||||
});
|
||||
|
||||
if (isCancel(searchResult)) {
|
||||
return 0;
|
||||
}
|
||||
|
||||
const query = (searchResult as string).toLowerCase();
|
||||
|
||||
if (query) {
|
||||
s.start('Searching...');
|
||||
results = allSkills.filter(skill =>
|
||||
skill.name.toLowerCase().includes(query) ||
|
||||
skill.description?.toLowerCase().includes(query) ||
|
||||
skill.source.toLowerCase().includes(query) ||
|
||||
skill.repoName.toLowerCase().includes(query)
|
||||
).slice(0, limit);
|
||||
s.stop(`Found ${results.length} skill(s)`);
|
||||
} else {
|
||||
results = allSkills.slice(0, limit);
|
||||
}
|
||||
}
|
||||
|
||||
if (results.length === 0) {
|
||||
console.log(colors.muted('No skills found matching your search'));
|
||||
console.log('');
|
||||
console.log(colors.muted('Try:'));
|
||||
console.log(colors.muted(' skillkit find --top # Show featured skills'));
|
||||
console.log(colors.muted(' skillkit ui # Browse in TUI'));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log('');
|
||||
|
||||
for (const skill of results) {
|
||||
const desc = skill.description
|
||||
? colors.muted(` - ${skill.description.slice(0, 50)}${skill.description.length > 50 ? '...' : ''}`)
|
||||
: '';
|
||||
console.log(` ${colors.success(symbols.bullet)} ${colors.primary(skill.name)}${desc}`);
|
||||
if (!this.quiet && skill.source) {
|
||||
console.log(` ${colors.muted(skill.source)}`);
|
||||
}
|
||||
}
|
||||
|
||||
console.log('');
|
||||
console.log(colors.muted(`Showing ${results.length} of ${allSkills.length} skills`));
|
||||
console.log('');
|
||||
|
||||
if (this.install || (!this.query && !this.top && process.stdin.isTTY)) {
|
||||
const installResult = await select({
|
||||
message: 'Install a skill?',
|
||||
options: [
|
||||
{ value: 'none', label: 'No, just browsing' },
|
||||
...results.slice(0, 5).map(skill => ({
|
||||
value: skill.source,
|
||||
label: skill.name,
|
||||
hint: skill.repoName,
|
||||
})),
|
||||
],
|
||||
initialValue: 'none',
|
||||
});
|
||||
|
||||
if (!isCancel(installResult) && installResult !== 'none') {
|
||||
console.log('');
|
||||
console.log(colors.cyan('To install, run:'));
|
||||
console.log(` ${colors.bold(`skillkit install ${installResult}`)}`);
|
||||
}
|
||||
} else {
|
||||
console.log(colors.muted('To install: skillkit install <source>'));
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,384 @@
|
||||
import { existsSync, readFileSync, writeFileSync } from 'node:fs';
|
||||
import { join, resolve, basename } from 'node:path';
|
||||
import { Command, Option } from 'clipanion';
|
||||
import {
|
||||
evaluateSkillFile,
|
||||
findAllSkills,
|
||||
type QualityScore,
|
||||
} from '@skillkit/core';
|
||||
import { getSearchDirs } from '../helpers.js';
|
||||
import {
|
||||
colors,
|
||||
symbols,
|
||||
success,
|
||||
warn,
|
||||
error,
|
||||
header,
|
||||
confirm,
|
||||
} from '../onboarding/index.js';
|
||||
|
||||
interface FixSuggestion {
|
||||
type: 'add' | 'replace' | 'format';
|
||||
description: string;
|
||||
original?: string;
|
||||
replacement: string;
|
||||
line?: number;
|
||||
automatic: boolean;
|
||||
}
|
||||
|
||||
const FRONTMATTER_TEMPLATE = `---
|
||||
name: {{NAME}}
|
||||
description: {{DESCRIPTION}}
|
||||
globs:
|
||||
- "**/*"
|
||||
---
|
||||
|
||||
`;
|
||||
|
||||
const WHEN_TO_USE_TEMPLATE = `
|
||||
## When to Use
|
||||
|
||||
Use this skill when:
|
||||
- [Add specific trigger conditions]
|
||||
- [Add relevant patterns to detect]
|
||||
|
||||
`;
|
||||
|
||||
const BOUNDARIES_TEMPLATE = `
|
||||
## Boundaries
|
||||
|
||||
This skill should NOT:
|
||||
- [Add constraints and limitations]
|
||||
- [Specify what the agent should never do]
|
||||
|
||||
`;
|
||||
|
||||
const VAGUE_TERM_REPLACEMENTS: Record<string, string> = {
|
||||
'be helpful': 'follow the specific instructions below',
|
||||
'assist the user': 'complete the requested task',
|
||||
'help with': 'handle',
|
||||
'try to': '',
|
||||
'attempt to': '',
|
||||
'do your best': 'follow these guidelines',
|
||||
'as needed': 'when the following conditions are met',
|
||||
'when appropriate': 'when',
|
||||
'if necessary': 'when required',
|
||||
'general purpose': 'designed for',
|
||||
'various tasks': 'the following tasks',
|
||||
'many things': 'the following',
|
||||
'etc.': '',
|
||||
'and so on': '',
|
||||
'stuff like that': '',
|
||||
};
|
||||
|
||||
function generateFixes(content: string, quality: QualityScore, skillName: string): FixSuggestion[] {
|
||||
const fixes: FixSuggestion[] = [];
|
||||
|
||||
if (!quality.structure.hasMetadata) {
|
||||
const template = FRONTMATTER_TEMPLATE
|
||||
.replace('{{NAME}}', skillName)
|
||||
.replace('{{DESCRIPTION}}', 'Add a description for this skill');
|
||||
fixes.push({
|
||||
type: 'add',
|
||||
description: 'Add YAML frontmatter template',
|
||||
replacement: template,
|
||||
automatic: true,
|
||||
});
|
||||
}
|
||||
|
||||
if (!quality.structure.hasTriggers && !quality.structure.hasWhenToUse) {
|
||||
fixes.push({
|
||||
type: 'add',
|
||||
description: 'Add "When to Use" section scaffold',
|
||||
replacement: WHEN_TO_USE_TEMPLATE,
|
||||
automatic: true,
|
||||
});
|
||||
}
|
||||
|
||||
if (!quality.structure.hasBoundaries) {
|
||||
fixes.push({
|
||||
type: 'add',
|
||||
description: 'Add "Boundaries" section scaffold',
|
||||
replacement: BOUNDARIES_TEMPLATE,
|
||||
automatic: true,
|
||||
});
|
||||
}
|
||||
|
||||
for (const [vague, replacement] of Object.entries(VAGUE_TERM_REPLACEMENTS)) {
|
||||
const escaped = vague.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
|
||||
const regex = new RegExp(escaped, 'gi');
|
||||
if (regex.test(content)) {
|
||||
fixes.push({
|
||||
type: 'replace',
|
||||
description: `Replace vague term "${vague}"`,
|
||||
original: vague,
|
||||
replacement: replacement || '[be specific]',
|
||||
automatic: false,
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
const codeBlockPattern = /```(\s*\n[\s\S]*?```)/g;
|
||||
let match;
|
||||
while ((match = codeBlockPattern.exec(content)) !== null) {
|
||||
if (match[1].startsWith('\n') && !content.slice(match.index, match.index + 10).match(/```\w/)) {
|
||||
fixes.push({
|
||||
type: 'format',
|
||||
description: 'Add language tag to code block',
|
||||
original: '```',
|
||||
replacement: '```typescript',
|
||||
automatic: false,
|
||||
});
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
return fixes;
|
||||
}
|
||||
|
||||
function applyFixes(content: string, fixes: FixSuggestion[]): string {
|
||||
let result = content;
|
||||
|
||||
const hasFrontmatter = /^---\s*\n/.test(content);
|
||||
|
||||
for (const fix of fixes) {
|
||||
if (fix.type === 'add') {
|
||||
if (fix.description.includes('frontmatter') && !hasFrontmatter) {
|
||||
result = fix.replacement + result;
|
||||
} else if (fix.description.includes('When to Use') || fix.description.includes('Boundaries')) {
|
||||
result = result.trimEnd() + '\n' + fix.replacement;
|
||||
}
|
||||
} else if (fix.type === 'replace' && fix.original && fix.automatic) {
|
||||
const escaped = fix.original.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
|
||||
const regex = new RegExp(escaped, 'gi');
|
||||
result = result.replace(regex, fix.replacement);
|
||||
}
|
||||
}
|
||||
|
||||
return result;
|
||||
}
|
||||
|
||||
export class FixCommand extends Command {
|
||||
static override paths = [['fix']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Automatically fix common skill quality issues',
|
||||
details: `
|
||||
The fix command analyzes skills and applies automatic fixes for common quality issues.
|
||||
|
||||
Fixes that can be automated:
|
||||
- Add missing YAML frontmatter template
|
||||
- Add "When to Use" section scaffold
|
||||
- Add "Boundaries" section scaffold
|
||||
- Format code blocks with language tags
|
||||
|
||||
Interactive mode prompts before each fix.
|
||||
`,
|
||||
examples: [
|
||||
['Fix a specific skill', '$0 fix my-skill'],
|
||||
['Fix skill file', '$0 fix ./path/to/SKILL.md'],
|
||||
['Preview fixes without applying', '$0 fix my-skill --dry-run'],
|
||||
['Apply all fixes without prompts', '$0 fix my-skill --yes'],
|
||||
],
|
||||
});
|
||||
|
||||
targets = Option.Rest();
|
||||
|
||||
dryRun = Option.Boolean('--dry-run,-d', false, {
|
||||
description: 'Show proposed changes without applying',
|
||||
});
|
||||
|
||||
yes = Option.Boolean('--yes,-y', false, {
|
||||
description: 'Apply all automatic fixes without prompting',
|
||||
});
|
||||
|
||||
interactive = Option.Boolean('--interactive,-i', {
|
||||
description: 'Prompt for each fix (default when not using --yes)',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const isInteractive = this.interactive !== false && !this.yes && !this.dryRun && process.stdin.isTTY;
|
||||
|
||||
if (this.targets.length === 0) {
|
||||
error('Please specify a skill to fix');
|
||||
console.log(colors.muted('Usage: skillkit fix <skill-name> or skillkit fix ./path/to/SKILL.md'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
header('Skill Quality Fixer');
|
||||
|
||||
let totalFixes = 0;
|
||||
let filesFixed = 0;
|
||||
|
||||
for (const target of this.targets) {
|
||||
const resolved = resolve(target);
|
||||
let filePath: string | null = null;
|
||||
let skillName = basename(target);
|
||||
|
||||
if (existsSync(resolved)) {
|
||||
if (resolved.endsWith('.md') || resolved.endsWith('.mdc')) {
|
||||
filePath = resolved;
|
||||
const fileName = basename(resolved);
|
||||
if (fileName.endsWith('.mdc')) {
|
||||
skillName = fileName.slice(0, -4);
|
||||
} else if (fileName.endsWith('.md')) {
|
||||
skillName = fileName.slice(0, -3);
|
||||
} else {
|
||||
skillName = fileName;
|
||||
}
|
||||
} else {
|
||||
const skillMd = join(resolved, 'SKILL.md');
|
||||
const indexMdc = join(resolved, 'index.mdc');
|
||||
if (existsSync(skillMd)) {
|
||||
filePath = skillMd;
|
||||
} else if (existsSync(indexMdc)) {
|
||||
filePath = indexMdc;
|
||||
}
|
||||
}
|
||||
} else {
|
||||
const searchDirs = getSearchDirs();
|
||||
const skills = findAllSkills(searchDirs);
|
||||
const found = skills.find(s => s.name === target);
|
||||
if (found) {
|
||||
const skillMd = join(found.path, 'SKILL.md');
|
||||
const indexMdc = join(found.path, 'index.mdc');
|
||||
if (existsSync(skillMd)) {
|
||||
filePath = skillMd;
|
||||
} else if (existsSync(indexMdc)) {
|
||||
filePath = indexMdc;
|
||||
}
|
||||
skillName = found.name;
|
||||
}
|
||||
}
|
||||
|
||||
if (!filePath || !existsSync(filePath)) {
|
||||
warn(`Skill not found: ${target}`);
|
||||
continue;
|
||||
}
|
||||
|
||||
const content = readFileSync(filePath, 'utf-8');
|
||||
const quality = evaluateSkillFile(filePath);
|
||||
|
||||
if (!quality) {
|
||||
warn(`Could not evaluate: ${target}`);
|
||||
continue;
|
||||
}
|
||||
|
||||
console.log('');
|
||||
console.log(colors.bold(skillName));
|
||||
console.log(colors.muted(`Score: ${quality.overall}/100`));
|
||||
|
||||
const fixes = generateFixes(content, quality, skillName);
|
||||
const automaticFixes = fixes.filter(f => f.automatic);
|
||||
const manualFixes = fixes.filter(f => !f.automatic);
|
||||
|
||||
if (fixes.length === 0) {
|
||||
console.log(colors.success(`${symbols.success} No automatic fixes needed`));
|
||||
continue;
|
||||
}
|
||||
|
||||
console.log('');
|
||||
console.log(colors.muted(`Found ${fixes.length} potential fix(es):`));
|
||||
|
||||
for (const fix of automaticFixes) {
|
||||
console.log(` ${colors.success(symbols.success)} ${fix.description} ${colors.muted('(automatic)')}`);
|
||||
}
|
||||
|
||||
for (const fix of manualFixes) {
|
||||
console.log(` ${colors.warning(symbols.warning)} ${fix.description} ${colors.muted('(manual review)')}`);
|
||||
}
|
||||
|
||||
if (this.dryRun) {
|
||||
console.log('');
|
||||
console.log(colors.muted('Dry run - no changes applied'));
|
||||
|
||||
if (automaticFixes.length > 0) {
|
||||
console.log('');
|
||||
console.log(colors.muted('Preview of automatic fixes:'));
|
||||
const preview = applyFixes(content, automaticFixes);
|
||||
const diff = generateDiff(content, preview);
|
||||
console.log(diff);
|
||||
}
|
||||
continue;
|
||||
}
|
||||
|
||||
if (automaticFixes.length > 0) {
|
||||
let shouldApply = this.yes;
|
||||
|
||||
if (isInteractive && !this.yes) {
|
||||
console.log('');
|
||||
const confirmResult = await confirm({
|
||||
message: `Apply ${automaticFixes.length} automatic fix(es)?`,
|
||||
initialValue: true,
|
||||
});
|
||||
shouldApply = confirmResult === true;
|
||||
}
|
||||
|
||||
if (shouldApply) {
|
||||
const fixed = applyFixes(content, automaticFixes);
|
||||
writeFileSync(filePath, fixed, 'utf-8');
|
||||
totalFixes += automaticFixes.length;
|
||||
filesFixed++;
|
||||
console.log(colors.success(`${symbols.success} Applied ${automaticFixes.length} fix(es)`));
|
||||
} else {
|
||||
console.log(colors.muted('Skipped'));
|
||||
}
|
||||
}
|
||||
|
||||
if (manualFixes.length > 0) {
|
||||
console.log('');
|
||||
console.log(colors.muted('Manual fixes required:'));
|
||||
for (const fix of manualFixes) {
|
||||
if (fix.original) {
|
||||
console.log(` ${colors.warning(symbols.bullet)} Replace "${fix.original}" with "${fix.replacement}"`);
|
||||
} else {
|
||||
console.log(` ${colors.warning(symbols.bullet)} ${fix.description}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
console.log('');
|
||||
if (totalFixes > 0) {
|
||||
success(`Fixed ${totalFixes} issue(s) in ${filesFixed} file(s)`);
|
||||
console.log(colors.muted('Run "skillkit validate" to verify improvements'));
|
||||
} else if (!this.dryRun) {
|
||||
console.log(colors.muted('No fixes applied'));
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
function generateDiff(original: string, modified: string): string {
|
||||
const originalLines = original.split('\n');
|
||||
const modifiedLines = modified.split('\n');
|
||||
|
||||
const originalSet = new Set(originalLines);
|
||||
const modifiedSet = new Set(modifiedLines);
|
||||
|
||||
const added = modifiedLines.filter(line => !originalSet.has(line));
|
||||
const removed = originalLines.filter(line => !modifiedSet.has(line));
|
||||
|
||||
const diff: string[] = [];
|
||||
|
||||
for (const line of removed.slice(0, 5)) {
|
||||
diff.push(colors.error(`- ${line}`));
|
||||
}
|
||||
if (removed.length > 5) {
|
||||
diff.push(colors.muted(` ... and ${removed.length - 5} more removed`));
|
||||
}
|
||||
|
||||
for (const line of added.slice(0, 10)) {
|
||||
diff.push(colors.success(`+ ${line}`));
|
||||
}
|
||||
if (added.length > 10) {
|
||||
diff.push(colors.muted(` ... and ${added.length - 10} more added`));
|
||||
}
|
||||
|
||||
if (diff.length === 0) {
|
||||
diff.push(colors.muted(' (no visible changes)'));
|
||||
}
|
||||
|
||||
return diff.join('\n');
|
||||
}
|
||||
@@ -8,6 +8,7 @@ export { RemoveCommand } from './remove.js';
|
||||
export { InstallCommand } from './install.js';
|
||||
export { UpdateCommand } from './update.js';
|
||||
export { ValidateCommand } from './validate.js';
|
||||
export { FixCommand } from './fix.js';
|
||||
export { CreateCommand } from './create.js';
|
||||
export { UICommand } from './ui.js';
|
||||
export { TranslateCommand } from './translate.js';
|
||||
@@ -41,3 +42,14 @@ export {
|
||||
AgentSyncCommand,
|
||||
AgentValidateCommand,
|
||||
} from './agent.js';
|
||||
|
||||
export { CheckCommand } from './check.js';
|
||||
export { FindCommand } from './find.js';
|
||||
export {
|
||||
ManifestCommand,
|
||||
ManifestInitCommand,
|
||||
ManifestAddCommand,
|
||||
ManifestRemoveCommand,
|
||||
ManifestInstallCommand,
|
||||
ManifestGenerateCommand,
|
||||
} from './manifest.js';
|
||||
|
||||
@@ -1,11 +1,27 @@
|
||||
import { existsSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import { createInterface } from 'node:readline';
|
||||
import chalk from 'chalk';
|
||||
import { Command, Option } from 'clipanion';
|
||||
import type { AgentType } from '@skillkit/core';
|
||||
import { detectAgent, getAdapter, getAllAdapters } from '@skillkit/agents';
|
||||
import { initProject } from '../helpers.js';
|
||||
import {
|
||||
welcome,
|
||||
header,
|
||||
colors,
|
||||
symbols,
|
||||
formatAgent,
|
||||
isCancel,
|
||||
spinner,
|
||||
select,
|
||||
confirm,
|
||||
outro,
|
||||
cancel,
|
||||
step,
|
||||
note,
|
||||
showNextSteps,
|
||||
isOnboardingComplete,
|
||||
completeOnboarding,
|
||||
} from '../onboarding/index.js';
|
||||
|
||||
export class InitCommand extends Command {
|
||||
static override paths = [['init']];
|
||||
@@ -27,64 +43,120 @@ export class InitCommand extends Command {
|
||||
description: 'List supported agents',
|
||||
});
|
||||
|
||||
quiet = Option.Boolean('--quiet,-q', false, {
|
||||
description: 'Minimal output (no logo)',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const isInteractive = process.stdin.isTTY;
|
||||
|
||||
// List mode
|
||||
if (this.list) {
|
||||
console.log(chalk.cyan('Supported agents:\n'));
|
||||
if (!this.quiet) {
|
||||
header('Supported Agents');
|
||||
}
|
||||
|
||||
const adapters = getAllAdapters();
|
||||
console.log('');
|
||||
|
||||
for (const adapter of adapters) {
|
||||
console.log(` ${chalk.green(adapter.type)}`);
|
||||
console.log(` Name: ${adapter.name}`);
|
||||
console.log(` Skills dir: ${adapter.skillsDir}`);
|
||||
console.log(` Config file: ${adapter.configFile}`);
|
||||
console.log();
|
||||
console.log(` ${formatAgent(adapter.type)}`);
|
||||
console.log(` ${colors.muted('Skills dir:')} ${adapter.skillsDir}`);
|
||||
console.log(` ${colors.muted('Config:')} ${adapter.configFile}`);
|
||||
console.log('');
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
|
||||
try {
|
||||
// Show welcome for first-time users
|
||||
const isFirstRun = !isOnboardingComplete();
|
||||
if (isInteractive && isFirstRun && !this.quiet) {
|
||||
welcome();
|
||||
} else if (!this.quiet) {
|
||||
header('Initialize');
|
||||
}
|
||||
|
||||
let agentType: AgentType;
|
||||
const s = spinner();
|
||||
|
||||
if (this.agent) {
|
||||
// Use specified agent
|
||||
agentType = this.agent as AgentType;
|
||||
} else if (isInteractive) {
|
||||
// Auto-detect and let user confirm/change
|
||||
s.start('Detecting agent...');
|
||||
const detected = await detectAgent();
|
||||
s.stop(`Detected: ${formatAgent(detected)}`);
|
||||
|
||||
const allAgents = getAllAdapters().map(a => a.type);
|
||||
|
||||
// Let user confirm or select different agent
|
||||
const agentResult = await select({
|
||||
message: 'Initialize for which agent?',
|
||||
options: allAgents.map(a => ({
|
||||
value: a,
|
||||
label: formatAgent(a),
|
||||
hint: a === detected ? '(detected)' : undefined,
|
||||
})),
|
||||
initialValue: detected,
|
||||
});
|
||||
|
||||
if (isCancel(agentResult)) {
|
||||
cancel('Initialization cancelled');
|
||||
return 0;
|
||||
}
|
||||
|
||||
agentType = agentResult as AgentType;
|
||||
} else {
|
||||
console.log(chalk.dim('Auto-detecting agent...'));
|
||||
// Non-interactive: auto-detect
|
||||
s.start('Detecting agent...');
|
||||
agentType = await detectAgent();
|
||||
s.stop(`Detected: ${formatAgent(agentType)}`);
|
||||
}
|
||||
|
||||
const adapter = getAdapter(agentType);
|
||||
|
||||
console.log(chalk.cyan(`Initializing for ${adapter.name}...`));
|
||||
|
||||
// Initialize project
|
||||
s.start(`Initializing for ${adapter.name}...`);
|
||||
await initProject(agentType);
|
||||
s.stop(`Initialized for ${adapter.name}`);
|
||||
|
||||
console.log();
|
||||
console.log(chalk.green('Initialized successfully!'));
|
||||
console.log();
|
||||
console.log(chalk.dim('Created:'));
|
||||
console.log(chalk.dim(` - ${adapter.skillsDir}/ (skills directory)`));
|
||||
console.log(chalk.dim(` - skillkit.yaml (config file)`));
|
||||
console.log(chalk.dim(` - ${adapter.configFile} (agent config)`));
|
||||
console.log();
|
||||
console.log(chalk.cyan('Next steps:'));
|
||||
console.log(chalk.dim(' 1. Install skills: skillkit install owner/repo'));
|
||||
console.log(chalk.dim(' 2. Sync config: skillkit sync'));
|
||||
console.log(chalk.dim(' 3. Use skills: skillkit read <skill-name>'));
|
||||
// Show what was created
|
||||
note(
|
||||
[
|
||||
`${symbols.success} ${adapter.skillsDir}/ ${colors.muted('(skills directory)')}`,
|
||||
`${symbols.success} skillkit.yaml ${colors.muted('(config file)')}`,
|
||||
`${symbols.success} ${adapter.configFile} ${colors.muted('(agent config)')}`,
|
||||
].join('\n'),
|
||||
'Created'
|
||||
);
|
||||
|
||||
// Check if SKILL.md exists and offer to publish
|
||||
// Mark onboarding complete
|
||||
if (isFirstRun) {
|
||||
completeOnboarding();
|
||||
}
|
||||
|
||||
// Check for SKILL.md to offer publishing
|
||||
await this.checkAndPromptPublish();
|
||||
|
||||
outro('Initialization complete!');
|
||||
|
||||
showNextSteps({
|
||||
skillNames: [],
|
||||
agentTypes: [agentType],
|
||||
});
|
||||
|
||||
return 0;
|
||||
} catch (error) {
|
||||
console.error(chalk.red('Initialization failed'));
|
||||
console.error(chalk.dim(error instanceof Error ? error.message : String(error)));
|
||||
} catch (err) {
|
||||
console.log(colors.error('Initialization failed'));
|
||||
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async checkAndPromptPublish(): Promise<void> {
|
||||
// Skip in non-interactive environments (CI, piped input, etc.)
|
||||
if (!process.stdin.isTTY) return;
|
||||
|
||||
const skillMdLocations = [
|
||||
@@ -97,32 +169,21 @@ export class InitCommand extends Command {
|
||||
const foundSkillMd = skillMdLocations.find(loc => existsSync(loc));
|
||||
if (!foundSkillMd) return;
|
||||
|
||||
console.log();
|
||||
console.log(chalk.yellow('Found SKILL.md in your project!'));
|
||||
console.log(chalk.dim('Would you like to publish it to the SkillKit marketplace?'));
|
||||
console.log();
|
||||
console.log('');
|
||||
step(`Found SKILL.md in your project`);
|
||||
|
||||
const answer = await this.prompt('Publish skill? [y/N]: ');
|
||||
const publishResult = await confirm({
|
||||
message: 'Would you like to publish it to the SkillKit marketplace?',
|
||||
initialValue: false,
|
||||
});
|
||||
|
||||
if (answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes') {
|
||||
console.log();
|
||||
console.log(chalk.cyan('To publish your skill, run:'));
|
||||
console.log(chalk.white(` skillkit publish ${foundSkillMd}`));
|
||||
console.log();
|
||||
if (isCancel(publishResult) || !publishResult) {
|
||||
return;
|
||||
}
|
||||
}
|
||||
|
||||
private prompt(question: string): Promise<string> {
|
||||
const rl = createInterface({
|
||||
input: process.stdin,
|
||||
output: process.stdout,
|
||||
});
|
||||
|
||||
return new Promise(resolve => {
|
||||
rl.question(question, answer => {
|
||||
rl.close();
|
||||
resolve(answer.trim());
|
||||
});
|
||||
});
|
||||
console.log('');
|
||||
console.log(colors.cyan('To publish your skill, run:'));
|
||||
console.log(` ${colors.bold(`skillkit publish ${foundSkillMd}`)}`);
|
||||
console.log('');
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,13 +1,37 @@
|
||||
import { existsSync, mkdirSync, cpSync, rmSync } from 'node:fs';
|
||||
import { existsSync, mkdirSync, cpSync, rmSync, symlinkSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import chalk from 'chalk';
|
||||
import ora from 'ora';
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { detectProvider, isLocalPath, getProvider } from '@skillkit/core';
|
||||
import { detectProvider, isLocalPath, getProvider, evaluateSkillDirectory } from '@skillkit/core';
|
||||
import type { SkillMetadata, GitProvider, AgentType } from '@skillkit/core';
|
||||
import { isPathInside } from '@skillkit/core';
|
||||
import { getAdapter, detectAgent } from '@skillkit/agents';
|
||||
import { getAdapter, detectAgent, getAllAdapters } from '@skillkit/agents';
|
||||
import { getInstallDir, saveSkillMetadata } from '../helpers.js';
|
||||
import {
|
||||
welcome,
|
||||
colors,
|
||||
symbols,
|
||||
formatAgent,
|
||||
getAgentIcon,
|
||||
isCancel,
|
||||
spinner,
|
||||
quickAgentSelect,
|
||||
skillMultiselect,
|
||||
selectInstallMethod,
|
||||
confirm,
|
||||
outro,
|
||||
cancel,
|
||||
step,
|
||||
success,
|
||||
error,
|
||||
warn,
|
||||
showInstallSummary,
|
||||
showNextSteps,
|
||||
saveLastAgents,
|
||||
getLastAgents,
|
||||
formatQualityBadge,
|
||||
getQualityGradeFromScore,
|
||||
type InstallResult,
|
||||
} from '../onboarding/index.js';
|
||||
|
||||
export class InstallCommand extends Command {
|
||||
static override paths = [['install'], ['i']];
|
||||
@@ -61,10 +85,20 @@ export class InstallCommand extends Command {
|
||||
description: 'Target specific agents (can specify multiple)',
|
||||
});
|
||||
|
||||
quiet = Option.Boolean('--quiet,-q', false, {
|
||||
description: 'Minimal output (no logo)',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const spinner = ora();
|
||||
const isInteractive = process.stdin.isTTY && !this.skills && !this.all && !this.yes;
|
||||
const s = spinner();
|
||||
|
||||
try {
|
||||
// Show welcome logo for interactive mode
|
||||
if (isInteractive && !this.quiet) {
|
||||
welcome();
|
||||
}
|
||||
|
||||
let providerAdapter = detectProvider(this.source);
|
||||
|
||||
if (this.provider) {
|
||||
@@ -72,40 +106,44 @@ export class InstallCommand extends Command {
|
||||
}
|
||||
|
||||
if (!providerAdapter) {
|
||||
console.error(chalk.red(`Could not detect provider for: ${this.source}`));
|
||||
console.error(chalk.dim('Use --provider flag or specify source as:'));
|
||||
console.error(chalk.dim(' GitHub: owner/repo or https://github.com/owner/repo'));
|
||||
console.error(chalk.dim(' GitLab: gitlab:owner/repo or https://gitlab.com/owner/repo'));
|
||||
console.error(chalk.dim(' Bitbucket: bitbucket:owner/repo'));
|
||||
console.error(chalk.dim(' Local: ./path or ~/path'));
|
||||
error(`Could not detect provider for: ${this.source}`);
|
||||
console.log(colors.muted('Use --provider flag or specify source as:'));
|
||||
console.log(colors.muted(' GitHub: owner/repo or https://github.com/owner/repo'));
|
||||
console.log(colors.muted(' GitLab: gitlab:owner/repo or https://gitlab.com/owner/repo'));
|
||||
console.log(colors.muted(' Bitbucket: bitbucket:owner/repo'));
|
||||
console.log(colors.muted(' Local: ./path or ~/path'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
spinner.start(`Fetching from ${providerAdapter.name}...`);
|
||||
s.start(`Fetching from ${providerAdapter.name}...`);
|
||||
|
||||
const result = await providerAdapter.clone(this.source, '', { depth: 1 });
|
||||
|
||||
if (!result.success || !result.path) {
|
||||
spinner.fail(chalk.red(result.error || 'Failed to fetch source'));
|
||||
s.stop(colors.error(result.error || 'Failed to fetch source'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
spinner.succeed(`Found ${result.skills?.length || 0} skill(s)`);
|
||||
s.stop(`Found ${result.skills?.length || 0} skill(s)`);
|
||||
|
||||
const discoveredSkills = result.discoveredSkills || [];
|
||||
|
||||
// List mode - just show skills and exit
|
||||
if (this.list) {
|
||||
if (discoveredSkills.length === 0) {
|
||||
console.log(chalk.yellow('\nNo skills found in this repository'));
|
||||
warn('No skills found in this repository');
|
||||
} else {
|
||||
console.log(chalk.cyan('\nAvailable skills:\n'));
|
||||
console.log('');
|
||||
console.log(colors.bold('Available skills:'));
|
||||
console.log('');
|
||||
for (const skill of discoveredSkills) {
|
||||
console.log(` ${chalk.green(skill.name)}`);
|
||||
const quality = evaluateSkillDirectory(skill.path);
|
||||
const qualityBadge = quality ? ` ${formatQualityBadge(quality.overall)}` : '';
|
||||
console.log(` ${colors.success(symbols.stepActive)} ${colors.primary(skill.name)}${qualityBadge}`);
|
||||
}
|
||||
console.log();
|
||||
console.log(chalk.dim(`Total: ${discoveredSkills.length} skill(s)`));
|
||||
console.log(chalk.dim('\nTo install specific skills: skillkit install <source> --skills=skill1,skill2'));
|
||||
console.log(chalk.dim('To install all skills: skillkit install <source> --all'));
|
||||
console.log('');
|
||||
console.log(colors.muted(`Total: ${discoveredSkills.length} skill(s)`));
|
||||
console.log(colors.muted('To install: skillkit install <source> --skills=skill1,skill2'));
|
||||
}
|
||||
|
||||
const cleanupPath = result.tempRoot || result.path;
|
||||
@@ -118,83 +156,185 @@ export class InstallCommand extends Command {
|
||||
|
||||
let skillsToInstall = discoveredSkills;
|
||||
|
||||
// Non-interactive: use --skills filter
|
||||
if (this.skills) {
|
||||
const requestedSkills = this.skills.split(',').map(s => s.trim());
|
||||
const available = discoveredSkills.map(s => s.name);
|
||||
const notFound = requestedSkills.filter(s => !available.includes(s));
|
||||
|
||||
if (notFound.length > 0) {
|
||||
console.error(chalk.red(`Skills not found: ${notFound.join(', ')}`));
|
||||
console.error(chalk.dim(`Available: ${available.join(', ')}`));
|
||||
error(`Skills not found: ${notFound.join(', ')}`);
|
||||
console.log(colors.muted(`Available: ${available.join(', ')}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
skillsToInstall = discoveredSkills.filter(s => requestedSkills.includes(s.name));
|
||||
} else if (this.all || this.yes) {
|
||||
skillsToInstall = discoveredSkills;
|
||||
} else {
|
||||
skillsToInstall = discoveredSkills;
|
||||
} else if (isInteractive && discoveredSkills.length > 1) {
|
||||
// Interactive skill selection
|
||||
step(`Source: ${colors.cyan(this.source)}`);
|
||||
|
||||
if (skillsToInstall.length > 0) {
|
||||
console.log(chalk.cyan('\nSkills to install:'));
|
||||
skillsToInstall.forEach(s => console.log(chalk.dim(` - ${s.name}`)));
|
||||
console.log();
|
||||
const skillResult = await skillMultiselect({
|
||||
message: 'Select skills to install',
|
||||
skills: discoveredSkills.map(s => ({ name: s.name })),
|
||||
initialValues: discoveredSkills.map(s => s.name),
|
||||
});
|
||||
|
||||
if (isCancel(skillResult)) {
|
||||
cancel('Installation cancelled');
|
||||
return 0;
|
||||
}
|
||||
|
||||
skillsToInstall = discoveredSkills.filter(s => (skillResult as string[]).includes(s.name));
|
||||
}
|
||||
|
||||
if (skillsToInstall.length === 0) {
|
||||
console.log(chalk.yellow('No skills to install'));
|
||||
warn('No skills to install');
|
||||
return 0;
|
||||
}
|
||||
|
||||
// Determine target agents
|
||||
let targetAgents: AgentType[];
|
||||
|
||||
if (this.agent && this.agent.length > 0) {
|
||||
// Explicitly specified agents
|
||||
targetAgents = this.agent as AgentType[];
|
||||
} else if (isInteractive) {
|
||||
const allAgentTypes = getAllAdapters().map(a => a.type);
|
||||
const lastAgents = getLastAgents();
|
||||
|
||||
step(`Detected ${allAgentTypes.length} agents`);
|
||||
|
||||
const agentResult = await quickAgentSelect({
|
||||
message: 'Install to',
|
||||
agents: allAgentTypes,
|
||||
lastSelected: lastAgents,
|
||||
});
|
||||
|
||||
if (isCancel(agentResult)) {
|
||||
cancel('Installation cancelled');
|
||||
return 0;
|
||||
}
|
||||
|
||||
targetAgents = (agentResult as { agents: string[] }).agents as AgentType[];
|
||||
|
||||
// Save selection for next time
|
||||
saveLastAgents(targetAgents);
|
||||
} else {
|
||||
// Non-interactive: use detected agent
|
||||
const detectedAgent = await detectAgent();
|
||||
targetAgents = [detectedAgent];
|
||||
}
|
||||
|
||||
// Interactive: select installation method
|
||||
let installMethod: 'symlink' | 'copy' = 'copy';
|
||||
|
||||
if (isInteractive && targetAgents.length > 1) {
|
||||
const methodResult = await selectInstallMethod({});
|
||||
|
||||
if (isCancel(methodResult)) {
|
||||
cancel('Installation cancelled');
|
||||
return 0;
|
||||
}
|
||||
|
||||
installMethod = methodResult as 'symlink' | 'copy';
|
||||
}
|
||||
|
||||
// Check for low-quality skills and warn
|
||||
const lowQualitySkills: Array<{ name: string; score: number; warnings: string[] }> = [];
|
||||
for (const skill of skillsToInstall) {
|
||||
const quality = evaluateSkillDirectory(skill.path);
|
||||
if (quality && quality.overall < 60) {
|
||||
lowQualitySkills.push({
|
||||
name: skill.name,
|
||||
score: quality.overall,
|
||||
warnings: quality.warnings.slice(0, 2),
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
// Confirm installation
|
||||
if (isInteractive && !this.yes) {
|
||||
console.log('');
|
||||
|
||||
// Show low-quality warning if any
|
||||
if (lowQualitySkills.length > 0) {
|
||||
console.log(colors.warning(`${symbols.warning} Warning: ${lowQualitySkills.length} skill(s) have low quality scores (< 60)`));
|
||||
for (const lq of lowQualitySkills) {
|
||||
const grade = getQualityGradeFromScore(lq.score);
|
||||
const warningText = lq.warnings.length > 0 ? ` - ${lq.warnings.join(', ')}` : '';
|
||||
console.log(colors.muted(` - ${lq.name} [${grade}]${warningText}`));
|
||||
}
|
||||
console.log('');
|
||||
}
|
||||
|
||||
const agentDisplay = targetAgents.length <= 3
|
||||
? targetAgents.map(formatAgent).join(', ')
|
||||
: `${targetAgents.slice(0, 2).map(formatAgent).join(', ')} +${targetAgents.length - 2} more`;
|
||||
|
||||
const confirmResult = await confirm({
|
||||
message: `Install ${skillsToInstall.length} skill(s) to ${agentDisplay}?`,
|
||||
initialValue: true,
|
||||
});
|
||||
|
||||
if (isCancel(confirmResult) || !confirmResult) {
|
||||
cancel('Installation cancelled');
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
// Perform installation
|
||||
let totalInstalled = 0;
|
||||
const installResults: { agent: string; dir: string; count: number }[] = [];
|
||||
const installResults: InstallResult[] = [];
|
||||
|
||||
for (const agentType of targetAgents) {
|
||||
const adapter = getAdapter(agentType);
|
||||
const installDir = getInstallDir(this.global, agentType);
|
||||
for (const skill of skillsToInstall) {
|
||||
const skillName = skill.name;
|
||||
const sourcePath = skill.path;
|
||||
const installedAgents: string[] = [];
|
||||
let primaryPath: string | null = null;
|
||||
|
||||
if (!existsSync(installDir)) {
|
||||
mkdirSync(installDir, { recursive: true });
|
||||
}
|
||||
for (const agentType of targetAgents) {
|
||||
const adapter = getAdapter(agentType);
|
||||
const installDir = getInstallDir(this.global, agentType);
|
||||
|
||||
if (targetAgents.length > 1) {
|
||||
console.log(chalk.cyan(`\nInstalling to ${adapter.name}...`));
|
||||
}
|
||||
if (!existsSync(installDir)) {
|
||||
mkdirSync(installDir, { recursive: true });
|
||||
}
|
||||
|
||||
let installed = 0;
|
||||
for (const skill of skillsToInstall) {
|
||||
const skillName = skill.name;
|
||||
const sourcePath = skill.path;
|
||||
const targetPath = join(installDir, skillName);
|
||||
|
||||
if (existsSync(targetPath) && !this.force) {
|
||||
console.log(chalk.yellow(` Skipping ${skillName} (already exists, use --force to overwrite)`));
|
||||
if (!this.quiet) {
|
||||
warn(`Skipping ${skillName} for ${adapter.name} (already exists, use --force)`);
|
||||
}
|
||||
continue;
|
||||
}
|
||||
|
||||
const securityRoot = result.tempRoot || result.path;
|
||||
if (!isPathInside(sourcePath, securityRoot)) {
|
||||
console.log(chalk.red(` Skipping ${skillName} (path traversal detected)`));
|
||||
error(`Skipping ${skillName} (path traversal detected)`);
|
||||
continue;
|
||||
}
|
||||
|
||||
spinner.start(`Installing ${skillName}...`);
|
||||
const isSymlinkMode = installMethod === 'symlink' && targetAgents.length > 1;
|
||||
const useSymlink = isSymlinkMode && primaryPath !== null;
|
||||
|
||||
s.start(`Installing ${skillName} to ${adapter.name}${useSymlink ? ' (symlink)' : ''}...`);
|
||||
|
||||
try {
|
||||
if (existsSync(targetPath)) {
|
||||
rmSync(targetPath, { recursive: true, force: true });
|
||||
}
|
||||
|
||||
cpSync(sourcePath, targetPath, { recursive: true, dereference: true });
|
||||
if (useSymlink && primaryPath) {
|
||||
symlinkSync(primaryPath, targetPath, 'dir');
|
||||
} else {
|
||||
cpSync(sourcePath, targetPath, { recursive: true, dereference: true });
|
||||
if (isSymlinkMode && primaryPath === null) {
|
||||
primaryPath = targetPath;
|
||||
}
|
||||
}
|
||||
|
||||
const metadata: SkillMetadata = {
|
||||
name: skillName,
|
||||
@@ -207,41 +347,66 @@ export class InstallCommand extends Command {
|
||||
};
|
||||
saveSkillMetadata(targetPath, metadata);
|
||||
|
||||
spinner.succeed(chalk.green(`Installed ${skillName}`));
|
||||
installed++;
|
||||
} catch (error) {
|
||||
spinner.fail(chalk.red(`Failed to install ${skillName}`));
|
||||
console.error(chalk.dim(error instanceof Error ? error.message : String(error)));
|
||||
installedAgents.push(agentType);
|
||||
s.stop(`Installed ${skillName} to ${adapter.name}${useSymlink ? ' (symlink)' : ''}`);
|
||||
} catch (err) {
|
||||
s.stop(colors.error(`Failed to install ${skillName} to ${adapter.name}`));
|
||||
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
|
||||
}
|
||||
}
|
||||
|
||||
totalInstalled += installed;
|
||||
installResults.push({ agent: adapter.name, dir: installDir, count: installed });
|
||||
if (installedAgents.length > 0) {
|
||||
totalInstalled++;
|
||||
installResults.push({
|
||||
skillName,
|
||||
method: installMethod,
|
||||
agents: installedAgents,
|
||||
path: join(getInstallDir(this.global, installedAgents[0] as AgentType), skillName),
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
// Cleanup temp directory
|
||||
const cleanupPath = result.tempRoot || result.path;
|
||||
if (!isLocalPath(this.source) && cleanupPath && existsSync(cleanupPath)) {
|
||||
rmSync(cleanupPath, { recursive: true, force: true });
|
||||
}
|
||||
|
||||
console.log();
|
||||
if (targetAgents.length > 1) {
|
||||
console.log(chalk.green(`Installed ${totalInstalled} skill(s) across ${targetAgents.length} agents:`));
|
||||
for (const r of installResults) {
|
||||
console.log(chalk.dim(` - ${r.agent}: ${r.count} skill(s) to ${r.dir}`));
|
||||
// Show summary
|
||||
if (totalInstalled > 0) {
|
||||
if (isInteractive) {
|
||||
showInstallSummary({
|
||||
totalSkills: totalInstalled,
|
||||
totalAgents: targetAgents.length,
|
||||
results: installResults,
|
||||
source: this.source,
|
||||
});
|
||||
|
||||
outro('Installation complete!');
|
||||
|
||||
if (!this.yes) {
|
||||
showNextSteps({
|
||||
skillNames: installResults.map(r => r.skillName),
|
||||
agentTypes: targetAgents,
|
||||
syncNeeded: true,
|
||||
});
|
||||
}
|
||||
} else {
|
||||
success(`Installed ${totalInstalled} skill(s) to ${targetAgents.length} agent(s)`);
|
||||
for (const r of installResults) {
|
||||
console.log(colors.muted(` ${symbols.success} ${r.skillName} ${symbols.arrowRight} ${r.agents.map(getAgentIcon).join(' ')}`));
|
||||
}
|
||||
console.log('');
|
||||
console.log(colors.muted('Run `skillkit sync` to update agent configs'));
|
||||
}
|
||||
} else {
|
||||
console.log(chalk.green(`Installed ${totalInstalled} skill(s) to ${installResults[0]?.dir}`));
|
||||
}
|
||||
|
||||
if (!this.yes) {
|
||||
console.log(chalk.dim('\nRun `skillkit sync` to update your agent config'));
|
||||
warn('No skills were installed');
|
||||
}
|
||||
|
||||
return 0;
|
||||
} catch (error) {
|
||||
spinner.fail(chalk.red('Installation failed'));
|
||||
console.error(chalk.dim(error instanceof Error ? error.message : String(error)));
|
||||
} catch (err) {
|
||||
s.stop(colors.error('Installation failed'));
|
||||
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,7 +1,8 @@
|
||||
import chalk from 'chalk';
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { findAllSkills } from '@skillkit/core';
|
||||
import { findAllSkills, evaluateSkillDirectory } from '@skillkit/core';
|
||||
import { getSearchDirs } from '../helpers.js';
|
||||
import { formatQualityBadge, colors } from '../onboarding/index.js';
|
||||
|
||||
export class ListCommand extends Command {
|
||||
static override paths = [['list'], ['ls'], ['l']];
|
||||
@@ -23,6 +24,10 @@ export class ListCommand extends Command {
|
||||
description: 'Show only disabled skills',
|
||||
});
|
||||
|
||||
quality = Option.Boolean('--quality,-q', false, {
|
||||
description: 'Show quality scores and grades',
|
||||
});
|
||||
|
||||
json = Option.Boolean('--json,-j', false, {
|
||||
description: 'Output as JSON',
|
||||
});
|
||||
@@ -44,8 +49,18 @@ export class ListCommand extends Command {
|
||||
return a.name.localeCompare(b.name);
|
||||
});
|
||||
|
||||
const skillsWithQuality = this.quality || this.json
|
||||
? skills.map(s => {
|
||||
const quality = evaluateSkillDirectory(s.path);
|
||||
return {
|
||||
...s,
|
||||
quality: quality?.overall ?? null,
|
||||
};
|
||||
})
|
||||
: skills.map(s => ({ ...s, quality: null as number | null }));
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(skills, null, 2));
|
||||
console.log(JSON.stringify(skillsWithQuality, null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
@@ -57,13 +72,13 @@ export class ListCommand extends Command {
|
||||
|
||||
console.log(chalk.cyan(`Installed skills (${skills.length}):\n`));
|
||||
|
||||
const projectSkills = skills.filter(s => s.location === 'project');
|
||||
const globalSkills = skills.filter(s => s.location === 'global');
|
||||
const projectSkills = skillsWithQuality.filter(s => s.location === 'project');
|
||||
const globalSkills = skillsWithQuality.filter(s => s.location === 'global');
|
||||
|
||||
if (projectSkills.length > 0) {
|
||||
console.log(chalk.blue('Project skills:'));
|
||||
for (const skill of projectSkills) {
|
||||
printSkill(skill);
|
||||
printSkill(skill, this.quality);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
@@ -71,7 +86,7 @@ export class ListCommand extends Command {
|
||||
if (globalSkills.length > 0) {
|
||||
console.log(chalk.dim('Global skills:'));
|
||||
for (const skill of globalSkills) {
|
||||
printSkill(skill);
|
||||
printSkill(skill, this.quality);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
@@ -86,16 +101,28 @@ export class ListCommand extends Command {
|
||||
)
|
||||
);
|
||||
|
||||
if (this.quality) {
|
||||
const qualityScores = skillsWithQuality.filter(s => s.quality !== null).map(s => s.quality!);
|
||||
if (qualityScores.length > 0) {
|
||||
const avgQuality = Math.round(qualityScores.reduce((a, b) => a + b, 0) / qualityScores.length);
|
||||
console.log(colors.muted(`Average quality: ${avgQuality}/100`));
|
||||
}
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
function printSkill(skill: { name: string; description: string; enabled: boolean; location: string }) {
|
||||
function printSkill(
|
||||
skill: { name: string; description: string; enabled: boolean; location: string; quality: number | null },
|
||||
showQuality = false
|
||||
) {
|
||||
const status = skill.enabled ? chalk.green('✓') : chalk.red('○');
|
||||
const name = skill.enabled ? skill.name : chalk.dim(skill.name);
|
||||
const desc = chalk.dim(truncate(skill.description, 50));
|
||||
const qualityBadge = showQuality && skill.quality !== null ? ` ${formatQualityBadge(skill.quality)}` : '';
|
||||
|
||||
console.log(` ${status} ${name}`);
|
||||
console.log(` ${status} ${name}${qualityBadge}`);
|
||||
if (skill.description) {
|
||||
console.log(` ${desc}`);
|
||||
}
|
||||
|
||||
@@ -0,0 +1,325 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import {
|
||||
loadManifest,
|
||||
saveManifest,
|
||||
initManifest,
|
||||
addToManifest,
|
||||
removeFromManifest,
|
||||
findManifestPath,
|
||||
generateManifestFromInstalled,
|
||||
findAllSkills,
|
||||
} from '@skillkit/core';
|
||||
import { getSearchDirs, loadSkillMetadata } from '../helpers.js';
|
||||
import {
|
||||
colors,
|
||||
symbols,
|
||||
spinner,
|
||||
step,
|
||||
success,
|
||||
warn,
|
||||
error,
|
||||
header,
|
||||
confirm,
|
||||
isCancel,
|
||||
} from '../onboarding/index.js';
|
||||
|
||||
export class ManifestCommand extends Command {
|
||||
static override paths = [['manifest']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Manage .skills manifest file',
|
||||
details: `
|
||||
The .skills manifest file allows declarative skill management.
|
||||
Commit this file to version control to share skill configurations.
|
||||
`,
|
||||
examples: [
|
||||
['Show current manifest', '$0 manifest'],
|
||||
['Initialize manifest', '$0 manifest init'],
|
||||
['Add skill to manifest', '$0 manifest add owner/repo'],
|
||||
['Remove skill from manifest', '$0 manifest remove owner/repo'],
|
||||
['Install from manifest', '$0 manifest install'],
|
||||
['Generate from installed', '$0 manifest generate'],
|
||||
],
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const manifestPath = findManifestPath();
|
||||
|
||||
if (!manifestPath) {
|
||||
warn('No .skills manifest found');
|
||||
console.log('');
|
||||
console.log(colors.muted('Create one with:'));
|
||||
console.log(` ${colors.cyan('skillkit manifest init')}`);
|
||||
console.log('');
|
||||
console.log(colors.muted('Or generate from installed skills:'));
|
||||
console.log(` ${colors.cyan('skillkit manifest generate')}`);
|
||||
return 0;
|
||||
}
|
||||
|
||||
const manifest = loadManifest(manifestPath);
|
||||
|
||||
if (!manifest) {
|
||||
error('Failed to load manifest');
|
||||
return 1;
|
||||
}
|
||||
|
||||
header('.skills Manifest');
|
||||
console.log(colors.muted(`Path: ${manifestPath}`));
|
||||
console.log('');
|
||||
|
||||
if (manifest.skills.length === 0) {
|
||||
console.log(colors.muted('No skills defined'));
|
||||
} else {
|
||||
console.log(colors.primary('Skills:'));
|
||||
for (const skill of manifest.skills) {
|
||||
const status = skill.enabled === false ? colors.muted('(disabled)') : '';
|
||||
console.log(` ${colors.success(symbols.bullet)} ${skill.source} ${status}`);
|
||||
if (skill.skills) {
|
||||
console.log(` ${colors.muted(`Skills: ${skill.skills.join(', ')}`)}`);
|
||||
}
|
||||
if (skill.agents) {
|
||||
console.log(` ${colors.muted(`Agents: ${skill.agents.join(', ')}`)}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
console.log('');
|
||||
|
||||
if (manifest.agents) {
|
||||
console.log(`${colors.muted('Default agents:')} ${manifest.agents.join(', ')}`);
|
||||
}
|
||||
|
||||
if (manifest.installMethod) {
|
||||
console.log(`${colors.muted('Install method:')} ${manifest.installMethod}`);
|
||||
}
|
||||
|
||||
if (manifest.updatedAt) {
|
||||
console.log(`${colors.muted('Updated:')} ${manifest.updatedAt}`);
|
||||
}
|
||||
|
||||
console.log('');
|
||||
console.log(colors.muted('Commands: init, add, remove, install, generate'));
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class ManifestInitCommand extends Command {
|
||||
static override paths = [['manifest', 'init']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Initialize a new .skills manifest',
|
||||
});
|
||||
|
||||
force = Option.Boolean('--force,-f', false, {
|
||||
description: 'Overwrite existing manifest',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const existingPath = findManifestPath();
|
||||
|
||||
if (existingPath && !this.force) {
|
||||
warn(`Manifest already exists: ${existingPath}`);
|
||||
console.log(colors.muted('Use --force to overwrite'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
initManifest();
|
||||
success('Created .skills manifest');
|
||||
console.log('');
|
||||
console.log(colors.muted('Add skills with:'));
|
||||
console.log(` ${colors.cyan('skillkit manifest add owner/repo')}`);
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class ManifestAddCommand extends Command {
|
||||
static override paths = [['manifest', 'add']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Add a skill source to the manifest',
|
||||
});
|
||||
|
||||
source = Option.String({ required: true });
|
||||
|
||||
skills = Option.String('--skills,-s', {
|
||||
description: 'Specific skills to include (comma-separated)',
|
||||
});
|
||||
|
||||
agents = Option.String('--agents,-a', {
|
||||
description: 'Target agents (comma-separated)',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const options: { skills?: string[]; agents?: string[] } = {};
|
||||
|
||||
if (this.skills) {
|
||||
options.skills = this.skills.split(',').map(s => s.trim());
|
||||
}
|
||||
|
||||
if (this.agents) {
|
||||
options.agents = this.agents.split(',').map(s => s.trim());
|
||||
}
|
||||
|
||||
addToManifest(this.source, options);
|
||||
success(`Added ${this.source} to manifest`);
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class ManifestRemoveCommand extends Command {
|
||||
static override paths = [['manifest', 'remove']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Remove a skill source from the manifest',
|
||||
});
|
||||
|
||||
source = Option.String({ required: true });
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const result = removeFromManifest(this.source);
|
||||
|
||||
if (!result) {
|
||||
error('No manifest found');
|
||||
return 1;
|
||||
}
|
||||
|
||||
success(`Removed ${this.source} from manifest`);
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class ManifestInstallCommand extends Command {
|
||||
static override paths = [['manifest', 'install']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Install all skills defined in the manifest',
|
||||
});
|
||||
|
||||
yes = Option.Boolean('--yes,-y', false, {
|
||||
description: 'Skip confirmation',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const manifest = loadManifest();
|
||||
|
||||
if (!manifest) {
|
||||
error('No .skills manifest found');
|
||||
console.log(colors.muted('Create one with: skillkit manifest init'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const enabledSkills = manifest.skills.filter(s => s.enabled !== false);
|
||||
|
||||
if (enabledSkills.length === 0) {
|
||||
warn('No skills to install');
|
||||
return 0;
|
||||
}
|
||||
|
||||
header('Install from Manifest');
|
||||
|
||||
console.log(`Installing ${enabledSkills.length} source(s):`);
|
||||
for (const skill of enabledSkills) {
|
||||
console.log(` ${colors.success(symbols.bullet)} ${skill.source}`);
|
||||
}
|
||||
console.log('');
|
||||
|
||||
if (!this.yes && process.stdin.isTTY) {
|
||||
const confirmResult = await confirm({
|
||||
message: 'Proceed with installation?',
|
||||
initialValue: true,
|
||||
});
|
||||
|
||||
if (isCancel(confirmResult) || !confirmResult) {
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
const s = spinner();
|
||||
|
||||
for (const skill of enabledSkills) {
|
||||
s.start(`Installing ${skill.source}...`);
|
||||
|
||||
try {
|
||||
const args = ['install', skill.source];
|
||||
|
||||
if (skill.skills) {
|
||||
args.push('--skills', skill.skills.join(','));
|
||||
}
|
||||
|
||||
if (skill.agents || manifest.agents) {
|
||||
const agents = skill.agents || manifest.agents || [];
|
||||
for (const agent of agents) {
|
||||
args.push('--agent', agent);
|
||||
}
|
||||
}
|
||||
|
||||
args.push('--yes');
|
||||
|
||||
const { execFileSync } = await import('node:child_process');
|
||||
execFileSync('skillkit', args, {
|
||||
stdio: 'pipe',
|
||||
encoding: 'utf-8',
|
||||
});
|
||||
|
||||
s.stop(`Installed ${skill.source}`);
|
||||
} catch (err) {
|
||||
s.stop(colors.error(`Failed: ${skill.source}`));
|
||||
if (err instanceof Error) {
|
||||
console.log(colors.muted(err.message));
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
success('Manifest installation complete');
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class ManifestGenerateCommand extends Command {
|
||||
static override paths = [['manifest', 'generate']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Generate manifest from currently installed skills',
|
||||
});
|
||||
|
||||
output = Option.String('--output,-o', {
|
||||
description: 'Output file path (default: .skills)',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const searchDirs = getSearchDirs();
|
||||
const installedSkills = findAllSkills(searchDirs);
|
||||
|
||||
if (installedSkills.length === 0) {
|
||||
warn('No installed skills found');
|
||||
return 0;
|
||||
}
|
||||
|
||||
step(`Found ${installedSkills.length} installed skill(s)`);
|
||||
|
||||
const skillsWithMeta = installedSkills.map(skill => {
|
||||
const metadata = loadSkillMetadata(skill.path);
|
||||
return {
|
||||
name: skill.name,
|
||||
source: metadata?.source || '',
|
||||
};
|
||||
}).filter(s => s.source);
|
||||
|
||||
const manifest = generateManifestFromInstalled(skillsWithMeta);
|
||||
|
||||
const outputPath = this.output || '.skills';
|
||||
saveManifest(manifest, outputPath);
|
||||
|
||||
success(`Generated ${outputPath} with ${manifest.skills.length} source(s)`);
|
||||
|
||||
console.log('');
|
||||
console.log(colors.muted('Commit this file to share skill configuration with your team.'));
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
@@ -1,14 +1,18 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import chalk from 'chalk';
|
||||
import ora from 'ora';
|
||||
import {
|
||||
createMarketplaceAggregator,
|
||||
type MarketplaceSearchOptions,
|
||||
} from '@skillkit/core';
|
||||
import {
|
||||
header,
|
||||
colors,
|
||||
spinner,
|
||||
warn,
|
||||
showMarketplaceInfo,
|
||||
showSkillList,
|
||||
progressBar,
|
||||
} from '../onboarding/index.js';
|
||||
|
||||
/**
|
||||
* Marketplace command - browse and install skills from the marketplace
|
||||
*/
|
||||
export class MarketplaceCommand extends Command {
|
||||
static override paths = [['marketplace'], ['market'], ['mp']];
|
||||
|
||||
@@ -51,6 +55,10 @@ export class MarketplaceCommand extends Command {
|
||||
description: 'Output as JSON',
|
||||
});
|
||||
|
||||
quiet = Option.Boolean('--quiet,-q', false, {
|
||||
description: 'Minimal output',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const marketplace = createMarketplaceAggregator();
|
||||
|
||||
@@ -73,11 +81,16 @@ export class MarketplaceCommand extends Command {
|
||||
}
|
||||
|
||||
private async browseMarketplace(marketplace: ReturnType<typeof createMarketplaceAggregator>): Promise<number> {
|
||||
const spinner = ora('Loading marketplace...').start();
|
||||
if (!this.quiet && !this.json) {
|
||||
header('Skill Marketplace');
|
||||
}
|
||||
|
||||
const s = spinner();
|
||||
s.start('Loading marketplace...');
|
||||
|
||||
try {
|
||||
const index = await marketplace.getIndex();
|
||||
spinner.stop();
|
||||
s.stop('Marketplace loaded');
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify({
|
||||
@@ -88,31 +101,31 @@ export class MarketplaceCommand extends Command {
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.bold('Skill Marketplace\n'));
|
||||
console.log(`Total skills: ${chalk.cyan(index.totalCount)}`);
|
||||
console.log(`Sources: ${chalk.cyan(index.sources.length)}`);
|
||||
console.log(`Last updated: ${chalk.dim(new Date(index.updatedAt).toLocaleString())}\n`);
|
||||
// Show marketplace info
|
||||
showMarketplaceInfo({
|
||||
totalSkills: index.totalCount,
|
||||
sourceCount: index.sources.length,
|
||||
lastUpdated: index.updatedAt,
|
||||
});
|
||||
|
||||
// Show featured skills
|
||||
console.log(colors.bold('Featured Skills:'));
|
||||
console.log('');
|
||||
|
||||
// Show sample skills
|
||||
console.log(chalk.bold('Featured Skills:\n'));
|
||||
const featured = index.skills.slice(0, 10);
|
||||
showSkillList(featured.map(skill => ({
|
||||
name: skill.name,
|
||||
description: skill.description,
|
||||
source: skill.source.name,
|
||||
})));
|
||||
|
||||
for (const skill of featured) {
|
||||
console.log(` ${chalk.cyan(skill.name)}`);
|
||||
if (skill.description) {
|
||||
console.log(` ${chalk.dim(skill.description.slice(0, 60))}${skill.description.length > 60 ? '...' : ''}`);
|
||||
}
|
||||
console.log(` ${chalk.dim(`Source: ${skill.source.name}`)}`);
|
||||
console.log();
|
||||
}
|
||||
|
||||
console.log(chalk.dim('Use "skillkit marketplace search <query>" to search for skills.'));
|
||||
console.log(chalk.dim('Use "skillkit marketplace tags" to see popular tags.'));
|
||||
console.log(colors.muted('Use "skillkit marketplace search <query>" to search for skills.'));
|
||||
console.log(colors.muted('Use "skillkit marketplace tags" to see popular tags.'));
|
||||
|
||||
return 0;
|
||||
} catch (error) {
|
||||
spinner.fail('Failed to load marketplace');
|
||||
console.error(chalk.red(error instanceof Error ? error.message : String(error)));
|
||||
} catch (err) {
|
||||
s.stop(colors.error('Failed to load marketplace'));
|
||||
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
@@ -120,12 +133,16 @@ export class MarketplaceCommand extends Command {
|
||||
private async searchSkills(marketplace: ReturnType<typeof createMarketplaceAggregator>): Promise<number> {
|
||||
const query = this.query || this.action;
|
||||
|
||||
if (!this.quiet && !this.json) {
|
||||
header('Search Skills');
|
||||
}
|
||||
|
||||
// Validate and parse limit
|
||||
let limit = 20;
|
||||
if (this.limit) {
|
||||
const parsed = parseInt(this.limit, 10);
|
||||
if (isNaN(parsed) || parsed <= 0) {
|
||||
console.error(chalk.red('Invalid --limit value. Must be a positive number.'));
|
||||
console.log(colors.error('Invalid --limit value. Must be a positive number.'));
|
||||
return 1;
|
||||
}
|
||||
limit = parsed;
|
||||
@@ -137,7 +154,8 @@ export class MarketplaceCommand extends Command {
|
||||
.map((t) => t.trim())
|
||||
.filter((t) => t.length > 0);
|
||||
|
||||
const spinner = ora(`Searching for "${query}"...`).start();
|
||||
const s = spinner();
|
||||
s.start(`Searching for "${query}"...`);
|
||||
|
||||
try {
|
||||
const options: MarketplaceSearchOptions = {
|
||||
@@ -148,7 +166,7 @@ export class MarketplaceCommand extends Command {
|
||||
};
|
||||
|
||||
const result = await marketplace.search(options);
|
||||
spinner.stop();
|
||||
s.stop(`Found ${result.total} skill(s)`);
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(result));
|
||||
@@ -156,77 +174,94 @@ export class MarketplaceCommand extends Command {
|
||||
}
|
||||
|
||||
if (result.skills.length === 0) {
|
||||
console.log(chalk.yellow(`No skills found${query ? ` matching "${query}"` : ''}.`));
|
||||
warn(`No skills found${query ? ` matching "${query}"` : ''}.`);
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.bold(`Found ${result.total} skill(s):\n`));
|
||||
console.log('');
|
||||
console.log(colors.bold(`Found ${result.total} skill(s):`));
|
||||
console.log('');
|
||||
|
||||
for (const skill of result.skills) {
|
||||
console.log(`${chalk.cyan(skill.name)} ${chalk.dim(`(${skill.source.name})`)}`);
|
||||
if (skill.description) {
|
||||
console.log(` ${skill.description}`);
|
||||
}
|
||||
if (skill.tags.length > 0) {
|
||||
console.log(` Tags: ${chalk.dim(skill.tags.join(', '))}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
showSkillList(result.skills.map(skill => ({
|
||||
name: skill.name,
|
||||
description: skill.description,
|
||||
source: skill.source.name,
|
||||
})));
|
||||
|
||||
if (result.total > result.skills.length) {
|
||||
console.log(chalk.dim(`Showing ${result.skills.length} of ${result.total} results. Use --limit to see more.`));
|
||||
console.log(colors.muted(`Showing ${result.skills.length} of ${result.total} results. Use --limit to see more.`));
|
||||
}
|
||||
|
||||
return 0;
|
||||
} catch (error) {
|
||||
spinner.fail('Search failed');
|
||||
console.error(chalk.red(error instanceof Error ? error.message : String(error)));
|
||||
} catch (err) {
|
||||
s.stop(colors.error('Search failed'));
|
||||
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async refreshIndex(marketplace: ReturnType<typeof createMarketplaceAggregator>): Promise<number> {
|
||||
const spinner = ora('Refreshing marketplace index...').start();
|
||||
if (!this.quiet) {
|
||||
header('Refresh Marketplace');
|
||||
}
|
||||
|
||||
const s = spinner();
|
||||
s.start('Refreshing marketplace index...');
|
||||
|
||||
try {
|
||||
const index = await marketplace.refresh();
|
||||
spinner.succeed(`Marketplace refreshed: ${index.totalCount} skills from ${index.sources.length} sources`);
|
||||
s.stop(`Refreshed: ${index.totalCount} skills from ${index.sources.length} sources`);
|
||||
return 0;
|
||||
} catch (error) {
|
||||
spinner.fail('Refresh failed');
|
||||
console.error(chalk.red(error instanceof Error ? error.message : String(error)));
|
||||
} catch (err) {
|
||||
s.stop(colors.error('Refresh failed'));
|
||||
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async showTags(marketplace: ReturnType<typeof createMarketplaceAggregator>): Promise<number> {
|
||||
const spinner = ora('Loading tags...').start();
|
||||
if (!this.quiet && !this.json) {
|
||||
header('Popular Tags');
|
||||
}
|
||||
|
||||
const s = spinner();
|
||||
s.start('Loading tags...');
|
||||
|
||||
try {
|
||||
const tags = await marketplace.getPopularTags(30);
|
||||
spinner.stop();
|
||||
s.stop('Tags loaded');
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(tags));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.bold('Popular Tags:\n'));
|
||||
console.log('');
|
||||
console.log(colors.bold('Popular Tags:'));
|
||||
console.log('');
|
||||
|
||||
const maxCount = Math.max(...tags.map(t => t.count));
|
||||
|
||||
for (const { tag, count } of tags) {
|
||||
const bar = '█'.repeat(Math.min(count, 20));
|
||||
console.log(` ${tag.padEnd(15)} ${chalk.cyan(bar)} ${count}`);
|
||||
const bar = progressBar(count, maxCount, 20);
|
||||
console.log(` ${tag.padEnd(15)} ${colors.dim(bar)} ${colors.muted(String(count))}`);
|
||||
}
|
||||
|
||||
console.log('');
|
||||
|
||||
return 0;
|
||||
} catch (error) {
|
||||
spinner.fail('Failed to load tags');
|
||||
console.error(chalk.red(error instanceof Error ? error.message : String(error)));
|
||||
} catch (err) {
|
||||
s.stop(colors.error('Failed to load tags'));
|
||||
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
private async showSources(marketplace: ReturnType<typeof createMarketplaceAggregator>): Promise<number> {
|
||||
if (!this.quiet && !this.json) {
|
||||
header('Skill Sources');
|
||||
}
|
||||
|
||||
const sources = marketplace.getSources();
|
||||
|
||||
if (this.json) {
|
||||
@@ -234,15 +269,18 @@ export class MarketplaceCommand extends Command {
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.bold('Skill Sources:\n'));
|
||||
console.log('');
|
||||
console.log(colors.bold('Skill Sources:'));
|
||||
console.log('');
|
||||
|
||||
for (const source of sources) {
|
||||
console.log(`${chalk.cyan(source.name)} ${source.official ? chalk.green('(official)') : ''}`);
|
||||
console.log(` ${chalk.dim(`${source.owner}/${source.repo}`)}`);
|
||||
const officialBadge = source.official ? colors.success(' (official)') : '';
|
||||
console.log(`${colors.cyan(source.name)}${officialBadge}`);
|
||||
console.log(` ${colors.muted(`${source.owner}/${source.repo}`)}`);
|
||||
if (source.description) {
|
||||
console.log(` ${source.description}`);
|
||||
}
|
||||
console.log();
|
||||
console.log('');
|
||||
}
|
||||
|
||||
return 0;
|
||||
|
||||
@@ -1,7 +1,5 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { resolve } from 'node:path';
|
||||
import chalk from 'chalk';
|
||||
import ora from 'ora';
|
||||
import {
|
||||
type ProjectProfile,
|
||||
type ScoredSkill,
|
||||
@@ -14,10 +12,18 @@ import {
|
||||
INDEX_PATH,
|
||||
KNOWN_SKILL_REPOS,
|
||||
} from '@skillkit/core';
|
||||
import {
|
||||
header,
|
||||
colors,
|
||||
symbols,
|
||||
spinner,
|
||||
warn,
|
||||
showProjectSummary,
|
||||
progressBar,
|
||||
formatQualityBadge,
|
||||
getQualityGradeFromScore,
|
||||
} from '../onboarding/index.js';
|
||||
|
||||
/**
|
||||
* Recommend command - get smart skill recommendations based on project analysis
|
||||
*/
|
||||
export class RecommendCommand extends Command {
|
||||
static override paths = [['recommend'], ['rec']];
|
||||
|
||||
@@ -97,6 +103,11 @@ export class RecommendCommand extends Command {
|
||||
description: 'Project path (default: current directory)',
|
||||
});
|
||||
|
||||
// Quiet mode
|
||||
quiet = Option.Boolean('--quiet,-q', false, {
|
||||
description: 'Minimal output',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const targetPath = resolve(this.projectPath || process.cwd());
|
||||
|
||||
@@ -105,19 +116,23 @@ export class RecommendCommand extends Command {
|
||||
return await this.updateIndex();
|
||||
}
|
||||
|
||||
if (!this.quiet && !this.json) {
|
||||
header('Skill Recommendations');
|
||||
}
|
||||
|
||||
// Load or create project profile
|
||||
const profile = await this.getProjectProfile(targetPath);
|
||||
if (!profile) {
|
||||
console.error(chalk.red('Failed to analyze project'));
|
||||
console.log(colors.error('Failed to analyze project'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
// Load skill index
|
||||
const index = this.loadIndex();
|
||||
if (!index || index.skills.length === 0) {
|
||||
console.log(chalk.yellow('No skill index found.'));
|
||||
console.log(chalk.dim('Run "skillkit recommend --update" to fetch skills from known sources.'));
|
||||
console.log(chalk.dim('Or install skills manually with "skillkit install <source>"\n'));
|
||||
warn('No skill index found.');
|
||||
console.log(colors.muted('Run "skillkit recommend --update" to fetch skills from known sources.'));
|
||||
console.log(colors.muted('Or install skills manually with "skillkit install <source>"\n'));
|
||||
|
||||
// Still show project profile
|
||||
this.showProjectProfile(profile);
|
||||
@@ -153,19 +168,20 @@ export class RecommendCommand extends Command {
|
||||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get project profile from context or by analyzing project
|
||||
*/
|
||||
private async getProjectProfile(projectPath: string): Promise<ProjectProfile | null> {
|
||||
const manager = new ContextManager(projectPath);
|
||||
let context = manager.get();
|
||||
|
||||
if (!context) {
|
||||
// Auto-analyze project
|
||||
if (!this.json) {
|
||||
console.log(chalk.dim('Analyzing project...\n'));
|
||||
if (!this.json && !this.quiet) {
|
||||
const s = spinner();
|
||||
s.start('Analyzing project...');
|
||||
context = manager.init();
|
||||
s.stop('Project analyzed');
|
||||
} else {
|
||||
context = manager.init();
|
||||
}
|
||||
context = manager.init();
|
||||
}
|
||||
|
||||
if (!context) {
|
||||
@@ -183,33 +199,18 @@ export class RecommendCommand extends Command {
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Show project profile summary
|
||||
*/
|
||||
private showProjectProfile(profile: ProjectProfile): void {
|
||||
console.log(chalk.cyan('Project Profile:'));
|
||||
console.log(` Name: ${chalk.bold(profile.name)}`);
|
||||
if (profile.type) {
|
||||
console.log(` Type: ${profile.type}`);
|
||||
}
|
||||
const languages = profile.stack.languages.map(l => `${l.name}${l.version ? ` ${l.version}` : ''}`);
|
||||
const frameworks = profile.stack.frameworks.map(f => `${f.name}${f.version ? ` ${f.version}` : ''}`);
|
||||
|
||||
const stackItems: string[] = [];
|
||||
for (const lang of profile.stack.languages) {
|
||||
stackItems.push(`${lang.name}${lang.version ? ` ${lang.version}` : ''}`);
|
||||
}
|
||||
for (const fw of profile.stack.frameworks) {
|
||||
stackItems.push(`${fw.name}${fw.version ? ` ${fw.version}` : ''}`);
|
||||
}
|
||||
|
||||
if (stackItems.length > 0) {
|
||||
console.log(` Stack: ${chalk.dim(stackItems.join(', '))}`);
|
||||
}
|
||||
console.log();
|
||||
showProjectSummary({
|
||||
name: profile.name,
|
||||
type: profile.type,
|
||||
languages,
|
||||
frameworks,
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Display recommendations
|
||||
*/
|
||||
private displayRecommendations(
|
||||
recommendations: ScoredSkill[],
|
||||
profile: ProjectProfile,
|
||||
@@ -219,59 +220,67 @@ export class RecommendCommand extends Command {
|
||||
this.showProjectProfile(profile);
|
||||
|
||||
if (recommendations.length === 0) {
|
||||
console.log(chalk.yellow('No matching skills found.'));
|
||||
console.log(chalk.dim('Try lowering the minimum score with --min-score'));
|
||||
warn('No matching skills found.');
|
||||
console.log(colors.muted('Try lowering the minimum score with --min-score'));
|
||||
return;
|
||||
}
|
||||
|
||||
console.log(chalk.cyan(`Recommended Skills (${recommendations.length} of ${totalScanned} scanned):\n`));
|
||||
console.log(colors.bold(`Recommended Skills (${recommendations.length} of ${totalScanned} scanned):`));
|
||||
console.log('');
|
||||
|
||||
for (const rec of recommendations) {
|
||||
const scoreColor = rec.score >= 70 ? chalk.green : rec.score >= 50 ? chalk.yellow : chalk.dim;
|
||||
const scoreBar = this.getScoreBar(rec.score);
|
||||
let scoreColor: (text: string) => string;
|
||||
if (rec.score >= 70) {
|
||||
scoreColor = colors.success;
|
||||
} else if (rec.score >= 50) {
|
||||
scoreColor = colors.warning;
|
||||
} else {
|
||||
scoreColor = colors.muted;
|
||||
}
|
||||
const scoreBar = progressBar(rec.score, 100, 10);
|
||||
const qualityScore = rec.skill.quality ?? null;
|
||||
const qualityDisplay = qualityScore !== null && qualityScore !== undefined
|
||||
? ` ${formatQualityBadge(qualityScore)}`
|
||||
: '';
|
||||
|
||||
console.log(` ${scoreColor(`${rec.score}%`)} ${scoreBar} ${chalk.bold(rec.skill.name)}`);
|
||||
console.log(` ${scoreColor(`${rec.score}%`)} ${colors.dim(scoreBar)} ${colors.bold(rec.skill.name)}${qualityDisplay}`);
|
||||
|
||||
if (rec.skill.description) {
|
||||
console.log(` ${chalk.dim(truncate(rec.skill.description, 70))}`);
|
||||
console.log(` ${colors.muted(truncate(rec.skill.description, 70))}`);
|
||||
}
|
||||
|
||||
if (rec.skill.source) {
|
||||
console.log(` ${chalk.dim('Source:')} ${rec.skill.source}`);
|
||||
console.log(` ${colors.dim('Source:')} ${rec.skill.source}`);
|
||||
}
|
||||
|
||||
if (this.verbose && rec.reasons.length > 0) {
|
||||
console.log(chalk.dim(' Reasons:'));
|
||||
console.log(colors.dim(' Reasons:'));
|
||||
for (const reason of rec.reasons.filter(r => r.weight > 0)) {
|
||||
console.log(` ${chalk.dim('•')} ${reason.description} (+${reason.weight})`);
|
||||
console.log(` ${colors.muted(symbols.stepActive)} ${reason.description} (+${reason.weight})`);
|
||||
}
|
||||
if (qualityScore !== null && qualityScore !== undefined) {
|
||||
const grade = getQualityGradeFromScore(qualityScore);
|
||||
console.log(` ${colors.muted(symbols.stepActive)} Quality: ${qualityScore}/100 (${grade})`);
|
||||
}
|
||||
}
|
||||
|
||||
if (rec.warnings.length > 0) {
|
||||
for (const warning of rec.warnings) {
|
||||
console.log(` ${chalk.yellow('⚠')} ${warning}`);
|
||||
console.log(` ${colors.warning(symbols.warning)} ${warning}`);
|
||||
}
|
||||
}
|
||||
|
||||
console.log();
|
||||
console.log('');
|
||||
}
|
||||
|
||||
console.log(chalk.dim('Install with: skillkit install <source>'));
|
||||
console.log(colors.muted('Install with: skillkit install <source>'));
|
||||
}
|
||||
|
||||
/**
|
||||
* Generate a visual score bar
|
||||
*/
|
||||
private getScoreBar(score: number): string {
|
||||
const filled = Math.round(score / 10);
|
||||
const empty = 10 - filled;
|
||||
return chalk.green('█'.repeat(filled)) + chalk.dim('░'.repeat(empty));
|
||||
}
|
||||
|
||||
/**
|
||||
* Handle search mode
|
||||
*/
|
||||
private handleSearch(engine: RecommendationEngine, query: string): number {
|
||||
if (!this.quiet && !this.json) {
|
||||
header(`Search: "${query}"`);
|
||||
}
|
||||
|
||||
const results = engine.search({
|
||||
query,
|
||||
limit: this.limit ? parseInt(this.limit, 10) : 10,
|
||||
@@ -287,35 +296,41 @@ export class RecommendCommand extends Command {
|
||||
}
|
||||
|
||||
if (results.length === 0) {
|
||||
console.log(chalk.yellow(`No skills found matching "${query}"`));
|
||||
warn(`No skills found matching "${query}"`);
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.cyan(`Search results for "${query}" (${results.length} found):\n`));
|
||||
console.log('');
|
||||
console.log(colors.bold(`Search results for "${query}" (${results.length} found):`));
|
||||
console.log('');
|
||||
|
||||
for (const result of results) {
|
||||
const relevanceColor =
|
||||
result.relevance >= 70 ? chalk.green : result.relevance >= 50 ? chalk.yellow : chalk.dim;
|
||||
let relevanceColor: (text: string) => string;
|
||||
if (result.relevance >= 70) {
|
||||
relevanceColor = colors.success;
|
||||
} else if (result.relevance >= 50) {
|
||||
relevanceColor = colors.warning;
|
||||
} else {
|
||||
relevanceColor = colors.muted;
|
||||
}
|
||||
const relevanceBar = progressBar(result.relevance, 100, 10);
|
||||
|
||||
console.log(` ${relevanceColor(`${result.relevance}%`)} ${chalk.bold(result.skill.name)}`);
|
||||
console.log(` ${relevanceColor(`${result.relevance}%`)} ${colors.dim(relevanceBar)} ${colors.bold(result.skill.name)}`);
|
||||
|
||||
if (result.snippet) {
|
||||
console.log(` ${chalk.dim(result.snippet)}`);
|
||||
console.log(` ${colors.muted(result.snippet)}`);
|
||||
}
|
||||
|
||||
if (result.matchedTerms.length > 0) {
|
||||
console.log(` ${chalk.dim('Matched:')} ${result.matchedTerms.join(', ')}`);
|
||||
console.log(` ${colors.dim('Matched:')} ${result.matchedTerms.join(', ')}`);
|
||||
}
|
||||
|
||||
console.log();
|
||||
console.log('');
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
* Load skill index from cache
|
||||
*/
|
||||
private loadIndex() {
|
||||
const index = loadIndexFromCache();
|
||||
|
||||
@@ -324,63 +339,62 @@ export class RecommendCommand extends Command {
|
||||
}
|
||||
|
||||
// Check if index is stale
|
||||
if (isIndexStale(index) && !this.json) {
|
||||
if (isIndexStale(index) && !this.json && !this.quiet) {
|
||||
const lastUpdated = new Date(index.lastUpdated);
|
||||
const hoursSinceUpdate = (Date.now() - lastUpdated.getTime()) / (1000 * 60 * 60);
|
||||
console.log(
|
||||
chalk.dim(`Index is ${Math.round(hoursSinceUpdate)} hours old. Run --update to refresh.\n`)
|
||||
colors.muted(`Index is ${Math.round(hoursSinceUpdate)} hours old. Run --update to refresh.\n`)
|
||||
);
|
||||
}
|
||||
|
||||
return index;
|
||||
}
|
||||
|
||||
/**
|
||||
* Update skill index from sources
|
||||
*/
|
||||
private async updateIndex(): Promise<number> {
|
||||
console.log(chalk.cyan('Updating skill index from GitHub repositories...\n'));
|
||||
console.log(chalk.dim(`Sources: ${KNOWN_SKILL_REPOS.map(r => `${r.owner}/${r.repo}`).join(', ')}\n`));
|
||||
if (!this.quiet) {
|
||||
header('Update Skill Index');
|
||||
}
|
||||
|
||||
const spinner = ora('Fetching skills...').start();
|
||||
console.log(colors.muted(`Sources: ${KNOWN_SKILL_REPOS.map(r => `${r.owner}/${r.repo}`).join(', ')}\n`));
|
||||
|
||||
const s = spinner();
|
||||
s.start('Fetching skills...');
|
||||
|
||||
try {
|
||||
const { index, errors } = await buildSkillIndex(KNOWN_SKILL_REPOS, (message) => {
|
||||
spinner.text = message;
|
||||
s.message(message);
|
||||
});
|
||||
|
||||
spinner.stop();
|
||||
s.stop(`Fetched ${index.skills.length} skills`);
|
||||
|
||||
// Report any errors
|
||||
if (errors.length > 0) {
|
||||
console.log(chalk.yellow('\nWarnings:'));
|
||||
console.log('');
|
||||
console.log(colors.warning('Warnings:'));
|
||||
for (const error of errors) {
|
||||
console.log(chalk.dim(` • ${error}`));
|
||||
console.log(colors.muted(` ${symbols.stepActive} ${error}`));
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
// Save the index
|
||||
saveIndex(index);
|
||||
|
||||
console.log(chalk.green(`✓ Updated index with ${index.skills.length} skills`));
|
||||
console.log('');
|
||||
console.log(colors.success(`${symbols.success} Updated index with ${index.skills.length} skills`));
|
||||
if (index.sources.length > 0) {
|
||||
console.log(chalk.dim(` Sources: ${index.sources.map((s) => s.name).join(', ')}`));
|
||||
console.log(colors.muted(` Sources: ${index.sources.map((s) => s.name).join(', ')}`));
|
||||
}
|
||||
console.log(chalk.dim(` Saved to: ${INDEX_PATH}\n`));
|
||||
console.log(colors.muted(` Saved to: ${INDEX_PATH}\n`));
|
||||
|
||||
return 0;
|
||||
} catch (error) {
|
||||
spinner.fail('Failed to update index');
|
||||
console.error(chalk.red(error instanceof Error ? error.message : String(error)));
|
||||
} catch (err) {
|
||||
s.stop(colors.error('Failed to update index'));
|
||||
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Truncate string to max length
|
||||
*/
|
||||
function truncate(str: string, maxLen: number): string {
|
||||
if (str.length <= maxLen) return str;
|
||||
return str.slice(0, maxLen - 3) + '...';
|
||||
|
||||
@@ -1,11 +1,24 @@
|
||||
import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
|
||||
import { dirname } from 'node:path';
|
||||
import chalk from 'chalk';
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { loadConfig, findAllSkills } from '@skillkit/core';
|
||||
import type { AgentType } from '@skillkit/core';
|
||||
import { getAdapter, detectAgent } from '@skillkit/agents';
|
||||
import { getAdapter, detectAgent, getAllAdapters } from '@skillkit/agents';
|
||||
import { getSearchDirs, getAgentConfigPath } from '../helpers.js';
|
||||
import {
|
||||
header,
|
||||
colors,
|
||||
symbols,
|
||||
formatAgent,
|
||||
isCancel,
|
||||
spinner,
|
||||
select,
|
||||
confirm,
|
||||
outro,
|
||||
cancel,
|
||||
warn,
|
||||
showSyncSummary,
|
||||
} from '../onboarding/index.js';
|
||||
|
||||
export class SyncCommand extends Command {
|
||||
static override paths = [['sync'], ['s']];
|
||||
@@ -36,19 +49,54 @@ export class SyncCommand extends Command {
|
||||
description: 'Skip confirmation prompts',
|
||||
});
|
||||
|
||||
quiet = Option.Boolean('--quiet,-q', false, {
|
||||
description: 'Minimal output',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const isInteractive = process.stdin.isTTY && !this.yes;
|
||||
|
||||
if (!this.quiet) {
|
||||
header('Sync Skills');
|
||||
}
|
||||
|
||||
try {
|
||||
let agentType: AgentType;
|
||||
const s = spinner();
|
||||
|
||||
if (this.agent) {
|
||||
agentType = this.agent as AgentType;
|
||||
} else if (isInteractive) {
|
||||
// Let user select agent
|
||||
s.start('Detecting agent...');
|
||||
const config = loadConfig();
|
||||
const detected = config.agent || (await detectAgent());
|
||||
s.stop(`Detected: ${formatAgent(detected)}`);
|
||||
|
||||
const allAgents = getAllAdapters().map(a => a.type);
|
||||
|
||||
const agentResult = await select({
|
||||
message: 'Sync to which agent?',
|
||||
options: allAgents.map(a => ({
|
||||
value: a,
|
||||
label: formatAgent(a),
|
||||
hint: a === detected ? '(current)' : undefined,
|
||||
})),
|
||||
initialValue: detected,
|
||||
});
|
||||
|
||||
if (isCancel(agentResult)) {
|
||||
cancel('Sync cancelled');
|
||||
return 0;
|
||||
}
|
||||
|
||||
agentType = agentResult as AgentType;
|
||||
} else {
|
||||
const config = loadConfig();
|
||||
agentType = config.agent || (await detectAgent());
|
||||
}
|
||||
|
||||
const adapter = getAdapter(agentType);
|
||||
|
||||
const outputPath = this.output || getAgentConfigPath(agentType);
|
||||
|
||||
const searchDirs = getSearchDirs(agentType);
|
||||
@@ -59,23 +107,47 @@ export class SyncCommand extends Command {
|
||||
}
|
||||
|
||||
if (skills.length === 0) {
|
||||
console.log(chalk.yellow('No skills found to sync'));
|
||||
console.log(chalk.dim('Install skills with: skillkit install <source>'));
|
||||
warn('No skills found to sync');
|
||||
console.log(colors.muted('Install skills with: skillkit install <source>'));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.cyan(`Syncing ${skills.length} skill(s) for ${adapter.name}:`));
|
||||
skills.forEach(s => {
|
||||
const status = s.enabled ? chalk.green('✓') : chalk.dim('○');
|
||||
const location = s.location === 'project' ? chalk.blue('[project]') : chalk.dim('[global]');
|
||||
console.log(` ${status} ${s.name} ${location}`);
|
||||
});
|
||||
console.log();
|
||||
// Show skills to sync
|
||||
if (!this.quiet) {
|
||||
console.log('');
|
||||
console.log(colors.bold(`Syncing ${skills.length} skill(s) for ${adapter.name}:`));
|
||||
console.log('');
|
||||
|
||||
for (const skill of skills) {
|
||||
const status = skill.enabled ? colors.success(symbols.success) : colors.muted(symbols.stepPending);
|
||||
const location = skill.location === 'project'
|
||||
? colors.cyan('[project]')
|
||||
: colors.muted('[global]');
|
||||
console.log(` ${status} ${skill.name} ${location}`);
|
||||
}
|
||||
console.log('');
|
||||
}
|
||||
|
||||
// Confirm sync
|
||||
if (isInteractive && !this.yes) {
|
||||
const confirmResult = await confirm({
|
||||
message: `Sync ${skills.length} skill(s) to ${outputPath}?`,
|
||||
initialValue: true,
|
||||
});
|
||||
|
||||
if (isCancel(confirmResult) || !confirmResult) {
|
||||
cancel('Sync cancelled');
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
// Generate and write config
|
||||
s.start('Generating config...');
|
||||
|
||||
const config = adapter.generateConfig(skills);
|
||||
|
||||
if (!config) {
|
||||
console.log(chalk.yellow('No configuration generated'));
|
||||
s.stop('No configuration generated');
|
||||
return 0;
|
||||
}
|
||||
|
||||
@@ -93,13 +165,23 @@ export class SyncCommand extends Command {
|
||||
|
||||
writeFileSync(outputPath, newContent, 'utf-8');
|
||||
|
||||
console.log(chalk.green(`Synced to ${outputPath}`));
|
||||
console.log(chalk.dim(`Agent: ${adapter.name}`));
|
||||
s.stop('Config generated');
|
||||
|
||||
// Show summary
|
||||
showSyncSummary({
|
||||
skillCount: skills.length,
|
||||
agentType,
|
||||
configPath: outputPath,
|
||||
});
|
||||
|
||||
if (!this.quiet) {
|
||||
outro('Sync complete!');
|
||||
}
|
||||
|
||||
return 0;
|
||||
} catch (error) {
|
||||
console.error(chalk.red('Sync failed'));
|
||||
console.error(chalk.dim(error instanceof Error ? error.message : String(error)));
|
||||
} catch (err) {
|
||||
console.log(colors.error('Sync failed'));
|
||||
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -36,8 +36,11 @@ export class UICommand extends Command {
|
||||
if (err instanceof Error) {
|
||||
console.error('Error launching TUI:', err.message);
|
||||
console.error('');
|
||||
console.error('Make sure you are running with Bun (>=1.2.0):');
|
||||
console.error(' bun skillkit ui');
|
||||
console.error('The TUI requires Bun runtime (>=1.2.0). Run with:');
|
||||
console.error(' bun $(which skillkit) ui');
|
||||
console.error('');
|
||||
console.error('Or from source directory:');
|
||||
console.error(' bun ./apps/skillkit/dist/cli.js ui');
|
||||
console.error('');
|
||||
console.error('Install Bun from: https://bun.sh');
|
||||
}
|
||||
|
||||
@@ -1,87 +1,441 @@
|
||||
import { existsSync, readdirSync } from 'node:fs';
|
||||
import { join, basename } from 'node:path';
|
||||
import chalk from 'chalk';
|
||||
import { existsSync, readdirSync, statSync } from 'node:fs';
|
||||
import { join, basename, resolve, dirname } from 'node:path';
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { validateSkill } from '@skillkit/core';
|
||||
import {
|
||||
validateSkill,
|
||||
evaluateSkillFile,
|
||||
evaluateSkillDirectory,
|
||||
getQualityGrade,
|
||||
isHighQuality,
|
||||
findAllSkills,
|
||||
benchmarkSkill,
|
||||
type QualityScore,
|
||||
type BenchmarkResult,
|
||||
} from '@skillkit/core';
|
||||
import { getSearchDirs } from '../helpers.js';
|
||||
import {
|
||||
colors,
|
||||
symbols,
|
||||
spinner,
|
||||
success,
|
||||
warn,
|
||||
error,
|
||||
header,
|
||||
} from '../onboarding/index.js';
|
||||
|
||||
function formatScore(score: number): string {
|
||||
if (score >= 80) return colors.success(`${score}`);
|
||||
if (score >= 60) return colors.warning(`${score}`);
|
||||
return colors.error(`${score}`);
|
||||
}
|
||||
|
||||
function formatGrade(grade: string): string {
|
||||
switch (grade) {
|
||||
case 'A':
|
||||
case 'B':
|
||||
return colors.success(grade);
|
||||
case 'C':
|
||||
case 'D':
|
||||
return colors.warning(grade);
|
||||
default:
|
||||
return colors.error(grade);
|
||||
}
|
||||
}
|
||||
|
||||
function printQualityReport(name: string, quality: QualityScore, verbose: boolean): void {
|
||||
const grade = getQualityGrade(quality.overall);
|
||||
const gradeDisplay = formatGrade(grade);
|
||||
const scoreDisplay = formatScore(quality.overall);
|
||||
|
||||
console.log(`\n${colors.primary(name)}`);
|
||||
console.log(` Grade: ${gradeDisplay} Score: ${scoreDisplay}/100`);
|
||||
|
||||
if (verbose) {
|
||||
console.log('');
|
||||
console.log(` ${colors.muted('Structure:')} ${formatScore(quality.structure.score)}/100`);
|
||||
console.log(` ${quality.structure.hasMetadata ? colors.success(symbols.success) : colors.error(symbols.error)} Metadata`);
|
||||
console.log(` ${quality.structure.hasDescription ? colors.success(symbols.success) : colors.error(symbols.error)} Description`);
|
||||
console.log(` ${quality.structure.hasTriggers ? colors.success(symbols.success) : colors.error(symbols.error)} Trigger conditions`);
|
||||
console.log(` ${quality.structure.hasExamples ? colors.success(symbols.success) : colors.error(symbols.error)} Code examples`);
|
||||
console.log(` ${quality.structure.hasBoundaries ? colors.success(symbols.success) : colors.error(symbols.error)} Boundaries defined`);
|
||||
|
||||
console.log('');
|
||||
console.log(` ${colors.muted('Clarity:')} ${formatScore(quality.clarity.score)}/100`);
|
||||
console.log(` Lines: ${quality.clarity.lineCount}${quality.clarity.lineCount > 300 ? colors.warning(' (consider splitting)') : ''}`);
|
||||
console.log(` Tokens: ${quality.clarity.tokenCount}${quality.clarity.tokenCount > 2000 ? colors.warning(' (high)') : ''}`);
|
||||
console.log(` ${quality.clarity.hasHeaders ? colors.success(symbols.success) : colors.error(symbols.error)} Uses headers`);
|
||||
|
||||
console.log('');
|
||||
console.log(` ${colors.muted('Specificity:')} ${formatScore(quality.specificity.score)}/100`);
|
||||
console.log(` ${quality.specificity.hasConcreteCommands ? colors.success(symbols.success) : colors.error(symbols.error)} Concrete commands`);
|
||||
console.log(` ${quality.specificity.hasFilePatterns ? colors.success(symbols.success) : colors.error(symbols.error)} File patterns`);
|
||||
console.log(` ${quality.specificity.hasCodeExamples ? colors.success(symbols.success) : colors.error(symbols.error)} Multiple code examples`);
|
||||
if (quality.specificity.vagueTermCount > 0) {
|
||||
console.log(` ${colors.warning(symbols.warning)} ${quality.specificity.vagueTermCount} vague term(s)`);
|
||||
}
|
||||
|
||||
console.log('');
|
||||
console.log(` ${colors.muted('Advanced:')} ${formatScore(quality.advanced.score)}/100`);
|
||||
if (quality.advanced.deprecatedPatterns.length > 0) {
|
||||
console.log(` ${colors.warning(symbols.warning)} ${quality.advanced.deprecatedPatterns.length} deprecated pattern(s)`);
|
||||
for (const pattern of quality.advanced.deprecatedPatterns) {
|
||||
console.log(` ${colors.muted(symbols.bullet)} ${pattern}`);
|
||||
}
|
||||
}
|
||||
if (quality.advanced.securityIssues.length > 0) {
|
||||
console.log(` ${colors.error(symbols.error)} ${quality.advanced.securityIssues.length} security issue(s)`);
|
||||
for (const issue of quality.advanced.securityIssues) {
|
||||
console.log(` ${colors.muted(symbols.bullet)} ${issue}`);
|
||||
}
|
||||
}
|
||||
if (quality.advanced.conflictingInstructions.length > 0) {
|
||||
console.log(` ${colors.warning(symbols.warning)} ${quality.advanced.conflictingInstructions.length} conflicting instruction(s)`);
|
||||
}
|
||||
console.log(` Completeness: ${quality.advanced.completeness.score}/100`);
|
||||
console.log(` Example coverage: ${quality.advanced.completeness.exampleCoverage}%`);
|
||||
if (quality.advanced.completeness.hasTodos) {
|
||||
console.log(` ${colors.warning(symbols.warning)} ${quality.advanced.completeness.todoCount} TODO/FIXME comment(s)`);
|
||||
}
|
||||
}
|
||||
|
||||
if (quality.warnings.length > 0) {
|
||||
console.log('');
|
||||
console.log(` ${colors.warning('Warnings:')}`);
|
||||
for (const w of quality.warnings) {
|
||||
console.log(` ${colors.warning(symbols.warning)} ${w}`);
|
||||
}
|
||||
}
|
||||
|
||||
if (quality.suggestions.length > 0 && verbose) {
|
||||
console.log('');
|
||||
console.log(` ${colors.muted('Suggestions:')}`);
|
||||
for (const s of quality.suggestions) {
|
||||
console.log(` ${colors.muted(symbols.bullet)} ${s}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
function printBenchmarkReport(benchmark: BenchmarkResult): void {
|
||||
console.log('');
|
||||
console.log(colors.bold('Benchmark Comparison'));
|
||||
console.log('');
|
||||
|
||||
console.log(` ${colors.muted('Your Score:')} ${formatScore(benchmark.score)}/100 ${formatGrade(benchmark.grade)}`);
|
||||
console.log(` ${colors.muted('Category Average:')} ${benchmark.categoryAvg}/100`);
|
||||
console.log(` ${colors.muted('Top Skill Score:')} ${benchmark.topSkillScore}/100`);
|
||||
console.log(` ${colors.muted('Percentile:')} ${benchmark.percentile}${getOrdinal(benchmark.percentile)}`);
|
||||
|
||||
if (benchmark.comparisonNotes.length > 0) {
|
||||
console.log('');
|
||||
console.log(` ${colors.muted('Comparison:')}`);
|
||||
for (const note of benchmark.comparisonNotes) {
|
||||
console.log(` ${colors.muted(symbols.bullet)} ${note}`);
|
||||
}
|
||||
}
|
||||
|
||||
if (benchmark.recommendations.length > 0) {
|
||||
console.log('');
|
||||
console.log(` ${colors.muted('To Improve:')}`);
|
||||
for (const rec of benchmark.recommendations) {
|
||||
console.log(` ${colors.info(symbols.info)} ${rec}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
function getOrdinal(n: number): string {
|
||||
const s = ['th', 'st', 'nd', 'rd'];
|
||||
const v = n % 100;
|
||||
return s[(v - 20) % 10] || s[v] || s[0];
|
||||
}
|
||||
|
||||
export class ValidateCommand extends Command {
|
||||
static override paths = [['validate'], ['v']];
|
||||
static override paths = [['validate']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Validate skill(s) against the Agent Skills specification (agentskills.io)',
|
||||
description: 'Validate skill format and quality',
|
||||
details: `
|
||||
Validates skills against the specification and evaluates quality.
|
||||
Quality scores are based on structure, clarity, and specificity.
|
||||
`,
|
||||
examples: [
|
||||
['Validate a skill directory', '$0 validate ./my-skill'],
|
||||
['Validate all skills in a directory', '$0 validate ./skills --all'],
|
||||
['Validate all installed skills', '$0 validate'],
|
||||
['Validate specific skill', '$0 validate my-skill'],
|
||||
['Validate skill file', '$0 validate ./path/to/SKILL.md'],
|
||||
['Detailed quality report', '$0 validate --verbose'],
|
||||
['Only show issues', '$0 validate --issues'],
|
||||
['Quality check only', '$0 validate --quality'],
|
||||
['JSON output', '$0 validate --json'],
|
||||
],
|
||||
});
|
||||
|
||||
skillPath = Option.String({ required: true });
|
||||
targets = Option.Rest();
|
||||
|
||||
verbose = Option.Boolean('--verbose,-v', false, {
|
||||
description: 'Show detailed quality breakdown',
|
||||
});
|
||||
|
||||
quality = Option.Boolean('--quality,-q', false, {
|
||||
description: 'Only check quality (skip format validation)',
|
||||
});
|
||||
|
||||
issues = Option.Boolean('--issues,-i', false, {
|
||||
description: 'Only show skills with issues',
|
||||
});
|
||||
|
||||
minScore = Option.String('--min-score,-m', {
|
||||
description: 'Minimum acceptable score (default: 60)',
|
||||
});
|
||||
|
||||
json = Option.Boolean('--json', false, {
|
||||
description: 'Output as JSON',
|
||||
});
|
||||
|
||||
all = Option.Boolean('--all,-a', false, {
|
||||
description: 'Validate all skills in the directory',
|
||||
description: 'Validate all skills in directory',
|
||||
});
|
||||
|
||||
benchmark = Option.Boolean('--benchmark,-b', false, {
|
||||
description: 'Compare skill against category leaders',
|
||||
});
|
||||
|
||||
fix = Option.Boolean('--fix', false, {
|
||||
description: 'Automatically fix common quality issues (runs fix command)',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const targetPath = this.skillPath;
|
||||
|
||||
if (!existsSync(targetPath)) {
|
||||
console.error(chalk.red(`Path does not exist: ${targetPath}`));
|
||||
return 1;
|
||||
if (this.fix) {
|
||||
if (this.targets.length === 0) {
|
||||
error('--fix requires at least one target');
|
||||
console.log(colors.muted('Usage: skillkit validate --fix <skill-name>'));
|
||||
return 1;
|
||||
}
|
||||
const { FixCommand } = await import('./fix.js');
|
||||
const fixCmd = new FixCommand();
|
||||
fixCmd.targets = this.targets;
|
||||
fixCmd.yes = false;
|
||||
return fixCmd.execute();
|
||||
}
|
||||
|
||||
const skillPaths: string[] = [];
|
||||
let minScore = 60;
|
||||
if (this.minScore) {
|
||||
const parsed = parseInt(this.minScore, 10);
|
||||
if (Number.isNaN(parsed) || parsed < 0 || parsed > 100) {
|
||||
if (!this.json) {
|
||||
warn(`Invalid --min-score value "${this.minScore}", using default: 60`);
|
||||
}
|
||||
} else {
|
||||
minScore = parsed;
|
||||
}
|
||||
}
|
||||
const results: Array<{ name: string; quality: QualityScore | null; formatValid: boolean; formatErrors: string[]; path?: string }> = [];
|
||||
|
||||
if (this.all) {
|
||||
const entries = readdirSync(targetPath, { withFileTypes: true });
|
||||
for (const entry of entries) {
|
||||
if (entry.isDirectory()) {
|
||||
const skillPath = join(targetPath, entry.name);
|
||||
if (existsSync(join(skillPath, 'SKILL.md'))) {
|
||||
skillPaths.push(skillPath);
|
||||
if (this.targets.length > 0) {
|
||||
for (const target of this.targets) {
|
||||
const resolved = resolve(target);
|
||||
|
||||
if (existsSync(resolved)) {
|
||||
const isDirectory = statSync(resolved).isDirectory();
|
||||
if (this.all) {
|
||||
if (!isDirectory) {
|
||||
if (!this.json) {
|
||||
warn(`--all requires a directory, but "${target}" is a file`);
|
||||
}
|
||||
continue;
|
||||
}
|
||||
const entries = readdirSync(resolved, { withFileTypes: true });
|
||||
for (const entry of entries) {
|
||||
if (entry.isDirectory()) {
|
||||
const skillPath = join(resolved, entry.name);
|
||||
const hasSkillMd = existsSync(join(skillPath, 'SKILL.md'));
|
||||
const hasIndexMdc = existsSync(join(skillPath, 'index.mdc'));
|
||||
const hasNamedMdc = existsSync(join(skillPath, `${entry.name}.mdc`));
|
||||
if (hasSkillMd || hasIndexMdc || hasNamedMdc) {
|
||||
const formatResult = this.quality ? { valid: true, errors: [] } : validateSkill(skillPath);
|
||||
const quality = evaluateSkillDirectory(skillPath);
|
||||
results.push({
|
||||
name: entry.name,
|
||||
quality,
|
||||
formatValid: formatResult.valid,
|
||||
formatErrors: formatResult.errors || [],
|
||||
path: skillPath,
|
||||
});
|
||||
}
|
||||
}
|
||||
}
|
||||
} else {
|
||||
const isFile = resolved.endsWith('.md') || resolved.endsWith('.mdc');
|
||||
const skillDir = isFile ? dirname(resolved) : resolved;
|
||||
const formatResult = this.quality ? { valid: true, errors: [] } : validateSkill(skillDir);
|
||||
const quality = isFile ? evaluateSkillFile(resolved) : evaluateSkillDirectory(resolved);
|
||||
results.push({
|
||||
name: basename(target),
|
||||
quality,
|
||||
formatValid: formatResult.valid,
|
||||
formatErrors: formatResult.errors || [],
|
||||
path: resolved,
|
||||
});
|
||||
}
|
||||
} else {
|
||||
const searchDirs = getSearchDirs();
|
||||
const skills = findAllSkills(searchDirs);
|
||||
const found = skills.find(s => s.name === target);
|
||||
|
||||
if (found) {
|
||||
const formatResult = this.quality ? { valid: true, errors: [] } : validateSkill(found.path);
|
||||
const quality = evaluateSkillDirectory(found.path);
|
||||
results.push({
|
||||
name: found.name,
|
||||
quality,
|
||||
formatValid: formatResult.valid,
|
||||
formatErrors: formatResult.errors || [],
|
||||
path: found.path,
|
||||
});
|
||||
} else {
|
||||
if (!this.json) {
|
||||
warn(`Skill not found: ${target}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if (skillPaths.length === 0) {
|
||||
console.error(chalk.yellow('No skills found in directory'));
|
||||
return 1;
|
||||
}
|
||||
} else {
|
||||
skillPaths.push(targetPath);
|
||||
}
|
||||
const searchDirs = getSearchDirs();
|
||||
const skills = findAllSkills(searchDirs);
|
||||
|
||||
let hasErrors = false;
|
||||
|
||||
for (const skillPath of skillPaths) {
|
||||
const skillName = basename(skillPath);
|
||||
const result = validateSkill(skillPath);
|
||||
|
||||
if (result.valid) {
|
||||
console.log(chalk.green(`✓ ${skillName}`));
|
||||
|
||||
if (result.warnings && result.warnings.length > 0) {
|
||||
result.warnings.forEach(w => {
|
||||
console.log(chalk.yellow(` ⚠ ${w}`));
|
||||
});
|
||||
if (skills.length === 0) {
|
||||
if (!this.json) {
|
||||
warn('No installed skills found');
|
||||
}
|
||||
} else {
|
||||
console.log(chalk.red(`✗ ${skillName}`));
|
||||
result.errors.forEach(e => {
|
||||
console.log(chalk.red(` • ${e}`));
|
||||
return 0;
|
||||
}
|
||||
|
||||
const s = spinner();
|
||||
if (!this.json) {
|
||||
s.start(`Evaluating ${skills.length} skill(s)...`);
|
||||
}
|
||||
|
||||
for (const skill of skills) {
|
||||
const formatResult = this.quality ? { valid: true, errors: [] } : validateSkill(skill.path);
|
||||
const quality = evaluateSkillDirectory(skill.path);
|
||||
results.push({
|
||||
name: skill.name,
|
||||
quality,
|
||||
formatValid: formatResult.valid,
|
||||
formatErrors: formatResult.errors || [],
|
||||
path: skill.path,
|
||||
});
|
||||
hasErrors = true;
|
||||
}
|
||||
|
||||
if (!this.json) {
|
||||
s.stop(`Evaluated ${results.length} skill(s)`);
|
||||
}
|
||||
}
|
||||
|
||||
console.log();
|
||||
|
||||
if (hasErrors) {
|
||||
console.log(chalk.red('Validation failed'));
|
||||
console.log(chalk.dim('See https://agentskills.io/specification for the complete format'));
|
||||
if (results.length === 0) {
|
||||
if (!this.json) {
|
||||
error('No skills to validate');
|
||||
}
|
||||
return 1;
|
||||
}
|
||||
|
||||
console.log(chalk.green(`Validated ${skillPaths.length} skill(s) successfully`));
|
||||
if (this.json) {
|
||||
const output = results.map(r => {
|
||||
const result: Record<string, unknown> = {
|
||||
name: r.name,
|
||||
path: r.path,
|
||||
formatValid: r.formatValid,
|
||||
formatErrors: r.formatErrors,
|
||||
score: r.quality?.overall ?? null,
|
||||
grade: r.quality ? getQualityGrade(r.quality.overall) : null,
|
||||
highQuality: r.quality ? isHighQuality(r.quality) : false,
|
||||
structure: r.quality?.structure ?? null,
|
||||
clarity: r.quality?.clarity ?? null,
|
||||
specificity: r.quality?.specificity ?? null,
|
||||
advanced: r.quality?.advanced ?? null,
|
||||
warnings: r.quality?.warnings ?? [],
|
||||
suggestions: r.quality?.suggestions ?? [],
|
||||
};
|
||||
if (this.benchmark && r.quality) {
|
||||
result.benchmark = benchmarkSkill(r.name, r.quality);
|
||||
}
|
||||
return result;
|
||||
});
|
||||
console.log(JSON.stringify(output, null, 2));
|
||||
const hasFormatFailures = results.some(r => !r.formatValid);
|
||||
const hasBelowThreshold = results.some(r => r.quality && r.quality.overall < minScore);
|
||||
return hasFormatFailures || hasBelowThreshold ? 1 : 0;
|
||||
}
|
||||
|
||||
header('Skill Validation Report');
|
||||
|
||||
let filteredResults = results;
|
||||
if (this.issues) {
|
||||
filteredResults = results.filter(r =>
|
||||
!r.formatValid ||
|
||||
(r.quality && r.quality.overall < minScore) ||
|
||||
(r.quality && r.quality.warnings.length > 0)
|
||||
);
|
||||
}
|
||||
|
||||
filteredResults.sort((a, b) => (b.quality?.overall ?? 0) - (a.quality?.overall ?? 0));
|
||||
|
||||
for (const { name, quality, formatValid, formatErrors } of filteredResults) {
|
||||
if (!formatValid) {
|
||||
console.log(`\n${colors.error(symbols.error)} ${colors.primary(name)}`);
|
||||
console.log(` ${colors.error('Format validation failed:')}`);
|
||||
for (const err of formatErrors) {
|
||||
console.log(` ${colors.error(symbols.bullet)} ${err}`);
|
||||
}
|
||||
}
|
||||
|
||||
if (quality) {
|
||||
printQualityReport(name, quality, this.verbose);
|
||||
|
||||
if (this.benchmark) {
|
||||
const benchmark = benchmarkSkill(name, quality);
|
||||
printBenchmarkReport(benchmark);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
console.log('');
|
||||
|
||||
const formatFailed = results.filter(r => !r.formatValid).length;
|
||||
const withQuality = results.filter(r => r.quality !== null);
|
||||
const highQuality = withQuality.filter(r => r.quality!.overall >= 80).length;
|
||||
const passing = withQuality.filter(r => r.quality!.overall >= minScore).length;
|
||||
const failing = withQuality.filter(r => r.quality!.overall < minScore).length;
|
||||
|
||||
console.log(colors.muted('Summary:'));
|
||||
|
||||
if (!this.quality) {
|
||||
console.log(` ${formatFailed === 0 ? colors.success(symbols.success) : colors.error(symbols.error)} Format valid: ${results.length - formatFailed}/${results.length}`);
|
||||
}
|
||||
|
||||
console.log(` ${colors.success(symbols.success)} High quality (80+): ${highQuality}`);
|
||||
console.log(` ${colors.primary(symbols.bullet)} Passing (${minScore}+): ${passing}`);
|
||||
|
||||
if (failing > 0) {
|
||||
console.log(` ${colors.error(symbols.error)} Below threshold: ${failing}`);
|
||||
}
|
||||
|
||||
if (withQuality.length > 0) {
|
||||
const avgScore = Math.round(withQuality.reduce((sum, r) => sum + r.quality!.overall, 0) / withQuality.length);
|
||||
console.log(` ${colors.muted('Average score:')} ${formatScore(avgScore)}/100`);
|
||||
}
|
||||
|
||||
if (formatFailed > 0 || failing > 0) {
|
||||
console.log('');
|
||||
if (formatFailed > 0) {
|
||||
warn(`${formatFailed} skill(s) failed format validation`);
|
||||
}
|
||||
if (failing > 0) {
|
||||
warn(`${failing} skill(s) below quality threshold`);
|
||||
}
|
||||
return 1;
|
||||
}
|
||||
|
||||
console.log('');
|
||||
success('All skills validated successfully');
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,239 @@
|
||||
export {
|
||||
AGENT_ICONS,
|
||||
AGENT_NAMES,
|
||||
symbols,
|
||||
SPINNER_FRAMES,
|
||||
colors,
|
||||
formatAgent,
|
||||
getAgentIcon,
|
||||
formatAgentIconsInline,
|
||||
progressBar,
|
||||
formatScore,
|
||||
formatQualityBadge,
|
||||
formatQualityBadgeCompact,
|
||||
getQualityGradeFromScore,
|
||||
} from './theme.js';
|
||||
|
||||
export {
|
||||
getLogo,
|
||||
getFullLogo,
|
||||
getCompactLogo,
|
||||
getMinimalLogo,
|
||||
getHeader,
|
||||
getDivider,
|
||||
} from './logo.js';
|
||||
|
||||
export * as prompts from './prompts.js';
|
||||
export {
|
||||
isCancel,
|
||||
intro,
|
||||
outro,
|
||||
cancel,
|
||||
note,
|
||||
log,
|
||||
step,
|
||||
success,
|
||||
warn,
|
||||
error,
|
||||
spinner,
|
||||
text,
|
||||
password,
|
||||
confirm,
|
||||
select,
|
||||
agentMultiselect,
|
||||
quickAgentSelect,
|
||||
skillMultiselect,
|
||||
groupMultiselect,
|
||||
stepTrail,
|
||||
selectInstallMethod,
|
||||
tasks,
|
||||
summaryBox,
|
||||
type SkillOption,
|
||||
} from './prompts.js';
|
||||
|
||||
export {
|
||||
showInstallSummary,
|
||||
showNextSteps,
|
||||
showAgentSummary,
|
||||
showProjectSummary,
|
||||
showSyncSummary,
|
||||
showSkillList,
|
||||
showMarketplaceInfo,
|
||||
type InstallResult,
|
||||
type InstallSummary,
|
||||
} from './summary.js';
|
||||
|
||||
export {
|
||||
loadPreferences,
|
||||
savePreferences,
|
||||
isOnboardingComplete,
|
||||
completeOnboarding,
|
||||
saveLastAgents,
|
||||
getLastAgents,
|
||||
saveInstallMethod,
|
||||
getInstallMethod,
|
||||
getPreferencesDir,
|
||||
getPreferencesPath,
|
||||
type UserPreferences,
|
||||
} from './preferences.js';
|
||||
|
||||
import { getLogo, getHeader } from './logo.js';
|
||||
import * as prompts from './prompts.js';
|
||||
import { colors, formatAgent } from './theme.js';
|
||||
import { showNextSteps } from './summary.js';
|
||||
import {
|
||||
completeOnboarding,
|
||||
saveLastAgents,
|
||||
getLastAgents,
|
||||
} from './preferences.js';
|
||||
|
||||
let VERSION = '1.7.6';
|
||||
let AGENT_COUNT = 17;
|
||||
|
||||
export function setVersion(version: string): void {
|
||||
VERSION = version;
|
||||
}
|
||||
|
||||
export function setAgentCount(count: number): void {
|
||||
AGENT_COUNT = count;
|
||||
}
|
||||
|
||||
export function welcome(): void {
|
||||
console.log(getLogo(VERSION, AGENT_COUNT));
|
||||
}
|
||||
|
||||
export function header(title: string): void {
|
||||
console.log(getHeader(title));
|
||||
}
|
||||
|
||||
export async function runOnboarding(detectedAgents: string[]): Promise<{
|
||||
selectedAgents: string[];
|
||||
cancelled: boolean;
|
||||
}> {
|
||||
welcome();
|
||||
|
||||
if (detectedAgents.length === 0) {
|
||||
prompts.warn('No agents detected');
|
||||
completeOnboarding();
|
||||
return { selectedAgents: [], cancelled: false };
|
||||
}
|
||||
|
||||
prompts.log(`Detected ${detectedAgents.length} agent${detectedAgents.length !== 1 ? 's' : ''}: ${detectedAgents.map(formatAgent).join(', ')}`);
|
||||
|
||||
const agentResult = await prompts.agentMultiselect({
|
||||
message: 'Select agents to configure',
|
||||
agents: detectedAgents,
|
||||
initialValues: detectedAgents,
|
||||
});
|
||||
|
||||
if (prompts.isCancel(agentResult)) {
|
||||
prompts.cancel('Setup cancelled');
|
||||
return { selectedAgents: [], cancelled: true };
|
||||
}
|
||||
|
||||
saveLastAgents(agentResult as string[]);
|
||||
completeOnboarding();
|
||||
|
||||
prompts.success(`Configured ${agentResult.length} agent${agentResult.length !== 1 ? 's' : ''}`);
|
||||
|
||||
return { selectedAgents: agentResult as string[], cancelled: false };
|
||||
}
|
||||
|
||||
export interface InstallFlowOptions {
|
||||
source: string;
|
||||
discoveredSkills: Array<{ name: string; path: string }>;
|
||||
detectedAgents: string[];
|
||||
showLogo?: boolean;
|
||||
}
|
||||
|
||||
export interface InstallFlowResult {
|
||||
selectedSkills: string[];
|
||||
selectedAgents: string[];
|
||||
installMethod: 'symlink' | 'copy';
|
||||
cancelled: boolean;
|
||||
}
|
||||
|
||||
export async function runInstallFlow(options: InstallFlowOptions): Promise<InstallFlowResult> {
|
||||
const { source, discoveredSkills, detectedAgents, showLogo = true } = options;
|
||||
|
||||
if (showLogo) {
|
||||
welcome();
|
||||
}
|
||||
|
||||
prompts.step(`Source: ${colors.cyan(source)}`);
|
||||
prompts.step(`Found ${discoveredSkills.length} skill${discoveredSkills.length !== 1 ? 's' : ''}`);
|
||||
|
||||
const skillNames = discoveredSkills.map(s => s.name);
|
||||
const skillResult = await prompts.skillMultiselect({
|
||||
message: 'Select skills to install',
|
||||
skills: discoveredSkills.map(s => ({ name: s.name })),
|
||||
initialValues: skillNames,
|
||||
});
|
||||
|
||||
if (prompts.isCancel(skillResult)) {
|
||||
prompts.cancel('Installation cancelled');
|
||||
return { selectedSkills: [], selectedAgents: [], installMethod: 'symlink', cancelled: true };
|
||||
}
|
||||
|
||||
if (detectedAgents.length > 1) {
|
||||
prompts.step(`Detected ${detectedAgents.length} agents`);
|
||||
}
|
||||
|
||||
const lastAgents = getLastAgents();
|
||||
const initialAgents = lastAgents.length > 0 ? lastAgents : detectedAgents;
|
||||
|
||||
const agentResult = await prompts.agentMultiselect({
|
||||
message: 'Install to which agents?',
|
||||
agents: detectedAgents,
|
||||
initialValues: initialAgents.filter(a => detectedAgents.includes(a)),
|
||||
});
|
||||
|
||||
if (prompts.isCancel(agentResult)) {
|
||||
prompts.cancel('Installation cancelled');
|
||||
return { selectedSkills: skillResult as string[], selectedAgents: [], installMethod: 'symlink', cancelled: true };
|
||||
}
|
||||
|
||||
saveLastAgents(agentResult as string[]);
|
||||
|
||||
const methodResult = await prompts.selectInstallMethod({
|
||||
message: 'Installation method',
|
||||
});
|
||||
|
||||
if (prompts.isCancel(methodResult)) {
|
||||
prompts.cancel('Installation cancelled');
|
||||
return {
|
||||
selectedSkills: skillResult as string[],
|
||||
selectedAgents: agentResult as string[],
|
||||
installMethod: 'symlink',
|
||||
cancelled: true,
|
||||
};
|
||||
}
|
||||
|
||||
return {
|
||||
selectedSkills: skillResult as string[],
|
||||
selectedAgents: agentResult as string[],
|
||||
installMethod: methodResult as 'symlink' | 'copy',
|
||||
cancelled: false,
|
||||
};
|
||||
}
|
||||
|
||||
export function showCompletion(options: {
|
||||
skillNames: string[];
|
||||
agentTypes: string[];
|
||||
action?: 'install' | 'sync' | 'init';
|
||||
}): void {
|
||||
const action = options.action || 'install';
|
||||
const messages: Record<string, string> = {
|
||||
install: 'Installation complete!',
|
||||
sync: 'Sync complete!',
|
||||
init: 'Initialization complete!',
|
||||
};
|
||||
|
||||
prompts.outro(messages[action] || 'Done!');
|
||||
showNextSteps(options);
|
||||
}
|
||||
|
||||
export function handleCancel(message?: string): void {
|
||||
prompts.cancel(message || 'Operation cancelled');
|
||||
process.exit(0);
|
||||
}
|
||||
@@ -0,0 +1,86 @@
|
||||
import pc from 'picocolors';
|
||||
import { symbols } from './theme.js';
|
||||
|
||||
function getTerminalWidth(): number {
|
||||
return process.stdout.columns || 80;
|
||||
}
|
||||
|
||||
export function getFullLogo(version?: string, agentCount?: number): string {
|
||||
const lines = [
|
||||
'',
|
||||
pc.dim(' ') + pc.white('███████╗') + pc.gray('██╗ ██╗') + pc.dim('██╗') + pc.gray('██╗ ') + pc.dim('██╗ ') + pc.white('██╗ ██╗') + pc.gray('██╗') + pc.dim('████████╗'),
|
||||
pc.dim(' ') + pc.white('██╔════╝') + pc.gray('██║ ██╔╝') + pc.dim('██║') + pc.gray('██║ ') + pc.dim('██║ ') + pc.white('██║ ██╔╝') + pc.gray('██║') + pc.dim('╚══██╔══╝'),
|
||||
pc.dim(' ') + pc.white('███████╗') + pc.gray('█████╔╝ ') + pc.dim('██║') + pc.gray('██║ ') + pc.dim('██║ ') + pc.white('█████╔╝ ') + pc.gray('██║') + pc.dim(' ██║ '),
|
||||
pc.dim(' ') + pc.white('╚════██║') + pc.gray('██╔═██╗ ') + pc.dim('██║') + pc.gray('██║ ') + pc.dim('██║ ') + pc.white('██╔═██╗ ') + pc.gray('██║') + pc.dim(' ██║ '),
|
||||
pc.dim(' ') + pc.white('███████║') + pc.gray('██║ ██╗') + pc.dim('██║') + pc.gray('███████╗') + pc.dim('███████╗') + pc.white('██║ ██╗') + pc.gray('██║') + pc.dim(' ██║ '),
|
||||
pc.dim(' ') + pc.white('╚══════╝') + pc.gray('╚═╝ ╚═╝') + pc.dim('╚═╝') + pc.gray('╚══════╝') + pc.dim('╚══════╝') + pc.white('╚═╝ ╚═╝') + pc.gray('╚═╝') + pc.dim(' ╚═╝ '),
|
||||
'',
|
||||
];
|
||||
|
||||
if (version || agentCount) {
|
||||
const info: string[] = [];
|
||||
if (version) info.push(`v${version}`);
|
||||
if (agentCount) info.push(`${agentCount} agents`);
|
||||
lines.push(pc.dim(' ') + pc.dim(info.join(' │ ')));
|
||||
lines.push('');
|
||||
}
|
||||
|
||||
return lines.join('\n');
|
||||
}
|
||||
|
||||
export function getCompactLogo(version?: string, agentCount?: number): string {
|
||||
const frame = `${symbols.frameCorner}${symbols.frameLine.repeat(18)}${symbols.frameCorner}`;
|
||||
|
||||
const lines = [
|
||||
'',
|
||||
pc.dim(` ${frame}`),
|
||||
pc.dim(' ') + pc.white(' S K I L L K I T '),
|
||||
pc.dim(` ${frame}`),
|
||||
];
|
||||
|
||||
if (version || agentCount) {
|
||||
const info: string[] = [];
|
||||
if (version) info.push(`v${version}`);
|
||||
if (agentCount) info.push(`${agentCount} agents`);
|
||||
lines.push(pc.dim(' ') + pc.dim(info.join(' │ ')));
|
||||
}
|
||||
|
||||
lines.push('');
|
||||
return lines.join('\n');
|
||||
}
|
||||
|
||||
export function getMinimalLogo(version?: string): string {
|
||||
const lines = [
|
||||
'',
|
||||
pc.dim(`${symbols.diamondOpen}───`) + pc.white('SKILLKIT') + pc.dim(`───${symbols.diamondOpen}`),
|
||||
];
|
||||
|
||||
if (version) {
|
||||
lines.push(pc.dim(` v${version}`));
|
||||
}
|
||||
|
||||
lines.push('');
|
||||
return lines.join('\n');
|
||||
}
|
||||
|
||||
export function getLogo(version?: string, agentCount?: number): string {
|
||||
const width = getTerminalWidth();
|
||||
|
||||
if (width >= 70) {
|
||||
return getFullLogo(version, agentCount);
|
||||
}
|
||||
if (width >= 50) {
|
||||
return getCompactLogo(version, agentCount);
|
||||
}
|
||||
return getMinimalLogo(version);
|
||||
}
|
||||
|
||||
export function getHeader(title: string): string {
|
||||
return `\n${pc.dim(symbols.diamondOpen)} ${pc.white(pc.bold('SkillKit'))} ${pc.dim('│')} ${pc.cyan(title)}\n`;
|
||||
}
|
||||
|
||||
export function getDivider(width?: number): string {
|
||||
const fallback = Math.min(getTerminalWidth() - 4, 60);
|
||||
const w = Math.max(1, width ?? fallback);
|
||||
return pc.dim(symbols.horizontalLine.repeat(w));
|
||||
}
|
||||
@@ -0,0 +1,97 @@
|
||||
import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import { homedir } from 'node:os';
|
||||
|
||||
const SKILLKIT_DIR = join(homedir(), '.skillkit');
|
||||
const PREFERENCES_FILE = join(SKILLKIT_DIR, 'preferences.json');
|
||||
|
||||
export interface UserPreferences {
|
||||
onboardingComplete: boolean;
|
||||
lastSelectedAgents: string[];
|
||||
defaultInstallMethod: 'symlink' | 'copy';
|
||||
outputFormat: 'pretty' | 'json';
|
||||
lastAccessed: string;
|
||||
version?: string;
|
||||
}
|
||||
|
||||
const DEFAULT_PREFERENCES: UserPreferences = {
|
||||
onboardingComplete: false,
|
||||
lastSelectedAgents: [],
|
||||
defaultInstallMethod: 'symlink',
|
||||
outputFormat: 'pretty',
|
||||
lastAccessed: new Date().toISOString(),
|
||||
};
|
||||
|
||||
function ensureDir(): void {
|
||||
if (!existsSync(SKILLKIT_DIR)) {
|
||||
mkdirSync(SKILLKIT_DIR, { recursive: true });
|
||||
}
|
||||
}
|
||||
|
||||
export function loadPreferences(): UserPreferences {
|
||||
try {
|
||||
if (!existsSync(PREFERENCES_FILE)) {
|
||||
return { ...DEFAULT_PREFERENCES };
|
||||
}
|
||||
|
||||
const content = readFileSync(PREFERENCES_FILE, 'utf-8');
|
||||
const data = JSON.parse(content);
|
||||
|
||||
return {
|
||||
...DEFAULT_PREFERENCES,
|
||||
...data,
|
||||
lastAccessed: new Date().toISOString(),
|
||||
};
|
||||
} catch {
|
||||
return { ...DEFAULT_PREFERENCES };
|
||||
}
|
||||
}
|
||||
|
||||
export function savePreferences(prefs: Partial<UserPreferences>): void {
|
||||
try {
|
||||
ensureDir();
|
||||
|
||||
const current = loadPreferences();
|
||||
const updated: UserPreferences = {
|
||||
...current,
|
||||
...prefs,
|
||||
lastAccessed: new Date().toISOString(),
|
||||
};
|
||||
|
||||
writeFileSync(PREFERENCES_FILE, JSON.stringify(updated, null, 2), 'utf-8');
|
||||
} catch {
|
||||
// Silently fail - preferences are not critical
|
||||
}
|
||||
}
|
||||
|
||||
export function isOnboardingComplete(): boolean {
|
||||
return loadPreferences().onboardingComplete;
|
||||
}
|
||||
|
||||
export function completeOnboarding(): void {
|
||||
savePreferences({ onboardingComplete: true });
|
||||
}
|
||||
|
||||
export function saveLastAgents(agents: string[]): void {
|
||||
savePreferences({ lastSelectedAgents: agents });
|
||||
}
|
||||
|
||||
export function getLastAgents(): string[] {
|
||||
return loadPreferences().lastSelectedAgents;
|
||||
}
|
||||
|
||||
export function saveInstallMethod(method: 'symlink' | 'copy'): void {
|
||||
savePreferences({ defaultInstallMethod: method });
|
||||
}
|
||||
|
||||
export function getInstallMethod(): 'symlink' | 'copy' {
|
||||
return loadPreferences().defaultInstallMethod;
|
||||
}
|
||||
|
||||
export function getPreferencesDir(): string {
|
||||
return SKILLKIT_DIR;
|
||||
}
|
||||
|
||||
export function getPreferencesPath(): string {
|
||||
return PREFERENCES_FILE;
|
||||
}
|
||||
@@ -0,0 +1,309 @@
|
||||
import * as clack from '@clack/prompts';
|
||||
import pc from 'picocolors';
|
||||
import { symbols, colors, formatAgent, formatScore } from './theme.js';
|
||||
|
||||
export function isCancel(value: unknown): value is symbol {
|
||||
return clack.isCancel(value);
|
||||
}
|
||||
|
||||
export function intro(message?: string): void {
|
||||
clack.intro(message ? pc.bold(message) : undefined);
|
||||
}
|
||||
|
||||
export function outro(message: string): void {
|
||||
clack.outro(pc.green(message));
|
||||
}
|
||||
|
||||
export function cancel(message: string = 'Operation cancelled'): void {
|
||||
clack.cancel(pc.yellow(message));
|
||||
}
|
||||
|
||||
export function note(message: string, title?: string): void {
|
||||
clack.note(message, title);
|
||||
}
|
||||
|
||||
export function log(message: string): void {
|
||||
clack.log.info(message);
|
||||
}
|
||||
|
||||
export function step(message: string): void {
|
||||
clack.log.step(message);
|
||||
}
|
||||
|
||||
export function success(message: string): void {
|
||||
clack.log.success(pc.green(message));
|
||||
}
|
||||
|
||||
export function warn(message: string): void {
|
||||
clack.log.warn(pc.yellow(message));
|
||||
}
|
||||
|
||||
export function error(message: string): void {
|
||||
clack.log.error(pc.red(message));
|
||||
}
|
||||
|
||||
export function spinner(): ReturnType<typeof clack.spinner> {
|
||||
return clack.spinner();
|
||||
}
|
||||
|
||||
export async function text(options: {
|
||||
message: string;
|
||||
placeholder?: string;
|
||||
defaultValue?: string;
|
||||
validate?: (value: string) => string | Error | undefined;
|
||||
}): Promise<string | symbol> {
|
||||
return clack.text({
|
||||
message: options.message,
|
||||
placeholder: options.placeholder,
|
||||
defaultValue: options.defaultValue,
|
||||
validate: options.validate,
|
||||
});
|
||||
}
|
||||
|
||||
export async function password(options: {
|
||||
message: string;
|
||||
validate?: (value: string) => string | Error | undefined;
|
||||
}): Promise<string | symbol> {
|
||||
return clack.password({
|
||||
message: options.message,
|
||||
validate: options.validate,
|
||||
});
|
||||
}
|
||||
|
||||
export async function confirm(options: {
|
||||
message: string;
|
||||
initialValue?: boolean;
|
||||
}): Promise<boolean | symbol> {
|
||||
return clack.confirm({
|
||||
message: options.message,
|
||||
initialValue: options.initialValue,
|
||||
});
|
||||
}
|
||||
|
||||
export async function select<T extends string>(options: {
|
||||
message: string;
|
||||
options: Array<{ value: T; label: string; hint?: string }>;
|
||||
initialValue?: T;
|
||||
}): Promise<T | symbol> {
|
||||
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
||||
return clack.select({
|
||||
message: options.message,
|
||||
options: options.options as any,
|
||||
initialValue: options.initialValue,
|
||||
});
|
||||
}
|
||||
|
||||
export async function agentMultiselect(options: {
|
||||
message: string;
|
||||
agents: string[];
|
||||
initialValues?: string[];
|
||||
required?: boolean;
|
||||
}): Promise<string[] | symbol> {
|
||||
const agentOptions = options.agents.map((agent) => ({
|
||||
value: agent,
|
||||
label: formatAgent(agent),
|
||||
hint: undefined as string | undefined,
|
||||
}));
|
||||
|
||||
return clack.multiselect({
|
||||
message: options.message,
|
||||
options: agentOptions,
|
||||
initialValues: options.initialValues,
|
||||
required: options.required ?? true,
|
||||
});
|
||||
}
|
||||
|
||||
export async function quickAgentSelect(options: {
|
||||
message?: string;
|
||||
agents: string[];
|
||||
lastSelected?: string[];
|
||||
}): Promise<{ agents: string[]; method: 'last' | 'all' | 'select' } | symbol> {
|
||||
const { agents, lastSelected = [] } = options;
|
||||
const hasLast = lastSelected.length > 0 && lastSelected.some(a => agents.includes(a));
|
||||
|
||||
const selectOptions: Array<{ value: string; label: string; hint?: string }> = [];
|
||||
|
||||
if (hasLast) {
|
||||
const validLast = lastSelected.filter(a => agents.includes(a));
|
||||
const agentList = validLast.slice(0, 3).map(formatAgent).join(', ');
|
||||
const more = validLast.length > 3 ? ` +${validLast.length - 3}` : '';
|
||||
|
||||
selectOptions.push({
|
||||
value: 'last',
|
||||
label: `Same as last time (Recommended)`,
|
||||
hint: `${agentList}${more}`,
|
||||
});
|
||||
}
|
||||
|
||||
selectOptions.push({
|
||||
value: 'all',
|
||||
label: 'All detected agents',
|
||||
hint: `${agents.length} agent${agents.length !== 1 ? 's' : ''}`,
|
||||
});
|
||||
|
||||
selectOptions.push({
|
||||
value: 'select',
|
||||
label: 'Select specific agents',
|
||||
hint: 'Choose manually',
|
||||
});
|
||||
|
||||
const result = await clack.select({
|
||||
message: options.message || 'Install to',
|
||||
options: selectOptions,
|
||||
});
|
||||
|
||||
if (clack.isCancel(result)) {
|
||||
return result;
|
||||
}
|
||||
|
||||
const method = result as 'last' | 'all' | 'select';
|
||||
|
||||
if (method === 'last') {
|
||||
return { agents: lastSelected.filter(a => agents.includes(a)), method };
|
||||
}
|
||||
|
||||
if (method === 'all') {
|
||||
return { agents, method };
|
||||
}
|
||||
|
||||
const selected = await agentMultiselect({
|
||||
message: 'Select agents',
|
||||
agents,
|
||||
initialValues: lastSelected.length > 0 ? lastSelected : agents,
|
||||
});
|
||||
|
||||
if (clack.isCancel(selected)) {
|
||||
return selected;
|
||||
}
|
||||
|
||||
return { agents: selected as string[], method };
|
||||
}
|
||||
|
||||
export interface SkillOption {
|
||||
name: string;
|
||||
description?: string;
|
||||
score?: number;
|
||||
source?: string;
|
||||
}
|
||||
|
||||
export async function skillMultiselect(options: {
|
||||
message: string;
|
||||
skills: SkillOption[];
|
||||
initialValues?: string[];
|
||||
required?: boolean;
|
||||
}): Promise<string[] | symbol> {
|
||||
const skillOptions = options.skills.map((skill) => {
|
||||
const label = skill.name;
|
||||
let hint: string | undefined;
|
||||
|
||||
if (skill.score !== undefined) {
|
||||
hint = formatScore(skill.score);
|
||||
} else if (skill.source) {
|
||||
hint = pc.dim(skill.source);
|
||||
}
|
||||
|
||||
return { value: skill.name, label, hint };
|
||||
});
|
||||
|
||||
return clack.multiselect({
|
||||
message: options.message,
|
||||
options: skillOptions,
|
||||
initialValues: options.initialValues,
|
||||
required: options.required ?? false,
|
||||
});
|
||||
}
|
||||
|
||||
export async function groupMultiselect<T extends string>(options: {
|
||||
message: string;
|
||||
options: Record<string, Array<{ value: T; label: string; hint?: string }>>;
|
||||
required?: boolean;
|
||||
}): Promise<T[] | symbol> {
|
||||
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
||||
return clack.groupMultiselect({
|
||||
message: options.message,
|
||||
options: options.options as any,
|
||||
required: options.required,
|
||||
});
|
||||
}
|
||||
|
||||
export function stepTrail(steps: Array<{ label: string; status: 'pending' | 'active' | 'complete' }>): string {
|
||||
const lines: string[] = [];
|
||||
|
||||
for (let i = 0; i < steps.length; i++) {
|
||||
const currentStep = steps[i];
|
||||
const isLast = i === steps.length - 1;
|
||||
|
||||
let icon: string;
|
||||
let labelColor: (text: string) => string;
|
||||
|
||||
switch (currentStep.status) {
|
||||
case 'complete':
|
||||
icon = colors.success(symbols.stepComplete);
|
||||
labelColor = colors.muted;
|
||||
break;
|
||||
case 'active':
|
||||
icon = colors.accent(symbols.stepActive);
|
||||
labelColor = colors.primary;
|
||||
break;
|
||||
case 'pending':
|
||||
default:
|
||||
icon = colors.muted(symbols.stepPending);
|
||||
labelColor = colors.muted;
|
||||
break;
|
||||
}
|
||||
|
||||
lines.push(`${icon} ${labelColor(currentStep.label)}`);
|
||||
|
||||
if (!isLast) {
|
||||
lines.push(`${colors.muted(symbols.stepLine)}`);
|
||||
}
|
||||
}
|
||||
|
||||
return lines.join('\n');
|
||||
}
|
||||
|
||||
export async function selectInstallMethod(options: {
|
||||
message?: string;
|
||||
}): Promise<'symlink' | 'copy' | symbol> {
|
||||
return clack.select({
|
||||
message: options.message || 'Installation method',
|
||||
options: [
|
||||
{
|
||||
value: 'symlink' as const,
|
||||
label: 'Symlink (Recommended)',
|
||||
hint: 'Single source, auto-updates',
|
||||
},
|
||||
{
|
||||
value: 'copy' as const,
|
||||
label: 'Copy to all agents',
|
||||
hint: 'Independent copies',
|
||||
},
|
||||
],
|
||||
});
|
||||
}
|
||||
|
||||
export async function tasks(
|
||||
taskList: Array<{
|
||||
title: string;
|
||||
task: (message: (msg: string) => void) => Promise<string | void>;
|
||||
enabled?: boolean;
|
||||
}>
|
||||
): Promise<void> {
|
||||
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
||||
return clack.tasks(taskList.filter((t) => t.enabled !== false) as any);
|
||||
}
|
||||
|
||||
export function summaryBox(options: {
|
||||
title: string;
|
||||
items: Array<{ label: string; value: string; icon?: string }>;
|
||||
}): void {
|
||||
const lines: string[] = [];
|
||||
|
||||
for (const item of options.items) {
|
||||
const icon = item.icon ? `${item.icon} ` : '';
|
||||
lines.push(` ${icon}${colors.primary(item.label)}`);
|
||||
lines.push(` ${colors.muted(item.value)}`);
|
||||
}
|
||||
|
||||
clack.note(lines.join('\n'), options.title);
|
||||
}
|
||||
@@ -0,0 +1,176 @@
|
||||
import * as prompts from './prompts.js';
|
||||
import { symbols, colors, formatAgent, getAgentIcon, formatAgentIconsInline } from './theme.js';
|
||||
|
||||
export interface InstallResult {
|
||||
skillName: string;
|
||||
method: 'symlink' | 'copy';
|
||||
agents: string[];
|
||||
path: string;
|
||||
}
|
||||
|
||||
export interface InstallSummary {
|
||||
totalSkills: number;
|
||||
totalAgents: number;
|
||||
results: InstallResult[];
|
||||
source?: string;
|
||||
}
|
||||
|
||||
export function showInstallSummary(summary: InstallSummary): void {
|
||||
const title = `Installed ${summary.totalSkills} skill${summary.totalSkills !== 1 ? 's' : ''} to ${summary.totalAgents} agent${summary.totalAgents !== 1 ? 's' : ''}`;
|
||||
|
||||
const lines: string[] = [];
|
||||
|
||||
for (const result of summary.results) {
|
||||
lines.push(`${colors.success(symbols.success)} ${colors.primary(result.skillName)}`);
|
||||
|
||||
const agentDisplay = result.agents.length <= 3
|
||||
? result.agents.map(formatAgent).join(', ')
|
||||
: `${formatAgentIconsInline(result.agents.slice(0, 3))} +${result.agents.length - 3} more`;
|
||||
|
||||
lines.push(` ${result.method} ${symbols.arrowRight} ${agentDisplay}`);
|
||||
lines.push('');
|
||||
}
|
||||
|
||||
prompts.note(lines.join('\n').trim(), title);
|
||||
}
|
||||
|
||||
export function showNextSteps(options: {
|
||||
skillNames: string[];
|
||||
agentTypes: string[];
|
||||
syncNeeded?: boolean;
|
||||
}): void {
|
||||
const lines: string[] = [];
|
||||
|
||||
lines.push(`${colors.muted('1.')} Run ${colors.cyan('skillkit sync')} to update agent configs`);
|
||||
lines.push(`${colors.muted('2.')} Use ${colors.cyan(`skillkit read ${options.skillNames[0] || '<skill>'}`)} to view skill docs`);
|
||||
|
||||
if (options.agentTypes.includes('claude-code')) {
|
||||
lines.push(`${colors.muted('3.')} Skills are available via ${colors.cyan('/@')} in Claude Code`);
|
||||
} else if (options.agentTypes.includes('cursor')) {
|
||||
lines.push(`${colors.muted('3.')} Skills are available in Cursor rules`);
|
||||
}
|
||||
|
||||
console.log('');
|
||||
console.log(colors.dim('Next steps:'));
|
||||
console.log(lines.map(l => ` ${l}`).join('\n'));
|
||||
console.log('');
|
||||
}
|
||||
|
||||
export function showAgentSummary(agents: string[]): void {
|
||||
console.log('');
|
||||
console.log(colors.dim('Detected agents:'));
|
||||
|
||||
const iconLine = agents.map(a => `${getAgentIcon(a)} ${colors.muted(a)}`).join(' ');
|
||||
console.log(` ${iconLine}`);
|
||||
console.log('');
|
||||
}
|
||||
|
||||
export function showProjectSummary(profile: {
|
||||
name: string;
|
||||
type?: string;
|
||||
languages: string[];
|
||||
frameworks: string[];
|
||||
}): void {
|
||||
const lines: string[] = [];
|
||||
|
||||
lines.push(`${colors.primary('Project:')} ${profile.name}`);
|
||||
|
||||
if (profile.type) {
|
||||
lines.push(`${colors.primary('Type:')} ${profile.type}`);
|
||||
}
|
||||
|
||||
if (profile.languages.length > 0) {
|
||||
lines.push(`${colors.primary('Languages:')} ${profile.languages.join(', ')}`);
|
||||
}
|
||||
|
||||
if (profile.frameworks.length > 0) {
|
||||
lines.push(`${colors.primary('Frameworks:')} ${profile.frameworks.join(', ')}`);
|
||||
}
|
||||
|
||||
prompts.note(lines.join('\n'), 'Project Analysis');
|
||||
}
|
||||
|
||||
export function showSyncSummary(options: {
|
||||
skillCount: number;
|
||||
agentType: string;
|
||||
configPath: string;
|
||||
}): void {
|
||||
const lines: string[] = [];
|
||||
|
||||
lines.push(`${colors.success(symbols.success)} Synced ${options.skillCount} skill${options.skillCount !== 1 ? 's' : ''}`);
|
||||
lines.push(` Agent: ${formatAgent(options.agentType)}`);
|
||||
lines.push(` Config: ${colors.muted(options.configPath)}`);
|
||||
|
||||
console.log('');
|
||||
console.log(lines.join('\n'));
|
||||
console.log('');
|
||||
}
|
||||
|
||||
export function showSkillList(skills: Array<{
|
||||
name: string;
|
||||
description?: string;
|
||||
score?: number;
|
||||
source?: string;
|
||||
installed?: boolean;
|
||||
}>): void {
|
||||
console.log('');
|
||||
|
||||
for (const skill of skills) {
|
||||
let line = '';
|
||||
|
||||
if (skill.installed) {
|
||||
line += colors.success(symbols.success) + ' ';
|
||||
} else {
|
||||
line += colors.muted(symbols.stepPending) + ' ';
|
||||
}
|
||||
|
||||
line += colors.primary(skill.name);
|
||||
|
||||
if (skill.score !== undefined) {
|
||||
let scoreColor: (text: string) => string;
|
||||
if (skill.score >= 70) {
|
||||
scoreColor = colors.success;
|
||||
} else if (skill.score >= 50) {
|
||||
scoreColor = colors.warning;
|
||||
} else {
|
||||
scoreColor = colors.muted;
|
||||
}
|
||||
line += ` ${scoreColor(`${skill.score}%`)}`;
|
||||
}
|
||||
|
||||
console.log(line);
|
||||
|
||||
if (skill.description) {
|
||||
console.log(` ${colors.muted(truncate(skill.description, 60))}`);
|
||||
}
|
||||
|
||||
if (skill.source) {
|
||||
console.log(` ${colors.dim(`Source: ${skill.source}`)}`);
|
||||
}
|
||||
}
|
||||
|
||||
console.log('');
|
||||
}
|
||||
|
||||
export function showMarketplaceInfo(options: {
|
||||
totalSkills: number;
|
||||
sourceCount: number;
|
||||
lastUpdated?: string;
|
||||
}): void {
|
||||
const lines: string[] = [];
|
||||
|
||||
lines.push(`Total skills: ${colors.cyan(String(options.totalSkills))}`);
|
||||
lines.push(`Sources: ${colors.cyan(String(options.sourceCount))}`);
|
||||
|
||||
if (options.lastUpdated) {
|
||||
const date = new Date(options.lastUpdated).toLocaleDateString();
|
||||
lines.push(`Updated: ${colors.muted(date)}`);
|
||||
}
|
||||
|
||||
prompts.note(lines.join('\n'), 'Skill Marketplace');
|
||||
}
|
||||
|
||||
function truncate(str: string, maxLen: number): string {
|
||||
if (str.length <= maxLen) return str;
|
||||
return str.slice(0, maxLen - 3) + '...';
|
||||
}
|
||||
@@ -0,0 +1,156 @@
|
||||
import pc from 'picocolors';
|
||||
|
||||
export const AGENT_ICONS: Record<string, string> = {
|
||||
'claude-code': '\u27c1',
|
||||
'cursor': '\u25eb',
|
||||
'codex': '\u25ce',
|
||||
'gemini-cli': '\u2726',
|
||||
'opencode': '\u2b21',
|
||||
'github-copilot': '\u25c8',
|
||||
'windsurf': '\u224b',
|
||||
'droid': '\u25a3',
|
||||
'goose': '\u25c7',
|
||||
'amp': '\u25b3',
|
||||
'kilo': '\u25c9',
|
||||
'kiro-cli': '\u2b22',
|
||||
'roo': '\u2299',
|
||||
'trae': '\u25c6',
|
||||
'antigravity': '\u229b',
|
||||
'clawdbot': '\u27d0',
|
||||
'universal': '\u25cf',
|
||||
};
|
||||
|
||||
export const AGENT_NAMES: Record<string, string> = {
|
||||
'claude-code': 'Claude Code',
|
||||
'cursor': 'Cursor',
|
||||
'codex': 'Codex CLI',
|
||||
'gemini-cli': 'Gemini CLI',
|
||||
'opencode': 'OpenCode',
|
||||
'github-copilot': 'Copilot',
|
||||
'windsurf': 'Windsurf',
|
||||
'droid': 'Droid',
|
||||
'goose': 'Goose',
|
||||
'amp': 'Amp',
|
||||
'kilo': 'Kilo Code',
|
||||
'kiro-cli': 'Kiro',
|
||||
'roo': 'Roo Code',
|
||||
'trae': 'Trae',
|
||||
'antigravity': 'Antigravity',
|
||||
'clawdbot': 'Clawdbot',
|
||||
'universal': 'Universal',
|
||||
};
|
||||
|
||||
export const symbols = {
|
||||
stepPending: '\u25cb',
|
||||
stepActive: '\u25cf',
|
||||
stepComplete: '\u25cf',
|
||||
stepLine: '\u2502',
|
||||
selected: '\u25cf',
|
||||
unselected: '\u25cb',
|
||||
pointer: '\u25b8',
|
||||
bullet: '\u25cf',
|
||||
progressFull: '\u2588',
|
||||
progressEmpty: '\u2591',
|
||||
success: '\u2713',
|
||||
error: '\u2717',
|
||||
warning: '\u26a0',
|
||||
info: '\u2139',
|
||||
arrowRight: '\u2192',
|
||||
arrowLeft: '\u2190',
|
||||
arrowUp: '\u2191',
|
||||
arrowDown: '\u2193',
|
||||
diamondOpen: '\u25c7',
|
||||
diamondFilled: '\u25c6',
|
||||
horizontalLine: '\u2500',
|
||||
verticalLine: '\u2502',
|
||||
frameCorner: '\u25c7',
|
||||
frameLine: '\u2500',
|
||||
};
|
||||
|
||||
export const SPINNER_FRAMES = [
|
||||
'\u280b',
|
||||
'\u2819',
|
||||
'\u2839',
|
||||
'\u2838',
|
||||
'\u283c',
|
||||
'\u2834',
|
||||
'\u2826',
|
||||
'\u2827',
|
||||
'\u2807',
|
||||
'\u280f',
|
||||
];
|
||||
|
||||
export const colors = {
|
||||
accent: (text: string) => pc.green(text),
|
||||
accentBright: (text: string) => pc.bold(pc.green(text)),
|
||||
primary: (text: string) => pc.white(text),
|
||||
secondary: (text: string) => pc.gray(text),
|
||||
muted: (text: string) => pc.dim(text),
|
||||
success: (text: string) => pc.green(text),
|
||||
error: (text: string) => pc.red(text),
|
||||
warning: (text: string) => pc.yellow(text),
|
||||
info: (text: string) => pc.blue(text),
|
||||
bold: (text: string) => pc.bold(text),
|
||||
dim: (text: string) => pc.dim(text),
|
||||
underline: (text: string) => pc.underline(text),
|
||||
cyan: (text: string) => pc.cyan(text),
|
||||
magenta: (text: string) => pc.magenta(text),
|
||||
};
|
||||
|
||||
export function formatAgent(agentType: string): string {
|
||||
const icon = AGENT_ICONS[agentType] || symbols.stepActive;
|
||||
const name = AGENT_NAMES[agentType] || agentType;
|
||||
return `${icon} ${name}`;
|
||||
}
|
||||
|
||||
export function getAgentIcon(agentType: string): string {
|
||||
return AGENT_ICONS[agentType] || symbols.stepActive;
|
||||
}
|
||||
|
||||
export function formatAgentIconsInline(agents: string[]): string {
|
||||
return agents.map(a => getAgentIcon(a)).join(' ');
|
||||
}
|
||||
|
||||
export function progressBar(value: number, total: number, width: number = 6): string {
|
||||
if (width <= 0 || total <= 0) return '';
|
||||
const clampedValue = Math.min(Math.max(value, 0), total);
|
||||
const filled = Math.round((clampedValue / total) * width);
|
||||
const safeFilled = Math.min(Math.max(filled, 0), width);
|
||||
const empty = width - safeFilled;
|
||||
return symbols.progressFull.repeat(safeFilled) + symbols.progressEmpty.repeat(empty);
|
||||
}
|
||||
|
||||
export function formatScore(score: number): string {
|
||||
const bar = progressBar(score, 100, 6);
|
||||
let scoreColor: (text: string) => string;
|
||||
if (score >= 70) {
|
||||
scoreColor = colors.success;
|
||||
} else if (score >= 50) {
|
||||
scoreColor = colors.warning;
|
||||
} else {
|
||||
scoreColor = colors.muted;
|
||||
}
|
||||
return `${scoreColor(`${score}%`)} ${colors.dim(bar)}`;
|
||||
}
|
||||
|
||||
export function getQualityGradeFromScore(score: number): string {
|
||||
if (score >= 90) return 'A';
|
||||
if (score >= 80) return 'B';
|
||||
if (score >= 70) return 'C';
|
||||
if (score >= 60) return 'D';
|
||||
return 'F';
|
||||
}
|
||||
|
||||
export function formatQualityBadge(score: number): string {
|
||||
const grade = getQualityGradeFromScore(score);
|
||||
if (score >= 80) return colors.success(`[${grade}]`);
|
||||
if (score >= 60) return colors.warning(`[${grade}]`);
|
||||
return colors.error(`[${grade}]`);
|
||||
}
|
||||
|
||||
export function formatQualityBadgeCompact(score: number): string {
|
||||
const grade = getQualityGradeFromScore(score);
|
||||
if (score >= 80) return colors.success(grade);
|
||||
if (score >= 60) return colors.warning(grade);
|
||||
return colors.error(grade);
|
||||
}
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/core",
|
||||
"version": "1.7.1",
|
||||
"version": "1.7.6",
|
||||
"description": "Core functionality for SkillKit - skill discovery, parsing, and translation",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
@@ -45,7 +45,6 @@
|
||||
"test": "vitest run"
|
||||
},
|
||||
"dependencies": {
|
||||
"@types/minimatch": "^6.0.0",
|
||||
"minimatch": "^10.1.1",
|
||||
"yaml": "^2.6.1",
|
||||
"zod": "^3.24.1"
|
||||
|
||||
@@ -73,5 +73,7 @@ export * from './audit/index.js';
|
||||
// Custom Agents Support (Phase 19)
|
||||
export * from './agents/index.js';
|
||||
|
||||
// Skill Translator (Phase 20 - Cross-Agent Skill Translation)
|
||||
export * from './skill-translator.js';
|
||||
export * from './manifest/index.js';
|
||||
|
||||
export * from './quality/index.js';
|
||||
|
||||
@@ -0,0 +1,206 @@
|
||||
import { readFileSync, writeFileSync, existsSync } from 'node:fs';
|
||||
import { join, dirname } from 'node:path';
|
||||
import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
|
||||
|
||||
export interface SkillEntry {
|
||||
source: string;
|
||||
skills?: string[];
|
||||
agents?: string[];
|
||||
enabled?: boolean;
|
||||
}
|
||||
|
||||
export interface SkillsManifest {
|
||||
version: number;
|
||||
skills: SkillEntry[];
|
||||
agents?: string[];
|
||||
installMethod?: 'symlink' | 'copy';
|
||||
updatedAt?: string;
|
||||
}
|
||||
|
||||
const MANIFEST_FILENAMES = ['.skills', '.skills.yaml', '.skills.yml', 'skills.yaml'];
|
||||
|
||||
export function findManifestPath(startDir: string = process.cwd()): string | null {
|
||||
let dir = startDir;
|
||||
|
||||
while (dir !== dirname(dir)) {
|
||||
for (const filename of MANIFEST_FILENAMES) {
|
||||
const manifestPath = join(dir, filename);
|
||||
if (existsSync(manifestPath)) {
|
||||
return manifestPath;
|
||||
}
|
||||
}
|
||||
dir = dirname(dir);
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
export function loadManifest(manifestPath?: string): SkillsManifest | null {
|
||||
const path = manifestPath || findManifestPath();
|
||||
|
||||
if (!path || !existsSync(path)) {
|
||||
return null;
|
||||
}
|
||||
|
||||
try {
|
||||
const content = readFileSync(path, 'utf-8');
|
||||
const parsed = parseYaml(content) as SkillsManifest;
|
||||
|
||||
if (!parsed || typeof parsed !== 'object') {
|
||||
return null;
|
||||
}
|
||||
|
||||
return {
|
||||
version: parsed.version || 1,
|
||||
skills: normalizeSkills(parsed.skills || []),
|
||||
agents: parsed.agents,
|
||||
installMethod: parsed.installMethod,
|
||||
updatedAt: parsed.updatedAt,
|
||||
};
|
||||
} catch {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
function normalizeSkills(skills: unknown[]): SkillEntry[] {
|
||||
return skills.map(skill => {
|
||||
if (typeof skill === 'string') {
|
||||
const parts = skill.split('/');
|
||||
if (parts.length >= 3) {
|
||||
return {
|
||||
source: `${parts[0]}/${parts[1]}`,
|
||||
skills: [parts.slice(2).join('/')],
|
||||
enabled: true,
|
||||
};
|
||||
}
|
||||
return { source: skill, enabled: true };
|
||||
}
|
||||
|
||||
if (typeof skill === 'object' && skill !== null) {
|
||||
const entry = skill as Record<string, unknown>;
|
||||
return {
|
||||
source: String(entry.source || ''),
|
||||
skills: entry.skills as string[] | undefined,
|
||||
agents: entry.agents as string[] | undefined,
|
||||
enabled: entry.enabled !== false,
|
||||
};
|
||||
}
|
||||
|
||||
return { source: '', enabled: false };
|
||||
}).filter(s => s.source);
|
||||
}
|
||||
|
||||
export function saveManifest(manifest: SkillsManifest, manifestPath?: string): void {
|
||||
const path = manifestPath || join(process.cwd(), '.skills');
|
||||
|
||||
const content = stringifyYaml({
|
||||
version: manifest.version || 1,
|
||||
skills: manifest.skills.map(s => {
|
||||
if (!s.skills && !s.agents && s.enabled !== false) {
|
||||
return s.source;
|
||||
}
|
||||
return s;
|
||||
}),
|
||||
...(manifest.agents && { agents: manifest.agents }),
|
||||
...(manifest.installMethod && { installMethod: manifest.installMethod }),
|
||||
updatedAt: new Date().toISOString(),
|
||||
});
|
||||
|
||||
writeFileSync(path, content, 'utf-8');
|
||||
}
|
||||
|
||||
export function addToManifest(
|
||||
source: string,
|
||||
options?: { skills?: string[]; agents?: string[] },
|
||||
manifestPath?: string
|
||||
): SkillsManifest {
|
||||
const existing = loadManifest(manifestPath) || {
|
||||
version: 1,
|
||||
skills: [],
|
||||
};
|
||||
|
||||
const existingIndex = existing.skills.findIndex(s => s.source === source);
|
||||
|
||||
if (existingIndex >= 0) {
|
||||
existing.skills[existingIndex] = {
|
||||
...existing.skills[existingIndex],
|
||||
...options,
|
||||
enabled: true,
|
||||
};
|
||||
} else {
|
||||
existing.skills.push({
|
||||
source,
|
||||
...options,
|
||||
enabled: true,
|
||||
});
|
||||
}
|
||||
|
||||
saveManifest(existing, manifestPath);
|
||||
return existing;
|
||||
}
|
||||
|
||||
export function removeFromManifest(source: string, manifestPath?: string): SkillsManifest | null {
|
||||
const existing = loadManifest(manifestPath);
|
||||
|
||||
if (!existing) {
|
||||
return null;
|
||||
}
|
||||
|
||||
existing.skills = existing.skills.filter(s => s.source !== source);
|
||||
saveManifest(existing, manifestPath);
|
||||
return existing;
|
||||
}
|
||||
|
||||
export function initManifest(options?: {
|
||||
agents?: string[];
|
||||
installMethod?: 'symlink' | 'copy';
|
||||
}, manifestPath?: string): SkillsManifest {
|
||||
const manifest: SkillsManifest = {
|
||||
version: 1,
|
||||
skills: [],
|
||||
...options,
|
||||
updatedAt: new Date().toISOString(),
|
||||
};
|
||||
|
||||
saveManifest(manifest, manifestPath);
|
||||
return manifest;
|
||||
}
|
||||
|
||||
export function generateManifestFromInstalled(
|
||||
installedSkills: Array<{ name: string; source: string; agents?: string[] }>
|
||||
): SkillsManifest {
|
||||
const skillsBySource = new Map<string, { skills: string[]; agents: Set<string> }>();
|
||||
|
||||
for (const skill of installedSkills) {
|
||||
if (!skill.source) continue;
|
||||
|
||||
const existing = skillsBySource.get(skill.source);
|
||||
if (existing) {
|
||||
existing.skills.push(skill.name);
|
||||
if (skill.agents) {
|
||||
skill.agents.forEach(a => existing.agents.add(a));
|
||||
}
|
||||
} else {
|
||||
skillsBySource.set(skill.source, {
|
||||
skills: [skill.name],
|
||||
agents: new Set(skill.agents || []),
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
const skills: SkillEntry[] = [];
|
||||
for (const [source, data] of skillsBySource) {
|
||||
skills.push({
|
||||
source,
|
||||
skills: data.skills.length > 0 ? data.skills : undefined,
|
||||
agents: data.agents.size > 0 ? Array.from(data.agents) : undefined,
|
||||
enabled: true,
|
||||
});
|
||||
}
|
||||
|
||||
return {
|
||||
version: 1,
|
||||
skills,
|
||||
updatedAt: new Date().toISOString(),
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,214 @@
|
||||
import { describe, it, expect } from 'vitest';
|
||||
import {
|
||||
evaluateSkillContent,
|
||||
getQualityGrade,
|
||||
isHighQuality,
|
||||
} from '../index.js';
|
||||
|
||||
describe('Quality Evaluation', () => {
|
||||
describe('evaluateSkillContent', () => {
|
||||
it('should score a well-structured skill highly', () => {
|
||||
const content = `---
|
||||
name: test-skill
|
||||
description: A test skill for validation
|
||||
globs: ["**/*.ts"]
|
||||
---
|
||||
|
||||
# Test Skill
|
||||
|
||||
## When to Use
|
||||
|
||||
Use this skill when working with TypeScript files.
|
||||
|
||||
## Instructions
|
||||
|
||||
Always follow these patterns:
|
||||
|
||||
\`\`\`typescript
|
||||
function example(): void {
|
||||
console.log('example');
|
||||
}
|
||||
\`\`\`
|
||||
|
||||
## Commands
|
||||
|
||||
Run tests with:
|
||||
|
||||
\`\`\`bash
|
||||
npm test
|
||||
\`\`\`
|
||||
|
||||
## Boundaries
|
||||
|
||||
Never commit secrets to the repository.
|
||||
Always run linting before commits.
|
||||
`;
|
||||
|
||||
const result = evaluateSkillContent(content);
|
||||
expect(result.overall).toBeGreaterThanOrEqual(70);
|
||||
expect(result.structure.hasMetadata).toBe(true);
|
||||
expect(result.structure.hasTriggers).toBe(true);
|
||||
expect(result.structure.hasExamples).toBe(true);
|
||||
expect(result.structure.hasBoundaries).toBe(true);
|
||||
expect(result.clarity.hasHeaders).toBe(true);
|
||||
expect(result.specificity.hasConcreteCommands).toBe(true);
|
||||
});
|
||||
|
||||
it('should score a minimal skill lower', () => {
|
||||
const content = `# My Skill
|
||||
|
||||
Be helpful and assist the user with various tasks.
|
||||
Try to do your best.
|
||||
`;
|
||||
|
||||
const result = evaluateSkillContent(content);
|
||||
expect(result.overall).toBeLessThan(50);
|
||||
expect(result.structure.hasMetadata).toBe(false);
|
||||
expect(result.structure.hasTriggers).toBe(false);
|
||||
expect(result.specificity.vagueTermCount).toBeGreaterThan(0);
|
||||
expect(result.warnings.length).toBeGreaterThan(0);
|
||||
});
|
||||
|
||||
it('should penalize overly long skills', () => {
|
||||
const longContent = '# Skill\n' + 'Some content.\n'.repeat(600);
|
||||
const result = evaluateSkillContent(longContent);
|
||||
expect(result.clarity.lineCount).toBeGreaterThan(500);
|
||||
expect(result.clarity.score).toBeLessThan(70);
|
||||
});
|
||||
|
||||
it('should detect vague terms', () => {
|
||||
const content = `# Skill
|
||||
|
||||
Be helpful and assist the user.
|
||||
Try to do your best when appropriate.
|
||||
Help with various tasks as needed.
|
||||
`;
|
||||
|
||||
const result = evaluateSkillContent(content);
|
||||
expect(result.specificity.vagueTermCount).toBeGreaterThan(3);
|
||||
});
|
||||
|
||||
it('should detect code examples', () => {
|
||||
const content = `# Skill
|
||||
|
||||
\`\`\`typescript
|
||||
const x = 1;
|
||||
\`\`\`
|
||||
|
||||
\`\`\`javascript
|
||||
const y = 2;
|
||||
\`\`\`
|
||||
`;
|
||||
|
||||
const result = evaluateSkillContent(content);
|
||||
expect(result.structure.hasExamples).toBe(true);
|
||||
expect(result.specificity.hasCodeExamples).toBe(true);
|
||||
});
|
||||
|
||||
it('should detect boundary patterns', () => {
|
||||
const content = `# Skill
|
||||
|
||||
## Boundaries
|
||||
|
||||
- Never commit secrets
|
||||
- Always run tests
|
||||
- Don't modify node_modules
|
||||
- Avoid using deprecated APIs
|
||||
`;
|
||||
|
||||
const result = evaluateSkillContent(content);
|
||||
expect(result.structure.hasBoundaries).toBe(true);
|
||||
});
|
||||
|
||||
it('should detect trigger conditions', () => {
|
||||
const content = `# Skill
|
||||
|
||||
## When to Use
|
||||
|
||||
Use this skill when:
|
||||
- Working with React components
|
||||
- Building forms
|
||||
`;
|
||||
|
||||
const result = evaluateSkillContent(content);
|
||||
expect(result.structure.hasTriggers).toBe(true);
|
||||
expect(result.structure.hasWhenToUse).toBe(true);
|
||||
});
|
||||
});
|
||||
|
||||
describe('getQualityGrade', () => {
|
||||
it('should return A for scores >= 90', () => {
|
||||
expect(getQualityGrade(90)).toBe('A');
|
||||
expect(getQualityGrade(100)).toBe('A');
|
||||
});
|
||||
|
||||
it('should return B for scores >= 80', () => {
|
||||
expect(getQualityGrade(80)).toBe('B');
|
||||
expect(getQualityGrade(89)).toBe('B');
|
||||
});
|
||||
|
||||
it('should return C for scores >= 70', () => {
|
||||
expect(getQualityGrade(70)).toBe('C');
|
||||
expect(getQualityGrade(79)).toBe('C');
|
||||
});
|
||||
|
||||
it('should return D for scores >= 60', () => {
|
||||
expect(getQualityGrade(60)).toBe('D');
|
||||
expect(getQualityGrade(69)).toBe('D');
|
||||
});
|
||||
|
||||
it('should return F for scores < 60', () => {
|
||||
expect(getQualityGrade(59)).toBe('F');
|
||||
expect(getQualityGrade(0)).toBe('F');
|
||||
});
|
||||
});
|
||||
|
||||
describe('isHighQuality', () => {
|
||||
const defaultAdvanced = {
|
||||
score: 100,
|
||||
deprecatedPatterns: [],
|
||||
conflictingInstructions: [],
|
||||
securityIssues: [],
|
||||
completeness: { score: 100, hasTodos: false, todoCount: 0, emptySections: [], exampleCoverage: 100 },
|
||||
};
|
||||
|
||||
it('should return true for high scoring skills with few warnings', () => {
|
||||
const score = {
|
||||
overall: 80,
|
||||
structure: { score: 80, hasMetadata: true, hasDescription: true, hasTriggers: true, hasExamples: true, hasBoundaries: true, hasWhenToUse: true },
|
||||
clarity: { score: 80, lineCount: 100, tokenCount: 500, avgSentenceLength: 15, hasHeaders: true },
|
||||
specificity: { score: 80, hasConcreteCommands: true, hasFilePatterns: true, hasCodeExamples: true, vagueTermCount: 0 },
|
||||
advanced: defaultAdvanced,
|
||||
warnings: [],
|
||||
suggestions: [],
|
||||
};
|
||||
expect(isHighQuality(score)).toBe(true);
|
||||
});
|
||||
|
||||
it('should return false for low scoring skills', () => {
|
||||
const score = {
|
||||
overall: 50,
|
||||
structure: { score: 50, hasMetadata: false, hasDescription: false, hasTriggers: false, hasExamples: false, hasBoundaries: false, hasWhenToUse: false },
|
||||
clarity: { score: 50, lineCount: 100, tokenCount: 500, avgSentenceLength: 15, hasHeaders: true },
|
||||
specificity: { score: 50, hasConcreteCommands: false, hasFilePatterns: false, hasCodeExamples: false, vagueTermCount: 5 },
|
||||
advanced: { ...defaultAdvanced, score: 50 },
|
||||
warnings: ['Missing triggers', 'No examples'],
|
||||
suggestions: [],
|
||||
};
|
||||
expect(isHighQuality(score)).toBe(false);
|
||||
});
|
||||
|
||||
it('should return false for skills with many warnings', () => {
|
||||
const score = {
|
||||
overall: 75,
|
||||
structure: { score: 75, hasMetadata: true, hasDescription: true, hasTriggers: false, hasExamples: false, hasBoundaries: false, hasWhenToUse: false },
|
||||
clarity: { score: 75, lineCount: 100, tokenCount: 500, avgSentenceLength: 15, hasHeaders: true },
|
||||
specificity: { score: 75, hasConcreteCommands: true, hasFilePatterns: true, hasCodeExamples: false, vagueTermCount: 0 },
|
||||
advanced: { ...defaultAdvanced, score: 75 },
|
||||
warnings: ['Warning 1', 'Warning 2', 'Warning 3'],
|
||||
suggestions: [],
|
||||
};
|
||||
expect(isHighQuality(score)).toBe(false);
|
||||
});
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,262 @@
|
||||
/**
|
||||
* Benchmark quality scores against category leaders
|
||||
*/
|
||||
|
||||
import type { QualityScore } from './index.js';
|
||||
|
||||
export interface BenchmarkResult {
|
||||
skill: string;
|
||||
score: number;
|
||||
grade: string;
|
||||
categoryAvg: number;
|
||||
topSkillScore: number;
|
||||
percentile: number;
|
||||
comparisonNotes: string[];
|
||||
recommendations: string[];
|
||||
}
|
||||
|
||||
export interface CategoryStats {
|
||||
category: string;
|
||||
avgScore: number;
|
||||
topScore: number;
|
||||
topSkills: string[];
|
||||
count: number;
|
||||
distribution: {
|
||||
A: number;
|
||||
B: number;
|
||||
C: number;
|
||||
D: number;
|
||||
F: number;
|
||||
};
|
||||
}
|
||||
|
||||
const CATEGORY_BENCHMARKS: Record<string, CategoryStats> = {
|
||||
react: {
|
||||
category: 'react',
|
||||
avgScore: 78,
|
||||
topScore: 95,
|
||||
topSkills: ['react-patterns', 'react-hooks-best-practices'],
|
||||
count: 150,
|
||||
distribution: { A: 15, B: 35, C: 30, D: 15, F: 5 },
|
||||
},
|
||||
typescript: {
|
||||
category: 'typescript',
|
||||
avgScore: 75,
|
||||
topScore: 92,
|
||||
topSkills: ['typescript-strict', 'type-safety-patterns'],
|
||||
count: 120,
|
||||
distribution: { A: 12, B: 30, C: 35, D: 18, F: 5 },
|
||||
},
|
||||
testing: {
|
||||
category: 'testing',
|
||||
avgScore: 72,
|
||||
topScore: 90,
|
||||
topSkills: ['tdd-workflow', 'testing-best-practices'],
|
||||
count: 80,
|
||||
distribution: { A: 10, B: 28, C: 38, D: 19, F: 5 },
|
||||
},
|
||||
git: {
|
||||
category: 'git',
|
||||
avgScore: 80,
|
||||
topScore: 94,
|
||||
topSkills: ['git-workflow', 'conventional-commits'],
|
||||
count: 60,
|
||||
distribution: { A: 18, B: 40, C: 28, D: 12, F: 2 },
|
||||
},
|
||||
security: {
|
||||
category: 'security',
|
||||
avgScore: 76,
|
||||
topScore: 93,
|
||||
topSkills: ['security-review', 'owasp-patterns'],
|
||||
count: 45,
|
||||
distribution: { A: 14, B: 32, C: 34, D: 16, F: 4 },
|
||||
},
|
||||
api: {
|
||||
category: 'api',
|
||||
avgScore: 74,
|
||||
topScore: 91,
|
||||
topSkills: ['api-design', 'rest-best-practices'],
|
||||
count: 55,
|
||||
distribution: { A: 11, B: 30, C: 36, D: 18, F: 5 },
|
||||
},
|
||||
general: {
|
||||
category: 'general',
|
||||
avgScore: 70,
|
||||
topScore: 88,
|
||||
topSkills: ['code-review', 'best-practices'],
|
||||
count: 200,
|
||||
distribution: { A: 8, B: 25, C: 40, D: 22, F: 5 },
|
||||
},
|
||||
};
|
||||
|
||||
export function getGrade(score: number): string {
|
||||
if (score >= 90) return 'A';
|
||||
if (score >= 80) return 'B';
|
||||
if (score >= 70) return 'C';
|
||||
if (score >= 60) return 'D';
|
||||
return 'F';
|
||||
}
|
||||
|
||||
export function detectCategory(skillName: string, tags: string[] = []): string {
|
||||
const lowerName = skillName.toLowerCase();
|
||||
const lowerTags = tags.map(t => t.toLowerCase());
|
||||
const searchTerms = [lowerName, ...lowerTags];
|
||||
|
||||
const categoryKeywords: Record<string, string[]> = {
|
||||
react: ['react', 'hooks', 'jsx', 'tsx', 'component', 'nextjs', 'remix'],
|
||||
typescript: ['typescript', 'type', 'types', 'ts', 'strict'],
|
||||
testing: ['test', 'testing', 'tdd', 'jest', 'vitest', 'playwright', 'e2e'],
|
||||
git: ['git', 'commit', 'branch', 'merge', 'workflow', 'conventional'],
|
||||
security: ['security', 'auth', 'owasp', 'vulnerability', 'safe'],
|
||||
api: ['api', 'rest', 'graphql', 'endpoint', 'http'],
|
||||
};
|
||||
|
||||
for (const [category, keywords] of Object.entries(categoryKeywords)) {
|
||||
for (const term of searchTerms) {
|
||||
if (keywords.some(kw => term.includes(kw))) {
|
||||
return category;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return 'general';
|
||||
}
|
||||
|
||||
export function calculatePercentile(score: number, categoryStats: CategoryStats): number {
|
||||
const { distribution } = categoryStats;
|
||||
const totalSkills = distribution.A + distribution.B + distribution.C + distribution.D + distribution.F;
|
||||
|
||||
let percentBelow = 0;
|
||||
|
||||
if (score < 60) {
|
||||
percentBelow = (score / 60) * (distribution.F / totalSkills) * 100;
|
||||
} else if (score < 70) {
|
||||
percentBelow = (distribution.F / totalSkills) * 100;
|
||||
percentBelow += ((score - 60) / 10) * (distribution.D / totalSkills) * 100;
|
||||
} else if (score < 80) {
|
||||
percentBelow = ((distribution.F + distribution.D) / totalSkills) * 100;
|
||||
percentBelow += ((score - 70) / 10) * (distribution.C / totalSkills) * 100;
|
||||
} else if (score < 90) {
|
||||
percentBelow = ((distribution.F + distribution.D + distribution.C) / totalSkills) * 100;
|
||||
percentBelow += ((score - 80) / 10) * (distribution.B / totalSkills) * 100;
|
||||
} else {
|
||||
percentBelow = ((distribution.F + distribution.D + distribution.C + distribution.B) / totalSkills) * 100;
|
||||
percentBelow += ((score - 90) / 10) * (distribution.A / totalSkills) * 100;
|
||||
}
|
||||
|
||||
return Math.round(Math.min(99, Math.max(1, percentBelow)));
|
||||
}
|
||||
|
||||
export function generateComparisonNotes(
|
||||
quality: QualityScore,
|
||||
categoryStats: CategoryStats
|
||||
): string[] {
|
||||
const notes: string[] = [];
|
||||
const topScore = categoryStats.topScore;
|
||||
const avgScore = categoryStats.avgScore;
|
||||
|
||||
if (quality.overall >= topScore) {
|
||||
notes.push('Your skill is among the top performers in this category');
|
||||
} else if (quality.overall >= avgScore) {
|
||||
notes.push(`Your skill is above the category average (${avgScore})`);
|
||||
} else {
|
||||
notes.push(`Your skill is ${avgScore - quality.overall} points below the category average`);
|
||||
}
|
||||
|
||||
if (!quality.structure.hasExamples) {
|
||||
notes.push('Missing code examples (present in 95% of top skills)');
|
||||
}
|
||||
|
||||
if (!quality.structure.hasTriggers) {
|
||||
notes.push('Missing trigger conditions (present in 80% of top skills)');
|
||||
}
|
||||
|
||||
if (!quality.structure.hasBoundaries) {
|
||||
notes.push('Missing "When Not to Use" section (present in 80% of top skills)');
|
||||
}
|
||||
|
||||
if (quality.specificity.vagueTermCount > 3) {
|
||||
notes.push('Trigger conditions are less specific than category average');
|
||||
}
|
||||
|
||||
if (quality.clarity.lineCount > 300) {
|
||||
notes.push('Skill is longer than recommended (top skills average 150-250 lines)');
|
||||
}
|
||||
|
||||
if (quality.advanced.deprecatedPatterns.length > 0) {
|
||||
notes.push('Contains deprecated patterns not found in top skills');
|
||||
}
|
||||
|
||||
return notes;
|
||||
}
|
||||
|
||||
export function generateRecommendations(
|
||||
quality: QualityScore,
|
||||
categoryStats: CategoryStats
|
||||
): string[] {
|
||||
const recommendations: string[] = [];
|
||||
const gap = categoryStats.topScore - quality.overall;
|
||||
|
||||
if (gap > 20) {
|
||||
recommendations.push('Consider studying top skills in this category for patterns');
|
||||
}
|
||||
|
||||
if (!quality.structure.hasExamples) {
|
||||
recommendations.push(`Add ${quality.specificity.hasCodeExamples ? 'more' : ''} code examples showing input/output`);
|
||||
}
|
||||
|
||||
if (!quality.structure.hasTriggers) {
|
||||
recommendations.push('Add explicit trigger conditions with patterns like "Triggers when:"');
|
||||
}
|
||||
|
||||
if (!quality.structure.hasBoundaries) {
|
||||
recommendations.push('Add a "Boundaries" or "Limitations" section');
|
||||
}
|
||||
|
||||
if (quality.clarity.lineCount > 400) {
|
||||
recommendations.push('Split into multiple focused skills (top skills are 150-250 lines)');
|
||||
}
|
||||
|
||||
if (quality.specificity.vagueTermCount > 0) {
|
||||
recommendations.push(`Replace ${quality.specificity.vagueTermCount} vague term(s) with specific instructions`);
|
||||
}
|
||||
|
||||
if (quality.advanced.completeness.hasTodos) {
|
||||
recommendations.push('Complete TODO items before publishing');
|
||||
}
|
||||
|
||||
return recommendations;
|
||||
}
|
||||
|
||||
export function benchmarkSkill(
|
||||
skillName: string,
|
||||
quality: QualityScore,
|
||||
tags: string[] = [],
|
||||
customCategoryStats?: CategoryStats
|
||||
): BenchmarkResult {
|
||||
const category = detectCategory(skillName, tags);
|
||||
const categoryStats = customCategoryStats || CATEGORY_BENCHMARKS[category] || CATEGORY_BENCHMARKS.general;
|
||||
|
||||
const percentile = calculatePercentile(quality.overall, categoryStats);
|
||||
const comparisonNotes = generateComparisonNotes(quality, categoryStats);
|
||||
const recommendations = generateRecommendations(quality, categoryStats);
|
||||
|
||||
return {
|
||||
skill: skillName,
|
||||
score: quality.overall,
|
||||
grade: getGrade(quality.overall),
|
||||
categoryAvg: categoryStats.avgScore,
|
||||
topSkillScore: categoryStats.topScore,
|
||||
percentile,
|
||||
comparisonNotes,
|
||||
recommendations,
|
||||
};
|
||||
}
|
||||
|
||||
export function getCategoryStats(category: string): CategoryStats | null {
|
||||
return CATEGORY_BENCHMARKS[category] || null;
|
||||
}
|
||||
|
||||
export function getAllCategories(): string[] {
|
||||
return Object.keys(CATEGORY_BENCHMARKS);
|
||||
}
|
||||
@@ -0,0 +1,589 @@
|
||||
import { readFileSync, existsSync } from 'node:fs';
|
||||
import { join, basename } from 'node:path';
|
||||
|
||||
export * from './benchmark.js';
|
||||
|
||||
export interface QualityScore {
|
||||
overall: number;
|
||||
structure: StructureScore;
|
||||
clarity: ClarityScore;
|
||||
specificity: SpecificityScore;
|
||||
advanced: AdvancedScore;
|
||||
warnings: string[];
|
||||
suggestions: string[];
|
||||
}
|
||||
|
||||
export interface AdvancedScore {
|
||||
score: number;
|
||||
deprecatedPatterns: string[];
|
||||
conflictingInstructions: string[];
|
||||
securityIssues: string[];
|
||||
completeness: CompletenessResult;
|
||||
}
|
||||
|
||||
export interface CompletenessResult {
|
||||
score: number;
|
||||
hasTodos: boolean;
|
||||
todoCount: number;
|
||||
emptySections: string[];
|
||||
exampleCoverage: number;
|
||||
}
|
||||
|
||||
export interface StructureScore {
|
||||
score: number;
|
||||
hasMetadata: boolean;
|
||||
hasDescription: boolean;
|
||||
hasTriggers: boolean;
|
||||
hasExamples: boolean;
|
||||
hasBoundaries: boolean;
|
||||
hasWhenToUse: boolean;
|
||||
}
|
||||
|
||||
export interface ClarityScore {
|
||||
score: number;
|
||||
lineCount: number;
|
||||
tokenCount: number;
|
||||
avgSentenceLength: number;
|
||||
hasHeaders: boolean;
|
||||
}
|
||||
|
||||
export interface SpecificityScore {
|
||||
score: number;
|
||||
hasConcreteCommands: boolean;
|
||||
hasFilePatterns: boolean;
|
||||
hasCodeExamples: boolean;
|
||||
vagueTermCount: number;
|
||||
}
|
||||
|
||||
const VAGUE_TERMS = [
|
||||
'be helpful',
|
||||
'assist the user',
|
||||
'help with',
|
||||
'try to',
|
||||
'attempt to',
|
||||
'do your best',
|
||||
'as needed',
|
||||
'when appropriate',
|
||||
'if necessary',
|
||||
'general purpose',
|
||||
'various tasks',
|
||||
'many things',
|
||||
'etc.',
|
||||
'and so on',
|
||||
'stuff like that',
|
||||
];
|
||||
|
||||
const BOUNDARY_PATTERNS = [
|
||||
/never\s+(?:do|use|commit|push|delete|remove)/i,
|
||||
/always\s+(?:do|use|check|verify|ensure)/i,
|
||||
/don'?t\s+(?:do|use|commit|push|delete)/i,
|
||||
/avoid\s+(?:using|doing|committing)/i,
|
||||
/must\s+(?:not|always|never)/i,
|
||||
/forbidden/i,
|
||||
/prohibited/i,
|
||||
/required/i,
|
||||
];
|
||||
|
||||
const TRIGGER_PATTERNS = [
|
||||
/when\s+to\s+use/i,
|
||||
/use\s+this\s+(?:skill|when)/i,
|
||||
/triggers?\s*(?:when|:)/i,
|
||||
/activated?\s+(?:when|by)/i,
|
||||
/applies?\s+(?:when|to)/i,
|
||||
/invoke\s+(?:when|this)/i,
|
||||
];
|
||||
|
||||
const COMMAND_PATTERNS = [
|
||||
/```(?:bash|sh|shell|zsh)[\s\S]*?```/g,
|
||||
/`(?:npm|pnpm|yarn|bun|npx|git|docker|kubectl)\s+[^`]+`/g,
|
||||
/\$\s*\w+/g,
|
||||
];
|
||||
|
||||
const CODE_EXAMPLE_PATTERNS = [
|
||||
/```(?:typescript|javascript|tsx|jsx|python|go|rust|java)[\s\S]*?```/g,
|
||||
/```[\s\S]{50,}?```/g,
|
||||
];
|
||||
|
||||
const FILE_PATTERN_PATTERNS = [
|
||||
/\*\*\/\*\.\w+/,
|
||||
/\.\w+$/m,
|
||||
/glob[s]?\s*[:=]/i,
|
||||
/include[s]?\s*[:=]/i,
|
||||
/pattern[s]?\s*[:=]/i,
|
||||
];
|
||||
|
||||
const DEPRECATED_PATTERNS = [
|
||||
{ pattern: /require\s*\(['"][^'"]+['"]\)/g, message: 'Uses CommonJS require() instead of ES modules' },
|
||||
{ pattern: /React\.Component/g, message: 'Uses class components instead of functional' },
|
||||
{ pattern: /componentDidMount|componentWillUnmount|componentDidUpdate/g, message: 'Uses lifecycle methods instead of hooks' },
|
||||
{ pattern: /\bvar\s+\w+\s*=/g, message: 'Uses var instead of const/let' },
|
||||
{ pattern: /\.then\s*\([^)]*\)\.catch/g, message: 'Uses .then().catch() instead of async/await' },
|
||||
{ pattern: /new\s+Promise\s*\(/g, message: 'Consider using async/await instead of new Promise()' },
|
||||
];
|
||||
|
||||
const SECURITY_PATTERNS = [
|
||||
{ pattern: /password\s*[:=]\s*['"][^'"]+['"]/gi, message: 'Potential hardcoded password' },
|
||||
{ pattern: /api[_-]?key\s*[:=]\s*['"][^'"]+['"]/gi, message: 'Potential hardcoded API key' },
|
||||
{ pattern: /secret\s*[:=]\s*['"][^'"]+['"]/gi, message: 'Potential hardcoded secret' },
|
||||
{ pattern: /token\s*[:=]\s*['"][A-Za-z0-9_-]{20,}['"]/gi, message: 'Potential hardcoded token' },
|
||||
{ pattern: /\$\{[^}]*\}/g, message: 'Template literal - ensure proper sanitization in shell commands' },
|
||||
{ pattern: /eval\s*\(/g, message: 'Uses eval() - potential code injection risk' },
|
||||
{ pattern: /innerHTML\s*=/g, message: 'Uses innerHTML - potential XSS risk' },
|
||||
{ pattern: /dangerouslySetInnerHTML/g, message: 'Uses dangerouslySetInnerHTML - potential XSS risk' },
|
||||
];
|
||||
|
||||
|
||||
function extractFrontmatter(content: string): Record<string, unknown> | null {
|
||||
const normalizedContent = content.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
|
||||
const match = normalizedContent.match(/^---\s*\n([\s\S]*?)\n---/);
|
||||
if (!match) return null;
|
||||
|
||||
const frontmatter: Record<string, unknown> = {};
|
||||
const lines = match[1].split('\n');
|
||||
|
||||
for (const line of lines) {
|
||||
const colonIndex = line.indexOf(':');
|
||||
if (colonIndex > 0) {
|
||||
const key = line.slice(0, colonIndex).trim();
|
||||
const value = line.slice(colonIndex + 1).trim();
|
||||
frontmatter[key] = value;
|
||||
}
|
||||
}
|
||||
|
||||
return Object.keys(frontmatter).length > 0 ? frontmatter : null;
|
||||
}
|
||||
|
||||
function countTokens(text: string): number {
|
||||
return Math.ceil(text.length / 4);
|
||||
}
|
||||
|
||||
function countVagueTerms(content: string): number {
|
||||
const lowerContent = content.toLowerCase();
|
||||
let count = 0;
|
||||
for (const term of VAGUE_TERMS) {
|
||||
const regex = new RegExp(term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'gi');
|
||||
const matches = lowerContent.match(regex);
|
||||
if (matches) count += matches.length;
|
||||
}
|
||||
return count;
|
||||
}
|
||||
|
||||
function hasPattern(content: string, patterns: RegExp[]): boolean {
|
||||
return patterns.some(p => p.test(content));
|
||||
}
|
||||
|
||||
function countMatches(content: string, patterns: RegExp[]): number {
|
||||
let count = 0;
|
||||
for (const pattern of patterns) {
|
||||
const matches = content.match(pattern);
|
||||
if (matches) count += matches.length;
|
||||
}
|
||||
return count;
|
||||
}
|
||||
|
||||
function calculateAvgSentenceLength(content: string): number {
|
||||
const contentWithoutCode = content.replace(/```[\s\S]*?```/g, '');
|
||||
const sentences = contentWithoutCode.split(/[.!?]+/).filter(s => s.trim().length > 0);
|
||||
if (sentences.length === 0) return 0;
|
||||
const totalWords = sentences.reduce((sum, s) => sum + s.trim().split(/\s+/).length, 0);
|
||||
return Math.round(totalWords / sentences.length);
|
||||
}
|
||||
|
||||
function evaluateStructure(content: string): StructureScore {
|
||||
const frontmatter = extractFrontmatter(content);
|
||||
const hasMetadata = frontmatter !== null && Object.keys(frontmatter).length > 0;
|
||||
const hasDescription = !!(frontmatter?.description) || /^#+\s*description/im.test(content);
|
||||
const hasTriggers = hasPattern(content, TRIGGER_PATTERNS);
|
||||
const hasExamples = countMatches(content, CODE_EXAMPLE_PATTERNS) > 0;
|
||||
const hasBoundaries = hasPattern(content, BOUNDARY_PATTERNS);
|
||||
const hasWhenToUse = /when\s+to\s+use|use\s+case|scenario/i.test(content);
|
||||
|
||||
let score = 0;
|
||||
if (hasMetadata) score += 15;
|
||||
if (hasDescription) score += 10;
|
||||
if (hasTriggers) score += 20;
|
||||
if (hasExamples) score += 20;
|
||||
if (hasBoundaries) score += 20;
|
||||
if (hasWhenToUse) score += 15;
|
||||
|
||||
return {
|
||||
score: Math.min(100, score),
|
||||
hasMetadata,
|
||||
hasDescription,
|
||||
hasTriggers,
|
||||
hasExamples,
|
||||
hasBoundaries,
|
||||
hasWhenToUse,
|
||||
};
|
||||
}
|
||||
|
||||
function evaluateClarity(content: string): ClarityScore {
|
||||
const lines = content.split('\n');
|
||||
const lineCount = lines.length;
|
||||
const tokenCount = countTokens(content);
|
||||
const avgSentenceLength = calculateAvgSentenceLength(content);
|
||||
const hasHeaders = /^#+\s+/m.test(content);
|
||||
|
||||
let score = 100;
|
||||
|
||||
if (lineCount > 500) score -= 30;
|
||||
else if (lineCount > 300) score -= 15;
|
||||
else if (lineCount > 150) score -= 5;
|
||||
|
||||
if (tokenCount > 4000) score -= 30;
|
||||
else if (tokenCount > 2000) score -= 15;
|
||||
else if (tokenCount > 1000) score -= 5;
|
||||
|
||||
if (avgSentenceLength > 30) score -= 20;
|
||||
else if (avgSentenceLength > 20) score -= 10;
|
||||
|
||||
if (!hasHeaders) score -= 15;
|
||||
|
||||
return {
|
||||
score: Math.max(0, score),
|
||||
lineCount,
|
||||
tokenCount,
|
||||
avgSentenceLength,
|
||||
hasHeaders,
|
||||
};
|
||||
}
|
||||
|
||||
function countCodeBlocks(content: string): number {
|
||||
const fencedBlocks = content.match(/```[\s\S]*?```/g) || [];
|
||||
return fencedBlocks.length;
|
||||
}
|
||||
|
||||
function detectDeprecatedPatterns(content: string): string[] {
|
||||
const codeBlocks = content.match(/```[\s\S]*?```/g) || [];
|
||||
const codeContent = codeBlocks.join('\n');
|
||||
const issues: string[] = [];
|
||||
|
||||
for (const { pattern, message } of DEPRECATED_PATTERNS) {
|
||||
const regex = new RegExp(pattern.source, pattern.flags);
|
||||
if (regex.test(codeContent)) {
|
||||
issues.push(message);
|
||||
}
|
||||
}
|
||||
|
||||
return [...new Set(issues)];
|
||||
}
|
||||
|
||||
function detectSecurityPatterns(content: string): string[] {
|
||||
const issues: string[] = [];
|
||||
|
||||
for (const { pattern, message } of SECURITY_PATTERNS) {
|
||||
const regex = new RegExp(pattern.source, pattern.flags);
|
||||
if (regex.test(content)) {
|
||||
if (!message.includes('Template literal') || content.includes('bash') || content.includes('shell')) {
|
||||
issues.push(message);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return [...new Set(issues)];
|
||||
}
|
||||
|
||||
function detectConflictingInstructions(content: string): string[] {
|
||||
const issues: string[] = [];
|
||||
const lowerContent = content.toLowerCase();
|
||||
|
||||
const alwaysMatches = lowerContent.match(/always\s+(?:use|do|include|add)\s+(\w+)/gi) || [];
|
||||
const neverMatches = lowerContent.match(/never\s+(?:use|do|include|add)\s+(\w+)/gi) || [];
|
||||
|
||||
for (const always of alwaysMatches) {
|
||||
const term = always.replace(/always\s+(?:use|do|include|add)\s+/i, '').toLowerCase();
|
||||
for (const never of neverMatches) {
|
||||
const neverTerm = never.replace(/never\s+(?:use|do|include|add)\s+/i, '').toLowerCase();
|
||||
if (term === neverTerm) {
|
||||
issues.push(`Conflicting instructions: "always" and "never" used with "${term}"`);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
const mustMatches = lowerContent.match(/must\s+(\w+)/gi) || [];
|
||||
const mustNotMatches = lowerContent.match(/must\s+not\s+(\w+)/gi) || [];
|
||||
|
||||
for (const must of mustMatches) {
|
||||
const term = must.replace(/must\s+/i, '').toLowerCase();
|
||||
for (const mustNot of mustNotMatches) {
|
||||
const notTerm = mustNot.replace(/must\s+not\s+/i, '').toLowerCase();
|
||||
if (term === notTerm) {
|
||||
issues.push(`Conflicting instructions: "must" and "must not" used with "${term}"`);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return [...new Set(issues)];
|
||||
}
|
||||
|
||||
function assessCompleteness(content: string): CompletenessResult {
|
||||
const todoMatches = content.match(/TODO|FIXME|XXX|HACK/gi) || [];
|
||||
const todoCount = todoMatches.length;
|
||||
|
||||
const headerPositions: Array<{ header: string; index: number }> = [];
|
||||
const lines = content.split('\n');
|
||||
let inFence = false;
|
||||
let offset = 0;
|
||||
|
||||
for (const line of lines) {
|
||||
if (/^```|^~~~/.test(line)) {
|
||||
inFence = !inFence;
|
||||
} else if (!inFence && /^#+\s+.+$/.test(line)) {
|
||||
headerPositions.push({ header: line, index: offset });
|
||||
}
|
||||
offset += line.length + 1;
|
||||
}
|
||||
|
||||
const emptySections: string[] = [];
|
||||
|
||||
for (let i = 0; i < headerPositions.length - 1; i++) {
|
||||
const current = headerPositions[i];
|
||||
const next = headerPositions[i + 1];
|
||||
const sectionContent = content.slice(current.index + current.header.length, next.index).trim();
|
||||
|
||||
if (sectionContent.length < 20) {
|
||||
const sectionName = current.header.replace(/^#+\s+/, '');
|
||||
emptySections.push(sectionName);
|
||||
}
|
||||
}
|
||||
|
||||
if (headerPositions.length > 0) {
|
||||
const last = headerPositions[headerPositions.length - 1];
|
||||
const tailContent = content.slice(last.index + last.header.length).trim();
|
||||
if (tailContent.length < 20) {
|
||||
const sectionName = last.header.replace(/^#+\s+/, '');
|
||||
emptySections.push(sectionName);
|
||||
}
|
||||
}
|
||||
|
||||
const codeBlocks = countCodeBlocks(content);
|
||||
const exampleCoverage = Math.min(100, codeBlocks * 25);
|
||||
|
||||
let score = 100;
|
||||
if (todoCount > 0) score -= Math.min(30, todoCount * 10);
|
||||
if (emptySections.length > 0) score -= Math.min(30, emptySections.length * 10);
|
||||
if (codeBlocks < 2) score -= 20;
|
||||
else if (codeBlocks < 4) score -= 10;
|
||||
|
||||
return {
|
||||
score: Math.max(0, score),
|
||||
hasTodos: todoCount > 0,
|
||||
todoCount,
|
||||
emptySections,
|
||||
exampleCoverage,
|
||||
};
|
||||
}
|
||||
|
||||
function evaluateAdvanced(content: string): AdvancedScore {
|
||||
const deprecatedPatterns = detectDeprecatedPatterns(content);
|
||||
const conflictingInstructions = detectConflictingInstructions(content);
|
||||
const securityIssues = detectSecurityPatterns(content);
|
||||
const completeness = assessCompleteness(content);
|
||||
|
||||
let score = 100;
|
||||
score -= Math.min(30, deprecatedPatterns.length * 10);
|
||||
score -= Math.min(30, conflictingInstructions.length * 15);
|
||||
score -= Math.min(25, securityIssues.length * 10);
|
||||
score -= Math.round((100 - completeness.score) * 0.15);
|
||||
|
||||
return {
|
||||
score: Math.max(0, score),
|
||||
deprecatedPatterns,
|
||||
conflictingInstructions,
|
||||
securityIssues,
|
||||
completeness,
|
||||
};
|
||||
}
|
||||
|
||||
function evaluateSpecificity(content: string): SpecificityScore {
|
||||
const hasConcreteCommands = countMatches(content, COMMAND_PATTERNS) > 0;
|
||||
const hasFilePatterns = hasPattern(content, FILE_PATTERN_PATTERNS);
|
||||
const codeBlockCount = countCodeBlocks(content);
|
||||
const hasCodeExamples = codeBlockCount >= 2;
|
||||
const vagueTermCount = countVagueTerms(content);
|
||||
|
||||
let score = 0;
|
||||
|
||||
if (hasConcreteCommands) score += 30;
|
||||
if (hasFilePatterns) score += 25;
|
||||
if (hasCodeExamples) score += 30;
|
||||
|
||||
if (vagueTermCount === 0) score += 15;
|
||||
else if (vagueTermCount <= 2) score += 10;
|
||||
else if (vagueTermCount <= 5) score += 5;
|
||||
|
||||
return {
|
||||
score: Math.min(100, score),
|
||||
hasConcreteCommands,
|
||||
hasFilePatterns,
|
||||
hasCodeExamples,
|
||||
vagueTermCount,
|
||||
};
|
||||
}
|
||||
|
||||
function generateWarnings(
|
||||
structure: StructureScore,
|
||||
clarity: ClarityScore,
|
||||
specificity: SpecificityScore,
|
||||
advanced: AdvancedScore
|
||||
): string[] {
|
||||
const warnings: string[] = [];
|
||||
|
||||
if (!structure.hasMetadata) {
|
||||
warnings.push('Missing frontmatter metadata');
|
||||
}
|
||||
if (!structure.hasTriggers) {
|
||||
warnings.push('No trigger conditions defined');
|
||||
}
|
||||
if (!structure.hasBoundaries) {
|
||||
warnings.push('No boundaries or constraints specified');
|
||||
}
|
||||
if (clarity.lineCount > 500) {
|
||||
warnings.push(`Skill is too long (${clarity.lineCount} lines)`);
|
||||
}
|
||||
if (clarity.tokenCount > 4000) {
|
||||
warnings.push(`High token usage (${clarity.tokenCount} tokens)`);
|
||||
}
|
||||
if (specificity.vagueTermCount > 5) {
|
||||
warnings.push(`Contains ${specificity.vagueTermCount} vague terms`);
|
||||
}
|
||||
if (!structure.hasExamples) {
|
||||
warnings.push('No code examples provided');
|
||||
} else if (!specificity.hasCodeExamples) {
|
||||
warnings.push('Only one code example provided');
|
||||
}
|
||||
|
||||
for (const issue of advanced.securityIssues) {
|
||||
warnings.push(`Security: ${issue}`);
|
||||
}
|
||||
for (const conflict of advanced.conflictingInstructions) {
|
||||
warnings.push(conflict);
|
||||
}
|
||||
if (advanced.completeness.hasTodos) {
|
||||
warnings.push(`Contains ${advanced.completeness.todoCount} TODO/FIXME comment(s)`);
|
||||
}
|
||||
if (advanced.completeness.emptySections.length > 0) {
|
||||
warnings.push(`Empty sections: ${advanced.completeness.emptySections.join(', ')}`);
|
||||
}
|
||||
|
||||
return warnings;
|
||||
}
|
||||
|
||||
function generateSuggestions(
|
||||
structure: StructureScore,
|
||||
clarity: ClarityScore,
|
||||
specificity: SpecificityScore,
|
||||
advanced: AdvancedScore
|
||||
): string[] {
|
||||
const suggestions: string[] = [];
|
||||
|
||||
if (!structure.hasMetadata) {
|
||||
suggestions.push('Add YAML frontmatter with name, description, and globs');
|
||||
}
|
||||
if (!structure.hasTriggers) {
|
||||
suggestions.push('Add a "When to Use" section with specific trigger conditions');
|
||||
}
|
||||
if (!structure.hasExamples) {
|
||||
suggestions.push('Include code examples showing expected output');
|
||||
}
|
||||
if (!structure.hasBoundaries) {
|
||||
suggestions.push('Define boundaries: what the agent should never do');
|
||||
}
|
||||
if (clarity.lineCount > 300) {
|
||||
suggestions.push('Consider splitting into multiple focused skills');
|
||||
}
|
||||
if (!clarity.hasHeaders) {
|
||||
suggestions.push('Use markdown headers to organize content');
|
||||
}
|
||||
if (specificity.vagueTermCount > 0) {
|
||||
suggestions.push('Replace vague terms with specific instructions');
|
||||
}
|
||||
if (!specificity.hasConcreteCommands) {
|
||||
suggestions.push('Add concrete executable commands with flags');
|
||||
}
|
||||
|
||||
if (advanced.deprecatedPatterns.length > 0) {
|
||||
suggestions.push('Update code examples to use modern patterns (ES modules, hooks, async/await)');
|
||||
}
|
||||
if (advanced.securityIssues.length > 0) {
|
||||
suggestions.push('Review and remove potential security risks from examples');
|
||||
}
|
||||
if (advanced.completeness.hasTodos) {
|
||||
suggestions.push('Complete or remove TODO/FIXME comments');
|
||||
}
|
||||
if (advanced.completeness.emptySections.length > 0) {
|
||||
suggestions.push('Add content to empty sections or remove them');
|
||||
}
|
||||
if (advanced.completeness.exampleCoverage < 50) {
|
||||
suggestions.push('Add more code examples to improve coverage');
|
||||
}
|
||||
|
||||
return suggestions;
|
||||
}
|
||||
|
||||
export function evaluateSkillContent(content: string): QualityScore {
|
||||
const structure = evaluateStructure(content);
|
||||
const clarity = evaluateClarity(content);
|
||||
const specificity = evaluateSpecificity(content);
|
||||
const advanced = evaluateAdvanced(content);
|
||||
|
||||
const overall = Math.round(
|
||||
structure.score * 0.35 +
|
||||
clarity.score * 0.25 +
|
||||
specificity.score * 0.25 +
|
||||
advanced.score * 0.15
|
||||
);
|
||||
|
||||
const warnings = generateWarnings(structure, clarity, specificity, advanced);
|
||||
const suggestions = generateSuggestions(structure, clarity, specificity, advanced);
|
||||
|
||||
return {
|
||||
overall,
|
||||
structure,
|
||||
clarity,
|
||||
specificity,
|
||||
advanced,
|
||||
warnings,
|
||||
suggestions,
|
||||
};
|
||||
}
|
||||
|
||||
export function evaluateSkillFile(filePath: string): QualityScore | null {
|
||||
if (!existsSync(filePath)) return null;
|
||||
|
||||
try {
|
||||
const content = readFileSync(filePath, 'utf-8');
|
||||
return evaluateSkillContent(content);
|
||||
} catch {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
export function evaluateSkillDirectory(dirPath: string): QualityScore | null {
|
||||
const skillMdPath = join(dirPath, 'SKILL.md');
|
||||
if (existsSync(skillMdPath)) {
|
||||
return evaluateSkillFile(skillMdPath);
|
||||
}
|
||||
|
||||
const mdcFiles = ['index.mdc', `${basename(dirPath)}.mdc`];
|
||||
for (const file of mdcFiles) {
|
||||
const mdcPath = join(dirPath, file);
|
||||
if (existsSync(mdcPath)) {
|
||||
return evaluateSkillFile(mdcPath);
|
||||
}
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
export function getQualityGrade(score: number): string {
|
||||
if (score >= 90) return 'A';
|
||||
if (score >= 80) return 'B';
|
||||
if (score >= 70) return 'C';
|
||||
if (score >= 60) return 'D';
|
||||
return 'F';
|
||||
}
|
||||
|
||||
export function isHighQuality(score: QualityScore): boolean {
|
||||
return score.overall >= 80 && score.warnings.length <= 2;
|
||||
}
|
||||
@@ -45,25 +45,16 @@ export function SkillList({
|
||||
const pointer = isSelected ? symbols.pointer : symbols.pointerInactive;
|
||||
const fg = isSelected ? terminalColors.accent : terminalColors.text;
|
||||
const statusIcon = skill.enabled ? symbols.active : symbols.pending;
|
||||
const statusColor = skill.enabled
|
||||
? terminalColors.success
|
||||
: terminalColors.textMuted;
|
||||
const descPart = skill.description
|
||||
? ` - ${skill.description.slice(0, 40)}${skill.description.length > 40 ? '...' : ''}`
|
||||
: '';
|
||||
// Use single text element to avoid rendering overlap
|
||||
const line = `${pointer} ${skill.name} ${statusIcon}${descPart}`;
|
||||
|
||||
return (
|
||||
<box key={skill.name} flexDirection="row">
|
||||
<text fg={fg}>
|
||||
{isSelected ? <b>{pointer} {skill.name}</b> : <>{pointer} {skill.name}</>}
|
||||
</text>
|
||||
<text fg={terminalColors.textMuted}>
|
||||
{' '}{statusIcon}
|
||||
</text>
|
||||
{skill.description && (
|
||||
<text fg={terminalColors.textMuted}>
|
||||
{' '}- {skill.description.slice(0, 40)}
|
||||
{skill.description.length > 40 ? '...' : ''}
|
||||
</text>
|
||||
)}
|
||||
</box>
|
||||
<text key={skill.name} fg={fg}>
|
||||
{isSelected ? <b>{line}</b> : line}
|
||||
</text>
|
||||
);
|
||||
})}
|
||||
|
||||
|
||||
@@ -2,19 +2,39 @@ import { createCliRenderer } from '@opentui/core';
|
||||
import { createRoot } from '@opentui/react';
|
||||
import { App } from './App.js';
|
||||
|
||||
let rootInstance: ReturnType<typeof createRoot> | null = null;
|
||||
|
||||
export function exitTUI(code = 0): void {
|
||||
try {
|
||||
process.stdout.write('\x1b[?1049l\x1b[?25h\x1b[0m');
|
||||
// Unmount React tree first
|
||||
if (rootInstance) {
|
||||
try {
|
||||
rootInstance.unmount();
|
||||
} catch {
|
||||
// Ignore unmount errors
|
||||
}
|
||||
rootInstance = null;
|
||||
}
|
||||
|
||||
// Restore terminal state: exit alt screen, show cursor, reset attributes, clear
|
||||
process.stdout.write('\x1b[?1049l\x1b[?25h\x1b[0m\x1b[H\x1b[2J');
|
||||
} catch {
|
||||
// Ignore write errors
|
||||
}
|
||||
process.exit(code);
|
||||
|
||||
// Use setImmediate to allow any pending operations to complete
|
||||
setImmediate(() => process.exit(code));
|
||||
}
|
||||
|
||||
export async function startTUI(): Promise<never> {
|
||||
const renderer = await createCliRenderer({ exitOnCtrlC: true });
|
||||
const root = createRoot(renderer);
|
||||
root.render(<App onExit={exitTUI} />);
|
||||
// Setup signal handlers for clean exit
|
||||
const handleSignal = () => exitTUI(0);
|
||||
process.on('SIGINT', handleSignal);
|
||||
process.on('SIGTERM', handleSignal);
|
||||
|
||||
const renderer = await createCliRenderer({ exitOnCtrlC: false });
|
||||
rootInstance = createRoot(renderer);
|
||||
rootInstance.render(<App onExit={exitTUI} />);
|
||||
return new Promise(() => {});
|
||||
}
|
||||
|
||||
|
||||
@@ -142,19 +142,16 @@ export function Browse({ onNavigate, cols = 80, rows = 24 }: BrowseProps) {
|
||||
const selected = actualIdx === selectedIndex;
|
||||
const indicator = selected ? '▸' : ' ';
|
||||
// Truncate source if needed - clamp to avoid negative slicing
|
||||
const available = Math.max(0, contentWidth - repo.name.length - 6);
|
||||
const safeSlice = Math.max(0, available - 3);
|
||||
const displaySource = available > 0 && repo.source.length > available
|
||||
? repo.source.slice(0, safeSlice) + '...'
|
||||
const maxSourceLen = Math.max(0, contentWidth - repo.name.length - 6);
|
||||
const displaySource = maxSourceLen > 3 && repo.source.length > maxSourceLen
|
||||
? repo.source.slice(0, maxSourceLen - 3) + '...'
|
||||
: repo.source;
|
||||
// Use single text element to avoid rendering overlap issues
|
||||
const line = `${indicator}${repo.name} · ${displaySource}`;
|
||||
return (
|
||||
<box key={repo.source} flexDirection="row">
|
||||
<text fg={terminalColors.text}>{indicator}</text>
|
||||
<text fg={selected ? terminalColors.accent : terminalColors.text}>
|
||||
{repo.name}
|
||||
</text>
|
||||
<text fg={terminalColors.textMuted}> · {displaySource}</text>
|
||||
</box>
|
||||
<text key={repo.source} fg={selected ? terminalColors.accent : terminalColors.text}>
|
||||
{line}
|
||||
</text>
|
||||
);
|
||||
})}
|
||||
</box>
|
||||
|
||||
@@ -188,15 +188,16 @@ export function Installed({ onNavigate, cols = 80, rows = 24 }: InstalledProps)
|
||||
const selected = actualIdx === selectedIndex;
|
||||
const indicator = selected ? '▸' : ' ';
|
||||
const statusIcon = skill.enabled !== false ? '●' : '○';
|
||||
const statusColor = skill.enabled !== false ? terminalColors.success : terminalColors.textMuted;
|
||||
const qualityBadge = skill.grade ? ` [${skill.grade}]` : '';
|
||||
const warningIndicator = skill.warnings && skill.warnings > 2 ? ' ⚠' : '';
|
||||
const line = `${indicator}${statusIcon} ${skill.name}${qualityBadge}${warningIndicator}`;
|
||||
const badgeColor = skill.quality !== undefined
|
||||
? (skill.quality >= 80 ? terminalColors.success : skill.quality >= 60 ? terminalColors.warning : terminalColors.error)
|
||||
: terminalColors.text;
|
||||
return (
|
||||
<box key={skill.name} flexDirection="row">
|
||||
<text fg={terminalColors.text}>{indicator}</text>
|
||||
<text fg={statusColor}>{statusIcon} </text>
|
||||
<text fg={selected ? terminalColors.accent : terminalColors.text}>
|
||||
{skill.name}
|
||||
</text>
|
||||
</box>
|
||||
<text key={skill.name} fg={selected ? terminalColors.accent : badgeColor}>
|
||||
{line}
|
||||
</text>
|
||||
);
|
||||
})}
|
||||
|
||||
|
||||
@@ -109,23 +109,18 @@ export function Marketplace({ onNavigate, cols = 80, rows = 24 }: MarketplacePro
|
||||
{/* Featured section */}
|
||||
{animPhase >= 3 && (
|
||||
<box flexDirection="column">
|
||||
<box flexDirection="row">
|
||||
<text fg={terminalColors.text}>Featured</text>
|
||||
<text fg={terminalColors.textMuted}> · trending</text>
|
||||
</box>
|
||||
<text fg={terminalColors.text}>Featured · <text fg={terminalColors.textMuted}>trending</text></text>
|
||||
<text> </text>
|
||||
|
||||
{visibleFeatured.map((item, idx) => {
|
||||
const selected = idx === selectedIndex;
|
||||
const indicator = selected ? '▸' : ' ';
|
||||
// Use single text element to avoid rendering overlap
|
||||
const line = `${indicator}${item.name} ★${item.stars}`;
|
||||
return (
|
||||
<box key={item.source} flexDirection="row">
|
||||
<text fg={terminalColors.text}>{indicator}</text>
|
||||
<text fg={selected ? terminalColors.accent : terminalColors.text}>
|
||||
{item.name}
|
||||
</text>
|
||||
<text fg={terminalColors.recommend}> ★{item.stars}</text>
|
||||
</box>
|
||||
<text key={item.source} fg={selected ? terminalColors.accent : terminalColors.text}>
|
||||
{line}
|
||||
</text>
|
||||
);
|
||||
})}
|
||||
|
||||
|
||||
@@ -50,14 +50,14 @@ export function Recommend({ onNavigate, cols = 80, rows = 24 }: RecommendProps)
|
||||
return () => clearInterval(interval);
|
||||
}, [analyzing]);
|
||||
|
||||
// Recommendations data
|
||||
// Recommendations data (with quality scores)
|
||||
const recommendations = useMemo(() => [
|
||||
{ name: 'tdd-workflow', reason: 'Based on your test files and coverage patterns', confidence: 95 },
|
||||
{ name: 'react-patterns', reason: 'Detected React in package.json with hooks usage', confidence: 88 },
|
||||
{ name: 'typescript-strict', reason: 'tsconfig.json found with strict mode disabled', confidence: 82 },
|
||||
{ name: 'git-workflow', reason: '.git directory with complex branching detected', confidence: 75 },
|
||||
{ name: 'api-design', reason: 'REST endpoints found in your codebase', confidence: 68 },
|
||||
{ name: 'docker-compose', reason: 'docker-compose.yml detected for orchestration', confidence: 62 },
|
||||
{ name: 'tdd-workflow', reason: 'Based on your test files and coverage patterns', confidence: 95, quality: 92, grade: 'A' },
|
||||
{ name: 'react-patterns', reason: 'Detected React in package.json with hooks usage', confidence: 88, quality: 85, grade: 'B' },
|
||||
{ name: 'typescript-strict', reason: 'tsconfig.json found with strict mode disabled', confidence: 82, quality: 78, grade: 'C' },
|
||||
{ name: 'git-workflow', reason: '.git directory with complex branching detected', confidence: 75, quality: 82, grade: 'B' },
|
||||
{ name: 'api-design', reason: 'REST endpoints found in your codebase', confidence: 68, quality: 71, grade: 'C' },
|
||||
{ name: 'docker-compose', reason: 'docker-compose.yml detected for orchestration', confidence: 62, quality: 65, grade: 'D' },
|
||||
], []);
|
||||
|
||||
const maxVisible = Math.max(3, Math.floor((rows - 10) / 2));
|
||||
@@ -163,6 +163,7 @@ export function Recommend({ onNavigate, cols = 80, rows = 24 }: RecommendProps)
|
||||
{visibleRecs.map((rec, idx) => {
|
||||
const selected = idx === selectedIndex;
|
||||
const indicator = selected ? '▸' : ' ';
|
||||
const qualityColor = rec.quality >= 80 ? terminalColors.success : rec.quality >= 60 ? terminalColors.warning : terminalColors.error;
|
||||
return (
|
||||
<box key={rec.name} flexDirection="column">
|
||||
<box flexDirection="row">
|
||||
@@ -171,6 +172,7 @@ export function Recommend({ onNavigate, cols = 80, rows = 24 }: RecommendProps)
|
||||
{rec.name}
|
||||
</text>
|
||||
<text fg={getConfColor(rec.confidence)}> {rec.confidence}%</text>
|
||||
<text fg={qualityColor}> [{rec.grade}]</text>
|
||||
</box>
|
||||
<text fg={terminalColors.textMuted}> {rec.reason}</text>
|
||||
<text> </text>
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
/**
|
||||
* Skills state management for SkillKit TUI
|
||||
*/
|
||||
import { findAllSkills } from '@skillkit/core';
|
||||
import { findAllSkills, evaluateSkillDirectory, getQualityGrade } from '@skillkit/core';
|
||||
import { rmSync } from 'node:fs';
|
||||
import { resolve, normalize } from 'node:path';
|
||||
import { getSearchDirs } from '../utils/helpers.js';
|
||||
@@ -38,12 +38,18 @@ export function loadSkills(agentType?: AgentType): SkillsState {
|
||||
const searchDirs = getSearchDirs(agentType);
|
||||
const foundSkills = findAllSkills(searchDirs);
|
||||
|
||||
const skillItems: SkillItem[] = foundSkills.map((s) => ({
|
||||
name: s.name,
|
||||
description: s.description,
|
||||
source: s.metadata?.source,
|
||||
enabled: s.enabled,
|
||||
}));
|
||||
const skillItems: SkillItem[] = foundSkills.map((s) => {
|
||||
const quality = evaluateSkillDirectory(s.path);
|
||||
return {
|
||||
name: s.name,
|
||||
description: s.description,
|
||||
source: s.metadata?.source,
|
||||
enabled: s.enabled,
|
||||
quality: quality?.overall,
|
||||
grade: quality ? getQualityGrade(quality.overall) : undefined,
|
||||
warnings: quality?.warnings.length,
|
||||
};
|
||||
});
|
||||
|
||||
return {
|
||||
skills: skillItems,
|
||||
|
||||
@@ -4,6 +4,9 @@ export interface SkillItem {
|
||||
source?: string;
|
||||
installs?: number;
|
||||
enabled?: boolean;
|
||||
quality?: number;
|
||||
grade?: string;
|
||||
warnings?: number;
|
||||
}
|
||||
|
||||
export interface RepoInfo {
|
||||
|
||||
Generated
+28
-11
@@ -82,6 +82,9 @@ importers:
|
||||
|
||||
packages/cli:
|
||||
dependencies:
|
||||
'@clack/prompts':
|
||||
specifier: ^0.11.0
|
||||
version: 0.11.0
|
||||
'@skillkit/agents':
|
||||
specifier: workspace:*
|
||||
version: link:../agents
|
||||
@@ -106,6 +109,9 @@ importers:
|
||||
ora:
|
||||
specifier: ^8.1.0
|
||||
version: 8.2.0
|
||||
picocolors:
|
||||
specifier: ^1.1.1
|
||||
version: 1.1.1
|
||||
yaml:
|
||||
specifier: ^2.7.0
|
||||
version: 2.8.2
|
||||
@@ -125,9 +131,6 @@ importers:
|
||||
|
||||
packages/core:
|
||||
dependencies:
|
||||
'@types/minimatch':
|
||||
specifier: ^6.0.0
|
||||
version: 6.0.0
|
||||
minimatch:
|
||||
specifier: ^10.1.1
|
||||
version: 10.1.1
|
||||
@@ -187,6 +190,12 @@ importers:
|
||||
|
||||
packages:
|
||||
|
||||
'@clack/core@0.5.0':
|
||||
resolution: {integrity: sha512-p3y0FIOwaYRUPRcMO7+dlmLh8PSRcrjuTndsiA0WAFbWES0mLZlrjVoBRZ9DzkPFJZG6KGkJmoEAY0ZcVWTkow==}
|
||||
|
||||
'@clack/prompts@0.11.0':
|
||||
resolution: {integrity: sha512-pMN5FcrEw9hUkZA4f+zLlzivQSeQf5dRGJjSUbvVYDLvpKCdQx5OaknvKzgbtXOizhP+SJJJjqEbOe55uKKfAw==}
|
||||
|
||||
'@dimforge/rapier2d-simd-compat@0.17.3':
|
||||
resolution: {integrity: sha512-bijvwWz6NHsNj5e5i1vtd3dU2pDhthSaTUZSh14DUGGKJfw8eMnlWZsxwHBxB/a3AXVNDjL9abuHw1k9FGR+jg==}
|
||||
|
||||
@@ -803,10 +812,6 @@ packages:
|
||||
'@types/http-cache-semantics@4.0.4':
|
||||
resolution: {integrity: sha512-1m0bIFVc7eJWyve9S0RnuRgcQqF/Xd5QsUZAZeQFr1Q3/p9JWoQQEqmVy+DPTNpGXwhgIetAoYF8JSc33q29QA==}
|
||||
|
||||
'@types/minimatch@6.0.0':
|
||||
resolution: {integrity: sha512-zmPitbQ8+6zNutpwgcQuLcsEpn/Cj54Kbn7L5pX0Os5kdWplB7xPgEh/g+SWOB/qmows2gpuCaPyduq8ZZRnxA==}
|
||||
deprecated: This is a stub types definition. minimatch provides its own type definitions, so you do not need this installed.
|
||||
|
||||
'@types/node@16.9.1':
|
||||
resolution: {integrity: sha512-QpLcX9ZSsq3YYUUnD3nFDY8H7wctAhQj/TFKL8Ya8v5fMm3CFXxo8zStsLAl780ltoYoo1WvKUVGBQK+1ifr7g==}
|
||||
|
||||
@@ -1524,6 +1529,9 @@ packages:
|
||||
resolution: {integrity: sha512-kWJDCr9EWtZ+/EYYM5MareWj2cRnZGF93YDNpH4jQiHB+hBIZnfPFSQiVMzZOdk+zXWqTZ/9fTeQNu2DqeiudA==}
|
||||
engines: {node: '>=20.12.2'}
|
||||
|
||||
sisteransi@1.0.5:
|
||||
resolution: {integrity: sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==}
|
||||
|
||||
source-map-js@1.2.1:
|
||||
resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==}
|
||||
engines: {node: '>=0.10.0'}
|
||||
@@ -1823,6 +1831,17 @@ packages:
|
||||
|
||||
snapshots:
|
||||
|
||||
'@clack/core@0.5.0':
|
||||
dependencies:
|
||||
picocolors: 1.1.1
|
||||
sisteransi: 1.0.5
|
||||
|
||||
'@clack/prompts@0.11.0':
|
||||
dependencies:
|
||||
'@clack/core': 0.5.0
|
||||
picocolors: 1.1.1
|
||||
sisteransi: 1.0.5
|
||||
|
||||
'@dimforge/rapier2d-simd-compat@0.17.3':
|
||||
optional: true
|
||||
|
||||
@@ -2322,10 +2341,6 @@ snapshots:
|
||||
|
||||
'@types/http-cache-semantics@4.0.4': {}
|
||||
|
||||
'@types/minimatch@6.0.0':
|
||||
dependencies:
|
||||
minimatch: 10.1.1
|
||||
|
||||
'@types/node@16.9.1': {}
|
||||
|
||||
'@types/node@22.19.7':
|
||||
@@ -3072,6 +3087,8 @@ snapshots:
|
||||
|
||||
simple-xml-to-json@1.2.3: {}
|
||||
|
||||
sisteransi@1.0.5: {}
|
||||
|
||||
source-map-js@1.2.1: {}
|
||||
|
||||
source-map@0.7.6: {}
|
||||
|
||||
@@ -0,0 +1,149 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* Compute quality scores for marketplace skills
|
||||
*
|
||||
* This script assigns default quality scores to skills based on source verification.
|
||||
* For detailed quality evaluation, skills would need to be fetched and analyzed individually.
|
||||
*
|
||||
* Usage:
|
||||
* npx tsx scripts/compute-quality.ts
|
||||
* pnpm tsx scripts/compute-quality.ts
|
||||
*/
|
||||
|
||||
import { readFileSync, writeFileSync } from 'node:fs';
|
||||
import { join, dirname } from 'node:path';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
|
||||
const __filename = fileURLToPath(import.meta.url);
|
||||
const __dirname = dirname(__filename);
|
||||
|
||||
interface Skill {
|
||||
id: string;
|
||||
name: string;
|
||||
source: string;
|
||||
description?: string;
|
||||
tags: string[];
|
||||
author?: string;
|
||||
version?: string;
|
||||
agents?: string[];
|
||||
quality?: number;
|
||||
}
|
||||
|
||||
interface SkillsIndex {
|
||||
version: number;
|
||||
updatedAt: string;
|
||||
skills: Skill[];
|
||||
}
|
||||
|
||||
const VERIFIED_SOURCES = [
|
||||
'anthropics/',
|
||||
'vercel/',
|
||||
'vercel-labs/',
|
||||
'modelcontextprotocol/',
|
||||
'cursor/',
|
||||
'google/',
|
||||
'microsoft/',
|
||||
'openai/',
|
||||
];
|
||||
|
||||
const TRUSTED_AUTHORS = [
|
||||
'anthropic',
|
||||
'vercel',
|
||||
'google',
|
||||
'microsoft',
|
||||
'openai',
|
||||
];
|
||||
|
||||
function computeDefaultQuality(skill: Skill): number {
|
||||
let score = 70;
|
||||
|
||||
for (const verified of VERIFIED_SOURCES) {
|
||||
if (skill.source.startsWith(verified)) {
|
||||
score = 85;
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
if (skill.author) {
|
||||
for (const trusted of TRUSTED_AUTHORS) {
|
||||
if (skill.author.toLowerCase().includes(trusted)) {
|
||||
score = Math.max(score, 85);
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if (skill.description && skill.description.length > 50) {
|
||||
score += 3;
|
||||
}
|
||||
|
||||
if (skill.tags && skill.tags.length >= 3) {
|
||||
score += 2;
|
||||
}
|
||||
|
||||
if (skill.version) {
|
||||
score += 2;
|
||||
}
|
||||
|
||||
if (skill.agents && skill.agents.length >= 2) {
|
||||
score += 3;
|
||||
}
|
||||
|
||||
return Math.min(100, score);
|
||||
}
|
||||
|
||||
function main(): void {
|
||||
const skillsPath = join(__dirname, '../marketplace/skills.json');
|
||||
|
||||
console.log('Reading skills.json...');
|
||||
|
||||
let data: SkillsIndex;
|
||||
try {
|
||||
const content = readFileSync(skillsPath, 'utf-8');
|
||||
data = JSON.parse(content) as SkillsIndex;
|
||||
} catch (err) {
|
||||
console.error(`Failed to read or parse skills.json: ${err instanceof Error ? err.message : String(err)}`);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
if (!data.skills || data.skills.length === 0) {
|
||||
console.log('No skills found in skills.json');
|
||||
return;
|
||||
}
|
||||
|
||||
console.log(`Processing ${data.skills.length} skills...`);
|
||||
|
||||
let updated = 0;
|
||||
let verified = 0;
|
||||
|
||||
for (const skill of data.skills) {
|
||||
const quality = computeDefaultQuality(skill);
|
||||
if (skill.quality !== quality) {
|
||||
skill.quality = quality;
|
||||
updated++;
|
||||
}
|
||||
if (quality >= 85) {
|
||||
verified++;
|
||||
}
|
||||
}
|
||||
|
||||
data.updatedAt = new Date().toISOString().split('T')[0];
|
||||
|
||||
console.log(`Updated ${updated} skills with quality scores`);
|
||||
console.log(`Verified sources: ${verified} skills (quality >= 85)`);
|
||||
|
||||
const averageQuality = Math.round(
|
||||
data.skills.reduce((sum, s) => sum + (s.quality ?? 70), 0) / data.skills.length
|
||||
);
|
||||
console.log(`Average quality: ${averageQuality}`);
|
||||
|
||||
try {
|
||||
writeFileSync(skillsPath, JSON.stringify(data, null, 2) + '\n');
|
||||
console.log('Saved skills.json');
|
||||
} catch (err) {
|
||||
console.error(`Failed to write skills.json: ${err instanceof Error ? err.message : String(err)}`);
|
||||
process.exit(1);
|
||||
}
|
||||
}
|
||||
|
||||
main();
|
||||
Reference in New Issue
Block a user