skills MCP server
Commit Oct 27, 2026An orchestrator-first collection of agent skills that transforms PRDs into approved specs, GitHub issues, and TDD-implemented code slices.
Also known as afonsoft/skills
- Stars
- 19
- Tools
- β
- Downloads, 30 days
- β
- Latest version
- β
- Last commit
- Oct 27, 2026
- License
- MIT
What is skills MCP?
skills is an orchestrator-first collection of agent skills that transforms PRDs into approved specs, GitHub issues, and TDD-implemented code slices.
Summary generated from the project's README
About skills MCP server
Transforming product requirements into production-ready code is the primary function of this collection of agent skills. Designed for spec-driven development, the orchestrator skill acts as a central control loop that manages the entire software lifecycle. It audits preconditions, fragments work into GitHub Issues, and coordinates specialized skills to handle implementation, testing, and quality assurance. This system is built to work across various AI runtimes including Claude Code, Cursor, Devin, and OpenCode.
Developers use the orchestrator by invoking the /spec-driven command to initiate a continuous loop of discovery, auditing, and execution. The process moves through distinct phases, such as GitHub fragmentation and implementation, while persisting state in local memory files. The toolkit includes specialized tools for scaffolding .NET or Angular projects, performing TDD via execute-specs, and conducting deep architectural audits. It also provides advanced capabilities like reverse engineering, web design validation, and the ability to build new MCP servers to extend agent functionality.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 14, 2026Full report βNot verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work Β· What to fix for more points
- Source repository linked and reachableafonsoft/skills is public and reachablegithub.com/afonsoft/skills βPass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html βPass
- Commit or release in the last yearLast commit or release 2026-10-27github.com/afonsoft/skills βPass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubSpec Driven
An orchestrator-first collection of Agent Skills for spec-driven development: the orchestrator skill turns a PRD or idea into approved SPECs, tracked GitHub Issues, TDD-implemented slices, QA gates, and reviewed PRs β across Claude Code, OpenCode, Devin, Cursor, and other runtimes.
π Overview
This repository implements Spec-Driven Development (SDD) for AI agents, following the Agent Skills Specification (agentskills.io). At the center is the orchestrator skill: a control loop that audits preconditions, provisions the agent harness, consolidates domain language into approved SPEC SDDs (.specs/SPEC-*.md), fragments work into GitHub Issues, and delegates implementation, review, QA, and documentation to specialized skills β never doing complex work itself.
Every other skill in the catalog is a delegation target in that loop. Instead of generic prompts, each skill provides structured patterns, constraints, and reference materials that allow agents to perform complex software engineering tasks with production-grade quality.
π§ The Orchestrator
The orchestrator is the entry point and central control skill for agent-driven projects. Invoke it with /spec-driven (alias for /spec-driven:orchestrator, or "use the orchestrator skill") and it runs a continuous loop, delegating complex work to specialized skills and persisting state in .claude/memory/orchestrator_stats.md.
flowchart TD
A[Phase -1: Framework Update] --> B[Phase 0: Governance]
B --> C[Phase 1: Discovery]
C --> D[Phase 2: Audit]
D --> E[Phase 3: GitHub Fragmentation]
E --> F[Phase 4: Implementation Loop]
F --> G[Phase 5: Verification & QA]
G --> H[PR / Merge]
C -->|PRD only| I[/scaffold-mvp\]
C -->|needs spec| J[/write-specs\]
D -->|P2 gap| K[/improve-codebase-architecture\]
E --> L[/create-issues\]
F -->|per slice| M[/execute-specs\]
F -->|bug| N[/diagnose\]
G --> O[/qa-analyst\]
G --> P[/architecture\]
G --> R[/gap-analysis\]
S[/migration-planner\] -.->|domain plans| J
T[/web-design-guidelines\] -.->|finding groups| J
The orchestrator advances automatically between phases once validation passes. It only pauses for escalation gates (security, schema, public APIs, data changes), validation failures, or an explicit user request to stop.
π οΈ Skill Catalog & Correlation
The skills are organized around the orchestrator's pipeline: Harness Engineering, Orchestration & Delivery, Code Quality & Review, Frontend & Design, Extensibility & Integration, and MCP Integrations.
ποΈ Harness Engineering
Foundation for creating and managing AI agents.
create-agent-harness: The starting point. Use this to bootstrap a complete agent environment (CLAUDE.md, rules, skills) in any repo.create-readme: Professionalizes the repository landing page. Generates evidence-based READMEs and SemVer-compliant CHANGELOGs.observability-and-instrumentation: Once the harness is set, use this to ensure the agent's actions and the application's behavior are visible and diagnosable in production.
π§ Orchestration & Delivery
Planning, execution, verification, and documentation for agent-driven projects.
orchestrator: Central control skill. Audits preconditions, creates documentation, reconciles open GitHub Issues, turns gaps into Issues, and coordinates execution, tests, QA, and PR in a continuous loop. Persists state in.claude/memory/orchestrator_stats.mdand auto-continues to the next slice.write-specs: Interviews the user in Portuguese to consolidate domain language and produce an approved.specs/SPEC-{YYYYMMDD}-{feature}.mdbefore implementation.scaffold-mvp: Bootstraps a new .NET/Blazor/Angular repository after domain/spec alignment. Installs the agent harness, proposes a productive stack, and generates the initial project skeleton, AD-0001, and stubs.create-issues: Turns approved gaps, roadmap, and specs into GitHub Issues with vertical slices and dependency links. Uses thereferences/spec-sdd-template.mdstructure when creating Issues from SPEC SDDs.execute-specs: Test-driven development using the approved SPEC SDD as the source of truth. Red-green-refactor one vertical slice at a time.qa-analyst: Full QA cycle β requirements analysis, test planning, test cases, execution, bug reports, and process improvement.diagnose: Disciplined diagnosis and re-validation loop for hard bugs and performance regressions β tight feedback loops, ranked falsifiable hypotheses, stack playbooks for .NET/Angular/Python/React, agent self-debug, and AI workflow audit.improve-codebase-architecture: Finds architectural deepening opportunities by reading.claude/CONTEXT.md,.claude/MEMORY.md, anddocs/architecture/, and produces an HTML report.architecture: The single owner ofdocs/architecture/. Routes ADRs, design docs, and diagrams todrawio-architecture,mermaid-architecture, and the optionalarchifyskill (interactive HTML, used only when already installed β never installed at runtime), then ends with thegap-analysisevidence audit it owns.gap-analysis: Evidence-backed audit of AS-IS code vs. TO-BE specs/docs. Confirmed gaps become Draft SPECs (write-specs), a tracked Epic with slices (create-issues), and orchestrated execution (orchestrator) β behind an explicit approval gate.migration-planner: Evidence-based legacy β .NET migration planning with the Strangler Fig pattern. Researches the codebase, maps bounded contexts, designs seams (YARP, DI, EF Core dual-write, Blazor/MAUI), writes per-domain plans + roadmap inmigration-plan/, then converts each domain into Draft SPECs (write-specs), a tracked Epic (create-issues), and orchestrated execution (orchestrator) β behind an explicit approval gate. Default targets: Blazor WebAssembly, .NET MAUI, ASP.NET Core.
π Code Quality & Review
Ensuring the output meets professional standards.
code-review-and-quality: The primary gatekeeper. Performs multi-axis reviews (correctness, security, performance) before any code is merged.quality-test-implementation: The whole-repo quality intervention. Fixes static-analysis warnings (Roslyn/Sonar, SpotBugs/Checkstyle, Bandit/Ruff), resolves security CVEs, and applies SOLID/DDD/Clean Architecture across .NET, Java, or Python repositories.sonarqube-autofix: The automated auditor. Integrates with SonarQube to identify and fix technical debt and smells systematically.
π¬ Security & Reverse Engineering
Authorized analysis of shipped artifacts, protocols, and adversarial surfaces.
reverse-engineer: Consolidated RE hub merging REA (rea-agentsCLI/MCP, evidence-ledger workflows) with the reverse-skill domain pack β 40+ guides covering binaries, APK/mobile, JS/Electron, .NET, firmware, protocols, malware, CTF, and authorized pentest lanes. Includes a deterministic router (master-route.sh), case/scope gates (case-init.sh,auth.status=grantedrequired before ACT), a per-module tool-readiness checker (check-tools.sh), and an REA installer (install-rea.sh).
π¨ Frontend & Design
Shaping user-facing interfaces with mobile-first, responsive craft.
design: Frontend UI design for Angular, React, and Blazor. Covers mobile-first responsive layouts, typography, color, components, accessibility, motion, design tokens, Bootstrap/Tailwind CSS examples, and production hardening.web-design-guidelines: Web design validation, merged from vercel-labs/web-design-guidelines + lighthouse-95. Audits UI files against the complete interface-guidelines rule set (file:linefindings, with Angular/Blazor mappings) and/or verifies deployed pages against Lighthouse 95+ (mobile + desktop, 3-run verdicts), then converts confirmed pendencies into Draft SPECs (write-specs), an Epic + Issues (create-issues), and orchestrated fixes (orchestrator).
π Extensibility & Integration
Expanding what the agent can actually do.
building-mcp-servers: The power-user tool. Teaches agents how to build their own Model Context Protocol (MCP) servers to connect to any API or database.drawio-architecture: Visual intelligence. Merges architecture diagram authoring with the official draw.io MCP server for automated system design.mermaid-architecture: Diagrams as code. Generates high-contrast, production-ready Mermaid architecture diagrams, workflows, and C4 models saved directly indocs/architecture/.obsidian: Obsidian vault operations. Runs the Obsidian CLI (read/create/search/manage notes, tasks, properties), builds Bases (.base views/filters/formulas), writes Obsidian Flavored Markdown (wikilinks, embeds, callouts), and develops/debugs plugins and themes.
π MCP Integrations
Configuring, authenticating, and using external MCP servers across all supported agent platforms.
composio-mcp: Connects AI agents to 1000+ external apps (Gmail, GitHub, Slack, Notion, Linear, Jira) via Composio. CLI-first path (ak_*project key) with MCP fallback (ck_*consumer key viax-consumer-api-keyheader). Includes multi-platform setup script (handlesserverUrlvsurl,mcpvsmcpServers,environmentvsenvacross Claude Code/Desktop, Cursor, Devin CLI/Desktop, OpenCode, Antigravity IDE/CLI, OpenClaw), verify script, per-platform config reference, and cross-platform quirks matrix.notebooklm-mcp: Google NotebookLM (Gemini Notebook) integration via thenlmCLI andnotebooklm-mcpserver. Desktopnlm loginis the default auth path; headless fallbacks (OpenClaw CDP or user-provided manualcookies.txt) require explicit user approval. Credentials/cookies are never logged, copied, or forwarded. Multi-platform setup script covering all 8 supported agent platforms, plus verify, auth guide, per-platform config reference, and cross-platform quirks matrix.wordpress-mcp: Expose WordPress to AI agents over MCP using pinned, verified plugins. Three paths: (A)wordpress/mcp-adapterofficial plugin from GitHub releases, (B) AI Engine plugin from wordpress.org, and (C) wp-mcp-ultimate (community, opt-in, requires explicit source review and user approval). High-privilege actions require explicit approval; WordPress posts/comments/user submissions are treated as untrusted data. Includes hardened WP-CLI install scripts with checksum support, Application Password / Bearer Token / OAuth setup, per-platform MCP config, endpoint verification, and troubleshooting.
π Documentation: each skill has a dedicated doc page in
docs/en/(English) anddocs/pt-br/(PortuguΓͺs).
π‘οΈ Security Audits
Latest results from the skills.sh third-party audit (Gen Agent Trust Hub, Socket, Snyk). Click View to see the full report for a skill.
Updated: 2026-10-08
Mitigations applied (PR #11):
notebooklm-mcp,orchestrator, andwordpress-mcpwere hardened with explicit-approval gates, pinned installs, credential isolation, untrusted-content handling, and audit logging. The latest scan still flagsarchitecture,notebooklm-mcp, andwordpress-mcpas π‘ medium risk on Gen Agent Trust Hub, andnotebooklm-mcpandsonarqube-autofixeach carry 1 Socket alert.
| Skill | Gen Agent Trust Hub | Socket alerts | Snyk | Details |
|---|---|---|---|---|
architecture |
π‘ medium | 0 | π’ low | View |
building-mcp-servers |
β safe | 0 | π’ low | View |
code-review-and-quality |
β safe | 0 | π‘ medium | View |
composio-mcp |
β safe | 0 | π‘ medium | View |
create-agent-harness |
β safe | 0 | π’ low | View |
create-issues |
β safe | 0 | π‘ medium | View |
create-readme |
β safe | 0 | π’ low | View |
design |
β safe | 0 | π’ low | View |
diagnose |
β safe | 0 | π’ low | View |
drawio-architecture |
β safe | 0 | π’ low | View |
execute-specs |
β safe | 0 | π’ low | View |
gap-analysis |
β safe | 0 | π‘ medium | View |
improve-codebase-architecture |
β safe | 0 | π’ low | View |
mermaid-architecture |
β safe | 0 | π’ low | View |
migration-planner |
β safe | 0 | βͺ pending | View |
notebooklm-mcp |
π‘ medium | 1 | π’ low | View |
observability-and-instrumentation |
β safe | 0 | π’ low | View |
obsidian |
β safe | 0 | π’ low | View |
orchestrator |
β safe | 0 | π‘ medium | View |
qa-analyst |
β safe | 0 | π‘ medium | View |
quality-test-implementation |
β safe | 0 | π’ low | View |
reverse-engineer |
βͺ pending | 0 | βͺ pending | View |
scaffold-mvp |
β safe | 0 | π’ low | View |
sonarqube-autofix |
β safe | 1 | π‘ medium | View |
web-design-guidelines |
β safe | 0 | βͺ pending | View |
wordpress-mcp |
π‘ medium | 0 | π‘ medium | View |
write-specs |
β safe | 0 | π’ low | View |
π¦ Installation
β‘ via skills.sh (Recommended)
The fastest way to install and auto-detect your environment.
npx skills add afonsoft/skills
π§© via Claude Code plugin
Installs skills and slash commands natively (no install.sh needed):
/plugin marketplace add afonsoft/skills
/plugin install spec-driven@afonsoft
Commands are namespaced by the plugin name: /spec-driven:orchestrator and /spec-driven:<skill> for each skill.
π€ via Codex plugin marketplace
The repo ships a Codex plugin manifest (.codex-plugin/plugin.json) and a repo marketplace catalog (.agents/plugins/marketplace.json):
codex plugin marketplace add afonsoft/skills
Then install spec-driven from the Plugins Directory, or invoke skills directly with $<skill> β Codex discovers them from the bundled skills/ directory. Skills are also discovered from .agents/skills/ (repo scope) and ~/.agents/skills/ (user scope, via install.sh --codex).
π via OpenCode HTTP catalog
Add the catalog URL to any opencode.json β OpenCode downloads skills/index.json and refreshes each skill automatically when its version changes:
{
"$schema": "https://opencode.ai/config.json",
"skills": ["https://raw.githubusercontent.com/afonsoft/skills/main/skills/"]
}
Regenerate the catalog after skill changes with python3 scripts/build-opencode-catalog.py. OpenCode also discovers skills from .opencode/skills/, .claude/skills/, and .agents/skills/ in project scope.
π₯οΈ via install.sh (local clone)
Copies the skills into each IDE's skills directory and generates slash commands:
./install.sh --all # all supported IDEs/CLIs + slash commands
./install.sh --claude # Claude Code only
./install.sh --opencode # OpenCode only
./install.sh --devin # Devin Desktop + Devin CLI
./install.sh --cursor # Cursor only
./install.sh --codex # OpenAI Codex CLI only
./install.sh --agy # Google Antigravity CLI only
./install.sh --aider # Aider only
./install.sh --cline # Cline only
./install.sh --continue # Continue only
./install.sh --grok # Grok CLI only
./install.sh --kimi # Kimi Code CLI only
./install.sh --kiro # Kiro CLI only
./install.sh --qwen # Qwen Code only
./install.sh --dry-run # preview without changing anything
Slash commands follow each CLI's own convention β some clients do not accept : in command names:
| CLI | Invocation | Mechanism |
|---|---|---|
| Claude Code, OpenCode, Devin Desktop | /spec-driven and /spec-driven:<skill> |
commands/spec-driven:<skill>.md shims |
| Devin CLI | /<skill> |
skills are native slash commands β no shims needed; installed to ~/.config/devin/skills/ |
| Qwen Code | /spec-driven and /spec-driven:<skill> |
commands/spec-driven/<skill>.md (namespace via subdirectory) |
| Codex CLI | /prompts:spec-driven-<skill> |
prompts/spec-driven-<skill>.md (custom prompts are deprecated β prefer $<skill>//skills) |
| Cline | /spec-driven-<skill> |
~/.cline/data/workflows/ workflows |
| Continue | /spec-driven-<skill> |
~/.continue/prompts/ with invokable: true |
| Grok CLI | /spec-driven-<skill> |
~/.agents/commands/ (skills also appear as /<skill>) |
| agy, Kimi, Kiro | /<skill> (Kimi: /skill:<skill>) |
skills are native slash commands β no shims needed |
| Aider | /read ~/.aider/skills/<skill>/SKILL.md |
no file-based commands; an index is written to ~/.aider/spec-driven-skills.md |
Reinstalling removes legacy /architecture:<skill> shims automatically.
π£ Publish on Skill Directories
SkillsLLM
SkillsLLM indexes open-source skills for Claude Code, Codex CLI, and ChatGPT. The scraper discovers repos daily via GitHub topics (claude-code, ai-agent, mcp-server, agent-skills, skill-md) and SKILL.md files. To list this collection:
- Sign in with GitHub at Submit a Skill
- Submit the repository URL:
https://github.com/afonsoft/skills - The scraper validates, fetches metadata, runs a security scan (Semgrep + npm audit + pip-audit), and adds it to the catalog within 24 hours
Note: SkillsLLM's automated discovery filters for repos with 100+ stars. Manual submission via the form above bypasses that filter β the repo is then scanned and listed regardless of star count. The GitHub topics and description are already set so the scraper can categorize the skills correctly.
Awesome Skills
Awesome Skills discovers open-source SKILL.md skills from GitHub via its Awesome List Import. Each skills/<name>/SKILL.md directory becomes a separate listing with slug afonsoft-skills-<name>. Submit the repository URL through the site's Submit a Skill form:
- Repository URL:
https://github.com/afonsoft/skills - Branch:
main - Skills Path:
/skills
Each skill's description frontmatter includes afonsoft so the collection is discoverable at awesomeskill.ai/search?q=afonsoft. The Awesome Skills search API matches against skill name and description only (not owner, repo, or tags), so the afonsoft attribution in each description is what makes the search return results.
SkillHub
SkillHub aggregates skills from GitHub sources. Open Sources β Add Source, then use:
- Name:
afonsoft/skills - Repository URL:
https://github.com/afonsoft/skills - Source Type:
GitHub Repo - Branch:
main - Skills Path:
/skills
SkillHub imports the collection from this source and lists each valid SKILL.md directory in its marketplace.
LobeHub Skills Marketplace
LobeHub is the world's largest skills marketplace (100,000+ skills). Publishing is CLI-driven (no web form). Each skill gets identifier afonsoft-skills-<name>.
One-time setup (per machine, requires Node.js >= 22):
npx -y @lobehub/market-cli login # browser OAuth
npx -y @lobehub/market-cli github connect # verify GitHub ownership
Publish all skills locally:
./publish-lobehub.sh # publishes all skills
./publish-lobehub.sh --dry-run # preview without publishing
Publish a single skill:
npx -y @lobehub/market-cli skill publish --dir skills/<skill-name> --identifier afonsoft-skills-<skill-name>
Automatic publishing via GitHub Actions:
A workflow (.github/workflows/lobehub-publish.yml) publishes all skills when a v* tag is pushed, a release is published, or when triggered manually (workflow_dispatch). To enable it, add two repository secrets:
LOBEHUB_M2M_CREDENTIALSβ contents of~/.lobehub-market/credentials.json(device registration)LOBEHUB_USER_CREDENTIALSβ contents of~/.lobehub-market/user-credentials.json(OAuth tokens)
skills MCP questions
Which AI runtimes are supported by these skills?
The skills work across several runtimes including Claude Code, OpenCode, Devin, Cursor, and others.
How does the orchestrator handle complex work?
The orchestrator does not perform complex work itself; instead, it delegates implementation, review, QA, and documentation to specialized skills within its loop.