From b559a2acbf308a3b268115ddbb38826ad1f4e7db Mon Sep 17 00:00:00 2001 From: Rohit Ghumare <48523873+rohitg00@users.noreply.github.com> Date: Wed, 28 Jan 2026 10:47:02 +0000 Subject: [PATCH] feat: DX improvements - new CLI commands, simplified onboarding, and website updates (#19) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * feat(cli): add check, find, manifest commands and simplified onboarding New commands: - skillkit check - Check for available skill updates (dry-run) - skillkit find - Quick CLI marketplace search with interactive mode - skillkit manifest - Manage .skills manifest file for declarative skills Manifest subcommands: - manifest init - Create new .skills file - manifest add - Add skill source to manifest - manifest remove - Remove skill source from manifest - manifest install - Install all skills from manifest - manifest generate - Generate manifest from installed skills Onboarding improvements: - Add quickAgentSelect() for simplified agent selection - Same as last time (Recommended) option for returning users - All detected agents quick option - Select specific agents for manual selection - Streamlined install flow with fewer prompts Other changes: - Add bullet, arrowUp, arrowDown symbols to theme - Update version to 1.7.6 * feat(website): showcase full CLI power with Commands section - Add Commands.tsx with tabbed command showcase (Core, Discovery, Team, Advanced) - Update Hero terminal demo with new commands (find, ui, check, manifest) - Update Features section with TUI, Plugins, Manifest, CI/CD, Slash Commands - Update stats to show 17 agents, 30+ commands, 15K skills - Update comparison table with .skills manifest and CI/CD - Bump version display to v1.7.5 * fix: address CodeRabbit review suggestions - Security: Use execFileSync instead of execSync to prevent command injection in manifest install - Fix: Remove false positive hasUpdate for remote skills in check command - Fix: Add missing repoName filter in interactive find search - Fix: Remove incorrect sourceType→agents mapping in manifest generate - Perf: Eliminate duplicate findSkill calls in check command * docs: add demo video and update README - Add skillkit-demo.mp4 video to README - Update website badge to agenstskills.com - Remove old GIF reference --- README.md | 8 +- apps/skillkit/src/cli.ts | 18 ++ docs/skillkit/App.tsx | 2 + docs/skillkit/components/Commands.tsx | 103 ++++++++ docs/skillkit/components/Features.tsx | 47 ++-- docs/skillkit/components/Hero.tsx | 25 +- docs/skillkit/public/skillkit-demo.mp4 | Bin 0 -> 347277 bytes packages/cli/src/commands/check.ts | 211 ++++++++++++++++ packages/cli/src/commands/find.ts | 181 ++++++++++++++ packages/cli/src/commands/index.ts | 11 + packages/cli/src/commands/install.ts | 19 +- packages/cli/src/commands/manifest.ts | 325 +++++++++++++++++++++++++ packages/cli/src/onboarding/index.ts | 3 +- packages/cli/src/onboarding/prompts.ts | 66 +++++ packages/cli/src/onboarding/theme.ts | 3 + packages/core/src/index.ts | 2 +- packages/core/src/manifest/index.ts | 206 ++++++++++++++++ 17 files changed, 1178 insertions(+), 52 deletions(-) create mode 100644 docs/skillkit/components/Commands.tsx create mode 100644 docs/skillkit/public/skillkit-demo.mp4 create mode 100644 packages/cli/src/commands/check.ts create mode 100644 packages/cli/src/commands/find.ts create mode 100644 packages/cli/src/commands/manifest.ts create mode 100644 packages/core/src/manifest/index.ts diff --git a/README.md b/README.md index 04aef8ed..18d24da8 100644 --- a/README.md +++ b/README.md @@ -11,7 +11,7 @@ [![npm downloads](https://img.shields.io/npm/dm/skillkit.svg)](https://www.npmjs.com/package/skillkit) [![GitHub Package](https://img.shields.io/badge/GitHub%20Package-@rohitg00/skillkit-blue?logo=github)](https://github.com/rohitg00/skillkit/pkgs/npm/skillkit) [![CI](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml/badge.svg)](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml) -[![Website](https://img.shields.io/badge/Website-skillkit-black)](https://rohitg00.github.io/skillkit/) +[![Website](https://img.shields.io/badge/Website-agenstskills.com-black)](https://agenstskills.com) [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) ## Supercharge Every AI Coding Agent @@ -32,6 +32,10 @@ npm install -g skillkit ## See It In Action + + +> **Note:** If the video doesn't play above, [watch it here](https://raw.githubusercontent.com/rohitg00/skillkit/main/docs/skillkit/public/skillkit-demo.mp4) + ```bash # Install a skill for ALL your agents at once skillkit install anthropics/skills --agent claude-code,cursor,windsurf @@ -46,8 +50,6 @@ skillkit recommend # > 85% match: nextjs-app-router ``` -![SkillKit Demo](https://raw.githubusercontent.com/rohitg00/skillkit/main/skillkit.gif) - ## Beautiful CLI Experience SkillKit features a polished, interactive CLI with visual feedback: diff --git a/apps/skillkit/src/cli.ts b/apps/skillkit/src/cli.ts index 8d97f8e3..e79cf147 100644 --- a/apps/skillkit/src/cli.ts +++ b/apps/skillkit/src/cli.ts @@ -47,6 +47,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); @@ -108,4 +117,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)); diff --git a/docs/skillkit/App.tsx b/docs/skillkit/App.tsx index 414993af..0f3d6496 100644 --- a/docs/skillkit/App.tsx +++ b/docs/skillkit/App.tsx @@ -5,6 +5,7 @@ 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'; const GITHUB_ICON = ( @@ -61,6 +62,7 @@ export default function App(): React.ReactElement { +
diff --git a/docs/skillkit/components/Commands.tsx b/docs/skillkit/components/Commands.tsx new file mode 100644 index 00000000..238f7db6 --- /dev/null +++ b/docs/skillkit/components/Commands.tsx @@ -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 ( +
+
+
+

30+ Commands

+

+ Everything you need from the terminal. +

+
+ +
+ {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 ( + + ); + })} +
+ +
+
+ {group.commands.map((c) => ( +
+ $ + skillkit {c.cmd} + → + {c.desc} +
+ ))} +
+
+ +
+ + Run skillkit --help for all commands + +
+
+ + ); +} diff --git a/docs/skillkit/components/Features.tsx b/docs/skillkit/components/Features.tsx index 058d4f66..4a535490 100644 --- a/docs/skillkit/components/Features.tsx +++ b/docs/skillkit/components/Features.tsx @@ -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: ( @@ -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: ( - + ) }, { - title: 'Persistent Memory', - description: 'Save learnings as reusable skills.', + title: 'Plugins', + description: 'Extend with custom plugins & hooks.', icon: ( - + ) }, { - title: 'Team Sync', - description: 'Share skills via Git across your team.', + title: 'Manifest', + description: '.skills file for team-wide consistency.', icon: ( - + ) }, { - title: 'Testing', - description: 'Built-in framework for skill validation.', + title: 'CI/CD', + description: 'GitHub, GitLab, CircleCI templates included.', icon: ( - + ) }, { - title: 'Workflows', - description: 'Compose multi-step automated pipelines.', + title: 'Slash Commands', + description: 'Generate /commands for Claude, Cursor & more.', icon: ( - + ) } ]; 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 {

-
17+
+
17
Agents
-
1
-
Command
+
30+
+
Commands
-
∞
+
15K
Skills
diff --git a/docs/skillkit/components/Hero.tsx b/docs/skillkit/components/Hero.tsx index cb5fe73d..b16d141b 100644 --- a/docs/skillkit/components/Hero.tsx +++ b/docs/skillkit/components/Hero.tsx @@ -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 {
- v1.7.1 + v1.7.5

@@ -132,8 +133,8 @@ export function Hero(): React.ReactElement {

- 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.

diff --git a/docs/skillkit/public/skillkit-demo.mp4 b/docs/skillkit/public/skillkit-demo.mp4 new file mode 100644 index 0000000000000000000000000000000000000000..3214a6a50b5c17271033c0727906400f45e05efe GIT binary patch literal 347277 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 p;o1aHp(dz_KN!Tti6sm { + 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 } => 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; + } +} diff --git a/packages/cli/src/commands/find.ts b/packages/cli/src/commands/find.ts new file mode 100644 index 00000000..6b143092 --- /dev/null +++ b/packages/cli/src/commands/find.ts @@ -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 { + 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 ')); + } + + return 0; + } +} diff --git a/packages/cli/src/commands/index.ts b/packages/cli/src/commands/index.ts index 301b205e..59e58372 100644 --- a/packages/cli/src/commands/index.ts +++ b/packages/cli/src/commands/index.ts @@ -41,3 +41,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'; diff --git a/packages/cli/src/commands/install.ts b/packages/cli/src/commands/install.ts index 1f1e5f84..122b2657 100644 --- a/packages/cli/src/commands/install.ts +++ b/packages/cli/src/commands/install.ts @@ -14,7 +14,7 @@ import { getAgentIcon, isCancel, spinner, - agentMultiselect, + quickAgentSelect, skillMultiselect, selectInstallMethod, confirm, @@ -197,20 +197,15 @@ export class InstallCommand extends Command { // Explicitly specified agents targetAgents = this.agent as AgentType[]; } else if (isInteractive) { - // Interactive agent selection const allAgentTypes = getAllAdapters().map(a => a.type); - const detectedAgent = await detectAgent(); - - // Get last selected agents or use detected const lastAgents = getLastAgents(); - const initialAgents = lastAgents.length > 0 - ? lastAgents.filter(a => allAgentTypes.includes(a as AgentType)) - : [detectedAgent]; - const agentResult = await agentMultiselect({ - message: 'Install to which agents?', + step(`Detected ${allAgentTypes.length} agents`); + + const agentResult = await quickAgentSelect({ + message: 'Install to', agents: allAgentTypes, - initialValues: initialAgents, + lastSelected: lastAgents, }); if (isCancel(agentResult)) { @@ -218,7 +213,7 @@ export class InstallCommand extends Command { return 0; } - targetAgents = agentResult as AgentType[]; + targetAgents = (agentResult as { agents: string[] }).agents as AgentType[]; // Save selection for next time saveLastAgents(targetAgents); diff --git a/packages/cli/src/commands/manifest.ts b/packages/cli/src/commands/manifest.ts new file mode 100644 index 00000000..89083fbf --- /dev/null +++ b/packages/cli/src/commands/manifest.ts @@ -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 { + 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 { + 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 { + 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 { + 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 { + 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 { + 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; + } +} diff --git a/packages/cli/src/onboarding/index.ts b/packages/cli/src/onboarding/index.ts index 9b134286..a251092d 100644 --- a/packages/cli/src/onboarding/index.ts +++ b/packages/cli/src/onboarding/index.ts @@ -38,6 +38,7 @@ export { confirm, select, agentMultiselect, + quickAgentSelect, skillMultiselect, groupMultiselect, stepTrail, @@ -83,7 +84,7 @@ import { getLastAgents, } from './preferences.js'; -let VERSION = '1.7.5'; +let VERSION = '1.7.6'; let AGENT_COUNT = 17; export function setVersion(version: string): void { diff --git a/packages/cli/src/onboarding/prompts.ts b/packages/cli/src/onboarding/prompts.ts index de391fb4..bd49e377 100644 --- a/packages/cli/src/onboarding/prompts.ts +++ b/packages/cli/src/onboarding/prompts.ts @@ -113,6 +113,72 @@ export async function agentMultiselect(options: { }); } +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; diff --git a/packages/cli/src/onboarding/theme.ts b/packages/cli/src/onboarding/theme.ts index ec5392d9..7d0f4762 100644 --- a/packages/cli/src/onboarding/theme.ts +++ b/packages/cli/src/onboarding/theme.ts @@ -48,6 +48,7 @@ export const symbols = { selected: '\u25cf', unselected: '\u25cb', pointer: '\u25b8', + bullet: '\u25cf', progressFull: '\u2588', progressEmpty: '\u2591', success: '\u2713', @@ -56,6 +57,8 @@ export const symbols = { info: '\u2139', arrowRight: '\u2192', arrowLeft: '\u2190', + arrowUp: '\u2191', + arrowDown: '\u2193', diamondOpen: '\u25c7', diamondFilled: '\u25c6', horizontalLine: '\u2500', diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts index ba18da6e..9f82a9dd 100644 --- a/packages/core/src/index.ts +++ b/packages/core/src/index.ts @@ -73,5 +73,5 @@ 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'; diff --git a/packages/core/src/manifest/index.ts b/packages/core/src/manifest/index.ts new file mode 100644 index 00000000..f636721e --- /dev/null +++ b/packages/core/src/manifest/index.ts @@ -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; + 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 }>(); + + 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(), + }; +}