# Code Virtuoso

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

- **Type:** MCP server
- **Install:** `agentstack add mcp-krzysztofsurdy-code-virtuoso`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [krzysztofsurdy](https://agentstack.voostack.com/s/krzysztofsurdy)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [krzysztofsurdy](https://github.com/krzysztofsurdy)
- **Source:** https://github.com/krzysztofsurdy/code-virtuoso

## Install

```sh
agentstack add mcp-krzysztofsurdy-code-virtuoso
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

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](https://agentskills.io) 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

```bash
# 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](https://code.claude.com/docs/en/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

```bash
# 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

```bash
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)

```bash
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)

```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)

```bash
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](https://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](https://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](https://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](https://agentskills.io) 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](https://github.com/krzysztofsurdy)
- **Source:** [krzysztofsurdy/code-virtuoso](https://github.com/krzysztofsurdy/code-virtuoso)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-krzysztofsurdy-code-virtuoso
- Seller: https://agentstack.voostack.com/s/krzysztofsurdy
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.