@nano-step/skill-manager

Multi-skill registry CLI for OpenCode. Install, manage, and update AI agent skills from a built-in catalog.

Quick Start

# List available skills
npx @nano-step/skill-manager list

# Install a skill
npx @nano-step/skill-manager install skill-management

# Install all skills
npx @nano-step/skill-manager install --all

Commands

| Command | Description | |---------|-------------| | list | Show available skills from the catalog | | install <name> | Install a specific skill | | install --all | Install all available skills | | remove <name> | Remove an installed skill | | update [name] | Update one or all installed skills | | installed | Show currently installed skills |

Available Skills (15 public + 5 private)

Public Skills (bundled in npm)

| Skill | Description | |-------|-------------| | blog-workflow | Generate SEO-optimized blog posts for dev.to, Medium, LinkedIn, Hashnode | | comprehensive-feature-builder | Systematic 5-phase workflow for researching, designing, implementing, and testing features | | graphql-inspector | GraphQL schema inspection with progressive discovery workflow | | idea-workflow | Analyze source code and produce monetization strategy with execution blueprint | | mermaid-validator | Validate Mermaid diagram syntax — enforces rules that prevent parse errors | | nano-brain | Persistent memory for AI agents — hybrid search across sessions, codebase, and notes | | pdf | PDF manipulation toolkit — extract, create, merge, split, OCR, fill forms, watermark | | reddit-workflow | Draft Reddit posts optimized for subreddit rules, tone, and spam filters | | rtk | Token optimizer — wraps CLI commands with rtk to reduce token consumption by 60-90% | | rtk-setup | One-time RTK setup + ongoing enforcement across sessions and subagents | | security-workflow | OWASP Top 10 security audit with CVE scanning and prioritized hardening plan | | skill-creator | Create and validate AI agent skills with progressive disclosure and marketplace packaging | | skill-management | AI skill routing — isolates tool definitions in subagent context to save 80-95% tokens | | team-workflow | Simulate an autonomous software team — architecture, execution plan, QA strategy | | ui-ux-pro-max | UI/UX design intelligence with searchable database of styles, palettes, fonts, and guidelines |

Private Skills (requires login)

| Skill | Description | |-------|-------------| | e2e-test-generator | E2E test generation from PRD using Playwright MCP | | feature-analysis | Deep code analysis with execution tracing and gap analysis | | pr-code-reviewer | Comprehensive PR code review with 4 parallel subagents | | rri-t-testing | RRI-T QA methodology — 5-phase testing with 7 dimensions and release gates | | database-inspector | Database schema inspection for MySQL and PostgreSQL with progressive discovery |

What Gets Installed

When you install a skill, the manager:

1. Copies skill files (SKILL.md, references, assets) to {config}/skills/{name}/
2. Copies command files to {config}/command/ (if the skill has commands)
3. Merges agent config into {config}/oh-my-opencode.json (if the skill defines an agent)
4. Tracks installation state in {config}/.skill-manager.json

Config directory is detected automatically: .opencode/ (project-level, preferred) or ~/.config/opencode/ (global).

Migrating from v4

v5.0.0 replaces the flag-based CLI with subcommands:

| v4 (old) | v5 (new) | |----------|----------| | npx @nano-step/skill-manager | npx @nano-step/skill-manager install skill-management | | npx @nano-step/skill-manager --update | npx @nano-step/skill-manager update | | npx @nano-step/skill-manager --remove | npx @nano-step/skill-manager remove skill-management |

Existing v4 installations are automatically migrated on first run.

Development

npm install
npm run build

# Test locally
node bin/cli.js list
node bin/cli.js install skill-management
node bin/cli.js installed
node bin/cli.js remove skill-management

Project Structure

skill-manager/
├── src/
│   ├── index.ts          # CLI entry (commander subcommands)
│   ├── registry.ts       # Scan skills/ dirs, load manifests
│   ├── installer.ts      # Install/remove/update logic
│   ├── state.ts          # Read/write .skill-manager.json
│   ├── config.ts         # Merge agents/commands into oh-my-opencode.json
│   └── utils.ts          # Path detection, file ops, shared types
├── skills/
│   ├── skill-management/
│   │   ├── skill.json    # Skill manifest
│   │   ├── SKILL.md      # Skill instructions
│   │   ├── skill-refresh.md
│   │   ├── references/   # Detailed documentation
│   │   └── assets/       # Templates and schemas
│   └── graphql-inspector/
│       ├── skill.json
│       └── SKILL.md
├── bin/cli.js
└── package.json

Adding a New Skill

1. Create skills/<name>/ directory
2. Add skill.json manifest:

   {
     "name": "<name>",
     "version": "1.0.0",
     "description": "...",
     "compatibility": "OpenCode with ...",
     "agent": null,
     "commands": [],
     "tags": ["..."]
   }

3. Add SKILL.md with skill instructions
4. Build and test: npm run build && node bin/cli.js list

Related Projects

• nano-brain — Persistent memory for AI agents
• graphql-inspector-mcp — GraphQL schema inspection MCP server
• mcp-database-inspector — Database inspection MCP server

License

MIT