Code Virtuoso

Code Virtuoso

Skills, sub-agents, and playbooks for Claude Code, Cursor, and any Agent Skills–compatible AI coding assistant.

> What you get: 30+ curated skills, 19 sub-agents, 7 team role personas, and operational playbooks - all installable individually or as bundles, based on the open Agent Skills standard. Turn your AI coding assistant from a generalist into a domain specialist.

See [CHANGELOG.md](CHANGELOG.md) for release notes.

Table of Contents

• [Quickstart](#quickstart)
• [Why Use This](#why-use-this)
• [What's Inside](#whats-inside)
• [Knowledge Skills](#knowledge-skills)
• [Tool Skills](#tool-skills)
• [Framework Skills](#framework-skills)
• [Playbook Skills](#playbook-skills)
• [Role Skills](#role-skills)
• [Agents](#agents)
• [Installation (detailed)](#installation-detailed)
• [Works Well With](#works-well-with)
• [FAQ](#faq)
• [Contributing](#contributing)
• [License](#license)
• [Repository Structure](#repository-structure)

---

Quickstart

# 1. Install (interactive - pick what you want)
npx skills add krzysztofsurdy/code-virtuoso

# 2. Try a skill immediately
/ticket-writer
# Follow the prompts - paste the output into Jira, Linear, or GitHub Issues.

That is the whole tour. For fine-grained install modes (per-skill, global, offline, auto-update) see [Installation (detailed)](#installation-detailed).

---

Why Use This

• Battle-tested, not LLM-generated. Every skill was researched against official docs and community best practices, then hand-curated. No hallucinated API references.
• Progressive disclosure keeps your context clean. Skills load a short SKILL.md first and only pull in deeper references when the task calls for them. Less context rot, sharper answers.
• One installation, many tools. Built on the open Agent Skills standard - works with Claude Code, Cursor, Windsurf, Copilot, Codex, Gemini CLI, and more. No lock-in.
• Team-shaped, not pattern-shaped. The library ships 7 role personas (Product Manager, Architect, Backend Dev, Frontend Dev, QA, PM, Scrum Master) and 15 sub-agents that delegate like a real team rather than a single over-prompted assistant.

---

What's Inside

| Category | Count | Summary | |---|---|---| | [Knowledge](#knowledge-skills) | 18 | Principles, craft, process, and agent workflow references | | [Tools](#tool-skills) | 11 | Interactive generators - rules files, tickets, agents, plugins, PR messages, reports, updates, screenshots, image annotation | | [Frameworks](#framework-skills) | 4 | Symfony, Django, LangChain component libraries and upgrade guides | | [Playbooks](#playbook-skills) | 5 | Step-by-step procedures for recurring operational tasks | | [Roles](#role-skills) | 6 | Team-role reference skills used by role agents | | [Agents](#agents) | 19 | 12 specialist + 7 role sub-agents with tool, isolation, and memory metadata | | [Teams](#teams) | 3 | Pre-composed agent teams with bundled skills and coordination protocols |

---

Knowledge Skills

Grouped by theme. Each skill is a self-contained reference with a short SKILL.md and deep-dive files under references/.

Principles & Design

| Skill | Summary | |-------|---------| | [Design Patterns](skills/knowledge/design-patterns/SKILL.md) | 26 Gang of Four patterns with idiomatic implementations | | [SOLID](skills/knowledge/solid/SKILL.md) | All five SOLID principles with multi-language examples | | [Clean Architecture](skills/knowledge/clean-architecture/SKILL.md) | Clean/Hexagonal Architecture and DDD fundamentals | | [Refactoring](skills/knowledge/refactoring/SKILL.md) | 67 refactoring techniques and 22 code smells |

Craft & Code

| Skill | Summary | |-------|---------| | [Testing](skills/knowledge/testing/SKILL.md) | Testing pyramid, TDD schools, test doubles, strategies | | [Debugging](skills/knowledge/debugging/SKILL.md) | Systematic debugging methodology and post-mortem templates | | [API Design](skills/knowledge/api-design/SKILL.md) | REST and GraphQL design principles and evolution strategies | | [Database Design](skills/knowledge/database-design/SKILL.md) | Schema modeling, indexing strategies, migration patterns | | [Performance](skills/knowledge/performance/SKILL.md) | Profiling, caching, database optimization, N+1 prevention | | [Security](skills/knowledge/security/SKILL.md) | OWASP Top 10, auth patterns, secure coding practices | | [Accessibility](skills/knowledge/accessibility/SKILL.md) | WCAG compliance, ARIA patterns, keyboard navigation, a11y testing |

Process & Delivery

| Skill | Summary | |-------|---------| | [Scrum](skills/knowledge/scrum/SKILL.md) | Sprint goals, events, roles, and facilitation templates | | [Git Workflow](skills/knowledge/git-workflow/SKILL.md) | Branching strategies, commit conventions, PR patterns | | [CI/CD](skills/knowledge/cicd/SKILL.md) | Pipeline design, deployment strategies, environment promotion | | [Microservices](skills/knowledge/microservices/SKILL.md) | Saga, CQRS, event sourcing, circuit breakers, service mesh |

Agent Workflow

| Skill | Summary | |-------|---------| | [Verification Before Completion](skills/knowledge/verification-before-completion/SKILL.md) | Evidence-based completion discipline and tiered definition of done | | [Dispatching Parallel Agents](skills/knowledge/dispatching-parallel-agents/SKILL.md) | Fan-out/fan-in patterns, subagent briefing, result synthesis | | [Subagent-Driven Development](skills/knowledge/subagent-driven-development/SKILL.md) | One-fresh-agent-per-task execution with two-stage review gates |

---

Tool Skills

Interactive generators. Each is user-invocable via /skill-name.

| Skill | Summary | |-------|---------| | [Agentic Rules Writer](skills/tools/agentic-rules-writer/SKILL.md) | Generate rules files for Claude Code, Cursor, Windsurf, Copilot, Gemini, Roo Code, or Amp | | [Ticket Writer](skills/tools/ticket-writer/SKILL.md) | Write tickets of the right type - story, subtask, issue, bug, epic, or initiative | | [Agent Creator](skills/tools/agent-creator/SKILL.md) | Design a sub-agent with proper frontmatter, tool permissions, isolation, and system prompt | | [Plugin Creator](skills/tools/plugin-creator/SKILL.md) | Scaffold a complete Claude Code plugin - manifest, skills, agents, hooks, MCP/LSP servers | | [Brainstorming](skills/tools/brainstorming/SKILL.md) | Pre-implementation design exploration - turn a vague idea into an approved spec | | [Using Ecosystem](skills/tools/using-ecosystem/SKILL.md) | Guided tour and discovery advisor for the ecosystem | | [PR Message Writer](skills/tools/pr-message-writer/SKILL.md) | Write structured pull request messages with technical documentation and testing instructions | | [Report Writer](skills/tools/report-writer/SKILL.md) | Generate standalone HTML reports summarizing changes, investigations, or architectural decisions | | [Stakeholder Update Writer](skills/tools/stakeholder-update-writer/SKILL.md) | Draft stakeholder Slack or email updates about project status, blockers, and decisions | | [Web Screenshot](skills/tools/web-screenshot/SKILL.md) | Capture web page screenshots with shot-scraper - full page, element, viewport, multi-device, batch | | [Image Annotate](skills/tools/image-annotate/SKILL.md) | Mark up images with arrows, boxes, text, numbered steps, highlights, blur, and solid redaction |

---

Framework Skills

| Skill | Summary | |-------|---------| | [Symfony Components](skills/frameworks/symfony/symfony-components/SKILL.md) | 38 Symfony components for PHP 8.3+ and Symfony 7.x | | [Symfony Upgrade](skills/frameworks/symfony/symfony-upgrade/SKILL.md) | Deprecation-first upgrade guide for minor and major versions | | [Django Components](skills/frameworks/django/django-components/SKILL.md) | 33 Django components for Python 3.10+ and Django 6.0 | | [LangChain Components](skills/frameworks/langchain/langchain-components/SKILL.md) | 17 LangChain references - models, agents, tools, retrieval, LangGraph |

---

Playbook Skills

| Skill | Summary | |-------|---------| | [PHP Upgrade](skills/playbooks/php-upgrade/SKILL.md) | PHP version upgrade process with Rector, PHPCompatibility, breaking changes | | [Composer Dependencies](skills/playbooks/composer-dependencies/SKILL.md) | Safe dependency updates, security auditing, automated update tools | | [Finishing Branch](skills/playbooks/finishing-branch/SKILL.md) | End-to-end branch finishing - pre-push checks, PR messages, cleanup, recovery | | [Ticket Delivery](skills/playbooks/ticket-delivery/SKILL.md) | End-to-end ticket delivery - analysis, investigation, planning, TDD implementation, commit, and PR | | [Worktree Ops](skills/playbooks/worktree-ops/SKILL.md) | Create, list, switch, and remove git worktrees for parallel development sessions |

---

Role Skills

| Skill | Summary | |-------|---------| | [Product Manager](skills/roles/product-manager/SKILL.md) | Requirements gathering, PRD writing, prioritization, acceptance criteria | | [Architect](skills/roles/architect/SKILL.md) | System design, component boundaries, API contracts, ADRs | | [Backend Dev](skills/roles/backend-dev/SKILL.md) | API implementation, data models, TDD workflows | | [Frontend Dev](skills/roles/frontend-dev/SKILL.md) | UI components, accessibility, state management | | [QA Engineer](skills/roles/qa-engineer/SKILL.md) | Test planning, test design, bug reporting, release sign-off | | [Project Manager](skills/roles/project-manager/SKILL.md) | PRINCE2-based delivery, risk management, progress tracking |

---

Agents

Sub-agents follow the Claude Code sub-agents standard. Specialist agents handle one focused task type. Role agents embody a team position and carry persistent project memory. See [AGENTS.md](AGENTS.md) for full specifications, delegation patterns, and chaining examples.

| Kind | Agent | Tools | Isolation | Memory | Purpose | |------|-------|-------|-----------|--------|---------| | Specialist | [Investigator](agents/investigator.md) | Read, Grep, Glob, Bash | - | - | Deep codebase exploration, dependency mapping | | Specialist | [Implementer](agents/implementer.md) | All | worktree | - | TDD red-green-refactor execution | | Specialist | [Reviewer](agents/reviewer.md) | Read, Grep, Glob, Bash | - | - | Structured code review (SOLID, OWASP, smells) | | Specialist | [Refactor Scout](agents/refactor-scout.md) | Read, Grep, Glob, Bash | - | - | Code smell scanning, complexity hotspots | | Specialist | [Dependency Auditor](agents/dependency-auditor.md) | Bash, Read, Grep, Glob | - | - | CVE checks, outdated packages, license audit | | Specialist | [Doc Writer](agents/doc-writer.md) | Read, Grep, Glob, Bash, Write, Edit | - | - | Changelogs, API docs, migration guides | | Specialist | [Migration Planner](agents/migration-planner.md) | Read, Grep, Glob, Bash | - | - | Migration safety analysis, rollback paths | | Specialist | [Test Gap Analyzer](agents/test-gap-analyzer.md) | Read, Grep, Glob, Bash | - | - | Missing test coverage, untested edge cases | | Specialist | [Cold Reviewer](agents/cold-reviewer.md) | Read, Grep, Glob, Bash | - | - | Zero-context code review, fresh-eyes findings | | Specialist | [Acceptance Verifier](agents/acceptance-verifier.md) | Read, Grep, Glob, Bash | - | - | Spec compliance checking, criteria coverage matrix | | Specialist | [Readiness Checker](agents/readiness-checker.md) | Read, Grep, Glob, Bash | - | - | Pre-implementation readiness gate | | Specialist | [Course Corrector](agents/course-corrector.md) | Read, Grep, Glob, Bash | - | - | Mid-workflow change impact analysis | | Role | [Product Manager](agents/product-manager.md) | Read, Grep, Glob, Bash | - | project | Requirements, PRDs, prioritization | | Role | [Architect](agents/architect.md) | Read, Grep, Glob, Bash | - | project | System design, ADRs, trade-offs | | Role | [Backend Dev](agents/backend-dev.md) | Read, Edit, Write, Bash, Grep, Glob | worktree | - | API implementation, data models, TDD | | Role | [Frontend Dev](agents/frontend-dev.md) | Read, Edit, Write, Bash, Grep, Glob | worktree | - | UI components, accessibility, state | | Role | [QA Engineer](agents/qa-engineer.md) | Read, Grep, Glob, Bash | - | project | Test plans, bug reports, release sign-off | | Role | [Project Manager](agents/project-manager.md) | Read, Grep, Glob, Bash | - | project | PRINCE2 stages, risk, progress tracking | | Role | [Scrum Master](agents/scrum-master.md) | Read, Grep, Glob, Bash | - | - | Sprint planning, goals, retrospectives |

---

Teams

Pre-composed agent teams with bundled skills and coordination protocols. Pick a team instead of assembling agents manually. See [spec/team-spec.md](spec/team-spec.md) for the format.

| Team | Lead | Agents | Workflow | Use case | |------|------|--------|----------|----------| | [Development Team](skills/tools/agent-teams/teams/development-team.md) | Product Manager | PM, Architect, Backend Dev, Frontend Dev, QA | Hybrid | Full feature delivery from requirements to merged PR | | [Review Squad](skills/tools/agent-teams/teams/review-squad.md) | Reviewer | Reviewer, Cold Reviewer, Acceptance Verifier | Parallel | Multi-perspective code review with triaged findings | | [War Room](skills/tools/agent-teams/teams/war-room.md) | Architect | Architect, PM, Backend Dev, QA | War Room | Structured debate for high-stakes technical decisions |

---

Installation (detailed)

Selective install

# Pick individual skills
npx skills add krzysztofsurdy/code-virtuoso --skill design-patterns --skill refactoring

# Everything at once
npx skills add krzysztofsurdy/code-virtuoso --all

# Install globally (available in every project)
npx skills add krzysztofsurdy/code-virtuoso -g

# Preview what's available without installing
npx skills add krzysztofsurdy/code-virtuoso --list

Updating

npx skills check    # see what can be updated
npx skills update   # update everything installed

Auto-update, once a day, in the background

macOS / Linux (zsh)

echo '_skills_marker="${TMPDIR:-/tmp}/.skills-updated-$(date +%Y%m%d)"
[ ! -f "$_skills_marker" ] && (npx skills update --yes >/dev/null 2>&1 && touch "$_skills_marker" &)' >> ~/.zshrc

Windows (PowerShell)

Add-Content $PROFILE '$marker = "$env:TEMP\.skills-updated-$(Get-Date -Format yyyyMMdd)"; if (-not (Test-Path $marker)) { Start-Job { npx skills update --yes *> $null; New-Item $using:marker -Force } | Out-Null }'

Project-level (git post-merge hook)

printf '#!/bin/sh\nnpx skills update --yes >/dev/null 2>&1 &\n' > .git/hooks/post-merge
chmod +x .git/hooks/post-merge

---

Works Well With

Companion tools that pair naturally with this library.

Beads - Task Memory for AI Agents

github.com/steveyegge/beads

Distributed, git-backed graph issue tracker that gives AI agents persistent, structured memory for long-horizon tasks. Replaces ad-hoc markdown planning files with a dependency-aware task graph.

GSD - Spec-Driven Development

github.com/gsd-build/get-shit-done

Meta-prompting and context engineering system for Claude Code, OpenCode, Gemini CLI, and Codex. Targets context rot with spec-driven development, subagent orchestration, and state management.

Grepika - Token-Efficient Code Search

github.com/agentika-labs/grepika

MCP server that replaces built-in grep/file search with ranked, compact results using roughly 80% fewer tokens. Combines FTS5 full-text search, parallel grep, and trigram indexing with BM25 ranking.

---

FAQ

Which AI coding assistants does this support? Anything that follows the Agent Skills open standard, including Claude Code, Cursor, Windsurf, GitHub Copilot, Codex, Gemini CLI, Cline, OpenCode, Continue, Trae,

…

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: krzysztofsurdy
• Source: krzysztofsurdy/code-virtuoso
• License: MIT

Install and usage instructions live in the source repository linked above.