skills/magnus919_agent-skills
1
0
Fork 0
mirror of https://github.com/magnus919/agent-skills.git synced 2026-09-11 19:47:12 +03:00
Code Issues Packages Projects Releases Wiki Activity

docs(routing): remediate description and neighbor boundaries

Browse Source 
Squash-merge verified routing remediation at exact head 690f9c14b0. Required validate and paired evaluation checks passed; advisory droid review had no blocking findings.
This commit is contained in:
Magnus Hedemark
2026-09-01 20:05:48 -04:00
committed by GitHub
parent 24f21c64e3
commit 035e58d3e3
63 changed files with 665 additions and 383 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.claude-plugin/marketplace.json
+58 -58
View File
@@ -39,7 +39,7 @@
"./agent-evals-and-observability"
],
"strict": false,
"description": "Design, run, review, or release framework- and vendor-neutral evaluations and observability for AI agents. Use when defining agent evals, datasets, graders, trajectory review, regression analysis, release gates, production traces, or privacy-aware telemetry. Covers task and trajectory contracts, statistical comparisons, and incident-to-case learning; route framework implementation to pydanticai or langgraph when needed."
"description": "Design, run, review, or release framework- and vendor-neutral evaluations and observability for AI agents. Use when defining agent evals, datasets, graders, trajectory review, regression analysis, release gates, production traces, or privacy-aware telemetry. Covers task and trajectory contracts, statistical comparisons, and incident-to-case learning; route framework implementation to pydanticai or langgraph when needed. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "agent-production-operations",
@@ -102,7 +102,7 @@
"./artifact-pyramids"
],
"strict": false,
"description": "Organize durable agent research outputs as summaries, analysis, and evidence dossiers. Use when producing multi-layer research artifacts or coordinating research handoffs."
"description": "Organize durable agent research outputs as summaries, analysis, and evidence dossiers. Use when producing multi-layer research artifacts or coordinating research handoffs. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "ascii-city-engine",
@@ -120,7 +120,7 @@
"./autogen"
],
"strict": false,
"description": "Expert skill for conversational multi-agent AI with Microsoft AutoGen. AssistantAgent, UserProxyAgent, GroupChat, code execution, nested chats, cancellation tokens, tool integration, and MCP support. Use when building conversation-driven multi-agent systems or comparing agent frameworks."
"description": "Build conversational multi-agent systems with Microsoft AutoGen. AssistantAgent, UserProxyAgent, GroupChat, code execution, nested chats, cancellation tokens, tool integration, and MCP support. Use when building conversation-driven multi-agent systems or comparing agent frameworks. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "backend-engineering",
@@ -156,7 +156,7 @@
"./brand-designer"
],
"strict": false,
"description": "Create comprehensive brand identity documentation for any brand. Guides you through documenting strategy, visual identity (logo, color, typography, imagery), voice and tone, application guidelines, governance, and asset inventory. Produces markdown specs, compiled brand books, and brand-compliant images via reference-image-aware generation. Use when you need to capture a brand's identity in structured, durable form — for vault storage, agency handoff, or press kit distribution."
"description": "Create comprehensive brand identity documentation for any brand. Guides you through documenting strategy, visual identity (logo, color, typography, imagery), voice and tone, application guidelines, governance, and asset inventory. Produces markdown specs, compiled brand books, and brand-compliant images via reference-image-aware generation. Use when you need to capture a brand's identity in structured, durable form — for vault storage, agency handoff, or press kit distribution. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "c4-diagramming",
@@ -183,7 +183,7 @@
"./chief-of-staff-methodology"
],
"strict": false,
"description": "Prepare accountable executive decisions, information triage, briefing, calendar choices, organizational sensing, and institutional memory without assuming authority or monitoring people. Use when a chief of staff or CoS, executive office, gatekeeping, decision memo, executive briefing, board materials, organizational sensing, team health, institutional memory, calendar triage, meeting audit, strategic time, or attention allocation is requested."
"description": "Prepare accountable executive decisions, information triage, briefing, calendar choices, organizational sensing, and institutional memory without assuming authority or monitoring people. Use when a chief of staff or CoS, executive office, gatekeeping, decision memo, executive briefing, board materials, organizational sensing, team health, institutional memory, calendar triage, meeting audit, strategic time, or attention allocation is requested. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "cli-builder",
@@ -210,7 +210,7 @@
"./color-management"
],
"strict": false,
"description": "Expert-level color management for ICC profiles, working spaces, gamut mapping, and color science. Use when inspecting ICC profiles, converting between color spaces, checking gamut clipping, validating well-behaved working spaces, or troubleshooting color workflow issues with ImageMagick, ArgyllCMS, Exiftool, or LittleCMS."
"description": "Manage color workflows with ICC profiles, working spaces, gamut mapping, and color science. Use when inspecting ICC profiles, converting between color spaces, checking gamut clipping, validating well-behaved working spaces, or troubleshooting color workflow issues with ImageMagick, ArgyllCMS, Exiftool, or LittleCMS. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "conditional-customer-success",
@@ -228,7 +228,7 @@
"./confluence-cli"
],
"strict": false,
"description": "Interact with Atlassian Confluence from the terminal: list spaces, browse pages, view page content, search with CQL, and create pages. Use when the user mentions Confluence, a space key (e.g. DEV), or asks about documentation, wiki pages, space content, or knowledge base articles."
"description": "Interact with Atlassian Confluence from the terminal: list spaces, browse pages, view page content, search with CQL, and create pages. Use when the user mentions Confluence, a space key (e.g. DEV), or asks about documentation, wiki pages, space content, or knowledge base articles. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "crewai",
@@ -237,7 +237,7 @@
"./crewai"
],
"strict": false,
"description": "Expert skill for role-based multi-agent orchestration with CrewAI. Agents with Role/Goal/Backstory, task design, crew composition (sequential or hierarchical), tool integration, callbacks, and production deployment. Use when orchestrating multi-agent teams or comparing agent frameworks."
"description": "Build role-based multi-agent systems with CrewAI. Agents with Role/Goal/Backstory, task design, crew composition (sequential or hierarchical), tool integration, callbacks, and production deployment. Use when orchestrating multi-agent teams or comparing agent frameworks. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "crm",
@@ -309,7 +309,7 @@
"./data-scientist"
],
"strict": false,
"description": "Use for PhD-level expertise in data science, statistics, and machine learning: rigorous statistical analysis, experimental design, causal inference, advanced modeling, research methodology, or data science project leadership. Load when the user asks about statistical methods, experimental design, model selection, A/B testing, hypothesis testing, power analysis, regression, causality, Bayesian analysis, or research methodology. For insurance, actuarial, claims, reserving, solvency, credibility, tail-risk, or financial-risk statistical modeling, use `actuarial-risk-modeling`; for deterministic operating and SaaS financial models, use `financial-modeling`."
"description": "Use for PhD-level expertise in data science, statistics, and machine learning: rigorous statistical analysis, experimental design, causal inference, advanced modeling, research methodology, or data science project leadership. Load when the user asks about statistical methods, experimental design, model selection, A/B testing, hypothesis testing, power analysis, regression, causality, Bayesian analysis, or research methodology. For insurance, actuarial, claims, reserving, solvency, credibility, tail-risk, or financial-risk statistical modeling, use `actuarial-risk-modeling`; for deterministic operating and SaaS financial models, use `financial-modeling`. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "de-spin",
@@ -336,7 +336,7 @@
"./docker-compose"
],
"strict": false,
"description": "Use Docker Compose to define, run, debug, and harden multi-container applications. Load for compose.yaml design, networking, volumes, secrets, profiles, overrides, watch mode, lifecycle operations, or troubleshooting."
"description": "Use Docker Compose to define, run, debug, and harden multi-container applications. Load for compose.yaml design, networking, volumes, secrets, profiles, overrides, watch mode, lifecycle operations, or troubleshooting. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "documents",
@@ -363,7 +363,7 @@
"./dspy"
],
"strict": false,
"description": "Expert skill for programming—not prompting—language models with Stanford's DSPy framework. Signatures, modules (Predict, ChainOfThought, ReAct), optimizer/teleprompter selection, compilation, caching, evaluation. Use when doing programmatic prompt optimization or building compiled prompt programs."
"description": "Optimize and build programmatic prompt systems with Stanford DSPy. Signatures, modules (Predict, ChainOfThought, ReAct), optimizer/teleprompter selection, compilation, caching, evaluation. Use when doing programmatic prompt optimization or building compiled prompt programs. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "email",
@@ -390,7 +390,7 @@
"./epub"
],
"strict": false,
"description": "Read, write, and edit EPUB2/EPUB3 ebooks as an EPUB file format expert. Extract text, metadata, structure, and knowledge from EPUB files for enrichment or memory. Create valid EPUBs from scratch. Validate against the EPUB specification. Use when the user mentions epub, ebook, EPUB file, ebook format, read epub, write epub, create ebook, extract from epub, epub to text, or ebook structure."
"description": "Read, write, and edit EPUB2/EPUB3 ebooks as an EPUB file format expert. Extract text, metadata, structure, and knowledge from EPUB files for enrichment or memory. Create valid EPUBs from scratch. Validate against the EPUB specification. Use when the user mentions epub, ebook, EPUB file, ebook format, read epub, write epub, create ebook, extract from epub, epub to text, or ebook structure. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "esp32-development",
@@ -417,7 +417,7 @@
"./financial-modeling"
],
"strict": false,
"description": "Build and review assumptions-led financial models, unit economics, pricing, fundraising scenarios, and SaaS operating metrics. Use when calculating CAC, LTV, payback, runway, ARR, churn, NDR, Rule of 40, or sales efficiency; when modeling revenue, costs, cash flow, pricing, cap tables, or financing."
"description": "Build and review assumptions-led financial models, unit economics, pricing, fundraising scenarios, and SaaS operating metrics. Use when calculating CAC, LTV, payback, runway, ARR, churn, NDR, Rule of 40, or sales efficiency; when modeling revenue, costs, cash flow, pricing, cap tables, or financing. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "fireflies",
@@ -435,7 +435,7 @@
"./flaresolverr"
],
"strict": false,
"description": "Use the minimal FlareSolverr wrapper for a one-off health check or browser-backed GET/POST when ordinary retrieval is blocked by Cloudflare or DDoS-GUARD. Choose flaresolverr-cli instead for named session lifecycle, cookie-only returns, dry-run planning, or the full operational command surface."
"description": "Use the minimal FlareSolverr wrapper for a one-off health check or browser-backed GET/POST when ordinary retrieval is blocked by Cloudflare or DDoS-GUARD. Choose flaresolverr-cli instead for named session lifecycle, cookie-only returns, dry-run planning, or the full operational command surface. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "flaresolverr-cli",
@@ -444,7 +444,7 @@
"./flaresolverr-cli"
],
"strict": false,
"description": "Use a small FlareSolverr JSON CLI for browser-backed GET and POST requests, readiness checks, and session lifecycle management when a site requires Cloudflare or DDoS-GUARD challenge handling."
"description": "Use a small FlareSolverr JSON CLI for browser-backed GET and POST requests, readiness checks, and session lifecycle management when a site requires Cloudflare or DDoS-GUARD challenge handling. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "forgejo-cli",
@@ -453,7 +453,7 @@
"./forgejo-cli"
],
"strict": false,
"description": "Use when managing a Forgejo or Gitea server from the terminal: issues, pull requests, repositories, file contents, labels, milestones, releases, webhooks, user settings, or any /api/v1 endpoint through a safe generic API command."
"description": "Use when managing a Forgejo or Gitea server from the terminal: issues, pull requests, repositories, file contents, labels, milestones, releases, webhooks, user settings, or any /api/v1 endpoint through a safe generic API command. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "forward-deployed-engineering",
@@ -498,7 +498,7 @@
"./github-runner"
],
"strict": false,
"description": "Deploy, manage, and troubleshoot self-hosted GitHub Actions runners. Covers systemd service, Docker containers, Kubernetes (Actions Runner Controller), and the Scale Set Client. Use when setting up a CI runner, debugging registration failures, designing autoscaling, or hardening runner security."
"description": "Deploy, manage, and troubleshoot self-hosted GitHub Actions runners. Covers systemd service, Docker containers, Kubernetes (Actions Runner Controller), and the Scale Set Client. Use when setting up a CI runner, debugging registration failures, designing autoscaling, or hardening runner security. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "go-to-market",
@@ -525,7 +525,7 @@
"./gutenberg"
],
"strict": false,
"description": "Search, download, and extract public-domain books from Project Gutenberg. Look up books by ID or keyword via gutendex, download plain-text and EPUB editions, strip licensing boilerplate, extract clean text from EPUB for illustrated works, and classify fiction vs non-fiction. Ships a portable CLI script with zero external dependencies. Use when the user says \"gutenberg\", \"public domain\", \"download a book\", \"classic literature\", \"free ebook\", \"gutenberg.org\", or names any public-domain title or author."
"description": "Search, download, and extract public-domain books from Project Gutenberg. Look up books by ID or keyword via gutendex, download plain-text and EPUB editions, strip licensing boilerplate, extract clean text from EPUB for illustrated works, and classify fiction vs non-fiction. Ships a portable CLI script with zero external dependencies. Use when the user says \"gutenberg\", \"public domain\", \"download a book\", \"classic literature\", \"free ebook\", \"gutenberg.org\", or names any public-domain title or author. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "haystack",
@@ -534,7 +534,7 @@
"./haystack"
],
"strict": false,
"description": "Expert skill for production search and NLP pipelines with Haystack (deepset). Pipeline DAG composition, document stores, retrievers, PromptBuilder (Jinja2), generators, evaluation, Hayhooks deployment. Use when building search pipelines or comparing NLP application frameworks."
"description": "Build production search and NLP pipelines with Haystack. Pipeline DAG composition, document stores, retrievers, PromptBuilder (Jinja2), generators, evaluation, Hayhooks deployment. Use when building search pipelines or comparing NLP application frameworks. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "hugo-theme",
@@ -543,7 +543,7 @@
"./hugo-theme"
],
"strict": false,
"description": "Build, customize, and debug advanced Hugo CMS themes — template architecture, asset pipeline (CSS/JS/image processing), shortcodes and render hooks, page bundles, cover images, Hugo Modules, performance, SEO, and CI/CD. Use when working on a Hugo theme or site template layer."
"description": "Build, customize, and debug advanced Hugo CMS themes — template architecture, asset pipeline (CSS/JS/image processing), shortcodes and render hooks, page bundles, cover images, Hugo Modules, performance, SEO, and CI/CD. Use when working on a Hugo theme or site template layer. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "implementation-planning",
@@ -588,7 +588,7 @@
"./kanban-guru"
],
"strict": false,
"description": "A virtual Kanban expert who can diagnose flow problems, design board configurations, set up multi-portfolio operating models, calibrate WIP limits, establish service level expectations, and guide Scrum-to-Kanban transitions. Load this when your team is struggling with throughput, cycle times are unpredictable, multiple stakeholders compete for the same engineers, or you're wondering if Kanban is right for you."
"description": "Diagnose Kanban flow problems and design board operating models. Load this when your team is struggling with throughput, cycle times are unpredictable, multiple stakeholders compete for the same engineers, or you're wondering if Kanban is right for you. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "kubernetes",
@@ -597,7 +597,7 @@
"./kubernetes"
],
"strict": false,
"description": "Operate, troubleshoot, secure, upgrade, and automate Kubernetes clusters and workloads safely across upstream Kubernetes, k3s, RKE2, MicroK8s, k0s, Talos, OpenShift/OKD, kind, Minikube, Rancher-managed clusters, EKS, AKS, and GKE. Use when a task involves kubectl, Kubernetes APIs, Pods, Deployments, StatefulSets, Services, Ingress or Gateway API, CRDs, RBAC, NetworkPolicy, storage, scheduling, autoscaling, cluster lifecycle, or the bundled agent-first k8s-cli."
"description": "Operate, troubleshoot, secure, upgrade, and automate Kubernetes clusters and workloads safely across upstream Kubernetes, k3s, RKE2, MicroK8s, k0s, Talos, OpenShift/OKD, kind, Minikube, Rancher-managed clusters, EKS, AKS, and GKE. Use when a task involves kubectl, Kubernetes APIs, Pods, Deployments, StatefulSets, Services, Ingress or Gateway API, CRDs, RBAC, NetworkPolicy, storage, scheduling, autoscaling, cluster lifecycle, or the bundled agent-first k8s-cli. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "langchain",
@@ -606,7 +606,7 @@
"./langchain"
],
"strict": false,
"description": "Expert skill for building LLM applications with LangChain — LCEL chains, RAG pipelines, agent orchestration, LangGraph integration, LangSmith observability, and production deployment via LangServe. Use when working with LangChain or comparing LLM application frameworks."
"description": "Build LLM applications with LangChain. Use when working with LangChain or comparing LLM application frameworks. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "langgraph",
@@ -615,7 +615,7 @@
"./langgraph"
],
"strict": false,
"description": "Build multi-agent AI systems with LangGraph — the low-level orchestration framework for stateful, graph-based agent workflows. Covers supervisor, swarm, and hierarchical multi-agent patterns; subgraph composition; state management (checkpointers/stores); persistence; evals; and production debugging. Reach for this when designing agent architectures that need cycles, conditional branching, parallel execution, or human-in-the-loop patterns."
"description": "Build multi-agent AI systems with LangGraph — the low-level orchestration framework for stateful, graph-based agent workflows. Covers supervisor, swarm, and hierarchical multi-agent patterns; subgraph composition; state management (checkpointers/stores); persistence; evals; and production debugging. Reach for this when designing agent architectures that need cycles, conditional branching, parallel execution, or human-in-the-loop patterns. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "lastfm",
@@ -624,7 +624,7 @@
"./lastfm"
],
"strict": false,
"description": "Interact with the Last.fm music data API: lookup user listening history, get artist/album/track metadata, discover similar music via collaborative filtering, explore global and per-country charts, search by artist/album/track, manage tags, and scrobble listening events. Use when the user asks about music data, listening statistics, music recommendations, similar artists, charts, or wants to scrobble or love tracks."
"description": "Interact with the Last.fm music data API: lookup user listening history, get artist/album/track metadata, discover similar music via collaborative filtering, explore global and per-country charts, search by artist/album/track, manage tags, and scrobble listening events. Use when the user asks about music data, listening statistics, music recommendations, similar artists, charts, or wants to scrobble or love tracks. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "legal-strategy",
@@ -633,7 +633,7 @@
"./legal-strategy"
],
"strict": false,
"description": "CLO/General Counsel methodology — regulatory landscape analysis (GDPR, CCPA, AI Act, sector-specific), IP strategy (patent, trademark, trade secret, open source licensing), contract risk assessment (indemnification, liability caps, force majeure), data privacy frameworks (privacy-by-design, DPIAs, data mapping), corporate governance (board responsibilities, fiduciary duties, shareholder rights), employment law (classification, IP assignment, non-competes)."
"description": "Assess legal and regulatory strategy with a CLO or General Counsel methodology. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "life-coach",
@@ -678,7 +678,7 @@
"./llamaindex"
],
"strict": false,
"description": "Expert skill for building LLM applications with the LlamaIndex framework — RAG pipelines, multi-agent orchestration, event-driven workflows, knowledge graph construction, production deployment, and evaluation. Use when working with LlamaIndex or comparing RAG and agent orchestration frameworks."
"description": "Build LLM applications with the LlamaIndex framework. Use when working with LlamaIndex or comparing RAG and agent orchestration frameworks. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "mermaid-diagrams",
@@ -696,7 +696,7 @@
"./meshcore-packet-capture"
],
"strict": false,
"description": "Capture MeshCore Companion packets via BLE, serial, or TCP."
"description": "Capture MeshCore Companion packets via BLE, serial, or TCP. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "migration-engineering",
@@ -741,7 +741,7 @@
"./neckbeard"
],
"strict": false,
"description": "Use when asked to fix, build, refactor, review, verify, or release software and the work is non-trivial — including delivering a change request through planning, gates, implementation, review, verified PR, and authorized release; continuing work started elsewhere with no packet via evidence-based position assessment; or operating tracked work items in Linear, Jira, or Notion via their tooling skills. neckbeard routes the change through framing, discovery, design, implementation, review, verification, and learning — choosing the smallest *safe* intervention, proving it at the real delivery boundary, leaving an inspectable evidence ledger. For change-request / issue-to-PR work, conditionally loads a 9-phase journey with gates, delivery packet, and lifecycle integration. Composes specialist catalog skills rather than replacing them. Not a persona, not a '10x developer' prompt, not a LOC-minimizer. The journey is not loaded for plain fixes, refactors, or reviews that lack an issue/ticket trajectory."
"description": "Use when asked to fix, build, refactor, review, verify, or release software and the work is non-trivial — including delivering a change request through planning, gates, implementation, review, verified PR, and authorized release; continuing work started elsewhere with no packet via evidence-based position assessment; or operating tracked work items in Linear, Jira, or Notion via their tooling skills. neckbeard routes the change through framing, discovery, design, implementation, review, verification, and learning — choosing the smallest *safe* intervention, proving it at the real delivery boundary, and leaving an inspectable evidence ledger. For issue-to-PR work, conditionally loads a 9-phase journey with gates and lifecycle integration. Composes specialist catalog skills rather than replacing them. Not a persona or LOC-minimizer. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "notion",
@@ -759,7 +759,7 @@
"./nous-branding"
],
"strict": false,
"description": "Generate images and content consistent with the Nous Research brand identity. Use when creating visuals in the Nous / Theia / Hermes ecosystem: a \"cyber-classical\" style blending neo-classical statuary, cyberpunk/industrial grunge, and retro anime illustration. Covers official brand color palette, typography (Inter/IBM Plex Sans, JetBrains Mono, heavy distressed display faces), the Nous Girl mascot, texture system, and image prompt construction. Ships reference images for palette, mascot, and brand collage that can be used as img2img inputs."
"description": "Generate images and content consistent with the Nous Research brand identity. Use when creating visuals in the Nous / Theia / Hermes ecosystem: a \"cyber-classical\" style blending neo-classical statuary, cyberpunk/industrial grunge, and retro anime illustration. Covers official brand color palette, typography (Inter/IBM Plex Sans, JetBrains Mono, heavy distressed display faces), the Nous Girl mascot, texture system, and image prompt construction. Ships reference images for palette, mascot, and brand collage that can be used as img2img inputs. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "open-knowledge-format",
@@ -768,7 +768,7 @@
"./open-knowledge-format"
],
"strict": false,
"description": "Google's Open Knowledge Format (OKF) v0.1 — an open, vendor-neutral spec for representing knowledge as markdown files with YAML frontmatter, designed for AI agent consumption. Use when the user mentions OKF, Open Knowledge Format, Google's knowledge format, LLM wiki bundles, agent knowledge packs, creating OKF bundles, validating OKF documents, or converting knowledge into the OKF standard."
"description": "Define knowledge bundles with Google's Open Knowledge Format (OKF) v0.1. Use when the user mentions OKF, Open Knowledge Format, Google's knowledge format, LLM wiki bundles, agent knowledge packs, creating OKF bundles, validating OKF documents, or converting knowledge into the OKF standard. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "openlibrary",
@@ -786,7 +786,7 @@
"./opensource-contributions"
],
"strict": false,
"description": "Make good open source contributions — check CONTRIBUTING.md first, follow project norms, be a good citizen. Covers bug reports, feature requests, and pull requests with a defensible default posture when the project hasn't documented expectations."
"description": "Make good open source contributions — check CONTRIBUTING.md first, follow project norms, be a good citizen. Covers bug reports, feature requests, and pull requests with a defensible default posture when the project hasn't documented expectations. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "operational-design",
@@ -804,7 +804,7 @@
"./org-design"
],
"strict": false,
"description": "CHRO methodology — organizational design (team topologies, span of control, reporting structures), talent strategy (make-vs-buy, skill taxonomies, succession planning), compensation frameworks (market benchmarking, equity design, leveling), culture architecture (values codification, rituals, psychological safety), organizational health metrics (eNPS, retention risk, engagement surveys), DEI strategy (inclusive design, equitable systems, belonging)."
"description": "Design organizations with a CHRO methodology. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "pace-plan",
@@ -867,7 +867,7 @@
"./product-adoption"
],
"strict": false,
"description": "Diagnose and design product adoption for onboarding, activation, behavior change, feature discovery, rollout, and sustained use after launch. Covers consumer, B2B, internal-tool, and public-service contexts with evidence-based decision points and cohort segmentation. Does not own acquisition campaigns or marketing conversion (routes to go-to-market), product-analytics instrumentation (routes to product-analytics-and-measurement), or customer-success account management and health scoring (routes to conditional-customer-success)."
"description": "Diagnose and design product adoption for onboarding, activation, behavior change, feature discovery, rollout, and sustained use after launch. Covers consumer, B2B, internal-tool, and public-service contexts with evidence-based decision points and cohort segmentation. Does not own acquisition campaigns or marketing conversion (routes to go-to-market), product-analytics instrumentation (routes to product-analytics-and-measurement), or customer-success account management and health scoring (routes to conditional-customer-success). Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "product-analytics-and-measurement",
@@ -885,7 +885,7 @@
"./product-design-and-ux"
],
"strict": false,
"description": "Define user-facing product behavior from validated evidence and approved scope. Use for information architecture, task flows, state and recovery models, interface contracts, usability-study plans, interaction-pattern tradeoffs, or engineering UX handoffs. Use after product discovery and product decisions; route WCAG/ARIA conformance work to web-accessibility and formal software specifications to spec-driven-development."
"description": "Define user-facing product behavior from validated evidence and approved scope. Use for information architecture, task flows, state and recovery models, interface contracts, usability-study plans, interaction-pattern tradeoffs, or engineering UX handoffs. Use after product discovery and product decisions; route WCAG/ARIA conformance work to web-accessibility and formal software specifications to spec-driven-development. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "product-discovery",
@@ -894,7 +894,7 @@
"./product-discovery"
],
"strict": false,
"description": "Discover product requirements from human stakeholders — map who to talk to, ask questions that surface hidden assumptions, detect gaps in real time, resolve conflicts, and translate conversations into structured SDD specs. Phase 0 upstream of Spec-Driven Development."
"description": "Discover product requirements from human stakeholders — map who to talk to, ask questions that surface hidden assumptions, detect gaps in real time, resolve conflicts, and translate conversations into structured SDD specs. Phase 0 upstream of Spec-Driven Development. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "product-experimentation",
@@ -930,7 +930,7 @@
"./product-methodology"
],
"strict": false,
"description": "Translate validated product evidence into prioritized backlogs, decisions, specifications, and stakeholder communications. Covers RICE, MoSCoW, opportunity solution trees, decision logs, spec drafting, and audience-specific stakeholder communication. Use when the problem is validated and scope is being chosen."
"description": "Translate validated product evidence into tactical backlog decisions, prioritization, specifications, and stakeholder communications. Do not use this skill for CPO-level vision, positioning, or market strategy; use `product-strategy` for strategic direction."
},
{
"name": "product-operations-and-governance",
@@ -966,7 +966,7 @@
"./product-strategy"
],
"strict": false,
"description": "CPO methodology — product vision and strategy (North Star, product principles), competitive analysis and positioning, roadmap prioritization (RICE, Kano, OST), product-market fit frameworks (Sean Ellis test, retention curves), market sizing (TAM/SAM/SOM), platform strategy, product lifecycle management."
"description": "Set product vision and strategy with a CPO methodology. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "production-excellence",
@@ -975,7 +975,7 @@
"./production-excellence"
],
"strict": false,
"description": "Route cross-domain production evidence (readiness, migration, recovery, capacity/cost, incident-learning) into a launch or operational decision — go, no-go, defer, exception, or escalation — with an accountable owner and a post-launch learning path. Compose production specialists without copying their runbooks. Do not use for incident command, release-pipeline mechanics, platform architecture, threat modeling, data-pipeline design, or any task owned end-to-end by a single specialist skill; do not use as a generic checklist detached from service ownership, risk, evidence, and verification."
"description": "Build cross-domain production evidence from readiness, migration, recovery, capacity/cost, and incident learning into launch or operational decisions. Do not use this skill for a single specialist's risk packet and launch gate; use `production-readiness` for that readiness review."
},
{
"name": "production-readiness",
@@ -984,7 +984,7 @@
"./production-readiness"
],
"strict": false,
"description": "Define the minimum production evidence packet by risk class and produce go/no-go/defer/exception launch decisions with accountable owners. Cover ownership, user/business outcome, dependencies, SLOs, observability, support, security, data, rollback, capacity, and cost — every category with a named source or explicit missing-evidence outcome. Route detailed checks to existing specialist skills. Do not use for release pipeline mechanics (release-engineering) or incident response and SLO operations (site-reliability-engineering)."
"description": "Define risk-scaled evidence packets and go/no-go/defer/exception launch gates with accountable owners. Do not use this skill for cross-domain production composition; use `production-excellence` for assembling migration, recovery, capacity, and incident evidence."
},
{
"name": "programming-principles",
@@ -1002,7 +1002,7 @@
"./promise-theory"
],
"strict": false,
"description": "Design and diagnose coordination in hybrid human + AI agent workforces using promise theory (Burgess/Bergstra): model agents as autonomous, coordination as voluntary offers plus acceptance, and trust as calibrated assessment. Use for delegation modeling, capability manifests and agent contracts, coordination-failure diagnosis, trust/verification calibration, convergent self-healing systems, and converting obligation-based designs to promise-based. Do not use for enforceable centralized control, legal contract drafting (promise theory is not contract law), simple single-agent prompting, imperative push-based orchestration, or tool manuals — route those to the tool's own skill."
"description": "Teach promise vocabulary, fundamentals, and coordination diagnosis for promise-based systems. Do not use this skill for Semantic Spacetime models or SST CLI tooling; use `semantic-spacetime` for those model and tool workflows."
},
{
"name": "pydanticai",
@@ -1011,7 +1011,7 @@
"./pydanticai"
],
"strict": false,
"description": "Build type-safe AI agents and graph-based workflows with PydanticAI and PydanticGraph. Agent creation, function tools, capabilities, dependency injection, structured output, streaming, multi-agent patterns, testing, evals, and graph state machines. Use whenever you are building agents, tool-using LLM workflows, or graph-based state machines in Python."
"description": "Build type-safe AI agents and graph-based workflows with PydanticAI and PydanticGraph. Agent creation, function tools, capabilities, dependency injection, structured output, streaming, multi-agent patterns, testing, evals, and graph state machines. Use whenever you are building agents, tool-using LLM workflows, or graph-based state machines in Python. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "qa-methodology",
@@ -1056,7 +1056,7 @@
"./research-and-vault"
],
"strict": false,
"description": "Chain web research, atomic extraction, and durable knowledge capture into a repeatable workflow when the same research-to-notes sequence is needed."
"description": "Chain web research, atomic extraction, and durable note capture when the same research-to-notes sequence must repeat. Do not use this skill to design or evaluate an investigation; use `research-methodology` for research questions, methods, and evidence assessment."
},
{
"name": "research-methodology",
@@ -1065,7 +1065,7 @@
"./research-methodology"
],
"strict": false,
"description": "Plan, conduct, evaluate, and synthesize rigorous research. Use for journalistic, industry, or technical investigations that need credible evidence and a traceable method."
"description": "Plan, conduct, evaluate, and synthesize rigorous research investigations with credible evidence and a traceable method. Do not use this skill for repeated source extraction and durable note orchestration; use `research-and-vault` for that capture workflow."
},
{
"name": "resilience-and-recovery",
@@ -1110,7 +1110,7 @@
"./semantic-spacetime"
],
"strict": false,
"description": "Model and diagnose shared semantic ground between agents with Semantic Spacetime (Mark Burgess, 2014-2025): a discrete graph model of meaning over time, where local proper time replaces global clocks, causality is cooperative promises, and gamma(3,4) graphs expose semantic drift, world model divergence, and absorbing states. Use for designing convergent self-healing coordination, modeling intent and trajectories over time, mapping promises onto spacetime, diagnosing semantic drift or dead-ends, and analyzing temporal blindness in agents. Do not use for physics or relativity, pure vector embeddings or RAG without temporal-causal structure, enforceable centralized control, simple single-agent prompting, or tool manuals — route those to the appropriate skill."
"description": "Model and analyze Semantic Spacetime (SST) graphs, distances, trajectories, drift, and model files. Do not use this skill for promise-theory vocabulary and fundamentals without SST modeling; use `promise-theory` for the substrate concepts."
},
{
"name": "seo",
@@ -1128,7 +1128,7 @@
"./site-reliability-engineering"
],
"strict": false,
"description": "Design, operate, and improve reliable production systems with SLOs, incident command, observability, error budgets, and operational practices."
"description": "Design, operate, and improve reliable production systems with SLOs, incident command, observability, error budgets, and operational practices. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "slack",
@@ -1173,7 +1173,7 @@
"./strategy-frameworks"
],
"strict": false,
"description": "Structure organizational strategy work: strategic direction, competitive and industry analysis, growth options, capital allocation, acquisitions, and portfolio choices. Use when framing consequential choices about where to compete, how to pursue an opportunity, or how to compare strategic options."
"description": "Structure organizational strategy work: strategic direction, competitive and industry analysis, growth options, capital allocation, acquisitions, and portfolio choices. Use when framing consequential choices about where to compete, how to pursue an opportunity, or how to compare strategic options. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "stripe",
@@ -1200,7 +1200,7 @@
"./systematic-debugging"
],
"strict": false,
"description": "4-phase root cause debugging protocol: understand bugs before fixing. Use for ANY technical issue — test failures, production bugs, unexpected behavior, performance problems, build failures, or integration issues. ESPECIALLY when under time pressure, when \"one quick fix\" seems obvious, or when previous fix attempts have failed."
"description": "Diagnose root causes with a four-phase debugging protocol. Use for ANY technical issue — test failures, production bugs, unexpected behavior, performance problems, build failures, or integration issues. ESPECIALLY when under time pressure, when \"one quick fix\" seems obvious, or when previous fix attempts have failed. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "tailscale",
@@ -1209,7 +1209,7 @@
"./tailscale"
],
"strict": false,
"description": "Deploy and manage the self-hosted Tailscale/Headscale ecosystem: a Headscale control server, tailscale clients, ACL policies, node lifecycle, subnet routing, DERP relays, and backup/migration. Use when the user mentions Tailscale, Headscale, tailnet, mesh VPN, WireGuard mesh, or self-hosted VPN infrastructure."
"description": "Deploy and manage the self-hosted Tailscale/Headscale ecosystem: a Headscale control server, tailscale clients, ACL policies, node lifecycle, subnet routing, DERP relays, and backup/migration. Use when the user mentions Tailscale, Headscale, tailnet, mesh VPN, WireGuard mesh, or self-hosted VPN infrastructure. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "technical-documentation",
@@ -1263,7 +1263,7 @@
"./three"
],
"strict": false,
"description": "Build browser-based Three.js and WebGL scenes, animations, and interactive 3D visualizations with a small vanilla JavaScript starting point."
"description": "Build browser-based Three.js and WebGL scenes, animations, and interactive 3D visualizations with a small vanilla JavaScript starting point. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "tmdb",
@@ -1272,7 +1272,7 @@
"./tmdb"
],
"strict": false,
"description": "Query TMDb metadata for films and television, then enrich results with details, credits, providers, and external IDs. Do not use this skill for torrent search, streaming playback, or personal watch-history tracking."
"description": "Query TMDb metadata for films and television, then enrich results with details, credits, providers, and external IDs. Do not use this skill for personal watch history, watchlists, or tracking; use `trakt` for user activity and watch-state workflows."
},
{
"name": "traefik",
@@ -1281,7 +1281,7 @@
"./traefik"
],
"strict": false,
"description": "Deploy, configure, and troubleshoot Traefik v3 reverse proxy — covers all providers, routing, TLS/ACME, middlewares, and production patterns with YAML examples. Load when setting up or debugging a Traefik instance."
"description": "Deploy, configure, and troubleshoot Traefik v3 reverse proxy — covers all providers, routing, TLS/ACME, middlewares, and production patterns with YAML examples. Load when setting up or debugging a Traefik instance. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "trakt",
@@ -1290,7 +1290,7 @@
"./trakt"
],
"strict": false,
"description": "Discover and compare Trakt.tv trending, popular, and anticipated movies and shows from the terminal. Do not use this skill for TMDb catalog metadata, credits, images, or provider lookups; use the tmdb skill for those tasks."
"description": "Discover and compare Trakt.tv trending, popular, and anticipated movies and shows, and manage user-scoped history and watchlists from the terminal. Do not use this skill for general TMDb catalog metadata, credits, images, or provider lookups; use `tmdb` for those tasks."
},
{
"name": "transistor",
@@ -1353,7 +1353,7 @@
"./web-accessibility"
],
"strict": false,
"description": "Design, build, and review accessible web interfaces with native semantics, keyboard and focus behavior, forms and recovery, responsive input, motion, assistive-technology testing, and WCAG 2.2-informed evidence. Use for a11y, WCAG, ARIA, screen-reader, keyboard, focus, dialog, form, widget, or accessibility review work across frameworks."
"description": "Design, build, and review accessible web interfaces with native semantics, keyboard and focus behavior, forms and recovery, responsive input, motion, assistive-technology testing, and WCAG 2.2-informed evidence. Use for a11y, WCAG, ARIA, screen-reader, keyboard, focus, dialog, form, widget, or accessibility review work across frameworks. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "woodpecker-ci",
@@ -1362,7 +1362,7 @@
"./woodpecker-ci"
],
"strict": false,
"description": "Operate Woodpecker CI from installation through production troubleshooting: configure servers and agents, connect Forgejo/Gitea or another forge, write and validate pipelines, manage secrets and plugins, use Docker or Kubernetes backends, run the CLI, and diagnose failed builds. Use when setting up, administering, or debugging Woodpecker CI."
"description": "Operate Woodpecker CI from installation through production troubleshooting: configure servers and agents, connect Forgejo/Gitea or another forge, write and validate pipelines, manage secrets and plugins, use Docker or Kubernetes backends, run the CLI, and diagnose failed builds. Use when setting up, administering, or debugging Woodpecker CI. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "workflow-architect",
@@ -1371,7 +1371,7 @@
"./workflow-architect"
],
"strict": false,
"description": "Discover your actual workflow through conversation or observation, then generate a tailored skills bundle that encodes it as loadable agent skills with trigger conditions. Use when you want to understand your own process, formalize it, or share it with collaborators. Also use when a session feels aimless — this skill gives it structure."
"description": "Discover your actual workflow through conversation or observation, then generate a tailored skills bundle that encodes it as loadable agent skills with trigger conditions. Use when you want to understand your own process, formalize it, or share it with collaborators. Also use when a session feels aimless — this skill gives it structure. Do not use this skill for unrelated requests; route to the nearest named specialist."
},
{
"name": "writers-helper",
@@ -1389,7 +1389,7 @@
"./yc-default-alive-calculator"
],
"strict": false,
"description": "Evaluate whether a startup is on a trajectory to profitability before running out of cash — Paul Graham's \"Default Alive / Default Dead\" framework. Takes revenue, burn rate, cash on hand, and growth rate; computes runway, burn multiple, and months to breakeven. Ships a deterministic CLI calculator. Load when founders ask about runway, burn rate, default alive, whether they need to raise money, or financial sustainability analysis."
"description": "Evaluate startup runway, burn, revenue, and profitability trajectory using the Default Alive / Default Dead framework. Do not use this skill for weekly growth experiments or operating growth decisions; use `yc-weekly-growth-compass` for those decisions."
},
{
"name": "yc-weekly-growth-compass",
@@ -1398,7 +1398,7 @@
"./yc-weekly-growth-compass"
],
"strict": false,
"description": "Use Paul Graham's \"Startup = Growth\" framework as an operational decision tool. Computes weekly growth rates, benchmarks against YC tiers (1% concerning, 5-7% good, 10%+ exceptional), projects compound growth over time, and frames every startup decision through the question \"does this serve your target growth rate?\" Ships a deterministic CLI calculator. Load when founders ask about growth rate, weekly growth, startup traction, metrics, or whether they're moving fast enough; do not use for general financial modeling or engineering work unrelated to growth metrics."
"description": "Make weekly startup growth decisions using growth rate, user behavior, and experiment evidence. Do not use this skill for runway, burn, or profitability trajectory analysis; use `yc-default-alive-calculator` for financial sustainability."
}
]
}
agent-evals-and-observability/SKILL.md
+4 -3
View File
@@ -4,9 +4,10 @@ description: >-
Design, run, review, or release framework- and vendor-neutral evaluations and
observability for AI agents. Use when defining agent evals, datasets, graders,
trajectory review, regression analysis, release gates, production traces, or
privacy-aware telemetry. Covers task and trajectory contracts, statistical
comparisons, and incident-to-case learning; route framework implementation to
pydanticai or langgraph when needed.
privacy-aware telemetry. Covers task and trajectory contracts, statistical comparisons,
and incident-to-case learning; route framework implementation to pydanticai or langgraph
when needed. Do not use this skill for unrelated requests; route to the nearest named
specialist.
license: MIT
compatibility: No runtime dependency. Host-, framework-, model-, and telemetry-backend-neutral methodology.
metadata:
artifact-pyramids/SKILL.md
+4 -1
View File
@@ -1,6 +1,9 @@
---
name: artifact-pyramids
description: Organize durable agent research outputs as summaries, analysis, and evidence dossiers. Use when producing multi-layer research artifacts or coordinating research handoffs.
description: >-
Organize durable agent research outputs as summaries, analysis, and evidence dossiers.
Use when producing multi-layer research artifacts or coordinating research handoffs. Do
not use this skill for unrelated requests; route to the nearest named specialist.
license: MIT
compatibility: Python 3.9+ and a POSIX shell are required only for the bundled scripts.
metadata:
autogen/SKILL.md
+5 -4
View File
@@ -1,10 +1,11 @@
---
name: autogen
description: >-
Expert skill for conversational multi-agent AI with Microsoft AutoGen.
AssistantAgent, UserProxyAgent, GroupChat, code execution, nested chats,
cancellation tokens, tool integration, and MCP support. Use when building
conversation-driven multi-agent systems or comparing agent frameworks.
Build conversational multi-agent systems with Microsoft AutoGen. AssistantAgent,
UserProxyAgent, GroupChat, code execution, nested chats, cancellation tokens, tool
integration, and MCP support. Use when building conversation-driven multi-agent systems
or comparing agent frameworks. Do not use this skill for unrelated requests; route to
the nearest named specialist.
license: MIT
metadata:
author: Magnus Hedemark
brand-designer/SKILL.md
+7 -7
View File
@@ -1,13 +1,13 @@
---
name: brand-designer
description: >-
Create comprehensive brand identity documentation for any brand. Guides you
through documenting strategy, visual identity (logo, color, typography, imagery),
voice and tone, application guidelines, governance, and asset inventory.
Produces markdown specs, compiled brand books, and brand-compliant images via
reference-image-aware generation. Use when you need to capture a brand's identity
in structured, durable form — for vault storage, agency handoff, or press kit
distribution.
Create comprehensive brand identity documentation for any brand. Guides you through
documenting strategy, visual identity (logo, color, typography, imagery), voice and
tone, application guidelines, governance, and asset inventory. Produces markdown specs,
compiled brand books, and brand-compliant images via reference-image-aware generation.
Use when you need to capture a brand's identity in structured, durable form — for vault
storage, agency handoff, or press kit distribution. Do not use this skill for unrelated
requests; route to the nearest named specialist.
license: MIT
compatibility: >-
CLI requires Python 3.8+; generate script requires an image generation backend.
chief-of-staff-methodology/SKILL.md
+7 -6
View File
@@ -1,12 +1,13 @@
---
name: chief-of-staff-methodology
description: >-
Prepare accountable executive decisions, information triage, briefing, calendar
choices, organizational sensing, and institutional memory without assuming authority
or monitoring people. Use when a chief of staff or CoS, executive office,
gatekeeping, decision memo, executive briefing, board materials, organizational
sensing, team health, institutional memory, calendar triage, meeting audit,
strategic time, or attention allocation is requested.
Prepare accountable executive decisions, information triage, briefing, calendar choices,
organizational sensing, and institutional memory without assuming authority or
monitoring people. Use when a chief of staff or CoS, executive office, gatekeeping,
decision memo, executive briefing, board materials, organizational sensing, team health,
institutional memory, calendar triage, meeting audit, strategic time, or attention
allocation is requested. Do not use this skill for unrelated requests; route to the
nearest named specialist.
license: MIT
compatibility: No runtime dependency.
metadata:
color-management/SKILL.md
+5 -5
View File
@@ -1,11 +1,11 @@
---
name: color-management
description: >-
Expert-level color management for ICC profiles, working spaces, gamut
mapping, and color science. Use when inspecting ICC profiles, converting
between color spaces, checking gamut clipping, validating well-behaved
working spaces, or troubleshooting color workflow issues with ImageMagick,
ArgyllCMS, Exiftool, or LittleCMS.
Manage color workflows with ICC profiles, working spaces, gamut mapping, and color
science. Use when inspecting ICC profiles, converting between color spaces, checking
gamut clipping, validating well-behaved working spaces, or troubleshooting color
workflow issues with ImageMagick, ArgyllCMS, Exiftool, or LittleCMS. Do not use this
skill for unrelated requests; route to the nearest named specialist.
license: MIT
compatibility: CLI tools used (ImageMagick, Exiftool, ArgyllCMS, LittleCMS) are platform-independent; Python scripts require Python 3.8+
metadata:
confluence-cli/SKILL.md
+6 -4
View File
@@ -1,9 +1,11 @@
---
name: confluence-cli
description: 'Interact with Atlassian Confluence from the terminal: list spaces, browse
pages, view page content, search with CQL, and create pages. Use when the user mentions
Confluence, a space key (e.g. DEV), or asks about documentation, wiki pages, space
content, or knowledge base articles.'
description: >-
Interact with Atlassian Confluence from the terminal: list spaces, browse pages, view
page content, search with CQL, and create pages. Use when the user mentions Confluence,
a space key (e.g. DEV), or asks about documentation, wiki pages, space content, or
knowledge base articles. Do not use this skill for unrelated requests; route to the
nearest named specialist.
license: MIT
compatibility: Requires CONFLUENCE_EMAIL and CONFLUENCE_API_TOKEN env vars (free from
id.atlassian.com/manage/api-tokens), Python 3.8+, and the `requests` library. Also
crewai/SKILL.md
+5 -4
View File
@@ -1,10 +1,11 @@
---
name: crewai
description: >-
Expert skill for role-based multi-agent orchestration with CrewAI. Agents
with Role/Goal/Backstory, task design, crew composition (sequential or
hierarchical), tool integration, callbacks, and production deployment. Use
when orchestrating multi-agent teams or comparing agent frameworks.
Build role-based multi-agent systems with CrewAI. Agents with Role/Goal/Backstory, task
design, crew composition (sequential or hierarchical), tool integration, callbacks, and
production deployment. Use when orchestrating multi-agent teams or comparing agent
frameworks. Do not use this skill for unrelated requests; route to the nearest named
specialist.
license: MIT
metadata:
author: Magnus Hedemark
data-scientist/SKILL.md
+9 -9
View File
@@ -1,15 +1,15 @@
---
name: data-scientist
description: >-
Use for PhD-level expertise in data science, statistics, and machine learning:
rigorous statistical analysis, experimental design, causal inference, advanced
modeling, research methodology, or data science project leadership. Load when
the user asks about statistical methods, experimental design, model selection,
A/B testing, hypothesis testing, power analysis, regression, causality, Bayesian
analysis, or research methodology. For insurance, actuarial, claims, reserving,
solvency, credibility, tail-risk, or financial-risk statistical modeling, use
`actuarial-risk-modeling`; for deterministic operating and SaaS financial models,
use `financial-modeling`.
Use for PhD-level expertise in data science, statistics, and machine learning: rigorous
statistical analysis, experimental design, causal inference, advanced modeling, research
methodology, or data science project leadership. Load when the user asks about
statistical methods, experimental design, model selection, A/B testing, hypothesis
testing, power analysis, regression, causality, Bayesian analysis, or research
methodology. For insurance, actuarial, claims, reserving, solvency, credibility,
tail-risk, or financial-risk statistical modeling, use `actuarial-risk-modeling`; for
deterministic operating and SaaS financial models, use `financial-modeling`. Do not use
this skill for unrelated requests; route to the nearest named specialist.
license: MIT
compatibility: Python 3.10+ with scipy, statsmodels, scikit-learn, pandas, numpy.
PyTorch and sklearn are the primary ML frameworks. Hardware-aware via detect-compute.py.
docker-compose/SKILL.md
+4 -3
View File
@@ -1,9 +1,10 @@
---
name: docker-compose
description: >-
Use Docker Compose to define, run, debug, and harden multi-container applications.
Load for compose.yaml design, networking, volumes, secrets, profiles, overrides,
watch mode, lifecycle operations, or troubleshooting.
Use Docker Compose to define, run, debug, and harden multi-container applications. Load
for compose.yaml design, networking, volumes, secrets, profiles, overrides, watch mode,
lifecycle operations, or troubleshooting. Do not use this skill for unrelated requests;
route to the nearest named specialist.
license: MIT
compatibility: Docker Compose v2 or another implementation of the Compose Specification; commands require Docker CLI.
metadata:
dspy/SKILL.md
+5 -4
View File
@@ -1,10 +1,11 @@
---
name: dspy
description: >-
Expert skill for programming—not prompting—language models with Stanford's
DSPy framework. Signatures, modules (Predict, ChainOfThought, ReAct),
optimizer/teleprompter selection, compilation, caching, evaluation. Use when
doing programmatic prompt optimization or building compiled prompt programs.
Optimize and build programmatic prompt systems with Stanford DSPy. Signatures, modules
(Predict, ChainOfThought, ReAct), optimizer/teleprompter selection, compilation,
caching, evaluation. Use when doing programmatic prompt optimization or building
compiled prompt programs. Do not use this skill for unrelated requests; route to the
nearest named specialist.
license: MIT
metadata:
author: Magnus Hedemark
epub/SKILL.md
+7 -5
View File
@@ -1,10 +1,12 @@
---
name: epub
description: Read, write, and edit EPUB2/EPUB3 ebooks as an EPUB file format expert.
Extract text, metadata, structure, and knowledge from EPUB files for enrichment
or memory. Create valid EPUBs from scratch. Validate against the EPUB specification.
Use when the user mentions epub, ebook, EPUB file, ebook format, read epub, write
epub, create ebook, extract from epub, epub to text, or ebook structure.
description: >-
Read, write, and edit EPUB2/EPUB3 ebooks as an EPUB file format expert. Extract text,
metadata, structure, and knowledge from EPUB files for enrichment or memory. Create
valid EPUBs from scratch. Validate against the EPUB specification. Use when the user
mentions epub, ebook, EPUB file, ebook format, read epub, write epub, create ebook,
extract from epub, epub to text, or ebook structure. Do not use this skill for unrelated
requests; route to the nearest named specialist.
license: MIT
compatibility: Python 3.8+ required. Core scripts use EbookLib (pip install EbookLib)
for reading and creating EPUBs. Optional epublib (pip install epublib) for non-intrusive
financial-modeling/SKILL.md
+5 -4
View File
@@ -1,10 +1,11 @@
---
name: financial-modeling
description: >-
Build and review assumptions-led financial models, unit economics, pricing,
fundraising scenarios, and SaaS operating metrics. Use when calculating CAC,
LTV, payback, runway, ARR, churn, NDR, Rule of 40, or sales efficiency; when
modeling revenue, costs, cash flow, pricing, cap tables, or financing.
Build and review assumptions-led financial models, unit economics, pricing, fundraising
scenarios, and SaaS operating metrics. Use when calculating CAC, LTV, payback, runway,
ARR, churn, NDR, Rule of 40, or sales efficiency; when modeling revenue, costs, cash
flow, pricing, cap tables, or financing. Do not use this skill for unrelated requests;
route to the nearest named specialist.
license: MIT
metadata:
source_repo: https://github.com/magnus919/hermes-profiles
flaresolverr-cli/SKILL.md
+5 -1
View File
@@ -1,6 +1,10 @@
---
name: flaresolverr-cli
description: Use a small FlareSolverr JSON CLI for browser-backed GET and POST requests, readiness checks, and session lifecycle management when a site requires Cloudflare or DDoS-GUARD challenge handling.
description: >-
Use a small FlareSolverr JSON CLI for browser-backed GET and POST requests, readiness
checks, and session lifecycle management when a site requires Cloudflare or DDoS-GUARD
challenge handling. Do not use this skill for unrelated requests; route to the nearest
named specialist.
license: MIT
compatibility: Python 3.8+ (stdlib only). Requires a running FlareSolverr instance; FLARESOLVERR_SERVER defaults to http://localhost:8191.
metadata:
flaresolverr/SKILL.md
+6 -1
View File
@@ -1,6 +1,11 @@
---
name: flaresolverr
description: Use the minimal FlareSolverr wrapper for a one-off health check or browser-backed GET/POST when ordinary retrieval is blocked by Cloudflare or DDoS-GUARD. Choose flaresolverr-cli instead for named session lifecycle, cookie-only returns, dry-run planning, or the full operational command surface.
description: >-
Use the minimal FlareSolverr wrapper for a one-off health check or browser-backed
GET/POST when ordinary retrieval is blocked by Cloudflare or DDoS-GUARD. Choose
flaresolverr-cli instead for named session lifecycle, cookie-only returns, dry-run
planning, or the full operational command surface. Do not use this skill for unrelated
requests; route to the nearest named specialist.
---
# FlareSolverr
forgejo-cli/SKILL.md
+5 -3
View File
@@ -1,8 +1,10 @@
---
name: forgejo-cli
description: 'Use when managing a Forgejo or Gitea server from the terminal: issues,
pull requests, repositories, file contents, labels, milestones, releases, webhooks,
user settings, or any /api/v1 endpoint through a safe generic API command.'
description: >-
Use when managing a Forgejo or Gitea server from the terminal: issues, pull requests,
repositories, file contents, labels, milestones, releases, webhooks, user settings, or
any /api/v1 endpoint through a safe generic API command. Do not use this skill for
unrelated requests; route to the nearest named specialist.
license: MIT
compatibility: Python 3.8+; requests is required only for live API calls.
metadata:
github-runner/SKILL.md
+6 -4
View File
@@ -1,9 +1,11 @@
---
name: github-runner
description: Deploy, manage, and troubleshoot self-hosted GitHub Actions runners.
Covers systemd service, Docker containers, Kubernetes (Actions Runner Controller),
and the Scale Set Client. Use when setting up a CI runner, debugging registration
failures, designing autoscaling, or hardening runner security.
description: >-
Deploy, manage, and troubleshoot self-hosted GitHub Actions runners. Covers systemd
service, Docker containers, Kubernetes (Actions Runner Controller), and the Scale Set
Client. Use when setting up a CI runner, debugging registration failures, designing
autoscaling, or hardening runner security. Do not use this skill for unrelated requests;
route to the nearest named specialist.
license: MIT
compatibility: Linux, macOS, or Windows target hosts. Docker for containerized runners.
Kubernetes for ARC deployments.
gutenberg/SKILL.md
+8 -7
View File
@@ -1,12 +1,13 @@
---
name: gutenberg
description: Search, download, and extract public-domain books from Project Gutenberg.
Look up books by ID or keyword via gutendex, download plain-text and EPUB editions,
strip licensing boilerplate, extract clean text from EPUB for illustrated works,
and classify fiction vs non-fiction. Ships a portable CLI script with zero external
dependencies. Use when the user says "gutenberg", "public domain", "download a book",
"classic literature", "free ebook", "gutenberg.org", or names any public-domain
title or author.
description: >-
Search, download, and extract public-domain books from Project Gutenberg. Look up books
by ID or keyword via gutendex, download plain-text and EPUB editions, strip licensing
boilerplate, extract clean text from EPUB for illustrated works, and classify fiction vs
non-fiction. Ships a portable CLI script with zero external dependencies. Use when the
user says "gutenberg", "public domain", "download a book", "classic literature", "free
ebook", "gutenberg.org", or names any public-domain title or author. Do not use this
skill for unrelated requests; route to the nearest named specialist.
license: MIT
compatibility: Python 3.8+ with zero external dependencies. The CLI uses only the
Python standard library (urllib.request, json, html.parser, zipfile, re, sys). For
haystack/SKILL.md
+4 -4
View File
@@ -1,10 +1,10 @@
---
name: haystack
description: >-
Expert skill for production search and NLP pipelines with Haystack (deepset).
Pipeline DAG composition, document stores, retrievers, PromptBuilder (Jinja2),
generators, evaluation, Hayhooks deployment. Use when building search pipelines
or comparing NLP application frameworks.
Build production search and NLP pipelines with Haystack. Pipeline DAG composition,
document stores, retrievers, PromptBuilder (Jinja2), generators, evaluation, Hayhooks
deployment. Use when building search pipelines or comparing NLP application frameworks.
Do not use this skill for unrelated requests; route to the nearest named specialist.
license: MIT
metadata:
author: Magnus Hedemark
hugo-theme/SKILL.md
+5 -5
View File
@@ -1,11 +1,11 @@
---
name: hugo-theme
description: >-
Build, customize, and debug advanced Hugo CMS themes — template
architecture, asset pipeline (CSS/JS/image processing), shortcodes and
render hooks, page bundles, cover images, Hugo Modules, performance,
SEO, and CI/CD.
Use when working on a Hugo theme or site template layer.
Build, customize, and debug advanced Hugo CMS themes — template architecture, asset
pipeline (CSS/JS/image processing), shortcodes and render hooks, page bundles, cover
images, Hugo Modules, performance, SEO, and CI/CD. Use when working on a Hugo theme or
site template layer. Do not use this skill for unrelated requests; route to the nearest
named specialist.
license: MIT
compatibility: Works with any agent framework supporting the Agent Skills format.
metadata:
kanban-guru/SKILL.md
+4 -6
View File
@@ -1,12 +1,10 @@
---
name: kanban-guru
description: >-
A virtual Kanban expert who can diagnose flow problems, design board
configurations, set up multi-portfolio operating models, calibrate WIP
limits, establish service level expectations, and guide Scrum-to-Kanban
transitions. Load this when your team is struggling with throughput,
cycle times are unpredictable, multiple stakeholders compete for the
same engineers, or you're wondering if Kanban is right for you.
Diagnose Kanban flow problems and design board operating models. Load this when your
team is struggling with throughput, cycle times are unpredictable, multiple stakeholders
compete for the same engineers, or you're wondering if Kanban is right for you. Do not
use this skill for unrelated requests; route to the nearest named specialist.
compatibility: >-
Designed for agentic AI assistants (Hermes Agent, Claude Code, OpenCode,
GitHub Copilot, Cursor, similar coding/chat agents). No special system
kubernetes/SKILL.md
+7 -1
View File
@@ -1,7 +1,13 @@
---
name: kubernetes
description: >-
Operate, troubleshoot, secure, upgrade, and automate Kubernetes clusters and workloads safely across upstream Kubernetes, k3s, RKE2, MicroK8s, k0s, Talos, OpenShift/OKD, kind, Minikube, Rancher-managed clusters, EKS, AKS, and GKE. Use when a task involves kubectl, Kubernetes APIs, Pods, Deployments, StatefulSets, Services, Ingress or Gateway API, CRDs, RBAC, NetworkPolicy, storage, scheduling, autoscaling, cluster lifecycle, or the bundled agent-first k8s-cli.
Operate, troubleshoot, secure, upgrade, and automate Kubernetes clusters and workloads
safely across upstream Kubernetes, k3s, RKE2, MicroK8s, k0s, Talos, OpenShift/OKD, kind,
Minikube, Rancher-managed clusters, EKS, AKS, and GKE. Use when a task involves kubectl,
Kubernetes APIs, Pods, Deployments, StatefulSets, Services, Ingress or Gateway API,
CRDs, RBAC, NetworkPolicy, storage, scheduling, autoscaling, cluster lifecycle, or the
bundled agent-first k8s-cli. Do not use this skill for unrelated requests; route to the
nearest named specialist.
---
# Kubernetes
langchain/SKILL.md
+3 -4
View File
@@ -1,10 +1,9 @@
---
name: langchain
description: >-
Expert skill for building LLM applications with LangChain — LCEL chains, RAG
pipelines, agent orchestration, LangGraph integration, LangSmith observability,
and production deployment via LangServe. Use when working with LangChain or
comparing LLM application frameworks.
Build LLM applications with LangChain. Use when working with LangChain or comparing LLM
application frameworks. Do not use this skill for unrelated requests; route to the
nearest named specialist.
license: MIT
metadata:
author: Magnus Hedemark
langgraph/SKILL.md
+7 -5
View File
@@ -1,11 +1,13 @@
---
name: langgraph
description: Build multi-agent AI systems with LangGraph — the low-level orchestration
framework for stateful, graph-based agent workflows. Covers supervisor, swarm, and
hierarchical multi-agent patterns; subgraph composition; state management (checkpointers/stores);
description: >-
Build multi-agent AI systems with LangGraph — the low-level orchestration framework for
stateful, graph-based agent workflows. Covers supervisor, swarm, and hierarchical
multi-agent patterns; subgraph composition; state management (checkpointers/stores);
persistence; evals; and production debugging. Reach for this when designing agent
architectures that need cycles, conditional branching, parallel execution, or human-in-the-loop
patterns.
architectures that need cycles, conditional branching, parallel execution, or
human-in-the-loop patterns. Do not use this skill for unrelated requests; route to the
nearest named specialist.
license: MIT
metadata:
source: LangGraph by LangChain Inc — https://langchain.com/langgraph
lastfm/SKILL.md
+7 -6
View File
@@ -1,11 +1,12 @@
---
name: lastfm
description: 'Interact with the Last.fm music data API: lookup user listening history,
get artist/album/track metadata, discover similar music via collaborative filtering,
explore global and per-country charts, search by artist/album/track, manage tags,
and scrobble listening events. Use when the user asks about music data, listening
statistics, music recommendations, similar artists, charts, or wants to scrobble
or love tracks.'
description: >-
Interact with the Last.fm music data API: lookup user listening history, get
artist/album/track metadata, discover similar music via collaborative filtering, explore
global and per-country charts, search by artist/album/track, manage tags, and scrobble
listening events. Use when the user asks about music data, listening statistics, music
recommendations, similar artists, charts, or wants to scrobble or love tracks. Do not
use this skill for unrelated requests; route to the nearest named specialist.
license: MIT
compatibility: Requires a Last.fm API key in the LASTFM_API_KEY env var. For write
operations (scrobble, love, now-playing), also needs LASTFM_API_SECRET and LASTFM_SESSION_KEY.
legal-strategy/SKILL.md
+3 -6
View File
@@ -1,11 +1,8 @@
---
name: legal-strategy
description: CLO/General Counsel methodology — regulatory landscape analysis (GDPR,
CCPA, AI Act, sector-specific), IP strategy (patent, trademark, trade secret, open
source licensing), contract risk assessment (indemnification, liability caps, force
majeure), data privacy frameworks (privacy-by-design, DPIAs, data mapping), corporate
governance (board responsibilities, fiduciary duties, shareholder rights), employment
law (classification, IP assignment, non-competes).
description: >-
Assess legal and regulatory strategy with a CLO or General Counsel methodology. Do not
use this skill for unrelated requests; route to the nearest named specialist.
license: MIT
metadata:
tags: legal-strategy, clo, general-counsel, regulatory, ip-strategy, contract-risk,
llamaindex/SKILL.md
+3 -4
View File
@@ -1,10 +1,9 @@
---
name: llamaindex
description: >-
Expert skill for building LLM applications with the LlamaIndex framework —
RAG pipelines, multi-agent orchestration, event-driven workflows, knowledge
graph construction, production deployment, and evaluation. Use when working
with LlamaIndex or comparing RAG and agent orchestration frameworks.
Build LLM applications with the LlamaIndex framework. Use when working with LlamaIndex
or comparing RAG and agent orchestration frameworks. Do not use this skill for unrelated
requests; route to the nearest named specialist.
license: MIT
metadata:
author: Magnus Hedemark
llms.txt
+58 -58
View File
@@ -5,29 +5,29 @@
- [actuarial-risk-modeling](actuarial-risk-modeling/SKILL.md): Use when analyzing, selecting, validating, or communicating models for insurance, actuarial, financial-risk, or other consequential uncertain outcomes. Covers regression, generalized linear models, frequency-severity, panel and longitudinal data, survival, time series, credibility, reserving, tail risk, calibration, and model governance. Do not use for generic software forecasting, ordinary SaaS financial models, or credentialed actuarial, investment, legal, or regulatory advice without the relevant specialist review.
- [adr-authoring](adr-authoring/SKILL.md): Write, review, and maintain architecture decision records with clear context, alternatives, consequences, confirmation links, and lifecycle governance. Use when a consequential technical decision or its enforceable architectural constraint must remain understandable. Do not use for system-wide evolutionary architecture design, general observability, or operating a named test or CI tool.
- [agent-council](agent-council/SKILL.md): Run a structured multi-agent debate by spawning a panel of expert agents on any question, with convergence-aware iteration and typed synthesis output via the `agent-council` CLI. Use when a decision has genuine tradeoffs, high stakes, or hidden assumptions worth adversarial collaboration, or when confidence diagnostics matter more than a single recommendation. Compatible with any AI agent harness that supports agentskills.io skills (Claude Code, Cursor, Hermes Agent, OpenHands, etc.). Do not use for simple factual lookups, tasks with a clear correct answer, routine single-perspective work, or code execution and tool orchestration beyond debate.
- [agent-evals-and-observability](agent-evals-and-observability/SKILL.md): Design, run, review, or release framework- and vendor-neutral evaluations and observability for AI agents. Use when defining agent evals, datasets, graders, trajectory review, regression analysis, release gates, production traces, or privacy-aware telemetry. Covers task and trajectory contracts, statistical comparisons, and incident-to-case learning; route framework implementation to pydanticai or langgraph when needed.
- [agent-evals-and-observability](agent-evals-and-observability/SKILL.md): Design, run, review, or release framework- and vendor-neutral evaluations and observability for AI agents. Use when defining agent evals, datasets, graders, trajectory review, regression analysis, release gates, production traces, or privacy-aware telemetry. Covers task and trajectory contracts, statistical comparisons, and incident-to-case learning; route framework implementation to pydanticai or langgraph when needed. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [agent-production-operations](agent-production-operations/SKILL.md): Operate an evaluated agent with tools and authority in production through a runtime control plane covering versioning, staged rollout, fallback, cost and latency budgets, tool health, human escalation, disablement, and trace-to-eval feedback. Do not use for building agents, designing evals, or general release, SRE, security, or platform engineering — those methods stay with their specialist skills.
- [agent-skills](agent-skills/SKILL.md): Use this skill when creating, reviewing, or editing Agent Skills-format skills, or when implementing skill discovery and loading in an agent client. It covers directory structure, SKILL.md metadata, progressive disclosure, evals, and repository conventions. Do not use this skill for general software work that does not involve the Agent Skills format or lifecycle.
- [ai-governance](ai-governance/SKILL.md): Design and operate an organization's AI governance system: define governance principles, operating models and decision rights, risk frameworks, lifecycle gates, and fairness, transparency, privacy, security, regulatory, and board-oversight controls. Use when standing up a governance program, tiering AI use-case risk, reviewing an LLM or agent system for governance and safety gaps, mapping a regulation to a compliance plan, scoring governance maturity, or preparing board reporting. For regulated life-sciences use cases, also cover GxP, ALCOA+, data integrity, electronic records, validation/assurance, and QMS interfaces. Do not use for interpreting regulations as legal advice (route to legal-strategy), data-governance mechanics (data-architect/data-engineering), or implementing application security (secure-software-engineering).
- [ai-operating-economics](ai-operating-economics/SKILL.md): Use when deciding whether an AI-enabled workflow should be adopted, scaled, constrained, redesigned, or retired, and the decision must connect business outcomes, worker or user effects, quality guardrails, full operating cost, telemetry, uncertainty, and accountable governance. Do not use for a standalone financial model, infrastructure cost calculation, agent evaluation design, runtime operations, or general AI governance; route those details to the neighboring specialist skills.
- [anydoc](anydoc/SKILL.md): Convert Word (.doc/.docx/.docm), PowerPoint (.ppt/.pps/.pot/.pptx/.pptm/.ppsx/.ppsm), Excel (.xls/.xlsx/.xlsm/.xlsb), OpenDocument (.odt/.ods/.odp), RTF, EPUB, CSV, and PDF documents to clean GitHub-Flavored Markdown locally with the Any Doc CLI (npx -y @firecrawl/anydoc@0.2.4): headings, GFM tables, slide structure, and footnotes in one pass. Use when a task needs the contents of an office document, spreadsheet, presentation, ebook, or PDF you cannot read directly. Do not use for generating, editing, or validating documents (use documents), for ebook packaging (use epub). For scanned or image-only PDFs, use hosted OCR only when the user explicitly authorizes whole-document upload; otherwise route to local OCR tooling.
- [api-design-and-evolution](api-design-and-evolution/SKILL.md): Design, govern, document, review, and evolve consumer-facing APIs and event interfaces. Use when choosing REST/HTTP, GraphQL, RPC, events, webhooks, or streaming; writing OpenAPI or AsyncAPI contracts; assessing an API landscape, ownership, duplication, lifecycle, discoverability, retirement, gateways, service meshes, north-south or east-west traffic, routing, policy, observability, or failure boundaries; defining schemas, pagination, mutations, errors, idempotency, or compatibility; or planning versioning, deprecation, and migration. Do not use for product discovery, platform operations, full security assessment, ADR authoring, or delivery gates; route those to the neighboring specialist skills.
- [artifact-pyramids](artifact-pyramids/SKILL.md): Organize durable agent research outputs as summaries, analysis, and evidence dossiers. Use when producing multi-layer research artifacts or coordinating research handoffs.
- [artifact-pyramids](artifact-pyramids/SKILL.md): Organize durable agent research outputs as summaries, analysis, and evidence dossiers. Use when producing multi-layer research artifacts or coordinating research handoffs. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [ascii-city-engine](ascii-city-engine/SKILL.md): Build portable, first-person colored ASCII city engines and small GIS-derived city packs. Use when designing terrain-following walking, raycast character rendering, city-provider schemas, or reproducible public-GIS ingestion. Do not use for conventional 3D/WebGL games, multi-level interiors, general GIS analysis, or committing full-resolution GIS archives.
- [autogen](autogen/SKILL.md): Expert skill for conversational multi-agent AI with Microsoft AutoGen. AssistantAgent, UserProxyAgent, GroupChat, code execution, nested chats, cancellation tokens, tool integration, and MCP support. Use when building conversation-driven multi-agent systems or comparing agent frameworks.
- [autogen](autogen/SKILL.md): Build conversational multi-agent systems with Microsoft AutoGen. AssistantAgent, UserProxyAgent, GroupChat, code execution, nested chats, cancellation tokens, tool integration, and MCP support. Use when building conversation-driven multi-agent systems or comparing agent frameworks. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [backend-engineering](backend-engineering/SKILL.md): Design and implement backend services and APIs — REST, gRPC, GraphQL, event-driven handlers, transaction boundaries, outbox/inbox delivery, migration coexistence, database access, integration, error handling, and service-level testing. Use for application/domain/infrastructure implementation decisions. Language and framework agnostic. Do not use for frontend, data engineering, platform provisioning, API contract ownership, service decomposition strategy, or cross-system migration planning.
- [binary-analysis](binary-analysis/SKILL.md): Analyze unknown binary files through a deterministic CLI that wraps Ghidra's static-analysis engine. Use when you need to inspect a PE, ELF, or Mach-O file — triage suspicious binaries, map imported APIs, decompile functions, trace call paths, or produce structured evidence reports. Do not use for runtime analysis (debugging, dynamic tracing, sandbox execution), for modifying or patching binaries, or for binaries you already know everything about. The skill owns planning, hypothesis formation, and evidence synthesis; the CLI owns all deterministic operations.
- [bmad](bmad/SKILL.md): Use this skill to run BMad (Breakthrough Method of Agile AI-Driven Development) as a harness-agnostic control-plane protocol that turns human intent into bounded, inspectable, resumable agent work. Compress intent into a five-field contract (Why, Capabilities, Constraints, Non-goals, Success signal); classify work as direct/bounded/initiative and route to the smallest safe path; carry decisions in durable artifacts; review as triage; route failure to the layer where ambiguity entered; and gate autonomy on observable acceptance with machine-readable status (draft/ready-for-dev/in-progress/in-review/done/blocked). Use when a change request, feature, delegated build, or multi-agent epic needs intent capture, bounded implementation, review, and resumability in any agent harness. Do not use for validating whether a problem is real (product-discovery), shaping bets before planning (product-shaping), formal spec/gate pipelines (spec-driven-development), or the issue-to-PR delivery flow (neckbeard).
- [brand-designer](brand-designer/SKILL.md): Create comprehensive brand identity documentation for any brand. Guides you through documenting strategy, visual identity (logo, color, typography, imagery), voice and tone, application guidelines, governance, and asset inventory. Produces markdown specs, compiled brand books, and brand-compliant images via reference-image-aware generation. Use when you need to capture a brand's identity in structured, durable form — for vault storage, agency handoff, or press kit distribution.
- [brand-designer](brand-designer/SKILL.md): Create comprehensive brand identity documentation for any brand. Guides you through documenting strategy, visual identity (logo, color, typography, imagery), voice and tone, application guidelines, governance, and asset inventory. Produces markdown specs, compiled brand books, and brand-compliant images via reference-image-aware generation. Use when you need to capture a brand's identity in structured, durable form — for vault storage, agency handoff, or press kit distribution. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [c4-diagramming](c4-diagramming/SKILL.md): Create and review C4 software-architecture diagrams using Mermaid or Structurizr. Use when teams need a communication-ready system context, container, component, or code-level view, including audience, narrative, hierarchy, labels, legends, accessibility, and uncertainty. Do not use for Mermaid syntax/rendering work without C4 modeling, architecture decisions, or full accessibility conformance reviews.
- [capacity-and-cost-engineering](capacity-and-cost-engineering/SKILL.md): Model technical capacity, unit cost, and budget constraints connected to demand, performance, and reliability decisions. Use when projecting capacity from growth forecasts, sizing for peak events, designing cost-aware scaling policies, defining budget thresholds or quota/rate-limit enforcement, running or planning load/soak tests as capacity evidence, resolving SLO-cost tradeoffs, or modeling multi-tenant demand distributions, hot-tenant skew, pooled or siloed headroom, fairness evidence, and tenant-variable unit cost. Do NOT use for financial P&L statements, fundraising scenarios, or SaaS metrics (route to financial-modeling); for infrastructure implementation or cloud-resource provisioning (route to platform-engineering); or for generic cloud-cost tips and universal utilization targets — this skill does not prescribe fixed savings rates or one-size-fits-all thresholds.
- [chief-of-staff-methodology](chief-of-staff-methodology/SKILL.md): Prepare accountable executive decisions, information triage, briefing, calendar choices, organizational sensing, and institutional memory without assuming authority or monitoring people. Use when a chief of staff or CoS, executive office, gatekeeping, decision memo, executive briefing, board materials, organizational sensing, team health, institutional memory, calendar triage, meeting audit, strategic time, or attention allocation is requested.
- [chief-of-staff-methodology](chief-of-staff-methodology/SKILL.md): Prepare accountable executive decisions, information triage, briefing, calendar choices, organizational sensing, and institutional memory without assuming authority or monitoring people. Use when a chief of staff or CoS, executive office, gatekeeping, decision memo, executive briefing, board materials, organizational sensing, team health, institutional memory, calendar triage, meeting audit, strategic time, or attention allocation is requested. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [cli-builder](cli-builder/SKILL.md): Build or refactor agent-facing CLI tools with non-interactive commands, stable --help and --json contracts, idempotent operations, and --dry-run previews. Use for CLI design, agent-friction refactors, output/exit-code debugging, or automation safety. Do not use for GUI/TUI design, conversational tools, MCP server design, or general API architecture; use api-design-and-evolution for the latter.
- [cncf-landscape](cncf-landscape/SKILL.md): Use this skill when discovering and comparing cloud-native technologies from the CNCF Landscape for an architecture or engineering decision. Query the live public Landscape API, filter candidates by capability, category, maturity, license, and repository signals, then produce an evidence-backed shortlist with trade-offs, unknowns, and validation steps. Do not use it as a substitute for project documentation, production-readiness testing, legal review, or general architecture methodology.
- [color-management](color-management/SKILL.md): Expert-level color management for ICC profiles, working spaces, gamut mapping, and color science. Use when inspecting ICC profiles, converting between color spaces, checking gamut clipping, validating well-behaved working spaces, or troubleshooting color workflow issues with ImageMagick, ArgyllCMS, Exiftool, or LittleCMS.
- [color-management](color-management/SKILL.md): Manage color workflows with ICC profiles, working spaces, gamut mapping, and color science. Use when inspecting ICC profiles, converting between color spaces, checking gamut clipping, validating well-behaved working spaces, or troubleshooting color workflow issues with ImageMagick, ArgyllCMS, Exiftool, or LittleCMS. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [conditional-customer-success](conditional-customer-success/SKILL.md): Guide recurring human-relationship practices — success plans, health evidence, renewal and expansion signals, QBRs, handoffs, escalation, and closed-loop Voice of Customer. Do not use this skill for products without accounts, renewals, QBRs, or a customer-success team, including some internal tools, pure transactional products without recurring relationships, and public services without account-based engagement. Load only when the product context includes a recurring human relationship; decline or route away otherwise.
- [confluence-cli](confluence-cli/SKILL.md): Interact with Atlassian Confluence from the terminal: list spaces, browse pages, view page content, search with CQL, and create pages. Use when the user mentions Confluence, a space key (e.g. DEV), or asks about documentation, wiki pages, space content, or knowledge base articles.
- [crewai](crewai/SKILL.md): Expert skill for role-based multi-agent orchestration with CrewAI. Agents with Role/Goal/Backstory, task design, crew composition (sequential or hierarchical), tool integration, callbacks, and production deployment. Use when orchestrating multi-agent teams or comparing agent frameworks.
- [confluence-cli](confluence-cli/SKILL.md): Interact with Atlassian Confluence from the terminal: list spaces, browse pages, view page content, search with CQL, and create pages. Use when the user mentions Confluence, a space key (e.g. DEV), or asks about documentation, wiki pages, space content, or knowledge base articles. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [crewai](crewai/SKILL.md): Build role-based multi-agent systems with CrewAI. Agents with Role/Goal/Backstory, task design, crew composition (sequential or hierarchical), tool integration, callbacks, and production deployment. Use when orchestrating multi-agent teams or comparing agent frameworks. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [crm](crm/SKILL.md): Operate HubSpot CRM from a terminal or agent: list and search contact records, view deal pipeline stages, and — with explicit confirmation — move deals between stages, backed by a bundled crm-cli script that is read-only by default and gates every stage change behind a --dry-run/--yes confirmation. Use when an agent needs to answer questions about contacts or deals, produce pipeline views, or apply a confirmed stage change. Do not use for building HubSpot apps or workflow automations (that is HubSpot app development), marketing/sequence automation, or other CRMs like Salesforce (that is their own tooling).
- [crowdsec](crowdsec/SKILL.md): Deploy, configure, and operate CrowdSec Security Engine, cscli, remediation components, acquisition pipelines, and AppSec WAF. Use for Linux or Docker installation, detection-to-blocking design, incident review, and safe changes. Do not use for generic firewall, Kubernetes, or reverse-proxy design; route those to the named platform skill and use this skill for CrowdSec integration.
- [cyberpunk](cyberpunk/SKILL.md): Create or analyze settings, scenes, world operations, and image direction in the literary cyberpunk mode of William Gibson's Sprawl fiction: dense, accreted urban systems; uneven high technology; corporate power; mediated culture; and human-scale survival inside global networks. Use for Gibson-informed creative work, setting design, or visual briefs, not for generic neon cyberpunk, faithful continuation of named canon, or imitation of Gibson's prose.
@@ -35,125 +35,125 @@
- [data-architect](data-architect/SKILL.md): Use this skill to assess, design, and evolve data architectures, including data platforms, data products, data mesh adoption, event-driven data flows, governance, modeling, and migration decisions. Load it when teams need workload-grounded tradeoffs, ownership and quality agreements, or a current-to-target data architecture. Do not use it for pipeline or platform operations, implementation details, interface contract semantics, SQL tuning, or statistical modeling; route those to data-engineering, platform-engineering, api-design-and-evolution, postgres, or data-scientist.
- [data-cleaning](data-cleaning/SKILL.md): Clean, profile, validate, reshape, and document messy tabular, text, JSON, and relational data through an evidence-first, reproducible workflow. Use when preparing data for analysis, reporting, modeling, ingestion, migration, or matching. Do not use for statistical modeling, dashboard design, or operating a named data platform; route those tasks to data-scientist, data-engineering, or the relevant tool skill.
- [data-engineering](data-engineering/SKILL.md): Design and operate data infrastructure — database operations (vector, relational, graph, time-series), ETL/ELT pipeline design (dbt patterns, incremental loading), SQL analytical patterns, data quality monitoring, schema migration, and storage infrastructure management. Do not use for statistical analysis or ML model development.
- [data-scientist](data-scientist/SKILL.md): Use for PhD-level expertise in data science, statistics, and machine learning: rigorous statistical analysis, experimental design, causal inference, advanced modeling, research methodology, or data science project leadership. Load when the user asks about statistical methods, experimental design, model selection, A/B testing, hypothesis testing, power analysis, regression, causality, Bayesian analysis, or research methodology. For insurance, actuarial, claims, reserving, solvency, credibility, tail-risk, or financial-risk statistical modeling, use `actuarial-risk-modeling`; for deterministic operating and SaaS financial models, use `financial-modeling`.
- [data-scientist](data-scientist/SKILL.md): Use for PhD-level expertise in data science, statistics, and machine learning: rigorous statistical analysis, experimental design, causal inference, advanced modeling, research methodology, or data science project leadership. Load when the user asks about statistical methods, experimental design, model selection, A/B testing, hypothesis testing, power analysis, regression, causality, Bayesian analysis, or research methodology. For insurance, actuarial, claims, reserving, solvency, credibility, tail-risk, or financial-risk statistical modeling, use `actuarial-risk-modeling`; for deterministic operating and SaaS financial models, use `financial-modeling`. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [de-spin](de-spin/SKILL.md): Use when someone asks what is true, false, misleading, unsupported, unknown, or genuinely complicated in a persuasive message, article, pitch, advertisement, policy claim, or viral post. Analyze propaganda, spin, selective framing, urgency, social proof, deceptive marketing, and AI-generated persuasion by tracing claims to evidence and separating literal truth from implied conclusions. Do not use to read deception from demeanor, adjudicate intent, or replace broad domain research.
- [digital-twin](digital-twin/SKILL.md): Design, build, evaluate, govern, monitor, evolve, and retire digital twins and federated twin universes for software systems, engineering processes, agentic software factories, infrastructure, and cyber-physical operations. Use when a task involves digital-twin architecture, digital thread, simulation, predictive maintenance, twin health, agent authority, or dark-factory design. Do not use for ordinary observability dashboards, static dependency graphs, generic AI governance, or operating one named infrastructure tool without a twin-specific representation and feedback loop.
- [docker-compose](docker-compose/SKILL.md): Use Docker Compose to define, run, debug, and harden multi-container applications. Load for compose.yaml design, networking, volumes, secrets, profiles, overrides, watch mode, lifecycle operations, or troubleshooting.
- [docker-compose](docker-compose/SKILL.md): Use Docker Compose to define, run, debug, and harden multi-container applications. Load for compose.yaml design, networking, volumes, secrets, profiles, overrides, watch mode, lifecycle operations, or troubleshooting. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [documents](documents/SKILL.md): Generate, inspect, validate, and fix PDF, Word (.docx), Excel (.xlsx), and PowerPoint (.pptx) documents: turn structured content into render-ready artifacts, verify structural and output quality before delivery, and repair broken files. Use when a task involves creating, editing, converting, or validating office documents and PDFs. Do not use for ebook packaging (use epub), for images, video, or other media production, for API or code documentation, or for data pipelines (use data-engineering).
- [dsm5](dsm5/SKILL.md): Assess and explain questions about mental health and neurocognitive conditions against DSM-5-TR diagnostic criteria, and guide evidence-based conversations for clinicians, patients, and family members. Use when someone asks about symptoms, possible conditions, differential diagnoses, diagnostic criteria, prevalence, specifiers, or wants to understand or explain a mental health or neurological condition in plain language. Do not use for formal diagnosis, treatment decisions, crisis intervention, legal or insurance determinations, or any situation that requires a licensed clinician's judgment.
- [dspy](dspy/SKILL.md): Expert skill for programming—not prompting—language models with Stanford's DSPy framework. Signatures, modules (Predict, ChainOfThought, ReAct), optimizer/teleprompter selection, compilation, caching, evaluation. Use when doing programmatic prompt optimization or building compiled prompt programs.
- [dspy](dspy/SKILL.md): Optimize and build programmatic prompt systems with Stanford DSPy. Signatures, modules (Predict, ChainOfThought, ReAct), optimizer/teleprompter selection, compilation, caching, evaluation. Use when doing programmatic prompt optimization or building compiled prompt programs. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [email](email/SKILL.md): Send and diagnose transactional email through Twilio SendGrid from a terminal or agent: send messages, check deliverability (bounces and spam reports), and verify Signed Event Webhook signatures (ECDSA P-256) — with a bundled email-cli script that is read-only by default and gates every send behind a --dry-run/--yes confirmation. Use when an agent needs to send a transactional email, triage bounces or spam complaints, or confirm an inbound SendGrid webhook is authentic. Do not use for marketing or bulk email campaigns (that is SendGrid Marketing Campaigns), building email template systems, or other email providers (that is their own tooling).
- [enterprise-architecture](enterprise-architecture/SKILL.md): Design and evolve enterprise architectures by connecting business capabilities, value streams, applications, information, technology, operating models, and transition choices. Use when mapping an enterprise portfolio, comparing current and target states, sequencing transition architectures, or defining federated architecture decision rights and stakeholder communication. Do not use for system or solution design, API or data-platform design, organizational or talent design, product roadmaps, technology adoption, or corporate strategy; route those to the named specialist skills.
- [epub](epub/SKILL.md): Read, write, and edit EPUB2/EPUB3 ebooks as an EPUB file format expert. Extract text, metadata, structure, and knowledge from EPUB files for enrichment or memory. Create valid EPUBs from scratch. Validate against the EPUB specification. Use when the user mentions epub, ebook, EPUB file, ebook format, read epub, write epub, create ebook, extract from epub, epub to text, or ebook structure.
- [epub](epub/SKILL.md): Read, write, and edit EPUB2/EPUB3 ebooks as an EPUB file format expert. Extract text, metadata, structure, and knowledge from EPUB files for enrichment or memory. Create valid EPUBs from scratch. Validate against the EPUB specification. Use when the user mentions epub, ebook, EPUB file, ebook format, read epub, write epub, create ebook, extract from epub, epub to text, or ebook structure. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [esp32-development](esp32-development/SKILL.md): Build, configure, flash, test, debug, and recover firmware for ESP32-family boards, including ESP-IDF C/C++, Arduino/PlatformIO, MicroPython, CircuitPython, ESPHome, Zephyr, Rust, and NuttX. Use when identifying an ESP32 board, choosing a framework, wiring GPIO or peripheral buses, integrating sensors or actuators, diagnosing serial/boot/power/network failures, or planning OTA and production security. Do not use as a substitute for the exact board schematic, SoC datasheet, or attached component datasheet.
- [ffmpeg](ffmpeg/SKILL.md): Use this skill when an agent needs to inspect, convert, remux, transcode, filter, combine, stream, or troubleshoot audio and video with the FFmpeg command-line tools, especially ffmpeg and ffprobe. It teaches explicit stream selection, filtergraph construction, timestamp diagnosis, build-aware commands, safe scripting, and post-run verification. Do not use it for libav API programming, professional color-management certification, DRM circumvention, or untested platform-specific capture hardware; route those to specialized guidance.
- [financial-modeling](financial-modeling/SKILL.md): Build and review assumptions-led financial models, unit economics, pricing, fundraising scenarios, and SaaS operating metrics. Use when calculating CAC, LTV, payback, runway, ARR, churn, NDR, Rule of 40, or sales efficiency; when modeling revenue, costs, cash flow, pricing, cap tables, or financing.
- [financial-modeling](financial-modeling/SKILL.md): Build and review assumptions-led financial models, unit economics, pricing, fundraising scenarios, and SaaS operating metrics. Use when calculating CAC, LTV, payback, runway, ARR, churn, NDR, Rule of 40, or sales efficiency; when modeling revenue, costs, cash flow, pricing, cap tables, or financing. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [fireflies](fireflies/SKILL.md): Query Fireflies.ai meeting transcripts, meeting notes, summaries, contacts, channels, AI meeting analytics, AskFred, audio uploads, and webhook signatures through its GraphQL API. Use when a user mentions Fireflies, Fireflies.ai, meeting transcripts or notes stored in Fireflies, AskFred, or Fireflies webhooks. Do not use for local audio transcription, calendar management, or meetings that are not Fireflies data.
- [flaresolverr](flaresolverr/SKILL.md): Use the minimal FlareSolverr wrapper for a one-off health check or browser-backed GET/POST when ordinary retrieval is blocked by Cloudflare or DDoS-GUARD. Choose flaresolverr-cli instead for named session lifecycle, cookie-only returns, dry-run planning, or the full operational command surface.
- [flaresolverr-cli](flaresolverr-cli/SKILL.md): Use a small FlareSolverr JSON CLI for browser-backed GET and POST requests, readiness checks, and session lifecycle management when a site requires Cloudflare or DDoS-GUARD challenge handling.
- [forgejo-cli](forgejo-cli/SKILL.md): Use when managing a Forgejo or Gitea server from the terminal: issues, pull requests, repositories, file contents, labels, milestones, releases, webhooks, user settings, or any /api/v1 endpoint through a safe generic API command.
- [flaresolverr](flaresolverr/SKILL.md): Use the minimal FlareSolverr wrapper for a one-off health check or browser-backed GET/POST when ordinary retrieval is blocked by Cloudflare or DDoS-GUARD. Choose flaresolverr-cli instead for named session lifecycle, cookie-only returns, dry-run planning, or the full operational command surface. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [flaresolverr-cli](flaresolverr-cli/SKILL.md): Use a small FlareSolverr JSON CLI for browser-backed GET and POST requests, readiness checks, and session lifecycle management when a site requires Cloudflare or DDoS-GUARD challenge handling. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [forgejo-cli](forgejo-cli/SKILL.md): Use when managing a Forgejo or Gitea server from the terminal: issues, pull requests, repositories, file contents, labels, milestones, releases, webhooks, user settings, or any /api/v1 endpoint through a safe generic API command. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [forward-deployed-engineering](forward-deployed-engineering/SKILL.md): Guide embedded technical engagements from ambiguous stakeholder need through discovery, framing, hypothesis, build, evaluation, deployment, adoption, measurement, and generalization while preserving evidence, decision rights, and field learning. Use when one accountable technical lead must carry continuity across customer or stakeholder discovery, implementation, production fit, adoption, and measurable outcomes. Do not use for a bounded repository change, product investment governance, ongoing reliability or platform ownership, an isolated specialist task, or advisory work that ends before implementation and adoption.
- [frontend-engineering](frontend-engineering/SKILL.md): Build and maintain web frontends — component architecture, state management, API integration, responsive layout, client-side performance, and frontend testing patterns. Framework agnostic, focused on web frontend implementation. Do not use for backend service implementation, data engineering, or platform infrastructure work.
- [genius-life](genius-life/SKILL.md): Guide a person in cultivating creativity in their own work and life: open conversational sessions on creative blocks, habits, environment, motivation, and resilience, or structured development of a concrete project or fledgling idea through a five-phase practice. Do not use for therapy or clinical support, general life coaching, product or stakeholder discovery, or as a study guide for a book.
- [ghost](ghost/SKILL.md): Manage Ghost CMS content over the Admin API — browse posts, pages, and tags, draft and publish content, schedule posts, and inspect site info from the terminal. Do not use this skill for Ghost server installation or site administration (installing, nginx, SSL, systemd, updates); those belong to the official npm ghost-cli tooling.
- [github-runner](github-runner/SKILL.md): Deploy, manage, and troubleshoot self-hosted GitHub Actions runners. Covers systemd service, Docker containers, Kubernetes (Actions Runner Controller), and the Scale Set Client. Use when setting up a CI runner, debugging registration failures, designing autoscaling, or hardening runner security.
- [github-runner](github-runner/SKILL.md): Deploy, manage, and troubleshoot self-hosted GitHub Actions runners. Covers systemd service, Docker containers, Kubernetes (Actions Runner Controller), and the Scale Set Client. Use when setting up a CI runner, debugging registration failures, designing autoscaling, or hardening runner security. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [go-to-market](go-to-market/SKILL.md): Plan and execute go-to-market strategy — positioning and messaging frameworks (April Dunford's positioning, message hierarchy), customer acquisition strategy (paid, organic, PLG, SLG), brand architecture (brand house vs house of brands), growth modeling (CAC/LTV by channel, cohort analysis), market entry strategy (beachhead, land-and-expand), and competitive response (pricing wars, feature races, brand defense). Do not use for sales execution and pipeline management, product strategy, or visual brand identity design.
- [grafana](grafana/SKILL.md): Operate, configure, provision, secure, and troubleshoot Grafana OSS, Enterprise, and Cloud, including dashboards, folders, data sources, annotations, alert rules, contact points, notification policies, silences, mute timings, service accounts, RBAC, plugins, APIs, and as-code workflows. Use for Grafana product work and Grafana-side integrations. Do not use for defining SLOs or paging policy, operating Prometheus/Loki/Tempo/InfluxDB backends, generic Docker/Kubernetes/Terraform/reverse-proxy work, plugin development, or authorized security assessments; use the corresponding specialist skill.
- [gutenberg](gutenberg/SKILL.md): Search, download, and extract public-domain books from Project Gutenberg. Look up books by ID or keyword via gutendex, download plain-text and EPUB editions, strip licensing boilerplate, extract clean text from EPUB for illustrated works, and classify fiction vs non-fiction. Ships a portable CLI script with zero external dependencies. Use when the user says "gutenberg", "public domain", "download a book", "classic literature", "free ebook", "gutenberg.org", or names any public-domain title or author.
- [haystack](haystack/SKILL.md): Expert skill for production search and NLP pipelines with Haystack (deepset). Pipeline DAG composition, document stores, retrievers, PromptBuilder (Jinja2), generators, evaluation, Hayhooks deployment. Use when building search pipelines or comparing NLP application frameworks.
- [hugo-theme](hugo-theme/SKILL.md): Build, customize, and debug advanced Hugo CMS themes — template architecture, asset pipeline (CSS/JS/image processing), shortcodes and render hooks, page bundles, cover images, Hugo Modules, performance, SEO, and CI/CD. Use when working on a Hugo theme or site template layer.
- [gutenberg](gutenberg/SKILL.md): Search, download, and extract public-domain books from Project Gutenberg. Look up books by ID or keyword via gutendex, download plain-text and EPUB editions, strip licensing boilerplate, extract clean text from EPUB for illustrated works, and classify fiction vs non-fiction. Ships a portable CLI script with zero external dependencies. Use when the user says "gutenberg", "public domain", "download a book", "classic literature", "free ebook", "gutenberg.org", or names any public-domain title or author. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [haystack](haystack/SKILL.md): Build production search and NLP pipelines with Haystack. Pipeline DAG composition, document stores, retrievers, PromptBuilder (Jinja2), generators, evaluation, Hayhooks deployment. Use when building search pipelines or comparing NLP application frameworks. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [hugo-theme](hugo-theme/SKILL.md): Build, customize, and debug advanced Hugo CMS themes — template architecture, asset pipeline (CSS/JS/image processing), shortcodes and render hooks, page bundles, cover images, Hugo Modules, performance, SEO, and CI/CD. Use when working on a Hugo theme or site template layer. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [implementation-planning](implementation-planning/SKILL.md): Plan the implementation of an approved requirement or specification: produce an executable, dependency-aware delivery plan covering work breakdown, dependency mapping, critical path, ownership, parallelism and sequencing, rollout strategy, rollback and recovery paths, and verification against the original requirement. Supports cross-team, cross-repository, migration, and staged-rollout scenarios. Do not use for pre-approval discovery or needs-finding, authoring a specification from scratch, coding or implementation, the neckbeard issue-to-PR delivery flow itself, or any work whose prerequisite decision has not been approved — planning unapproved work is an explicit stop condition.
- [incident-learning](incident-learning/SKILL.md): Convert operational incident and near-miss evidence into durable product, engineering, test, evaluation, and governance improvements with verified closure. Separate observed facts from causal hypotheses and unresolved uncertainty; map follow-up work across code, tests, skills, operations, product, and governance; track ownership, verification, and closure for every finding. Do not use to assign blame or produce a generic postmortem template; do not close learning because tickets were created — require evidence the intended change occurred.
- [jellyfin](jellyfin/SKILL.md): Query your Jellyfin media server from the terminal — recently added media, search, item details, series navigation, next-up episodes, library browsing, server info, and user login. Use when the user asks about Jellyfin, media servers, movies, TV shows, next episodes, or their media library. Do not use this skill for server installation, library management, playback control, or Emby/Plex servers.
- [jira](jira/SKILL.md): Interact with Atlassian Jira from the terminal: search issues with JQL, view details, create issues, add comments, count matches with fast approximate-count, list projects, discover valid transitions, and change status. Includes a full JQL language reference (functions, operators, history predicates, date expressions, saved filters, performance tuning) plus REST auth/pagination guidance. Use when the user mentions Jira, a ticket key (e.g. PROJ-123), asks about issues, bugs, tasks, projects, or sprint work, or needs to write, debug, or optimize JQL queries. Do not use for GitHub or GitLab issue tracking, Jira site administration, or generic ticketing systems.
- [kanban-guru](kanban-guru/SKILL.md): A virtual Kanban expert who can diagnose flow problems, design board configurations, set up multi-portfolio operating models, calibrate WIP limits, establish service level expectations, and guide Scrum-to-Kanban transitions. Load this when your team is struggling with throughput, cycle times are unpredictable, multiple stakeholders compete for the same engineers, or you're wondering if Kanban is right for you.
- [kubernetes](kubernetes/SKILL.md): Operate, troubleshoot, secure, upgrade, and automate Kubernetes clusters and workloads safely across upstream Kubernetes, k3s, RKE2, MicroK8s, k0s, Talos, OpenShift/OKD, kind, Minikube, Rancher-managed clusters, EKS, AKS, and GKE. Use when a task involves kubectl, Kubernetes APIs, Pods, Deployments, StatefulSets, Services, Ingress or Gateway API, CRDs, RBAC, NetworkPolicy, storage, scheduling, autoscaling, cluster lifecycle, or the bundled agent-first k8s-cli.
- [langchain](langchain/SKILL.md): Expert skill for building LLM applications with LangChain — LCEL chains, RAG pipelines, agent orchestration, LangGraph integration, LangSmith observability, and production deployment via LangServe. Use when working with LangChain or comparing LLM application frameworks.
- [langgraph](langgraph/SKILL.md): Build multi-agent AI systems with LangGraph — the low-level orchestration framework for stateful, graph-based agent workflows. Covers supervisor, swarm, and hierarchical multi-agent patterns; subgraph composition; state management (checkpointers/stores); persistence; evals; and production debugging. Reach for this when designing agent architectures that need cycles, conditional branching, parallel execution, or human-in-the-loop patterns.
- [lastfm](lastfm/SKILL.md): Interact with the Last.fm music data API: lookup user listening history, get artist/album/track metadata, discover similar music via collaborative filtering, explore global and per-country charts, search by artist/album/track, manage tags, and scrobble listening events. Use when the user asks about music data, listening statistics, music recommendations, similar artists, charts, or wants to scrobble or love tracks.
- [legal-strategy](legal-strategy/SKILL.md): CLO/General Counsel methodology — regulatory landscape analysis (GDPR, CCPA, AI Act, sector-specific), IP strategy (patent, trademark, trade secret, open source licensing), contract risk assessment (indemnification, liability caps, force majeure), data privacy frameworks (privacy-by-design, DPIAs, data mapping), corporate governance (board responsibilities, fiduciary duties, shareholder rights), employment law (classification, IP assignment, non-competes).
- [kanban-guru](kanban-guru/SKILL.md): Diagnose Kanban flow problems and design board operating models. Load this when your team is struggling with throughput, cycle times are unpredictable, multiple stakeholders compete for the same engineers, or you're wondering if Kanban is right for you. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [kubernetes](kubernetes/SKILL.md): Operate, troubleshoot, secure, upgrade, and automate Kubernetes clusters and workloads safely across upstream Kubernetes, k3s, RKE2, MicroK8s, k0s, Talos, OpenShift/OKD, kind, Minikube, Rancher-managed clusters, EKS, AKS, and GKE. Use when a task involves kubectl, Kubernetes APIs, Pods, Deployments, StatefulSets, Services, Ingress or Gateway API, CRDs, RBAC, NetworkPolicy, storage, scheduling, autoscaling, cluster lifecycle, or the bundled agent-first k8s-cli. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [langchain](langchain/SKILL.md): Build LLM applications with LangChain. Use when working with LangChain or comparing LLM application frameworks. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [langgraph](langgraph/SKILL.md): Build multi-agent AI systems with LangGraph — the low-level orchestration framework for stateful, graph-based agent workflows. Covers supervisor, swarm, and hierarchical multi-agent patterns; subgraph composition; state management (checkpointers/stores); persistence; evals; and production debugging. Reach for this when designing agent architectures that need cycles, conditional branching, parallel execution, or human-in-the-loop patterns. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [lastfm](lastfm/SKILL.md): Interact with the Last.fm music data API: lookup user listening history, get artist/album/track metadata, discover similar music via collaborative filtering, explore global and per-country charts, search by artist/album/track, manage tags, and scrobble listening events. Use when the user asks about music data, listening statistics, music recommendations, similar artists, charts, or wants to scrobble or love tracks. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [legal-strategy](legal-strategy/SKILL.md): Assess legal and regulatory strategy with a CLO or General Counsel methodology. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [life-coach](life-coach/SKILL.md): Guide a bounded, user-led coaching process for personal goals, decisions, transitions, habits, recurring nonclinical patterns, accountability, and progress review. Use when a person explicitly asks to be coached, wants reflective challenge, or wants help examining ambivalence while retaining ownership. Do not use for therapy, crisis support, diagnosis, direct factual or action requests, product or stakeholder discovery, or medical, legal, financial, addiction, domestic-violence, or other specialist advice.
- [linear](linear/SKILL.md): Manage Linear teams, projects, cycles, issues, comments, workflow state, and documents from a terminal through Linear's public GraphQL API. Use when a user asks to list, search, inspect, create, update, move, or comment on Linear work, or to find Linear documents. Do not use to embed a live agent inside Linear or to build an MCP integration.
- [litellm](litellm/SKILL.md): Operate, configure, secure, and troubleshoot the LiteLLM AI gateway (proxy) and Python SDK: run the proxy (litellm --config), route to 100+ providers through one OpenAI-compatible API, configure model lists and routing/reliability, virtual keys, teams, budgets, rate limits, caching, guardrails, observability, and spend, and diagnose request failures. Use when deploying or running a LiteLLM proxy or gateway (config.yaml, ghcr.io/berriai/litellm), wiring the Python SDK or OpenAI SDK through it, or hardening a public-facing deployment. Do not use for operating a single inference engine (vllm, llama-cpp), for engine-selection methodology (ml-engineering), or for building applications on top of an LLM API (backend/frontend engineering).
- [llama-cpp](llama-cpp/SKILL.md): Operate, configure, benchmark, and troubleshoot llama.cpp across CPU, Metal, CUDA, HIP/ROCm, Vulkan, SYCL, and hybrid or multi-GPU systems. Use when installing or building llama.cpp, selecting or inspecting GGUF models, running llama-cli, serving an OpenAI-compatible API with llama-server, tuning memory and performance, or diagnosing backend, context, template, and API failures. Do not use for model training or fine-tuning, general inference-framework selection, llama-cpp-python or other bindings, LlamaIndex, Ollama, or LM Studio operation.
- [llamaindex](llamaindex/SKILL.md): Expert skill for building LLM applications with the LlamaIndex framework — RAG pipelines, multi-agent orchestration, event-driven workflows, knowledge graph construction, production deployment, and evaluation. Use when working with LlamaIndex or comparing RAG and agent orchestration frameworks.
- [llamaindex](llamaindex/SKILL.md): Build LLM applications with the LlamaIndex framework. Use when working with LlamaIndex or comparing RAG and agent orchestration frameworks. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [mermaid-diagrams](mermaid-diagrams/SKILL.md): Author, render, troubleshoot, and review Mermaid diagrams for documentation, architecture, processes, and technical communication. Use when a versionable diagram must communicate a defined audience job across a real renderer, including narrative, hierarchy, labels, legends, accessibility fallback, and uncertainty. Do not use for C4 level/model ownership, architecture decisions, or full accessibility conformance.
- [meshcore-packet-capture](meshcore-packet-capture/SKILL.md): Capture MeshCore Companion packets via BLE, serial, or TCP.
- [meshcore-packet-capture](meshcore-packet-capture/SKILL.md): Capture MeshCore Companion packets via BLE, serial, or TCP. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [migration-engineering](migration-engineering/SKILL.md): Plan and execute safe cross-system migrations, including service extraction from monoliths. Use when moving data, schemas, interfaces, infrastructure, or service ownership through compatibility windows, dual-running, reconciliation, cutover, recovery, or deprecation. Do not use for deciding whether decomposition is justified, designing a target architecture, or implementing one named technology; route those to the relevant architecture or specialist skill.
- [ml-engineering](ml-engineering/SKILL.md): Plan and execute production ML engineering work — model training and fine-tuning (LoRA/QLoRA), evaluation and eval-set design, quantization decisions, inference deployment, and regression triage, grounded in practical engineering patterns for production ML systems. Do not use for statistical modeling and experimental design (that's the data scientist) or for operating a specific inference engine (that's a tool skill such as llama-cpp or vllm).
- [mobile-development](mobile-development/SKILL.md): Build, test, sign, and ship mobile apps across iOS, Android, Flutter, and React Native — project scaffolding, builds and code signing, device and emulator testing, store submission (App Store and Play Store), app lifecycle and backgrounding, offline and sync, and mobile-specific testing. Use when the task involves creating, building, testing, or shipping a mobile app for iOS or Android, or reasoning about mobile behavior such as background execution, push notifications, offline storage, and data sync. Do not use for web frontend work (that is frontend-engineering), backend services and APIs (that is backend-engineering), or desktop and web platform targets outside the iOS and Android scope.
- [multi-tenant-saas-architecture](multi-tenant-saas-architecture/SKILL.md): Design and review end-to-end multi-tenant SaaS architectures: tenant and subscription semantics, control and application planes, pooled or isolated tenancy, onboarding, entitlements, metering, billing handoffs, lifecycle, partitioning, and tenant-aware operations. Use when a subscription product needs a coherent tenant model and architecture decision across these seams. Do not use for threat modeling or isolation controls, API contract semantics, data-platform design, backend implementation, migration execution, privacy compliance artifacts, capacity evidence, financial modeling, or infrastructure operations; route those to the named specialist owners.
- [neckbeard](neckbeard/SKILL.md): Use when asked to fix, build, refactor, review, verify, or release software and the work is non-trivial — including delivering a change request through planning, gates, implementation, review, verified PR, and authorized release; continuing work started elsewhere with no packet via evidence-based position assessment; or operating tracked work items in Linear, Jira, or Notion via their tooling skills. neckbeard routes the change through framing, discovery, design, implementation, review, verification, and learning — choosing the smallest *safe* intervention, proving it at the real delivery boundary, leaving an inspectable evidence ledger. For change-request / issue-to-PR work, conditionally loads a 9-phase journey with gates, delivery packet, and lifecycle integration. Composes specialist catalog skills rather than replacing them. Not a persona, not a '10x developer' prompt, not a LOC-minimizer. The journey is not loaded for plain fixes, refactors, or reviews that lack an issue/ticket trajectory.
- [neckbeard](neckbeard/SKILL.md): Use when asked to fix, build, refactor, review, verify, or release software and the work is non-trivial — including delivering a change request through planning, gates, implementation, review, verified PR, and authorized release; continuing work started elsewhere with no packet via evidence-based position assessment; or operating tracked work items in Linear, Jira, or Notion via their tooling skills. neckbeard routes the change through framing, discovery, design, implementation, review, verification, and learning — choosing the smallest *safe* intervention, proving it at the real delivery boundary, and leaving an inspectable evidence ledger. For issue-to-PR work, conditionally loads a 9-phase journey with gates and lifecycle integration. Composes specialist catalog skills rather than replacing them. Not a persona or LOC-minimizer. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [notion](notion/SKILL.md): Operate Notion from a terminal or agent: retrieve pages, query databases, search pages and databases, and update page properties — with a bundled notion-cli script that is read-only by default and gates every create or update behind a --dry-run/--yes confirmation. Use when an agent needs to read Notion content, answer questions from a team wiki or database, or make a confirmed edit. Do not use for building Notion integrations or block-level page composition beyond property updates (that is Notion API application development), or for other knowledge bases (that is their own tooling).
- [nous-branding](nous-branding/SKILL.md): Generate images and content consistent with the Nous Research brand identity. Use when creating visuals in the Nous / Theia / Hermes ecosystem: a "cyber-classical" style blending neo-classical statuary, cyberpunk/industrial grunge, and retro anime illustration. Covers official brand color palette, typography (Inter/IBM Plex Sans, JetBrains Mono, heavy distressed display faces), the Nous Girl mascot, texture system, and image prompt construction. Ships reference images for palette, mascot, and brand collage that can be used as img2img inputs.
- [open-knowledge-format](open-knowledge-format/SKILL.md): Google's Open Knowledge Format (OKF) v0.1 — an open, vendor-neutral spec for representing knowledge as markdown files with YAML frontmatter, designed for AI agent consumption. Use when the user mentions OKF, Open Knowledge Format, Google's knowledge format, LLM wiki bundles, agent knowledge packs, creating OKF bundles, validating OKF documents, or converting knowledge into the OKF standard.
- [nous-branding](nous-branding/SKILL.md): Generate images and content consistent with the Nous Research brand identity. Use when creating visuals in the Nous / Theia / Hermes ecosystem: a "cyber-classical" style blending neo-classical statuary, cyberpunk/industrial grunge, and retro anime illustration. Covers official brand color palette, typography (Inter/IBM Plex Sans, JetBrains Mono, heavy distressed display faces), the Nous Girl mascot, texture system, and image prompt construction. Ships reference images for palette, mascot, and brand collage that can be used as img2img inputs. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [open-knowledge-format](open-knowledge-format/SKILL.md): Define knowledge bundles with Google's Open Knowledge Format (OKF) v0.1. Use when the user mentions OKF, Open Knowledge Format, Google's knowledge format, LLM wiki bundles, agent knowledge packs, creating OKF bundles, validating OKF documents, or converting knowledge into the OKF standard. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [openlibrary](openlibrary/SKILL.md): Query the Open Library catalog from the terminal: search books and authors, look up works, editions, and ISBNs, enumerate every edition of a work, read community ratings, and resolve cover-image URLs. Fully keyless public API. Includes the OL…M/W/A key-graph reference, ISBN 302-redirect resolution, search query syntax, covers-host rules, and worked pipelines. Do not use for library-IT administration (Koha/MARC/ILS migration), commercial book-data feeds, or managing your reading account on Open Library itself.
- [opensource-contributions](opensource-contributions/SKILL.md): Make good open source contributions — check CONTRIBUTING.md first, follow project norms, be a good citizen. Covers bug reports, feature requests, and pull requests with a defensible default posture when the project hasn't documented expectations.
- [opensource-contributions](opensource-contributions/SKILL.md): Make good open source contributions — check CONTRIBUTING.md first, follow project norms, be a good citizen. Covers bug reports, feature requests, and pull requests with a defensible default posture when the project hasn't documented expectations. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [operational-design](operational-design/SKILL.md): Design and improve operational processes and organizational scaling — process design, operational metrics, compliance and audit, vendor management, and team topology. Covers value stream mapping, BPMN, bottleneck analysis, scaling from 10 to 100 to 1000 people, KPI design, balanced scorecard, SOC 2, ISO 27001, GDPR readiness, RFP processes, SLA design, vendor scorecards, team topologies, Conway's Law, and Dunbar's Number. Do not use for engineering delivery, financial modeling, or technology evaluation.
- [org-design](org-design/SKILL.md): CHRO methodology — organizational design (team topologies, span of control, reporting structures), talent strategy (make-vs-buy, skill taxonomies, succession planning), compensation frameworks (market benchmarking, equity design, leveling), culture architecture (values codification, rituals, psychological safety), organizational health metrics (eNPS, retention risk, engagement surveys), DEI strategy (inclusive design, equitable systems, belonging).
- [org-design](org-design/SKILL.md): Design organizations with a CHRO methodology. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [pace-plan](pace-plan/SKILL.md): Build, coordinate, operate, troubleshoot, exercise, and improve an authorized Primary, Alternate, Contingency, and Emergency communications plan. Use for resilient emergency-communications paths and their ownership, triggers, check-ins, tests, and corrective actions. Do not use for generic incident status messaging, frequency or channel planning, radio programming, or unauthorized transmission and activation.
- [peertube](peertube/SKILL.md): Browse PeerTube federated video from the terminal — instance stats, latest videos, video detail, comment threads, channels, accounts, instance-local search, and OAuth2 login with per-instance token persistence. Set PEERTUBE_SERVER to any instance; point it at sepiasearch.org for fediverse-wide search. Use when the user mentions PeerTube, federated video, SepiaSearch, or browsing a specific PeerTube instance. Do not use this skill for YouTube/Vimeo uploads, video editing, or installing and administering a PeerTube server.
- [platform-engineering](platform-engineering/SKILL.md): Use this skill when building or operating internal developer platforms: infrastructure as code, CI/CD, container orchestration, service networking, secrets, and observability. Do not use it to define release process, promotion, rollout, or rollback policy; use release-engineering for that delivery model.
- [playwright](playwright/SKILL.md): Operate Playwright for browser automation end to end: author and debug E2E test suites (robust locators, network interception and mocking, parallel workers, accessibility snapshot checks), wire them into CI, and drive headless browsing and scraping with an extract -> validate -> save loop. Use when writing, running, fixing, or scraping with Playwright, when a Playwright CI failure or JSON report needs triage, or when the bundled pwrun script should analyze a run. Do not use for QA strategy or test framework selection (route to qa-methodology), for frontend component or architecture design (route to frontend-engineering), or for Cloudflare/DDoS-GUARD challenge bypass (use flaresolverr).
- [postgres](postgres/SKILL.md): Operate PostgreSQL instances safely: configuration review, index and query-plan analysis, vacuum and bloat management, WAL archiving and point-in-time recovery, replication and failover, extensions, major-version upgrades, and evidence-based diagnostics with the bundled read-only pgdiag script. Use when running or inspecting a PostgreSQL server, diagnosing performance or backup health, or planning an upgrade or failover. Do not use for application-level data access patterns (that's backend-engineering) or schema design (that's data-architect/data-engineering).
- [privacy-engineering](privacy-engineering/SKILL.md): Translate privacy principles and legal requirements into data-flow, lifecycle, acceptance, and verification artifacts. Map data classification, purpose, processing, access, retention, deletion, residency, and consent; define verifiable privacy acceptance criteria; and produce data-lifecycle records, retention/deletion verification plans, and privacy change reviews. Use when engineering privacy into a system, feature, or data flow — not for legal advice, jurisdiction-specific regulatory interpretation, or replacing security engineering or incident response.
- [product-adoption](product-adoption/SKILL.md): Diagnose and design product adoption for onboarding, activation, behavior change, feature discovery, rollout, and sustained use after launch. Covers consumer, B2B, internal-tool, and public-service contexts with evidence-based decision points and cohort segmentation. Does not own acquisition campaigns or marketing conversion (routes to go-to-market), product-analytics instrumentation (routes to product-analytics-and-measurement), or customer-success account management and health scoring (routes to conditional-customer-success).
- [product-adoption](product-adoption/SKILL.md): Diagnose and design product adoption for onboarding, activation, behavior change, feature discovery, rollout, and sustained use after launch. Covers consumer, B2B, internal-tool, and public-service contexts with evidence-based decision points and cohort segmentation. Does not own acquisition campaigns or marketing conversion (routes to go-to-market), product-analytics instrumentation (routes to product-analytics-and-measurement), or customer-success account management and health scoring (routes to conditional-customer-success). Do not use this skill for unrelated requests; route to the nearest named specialist.
- [product-analytics-and-measurement](product-analytics-and-measurement/SKILL.md): Define observable, governed evidence for product outcomes through metric trees, event/tracking plans, instrumentation QA, and measurement governance. Use when defining product metrics, designing tracking plans, building event taxonomies, running product funnels or cohort analysis, setting up dashboard contracts, or auditing instrumentation quality. Do NOT use for statistical inference or experiment design (route to data-scientist), data pipeline implementation (route to data-engineering), data architecture decisions (route to data-architect), observability or infrastructure monitoring (route to site-reliability-engineering), or general business intelligence and dashboard building (route to BI tooling).
- [product-design-and-ux](product-design-and-ux/SKILL.md): Define user-facing product behavior from validated evidence and approved scope. Use for information architecture, task flows, state and recovery models, interface contracts, usability-study plans, interaction-pattern tradeoffs, or engineering UX handoffs. Use after product discovery and product decisions; route WCAG/ARIA conformance work to web-accessibility and formal software specifications to spec-driven-development.
- [product-discovery](product-discovery/SKILL.md): Discover product requirements from human stakeholders — map who to talk to, ask questions that surface hidden assumptions, detect gaps in real time, resolve conflicts, and translate conversations into structured SDD specs. Phase 0 upstream of Spec-Driven Development.
- [product-design-and-ux](product-design-and-ux/SKILL.md): Define user-facing product behavior from validated evidence and approved scope. Use for information architecture, task flows, state and recovery models, interface contracts, usability-study plans, interaction-pattern tradeoffs, or engineering UX handoffs. Use after product discovery and product decisions; route WCAG/ARIA conformance work to web-accessibility and formal software specifications to spec-driven-development. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [product-discovery](product-discovery/SKILL.md): Discover product requirements from human stakeholders — map who to talk to, ask questions that surface hidden assumptions, detect gaps in real time, resolve conflicts, and translate conversations into structured SDD specs. Phase 0 upstream of Spec-Driven Development. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [product-experimentation](product-experimentation/SKILL.md): Run end-to-end product experiments from assumption to decision: translate assumptions into testable hypotheses and experiment briefs, select the right method among qualitative interviews, prototypes, concierge tests, fake doors, feature flags, and A/B tests, and produce readouts that update the roadmap and decision record. Do not use when a qualitative or prototype test is the clearly right answer without statistical measurement; do not prescribe A/B testing by default; do not treat statistical significance as the only decision criterion or hide ethical and guardrail considerations.
- [product-lifecycle](product-lifecycle/SKILL.md): Route a product through its full lifecycle — discovery, strategy, portfolio choice, roadmap, UX and requirements, experimentation, delivery handoff, adoption, success, and lifecycle review — by composing existing specialist product skills with phase-entry evidence, handoff artifacts, and escalation rules. Use when evaluating a new product idea, managing a product through its lifecycle, or connecting product phases that currently operate in isolation. Do not use for a single product task that is already owned by a specialist skill (load that skill directly); do not use for software delivery lifecycle work (route to neckbeard); do not use to duplicate product discovery, strategy, UX, experimentation, analytics, release, or delivery methods.
- [product-lifecycle-learning](product-lifecycle-learning/SKILL.md): Compare intended product outcomes against observed results to close the launch-to-learning loop: collect post-launch evidence, distinguish expected from observed from uncertain from inferred claims, update assumptions, assess feature health, and choose among continue/improve/harvest/pivot/pause/retire — including retirement lifecycles with deprecation, migration, customer treatment, and retained reusable learning. Do not use for incident postmortems or root-cause analysis (routes to incident-learning or site-reliability-engineering); do not use for analytics instrumentation or metric dashboard design (routes to product-analytics-and-measurement); do not use arbitrary thresholds as universal retirement rules — decisions require human judgment and context.
- [product-methodology](product-methodology/SKILL.md): Translate validated product evidence into prioritized backlogs, decisions, specifications, and stakeholder communications. Covers RICE, MoSCoW, opportunity solution trees, decision logs, spec drafting, and audience-specific stakeholder communication. Use when the problem is validated and scope is being chosen.
- [product-methodology](product-methodology/SKILL.md): Translate validated product evidence into tactical backlog decisions, prioritization, specifications, and stakeholder communications. Do not use this skill for CPO-level vision, positioning, or market strategy; use `product-strategy` for strategic direction.
- [product-operations-and-governance](product-operations-and-governance/SKILL.md): Define and run product governance — recurring decision rights, intake, portfolio cadences, evidence standards, and cross-functional operating contracts. Covers six review cadences (intake, portfolio, roadmap, experiment, launch, lifecycle) with named accountable owners, minimum evidence standards per decision type, and escalation paths. Supports lightweight and high-assurance operating modes with configurable governance patterns. Use when designing a product governance model, resolving contested decisions, establishing evidence standards, recording exceptions and escalations, or building cross-functional operating contracts. Do NOT use for executive governance (capital allocation, org structure — route to chief-of-staff-methodology or strategy-frameworks), for technical delivery gates (CI/CD, release approval — route to release-engineering or spec-driven-development), or to impose a universal org chart.
- [product-roadmapping-and-portfolio](product-roadmapping-and-portfolio/SKILL.md): Build and maintain outcome-based product roadmaps and portfolio views that sequence strategic bets by evidence, not dates. Covers Now/Next/Later views, strategic-bet management, capacity allocation, dependency and confidence mapping, scenario planning, continue/pause/kill/revisit criteria, stakeholder narratives, and roadmap review cadences. Use when building or reviewing a product roadmap, managing a portfolio of bets, or communicating strategic sequencing to stakeholders. Do NOT use for tactical prioritization mechanics (RICE, MoSCoW, Kano, OST — route to product-methodology or product-strategy), for project scheduling or Gantt charts, or for delivery-flow management (route to kanban-guru).
- [product-shaping](product-shaping/SKILL.md): Use this skill to shape product or engineering work before committing time to it: set appetites instead of estimates, narrow raw ideas into bounded problems, sketch solutions at the right level of abstraction, de-risk rabbit holes, write pitches, bet with capped downside (circuit breaker), and govern builds with discovered scopes and scope hammering. Adapted from Basecamp's Shape Up and extended for human+AI-agent teams. Use when a raw idea, feature request, or "redesign X" grab-bag needs to become a bounded project before anyone builds; when planning how much work an idea is worth; or when delegated agent builds need budgets, kill criteria, and non-convergence rules. Do not use for discovering whether a problem is real (use product-discovery), for portfolio-level sequencing across quarters (product-roadmapping-and-portfolio), for formal specification after the bet is placed (spec-driven-development), or for task-level prioritization frameworks like RICE (product-methodology).
- [product-strategy](product-strategy/SKILL.md): CPO methodology — product vision and strategy (North Star, product principles), competitive analysis and positioning, roadmap prioritization (RICE, Kano, OST), product-market fit frameworks (Sean Ellis test, retention curves), market sizing (TAM/SAM/SOM), platform strategy, product lifecycle management.
- [production-excellence](production-excellence/SKILL.md): Route cross-domain production evidence (readiness, migration, recovery, capacity/cost, incident-learning) into a launch or operational decision — go, no-go, defer, exception, or escalation — with an accountable owner and a post-launch learning path. Compose production specialists without copying their runbooks. Do not use for incident command, release-pipeline mechanics, platform architecture, threat modeling, data-pipeline design, or any task owned end-to-end by a single specialist skill; do not use as a generic checklist detached from service ownership, risk, evidence, and verification.
- [production-readiness](production-readiness/SKILL.md): Define the minimum production evidence packet by risk class and produce go/no-go/defer/exception launch decisions with accountable owners. Cover ownership, user/business outcome, dependencies, SLOs, observability, support, security, data, rollback, capacity, and cost — every category with a named source or explicit missing-evidence outcome. Route detailed checks to existing specialist skills. Do not use for release pipeline mechanics (release-engineering) or incident response and SLO operations (site-reliability-engineering).
- [product-strategy](product-strategy/SKILL.md): Set product vision and strategy with a CPO methodology. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [production-excellence](production-excellence/SKILL.md): Build cross-domain production evidence from readiness, migration, recovery, capacity/cost, and incident learning into launch or operational decisions. Do not use this skill for a single specialist's risk packet and launch gate; use `production-readiness` for that readiness review.
- [production-readiness](production-readiness/SKILL.md): Define risk-scaled evidence packets and go/no-go/defer/exception launch gates with accountable owners. Do not use this skill for cross-domain production composition; use `production-excellence` for assembling migration, recovery, capacity, and incident evidence.
- [programming-principles](programming-principles/SKILL.md): Apply distilled coding principles from 14 classic software books to code review, refactoring, design, and implementation decisions. Do not use for language- or framework-specific tutorials, tool manuals, or tasks already governed by a project's established conventions.
- [promise-theory](promise-theory/SKILL.md): Design and diagnose coordination in hybrid human + AI agent workforces using promise theory (Burgess/Bergstra): model agents as autonomous, coordination as voluntary offers plus acceptance, and trust as calibrated assessment. Use for delegation modeling, capability manifests and agent contracts, coordination-failure diagnosis, trust/verification calibration, convergent self-healing systems, and converting obligation-based designs to promise-based. Do not use for enforceable centralized control, legal contract drafting (promise theory is not contract law), simple single-agent prompting, imperative push-based orchestration, or tool manuals — route those to the tool's own skill.
- [pydanticai](pydanticai/SKILL.md): Build type-safe AI agents and graph-based workflows with PydanticAI and PydanticGraph. Agent creation, function tools, capabilities, dependency injection, structured output, streaming, multi-agent patterns, testing, evals, and graph state machines. Use whenever you are building agents, tool-using LLM workflows, or graph-based state machines in Python.
- [promise-theory](promise-theory/SKILL.md): Teach promise vocabulary, fundamentals, and coordination diagnosis for promise-based systems. Do not use this skill for Semantic Spacetime models or SST CLI tooling; use `semantic-spacetime` for those model and tool workflows.
- [pydanticai](pydanticai/SKILL.md): Build type-safe AI agents and graph-based workflows with PydanticAI and PydanticGraph. Agent creation, function tools, capabilities, dependency injection, structured output, streaming, multi-agent patterns, testing, evals, and graph state machines. Use whenever you are building agents, tool-using LLM workflows, or graph-based state machines in Python. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [qa-methodology](qa-methodology/SKILL.md): Design and apply QA methodology for software teams: test strategy, regression testing, CI failure triage, test automation, quality gates and metrics, risk-based testing, exploratory testing, test design techniques, AI code quality gates (independent verification, acceptance-criteria testability review for agentic Spec-Driven Development), mutation-guided test hardening and review evidence (surviving mutants, weak assertions, diff-aware mutation testing), agentic eval design (dataset test design, judge-as-system-under-test, flaky-eval discipline), QA career levels (Senior/Staff/Principal), and SDET engineering (test infrastructure, gTAA, CI/CD integration). Do not use for root-cause debugging of production incidents, security implementation or threat modeling, or evaluation framework governance and statistical analysis — route those to systematic-debugging, secure-software-engineering, and agent-evals-and-observability respectively.
- [raleigh](raleigh/SKILL.md): Query, search, and download public datasets and civic information for the City of Raleigh. Use for live ArcGIS Hub catalog discovery, ArcGIS FeatureServer and MapServer queries, ImageServer imagery exports, official Raleigh geocoding, GoRaleigh transit feeds, guest-public development records, public RaleighNC.gov content, eSCRIBE public meetings, Raleigh fire reports and inspections, and the Raleigh-Wake ECC active incident feed. Do not use for private data, authenticated operations, payments, submissions, bulk crawling, or non-public portals.
- [release-engineering](release-engineering/SKILL.md): Design, automate, and operate end-to-end software releases: release process models and pipelines (trunk-based development, CD stages, release trains), progressive delivery and feature flags, versioning and artifact management (SemVer, conventional commits, changelogs, SBOM/provenance), readiness and quality gates, rollback and recovery planning, change-management and audit compliance (SOC 2, SOX, PCI), DORA metrics, and multi-team release coordination. Do not use for application feature implementation (backend-engineering/frontend-engineering), production incident root-cause debugging or on-call/SLO operations (systematic-debugging / site-reliability-engineering), security implementation or threat modeling (secure-software-engineering), or internal developer platform construction (platform-engineering).
- [remote-systems-administration](remote-systems-administration/SKILL.md): Administer and troubleshoot remote Linux, FreeBSD, NetBSD, OpenBSD, and macOS systems safely, one host or a fleet at a time. Use when a task requires SSH, Ansible, Paramiko, POSIX diagnostics, service management, software updates, system configuration, firewall changes, or evidence-led remote operations. Do not use for local-only desktop administration, container or cluster orchestration (route to kubernetes), or cloud consoles that expose no remote shell.
- [research-and-vault](research-and-vault/SKILL.md): Chain web research, atomic extraction, and durable knowledge capture into a repeatable workflow when the same research-to-notes sequence is needed.
- [research-methodology](research-methodology/SKILL.md): Plan, conduct, evaluate, and synthesize rigorous research. Use for journalistic, industry, or technical investigations that need credible evidence and a traceable method.
- [research-and-vault](research-and-vault/SKILL.md): Chain web research, atomic extraction, and durable note capture when the same research-to-notes sequence must repeat. Do not use this skill to design or evaluate an investigation; use `research-methodology` for research questions, methods, and evidence assessment.
- [research-methodology](research-methodology/SKILL.md): Plan, conduct, evaluate, and synthesize rigorous research investigations with credible evidence and a traceable method. Do not use this skill for repeated source extraction and durable note orchestration; use `research-and-vault` for that capture workflow.
- [resilience-and-recovery](resilience-and-recovery/SKILL.md): Design, exercise, and evidence graceful degradation, disaster recovery, and restoration behavior across systems and dependencies. Covers failure-mode analysis, RTO/RPO decision records, restore testing, game days, failover drills, data integrity verification, and recovery communication. Do not use for live incident command or incident response; route to site-reliability-engineering for those. Do not use for infrastructure implementation details; route to platform-engineering.
- [restic](restic/SKILL.md): Install, configure, operate, secure, automate, tune, troubleshoot, and recover restic backups across local, SFTP, S3-compatible, cloud, and REST backends. Use when creating or managing a restic repository, designing backup or retention policy, validating restores, handling repository health or locks, moving repositories, or building safe scheduled backup jobs. Do not use for a generic file-copy task that does not need encrypted, deduplicated snapshots.
- [secure-software-engineering](secure-software-engineering/SKILL.md): Use when designing or implementing software securely: define security requirements, threat-model a feature, choose secure defaults, design authentication and authorization, handle untrusted data and secrets, evaluate dependencies, design multi-tenant trust boundaries, or review security-sensitive changes. Use for prevention during requirements, design, implementation, and review; not for post-build security assessments or scanning an existing codebase.
- [security-audit-methodology](security-audit-methodology/SKILL.md): Plan authorized security reviews with threat modeling, architecture and dependency audits, and vulnerability classification. Use for scoped defensive security assessment. Do not use for offensive operations, unauthorized testing, or security control implementation.
- [semantic-spacetime](semantic-spacetime/SKILL.md): Model and diagnose shared semantic ground between agents with Semantic Spacetime (Mark Burgess, 2014-2025): a discrete graph model of meaning over time, where local proper time replaces global clocks, causality is cooperative promises, and gamma(3,4) graphs expose semantic drift, world model divergence, and absorbing states. Use for designing convergent self-healing coordination, modeling intent and trajectories over time, mapping promises onto spacetime, diagnosing semantic drift or dead-ends, and analyzing temporal blindness in agents. Do not use for physics or relativity, pure vector embeddings or RAG without temporal-causal structure, enforceable centralized control, simple single-agent prompting, or tool manuals — route those to the appropriate skill.
- [semantic-spacetime](semantic-spacetime/SKILL.md): Model and analyze Semantic Spacetime (SST) graphs, distances, trajectories, drift, and model files. Do not use this skill for promise-theory vocabulary and fundamentals without SST modeling; use `promise-theory` for the substrate concepts.
- [seo](seo/SKILL.md): Audit and improve website discoverability across traditional search, answer engines, and generative search. Use for technical SEO, on-page content, structured data, question and entity architecture, AI citations, crawler controls, agent-readable content, and reproducible visibility measurement. Do not use for only copy-editing, writing, CMS operations, or generic AI marketing claims without a defined search surface and verification plan.
- [site-reliability-engineering](site-reliability-engineering/SKILL.md): Design, operate, and improve reliable production systems with SLOs, incident command, observability, error budgets, and operational practices.
- [site-reliability-engineering](site-reliability-engineering/SKILL.md): Design, operate, and improve reliable production systems with SLOs, incident command, observability, error budgets, and operational practices. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [slack](slack/SKILL.md): Operate Slack workspaces from a terminal or agent: list channels, read messages, follow threads, search message history, list files, and verify inbound webhook signatures — with a bundled slack-cli script that is read-only by default and gates every send behind a --dry-run/--yes confirmation. Use when an agent needs to read or post Slack data, triage incidents, or answer questions about what was said in a workspace. Do not use for building Slack apps or bots (that is application development) or workspace administration like user provisioning and org settings (that is the Slack admin console).
- [software-architecture](software-architecture/SKILL.md): Design and review software architectures from business drivers through system boundaries, tradeoffs, runtime behavior, evolution, and architecture practice. Use when choosing a greenfield or target architecture, comparing modular-monolith and service shapes, designing distributed consistency, replication, partitioning, coordination, ordering, transaction isolation, or failure behavior, defining architecture fitness evidence, or facilitating a consequential architecture review. Do not use for reverse engineering, API contract semantics, data-platform design, implementation, infrastructure operations, security lifecycle, or migration execution; route those to the named specialist skills.
- [software-architecture-analysis](software-architecture-analysis/SKILL.md): Use this skill to reverse-engineer an existing software system, map its architecture, data flow, privacy posture, coupling, quality characteristics, and feature surface, then produce an evidence-grounded clean-room design document, PRD, or migration plan under new constraints. Use for codebase archaeology, implicit contract extraction, architecture health assessment, or decomposition-readiness analysis. Do not use for greenfield architecture design, direct code review, bug hunting, security auditing, or implementation of API, data, platform, or migration changes; route those to the relevant neighboring skill.
- [spec-driven-development](spec-driven-development/SKILL.md): Design and run a Spec-Driven Development (SDD) pipeline for AI software factories — where structured specifications are the input, AI agents generate the code, and quality gates enforce correctness at each phase: SPECIFY → DECOMPOSE → IMPLEMENT → VERIFY → DELIVER. Use when building or refining a spec-driven pipeline any AI coding tool (Claude Code, Cursor, Hermes Agent, Devin, OpenHands, droid) can follow, or when you need spec quality gates, phase-gate verdicts, NFR encoding, or format translation. Do not use for a single small change with a clear goal (classify first via bmad), for the control-plane protocol of intent contracts, autonomy gating, and failure routing around a pipeline (bmad), or for unvalidated problems (product-discovery).
- [strategy-frameworks](strategy-frameworks/SKILL.md): Structure organizational strategy work: strategic direction, competitive and industry analysis, growth options, capital allocation, acquisitions, and portfolio choices. Use when framing consequential choices about where to compete, how to pursue an opportunity, or how to compare strategic options.
- [strategy-frameworks](strategy-frameworks/SKILL.md): Structure organizational strategy work: strategic direction, competitive and industry analysis, growth options, capital allocation, acquisitions, and portfolio choices. Use when framing consequential choices about where to compete, how to pursue an opportunity, or how to compare strategic options. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [stripe](stripe/SKILL.md): Read Stripe account state from a terminal or agent: balance, payment intents, and subscriptions — and perform guarded mutations like canceling a subscription — backed by a bundled stripe-cli script that is read-only first and gates every state-changing command behind a --dry-run/--yes confirmation. Use when an agent needs to answer questions about account balance, recent payments, active subscriptions, or apply a confirmed subscription cancellation. Do not use for building Stripe payments into an application (that is Stripe integration development), managing Stripe dashboard settings, or other payment processors (that is their own tooling).
- [supabase](supabase/SKILL.md): Use this skill when developing applications with Supabase, running the Supabase CLI, designing migrations and RLS policies, testing database behavior, generating client types, deploying the official self-hosted Docker stack, or administering its Postgres, Auth, Storage, Realtime, Functions, API gateway, backups, upgrades, and security. Use it for managed and self-hosted projects. Do not use for generic PostgreSQL work with no Supabase services or conventions.
- [systematic-debugging](systematic-debugging/SKILL.md): 4-phase root cause debugging protocol: understand bugs before fixing. Use for ANY technical issue — test failures, production bugs, unexpected behavior, performance problems, build failures, or integration issues. ESPECIALLY when under time pressure, when "one quick fix" seems obvious, or when previous fix attempts have failed.
- [tailscale](tailscale/SKILL.md): Deploy and manage the self-hosted Tailscale/Headscale ecosystem: a Headscale control server, tailscale clients, ACL policies, node lifecycle, subnet routing, DERP relays, and backup/migration. Use when the user mentions Tailscale, Headscale, tailnet, mesh VPN, WireGuard mesh, or self-hosted VPN infrastructure.
- [systematic-debugging](systematic-debugging/SKILL.md): Diagnose root causes with a four-phase debugging protocol. Use for ANY technical issue — test failures, production bugs, unexpected behavior, performance problems, build failures, or integration issues. ESPECIALLY when under time pressure, when "one quick fix" seems obvious, or when previous fix attempts have failed. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [tailscale](tailscale/SKILL.md): Deploy and manage the self-hosted Tailscale/Headscale ecosystem: a Headscale control server, tailscale clients, ACL policies, node lifecycle, subnet routing, DERP relays, and backup/migration. Use when the user mentions Tailscale, Headscale, tailnet, mesh VPN, WireGuard mesh, or self-hosted VPN infrastructure. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [technical-documentation](technical-documentation/SKILL.md): Create and review technical documentation, including READMEs, agent-facing instructions, API references, and CLI help. Use when documentation must help someone complete real work. Do not use for marketing copy, brand messaging, or long-form editorial content.
- [technology-radar](technology-radar/SKILL.md): Build and maintain technology radars for adoption, trial, assessment, and hold decisions, and choose proportionate architecture-governance paths for technology portfolios. Use when governing technology choices, build-versus-buy decisions, architecture standards, exceptions, or engineering portfolio risk. Do not use for enterprise capability or target-state architecture, writing ADRs, implementing systems, security engineering, or operational incident/runbook work.
- [telemetry](telemetry/SKILL.md): Operate the observability stack that deploys as one unit: Prometheus scrape configuration, recording and alerting rules, relabeling, retention, and high availability; OpenTelemetry Collector pipelines (receivers, processors, exporters, sampling, trace/span correlation); and Loki ingest, LogQL, retention, and label design — with a bundled read-only telemetry-check script for Prometheus rule sanity and scrape-target reachability. Use when running, tuning, or troubleshooting a Prometheus, OpenTelemetry Collector, or Loki deployment, or reviewing the collection/ingest/retention layer. Do not use for observability strategy, SLI/SLO design, or paging policy (that is platform-engineering) or Grafana dashboards, panels, and Grafana-side alerting (that is grafana).
- [tempest](tempest/SKILL.md): Query hyper-local weather from a WeatherFlow Tempest station over its REST API and the hub's local UDP broadcast: current conditions, forecast, historical observations, and real-time decoded datagrams (obs_st, rapid_wind, evt_precip, evt_strike, hub_status). Use when the user asks about weather, temperature, rain, wind, humidity, or forecast data from their own Tempest/WeatherFlow station, or wants to parse the hub's UDP port 50222 broadcast. Do not use this skill for generic or city forecasts without a Tempest station (public weather services serve those), for Shakespeare's play The Tempest or other literature questions, or for weather hardware from other vendors - the REST endpoints require a personal-use token and the UDP broadcast only exists on a Tempest hub's LAN.
- [terraform](terraform/SKILL.md): Operate Terraform and OpenTofu across the whole infrastructure lifecycle: module structure, state backends and locking, plan/apply workflow, drift detection, remote state, upgrade and refactor flows, and evidence-based diagnostics. Use when running or inspecting terraform plans, applies, state files, imports, or state surgery, or when the bundled tfops script should handle the task. Do not use for IaC methodology or cloud design decisions - those route up to platform-engineering.
- [three](three/SKILL.md): Build browser-based Three.js and WebGL scenes, animations, and interactive 3D visualizations with a small vanilla JavaScript starting point.
- [tmdb](tmdb/SKILL.md): Query TMDb metadata for films and television, then enrich results with details, credits, providers, and external IDs. Do not use this skill for torrent search, streaming playback, or personal watch-history tracking.
- [traefik](traefik/SKILL.md): Deploy, configure, and troubleshoot Traefik v3 reverse proxy — covers all providers, routing, TLS/ACME, middlewares, and production patterns with YAML examples. Load when setting up or debugging a Traefik instance.
- [trakt](trakt/SKILL.md): Discover and compare Trakt.tv trending, popular, and anticipated movies and shows from the terminal. Do not use this skill for TMDb catalog metadata, credits, images, or provider lookups; use the tmdb skill for those tasks.
- [three](three/SKILL.md): Build browser-based Three.js and WebGL scenes, animations, and interactive 3D visualizations with a small vanilla JavaScript starting point. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [tmdb](tmdb/SKILL.md): Query TMDb metadata for films and television, then enrich results with details, credits, providers, and external IDs. Do not use this skill for personal watch history, watchlists, or tracking; use `trakt` for user activity and watch-state workflows.
- [traefik](traefik/SKILL.md): Deploy, configure, and troubleshoot Traefik v3 reverse proxy — covers all providers, routing, TLS/ACME, middlewares, and production patterns with YAML examples. Load when setting up or debugging a Traefik instance. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [trakt](trakt/SKILL.md): Discover and compare Trakt.tv trending, popular, and anticipated movies and shows, and manage user-scoped history and watchlists from the terminal. Do not use this skill for general TMDb catalog metadata, credits, images, or provider lookups; use `tmdb` for those tasks.
- [transistor](transistor/SKILL.md): Operate Transistor.fm podcast hosting from the terminal: verify API access, browse shows and episodes with JSON:API-aware output, run the episode publish lifecycle (create draft, attach audio, publish or schedule via the dedicated publish endpoint), pull download analytics, and manage private podcast subscribers and webhooks. Use when the user mentions Transistor, Transistor.fm, podcast hosting, episode publishing, private podcast subscribers, or podcast download analytics. Do not use this skill for other podcast hosts (Buzzsprout, Libsyn, Megaphone, Spotify for Creators), for editing or producing audio, or for feed/RSS parsing — the bundled CLI manages a Transistor account through its v1 API and cannot create new shows (dashboard-only).
- [travel-guide](travel-guide/SKILL.md): Create personalized, source-grounded travel dossiers from a destination, dates, duration, travelers, and constraints. Ask only the questions that change the plan, use explicitly permitted personal context without exposing it, research current logistics, and produce a cited, visually coherent PDF or responsive companion web page. Use when someone wants an individualized itinerary, trip brief, travel field guide, or shareable travel website. Do not use for real-time booking, ticket purchasing, visa or legal advice, or generic destination summaries without a specific traveler and trip.
- [vercel-eve](vercel-eve/SKILL.md): Build, develop, deploy, self-host, secure, and troubleshoot durable backend AI agents with Vercel Eve. Use when creating an Eve agent, adding tools, skills, subagents, channels, schedules, sandboxing, durable sessions, observability, or deploying Eve on Vercel or a Node host. Do not use for the separate Vercel AI SDK Agent APIs such as ToolLoopAgent or WorkflowAgent; use an AI SDK-specific skill for those.
- [verification-methodology](verification-methodology/SKILL.md): Verify work against explicit criteria using direct, source-faithful evidence, reproducible checks, and clear verdicts. Use before declaring an artifact, implementation, or claim complete; do not use for exploratory research without pass/fail criteria.
- [verified-delivery](verified-delivery/SKILL.md): Implement and deliver an authorized change end to end — verify, open the PR, merge, and confirm post-merge state — using live-state gates, durable interruption handoffs, and live-state-first resumption. Use when a user grants end-to-end delivery authority for a specific change and the work may cross tool-call limits, context exhaustion, worker loss, or session interruptions before the delivery boundary is reached. Do not use for plain fixes with no delivery directive, for granting merge or post-merge authority the user did not grant, or for designing release pipelines (use release-engineering for that).
- [vllm](vllm/SKILL.md): Operate, configure, benchmark, and troubleshoot vLLM inference servers: Docker and Kubernetes deployment, quantization-aware model configuration (tensor parallelism, KV cache), OpenAI-compatible API serving, throughput and latency benchmarking, continuous batching tuning, GPU operation, and upgrade/rollback. Use when deploying or running a vLLM server (vllm serve, vllm/vllm-openai), sizing a model and its KV cache for GPUs, selecting quantization and parallelism, serving via /v1 endpoints, measuring serving throughput or latency, tuning batching, or diagnosing GPU, OOM, or startup failures in a vLLM deployment. Do not use for model training, fine-tuning, evaluation-set design, or engine-selection methodology (that is ml-engineering), or for operating the llama.cpp stack with GGUF models (that is llama-cpp); other inference engines (TGI, Ollama, Triton) are out of scope.
- [web-accessibility](web-accessibility/SKILL.md): Design, build, and review accessible web interfaces with native semantics, keyboard and focus behavior, forms and recovery, responsive input, motion, assistive-technology testing, and WCAG 2.2-informed evidence. Use for a11y, WCAG, ARIA, screen-reader, keyboard, focus, dialog, form, widget, or accessibility review work across frameworks.
- [woodpecker-ci](woodpecker-ci/SKILL.md): Operate Woodpecker CI from installation through production troubleshooting: configure servers and agents, connect Forgejo/Gitea or another forge, write and validate pipelines, manage secrets and plugins, use Docker or Kubernetes backends, run the CLI, and diagnose failed builds. Use when setting up, administering, or debugging Woodpecker CI.
- [workflow-architect](workflow-architect/SKILL.md): Discover your actual workflow through conversation or observation, then generate a tailored skills bundle that encodes it as loadable agent skills with trigger conditions. Use when you want to understand your own process, formalize it, or share it with collaborators. Also use when a session feels aimless — this skill gives it structure.
- [web-accessibility](web-accessibility/SKILL.md): Design, build, and review accessible web interfaces with native semantics, keyboard and focus behavior, forms and recovery, responsive input, motion, assistive-technology testing, and WCAG 2.2-informed evidence. Use for a11y, WCAG, ARIA, screen-reader, keyboard, focus, dialog, form, widget, or accessibility review work across frameworks. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [woodpecker-ci](woodpecker-ci/SKILL.md): Operate Woodpecker CI from installation through production troubleshooting: configure servers and agents, connect Forgejo/Gitea or another forge, write and validate pipelines, manage secrets and plugins, use Docker or Kubernetes backends, run the CLI, and diagnose failed builds. Use when setting up, administering, or debugging Woodpecker CI. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [workflow-architect](workflow-architect/SKILL.md): Discover your actual workflow through conversation or observation, then generate a tailored skills bundle that encodes it as loadable agent skills with trigger conditions. Use when you want to understand your own process, formalize it, or share it with collaborators. Also use when a session feels aimless — this skill gives it structure. Do not use this skill for unrelated requests; route to the nearest named specialist.
- [writers-helper](writers-helper/SKILL.md): Guide any writer, fiction or nonfiction, through the whole writing lifecycle: premise and planning, outlining and worldbuilding, research, drafting and finishing, editing and revision, breaking creative blocks, generating position-aware prompts and exercises, building sustainable writing habits, and the business of publishing — book proposals, query letters, synopses, agents, publishers, and book deals. Do not use for formatting deliverables into document files (see word-document, pdf-document, epub), for technical or business documentation (see technical-documentation), or for pure grammar and spelling reference.
- [yc-default-alive-calculator](yc-default-alive-calculator/SKILL.md): Evaluate whether a startup is on a trajectory to profitability before running out of cash — Paul Graham's "Default Alive / Default Dead" framework. Takes revenue, burn rate, cash on hand, and growth rate; computes runway, burn multiple, and months to breakeven. Ships a deterministic CLI calculator. Load when founders ask about runway, burn rate, default alive, whether they need to raise money, or financial sustainability analysis.
- [yc-weekly-growth-compass](yc-weekly-growth-compass/SKILL.md): Use Paul Graham's "Startup = Growth" framework as an operational decision tool. Computes weekly growth rates, benchmarks against YC tiers (1% concerning, 5-7% good, 10%+ exceptional), projects compound growth over time, and frames every startup decision through the question "does this serve your target growth rate?" Ships a deterministic CLI calculator. Load when founders ask about growth rate, weekly growth, startup traction, metrics, or whether they're moving fast enough; do not use for general financial modeling or engineering work unrelated to growth metrics.
- [yc-default-alive-calculator](yc-default-alive-calculator/SKILL.md): Evaluate startup runway, burn, revenue, and profitability trajectory using the Default Alive / Default Dead framework. Do not use this skill for weekly growth experiments or operating growth decisions; use `yc-weekly-growth-compass` for those decisions.
- [yc-weekly-growth-compass](yc-weekly-growth-compass/SKILL.md): Make weekly startup growth decisions using growth rate, user behavior, and experiment evidence. Do not use this skill for runway, burn, or profitability trajectory analysis; use `yc-default-alive-calculator` for financial sustainability.
meshcore-packet-capture/SKILL.md
+3 -1
View File
@@ -1,6 +1,8 @@
---
name: meshcore-packet-capture
description: Capture MeshCore Companion packets via BLE, serial, or TCP.
description: >-
Capture MeshCore Companion packets via BLE, serial, or TCP. Do not use this skill for
unrelated requests; route to the nearest named specialist.
license: MIT
compatibility: Requires Python 3.11+, a MeshCore Companion radio, and the project's runtime dependencies.
---
neckbeard/SKILL.md
+11 -11
View File
@@ -1,17 +1,17 @@
---
name: neckbeard
description: >-
Use when asked to fix, build, refactor, review, verify, or release software and the work is
non-trivial — including delivering a change request through planning, gates, implementation,
review, verified PR, and authorized release; continuing work started elsewhere with no packet
via evidence-based position assessment; or operating tracked work items in Linear, Jira, or
Notion via their tooling skills. neckbeard routes the change through framing, discovery,
design, implementation, review, verification, and learning — choosing the smallest *safe*
intervention, proving it at the real delivery boundary, leaving an inspectable evidence ledger.
For change-request / issue-to-PR work, conditionally loads a 9-phase journey with gates,
delivery packet, and lifecycle integration. Composes specialist catalog skills rather than
replacing them. Not a persona, not a '10x developer' prompt, not a LOC-minimizer. The journey
is not loaded for plain fixes, refactors, or reviews that lack an issue/ticket trajectory.
Use when asked to fix, build, refactor, review, verify, or release software and the work
is non-trivial — including delivering a change request through planning, gates,
implementation, review, verified PR, and authorized release; continuing work started
elsewhere with no packet via evidence-based position assessment; or operating tracked
work items in Linear, Jira, or Notion via their tooling skills. neckbeard routes the
change through framing, discovery, design, implementation, review, verification, and
learning — choosing the smallest *safe* intervention, proving it at the real delivery
boundary, and leaving an inspectable evidence ledger. For issue-to-PR work, conditionally
loads a 9-phase journey with gates and lifecycle integration. Composes specialist catalog
skills rather than replacing them. Not a persona or LOC-minimizer. Do not use this skill
for unrelated requests; route to the nearest named specialist.
license: MIT
compatibility: Agent harness with file read/write, terminal, and skill loading. No network or runtime dependency required by the bundle itself.
metadata:
nous-branding/SKILL.md
+6 -4
View File
@@ -1,12 +1,14 @@
---
name: nous-branding
description: 'Generate images and content consistent with the Nous Research brand
identity. Use when creating visuals in the Nous / Theia / Hermes ecosystem: a "cyber-classical"
style blending neo-classical statuary, cyberpunk/industrial grunge, and retro anime
description: >-
Generate images and content consistent with the Nous Research brand identity. Use when
creating visuals in the Nous / Theia / Hermes ecosystem: a "cyber-classical" style
blending neo-classical statuary, cyberpunk/industrial grunge, and retro anime
illustration. Covers official brand color palette, typography (Inter/IBM Plex Sans,
JetBrains Mono, heavy distressed display faces), the Nous Girl mascot, texture system,
and image prompt construction. Ships reference images for palette, mascot, and brand
collage that can be used as img2img inputs.'
collage that can be used as img2img inputs. Do not use this skill for unrelated
requests; route to the nearest named specialist.
license: MIT
compatibility: Compatible with any agent capable of image generation or brand analysis.
Reference-image workflows (img2img, style transfer, variations) require an API endpoint
open-knowledge-format/SKILL.md
+6 -5
View File
@@ -1,10 +1,11 @@
---
name: open-knowledge-format
description: Google's Open Knowledge Format (OKF) v0.1 — an open, vendor-neutral spec
for representing knowledge as markdown files with YAML frontmatter, designed for
AI agent consumption. Use when the user mentions OKF, Open Knowledge Format, Google's
knowledge format, LLM wiki bundles, agent knowledge packs, creating OKF bundles,
validating OKF documents, or converting knowledge into the OKF standard.
description: >-
Define knowledge bundles with Google's Open Knowledge Format (OKF) v0.1. Use when the
user mentions OKF, Open Knowledge Format, Google's knowledge format, LLM wiki bundles,
agent knowledge packs, creating OKF bundles, validating OKF documents, or converting
knowledge into the OKF standard. Do not use this skill for unrelated requests; route to
the nearest named specialist.
license: MIT
compatibility: Portable across any AgentSkills-compatible harness. The validation
script requires Python 3.8+ with PyYAML (pip install PyYAML). All examples use standard
opensource-contributions/SKILL.md
+5 -3
View File
@@ -1,8 +1,10 @@
---
name: opensource-contributions
description: Make good open source contributions — check CONTRIBUTING.md first, follow
project norms, be a good citizen. Covers bug reports, feature requests, and pull
requests with a defensible default posture when the project hasn't documented expectations.
description: >-
Make good open source contributions — check CONTRIBUTING.md first, follow project norms,
be a good citizen. Covers bug reports, feature requests, and pull requests with a
defensible default posture when the project hasn't documented expectations. Do not use
this skill for unrelated requests; route to the nearest named specialist.
license: MIT
compatibility: Compatible with any agent supporting the Agent Skills format (Hermes
Agent, Claude Code, GitHub Copilot, OpenCode, Cursor, etc.)
org-design/SKILL.md
+3 -6
View File
@@ -1,11 +1,8 @@
---
name: org-design
description: CHRO methodology — organizational design (team topologies, span of control,
reporting structures), talent strategy (make-vs-buy, skill taxonomies, succession
planning), compensation frameworks (market benchmarking, equity design, leveling),
culture architecture (values codification, rituals, psychological safety), organizational
health metrics (eNPS, retention risk, engagement surveys), DEI strategy (inclusive
design, equitable systems, belonging).
description: >-
Design organizations with a CHRO methodology. Do not use this skill for unrelated
requests; route to the nearest named specialist.
license: MIT
metadata:
tags: org-design, chro, hr, talent-strategy, compensation, culture, organizational-health,
product-adoption/SKILL.md
+8 -8
View File
@@ -1,14 +1,14 @@
---
name: product-adoption
description: >-
Diagnose and design product adoption for onboarding, activation, behavior
change, feature discovery, rollout, and sustained use after launch. Covers
consumer, B2B, internal-tool, and public-service contexts with evidence-based
decision points and cohort segmentation. Does not own acquisition campaigns
or marketing conversion (routes to go-to-market), product-analytics
instrumentation (routes to product-analytics-and-measurement), or
customer-success account management and health scoring (routes to
conditional-customer-success).
Diagnose and design product adoption for onboarding, activation, behavior change,
feature discovery, rollout, and sustained use after launch. Covers consumer, B2B,
internal-tool, and public-service contexts with evidence-based decision points and
cohort segmentation. Does not own acquisition campaigns or marketing conversion (routes
to go-to-market), product-analytics instrumentation (routes to
product-analytics-and-measurement), or customer-success account management and health
scoring (routes to conditional-customer-success). Do not use this skill for unrelated
requests; route to the nearest named specialist.
license: MIT
metadata:
tags: product-adoption, onboarding, activation, behavior-change, feature-discovery,
product-design-and-ux/SKILL.md
+6 -6
View File
@@ -1,12 +1,12 @@
---
name: product-design-and-ux
description: >-
Define user-facing product behavior from validated evidence and approved scope.
Use for information architecture, task flows, state and recovery models,
interface contracts, usability-study plans, interaction-pattern tradeoffs, or
engineering UX handoffs. Use after product discovery and product decisions;
route WCAG/ARIA conformance work to web-accessibility and formal software
specifications to spec-driven-development.
Define user-facing product behavior from validated evidence and approved scope. Use for
information architecture, task flows, state and recovery models, interface contracts,
usability-study plans, interaction-pattern tradeoffs, or engineering UX handoffs. Use
after product discovery and product decisions; route WCAG/ARIA conformance work to
web-accessibility and formal software specifications to spec-driven-development. Do not
use this skill for unrelated requests; route to the nearest named specialist.
license: MIT
compatibility: Works with any agent framework supporting the Agent Skills format; no design tool, frontend framework, or proprietary service required.
---
product-discovery/SKILL.md
+5 -4
View File
@@ -1,10 +1,11 @@
---
name: product-discovery
description: >-
Discover product requirements from human stakeholders — map who to talk to,
ask questions that surface hidden assumptions, detect gaps in real time,
resolve conflicts, and translate conversations into structured SDD specs.
Phase 0 upstream of Spec-Driven Development.
Discover product requirements from human stakeholders — map who to talk to, ask
questions that surface hidden assumptions, detect gaps in real time, resolve conflicts,
and translate conversations into structured SDD specs. Phase 0 upstream of Spec-Driven
Development. Do not use this skill for unrelated requests; route to the nearest named
specialist.
license: MIT
compatibility: Agent-agnostic — works with any agent supporting a spec-driven or requirements pipeline.
---
product-methodology/SKILL.md
+3 -4
View File
@@ -1,10 +1,9 @@
---
name: product-methodology
description: >-
Translate validated product evidence into prioritized backlogs, decisions,
specifications, and stakeholder communications. Covers RICE, MoSCoW, opportunity
solution trees, decision logs, spec drafting, and audience-specific stakeholder
communication. Use when the problem is validated and scope is being chosen.
Translate validated product evidence into tactical backlog decisions, prioritization,
specifications, and stakeholder communications. Do not use this skill for CPO-level
vision, positioning, or market strategy; use `product-strategy` for strategic direction.
license: MIT
metadata:
source_repo: https://github.com/magnus919/hermes-profiles
product-strategy/SKILL.md
+3 -4
View File
@@ -1,9 +1,8 @@
---
name: product-strategy
description: CPO methodology — product vision and strategy (North Star, product principles),
competitive analysis and positioning, roadmap prioritization (RICE, Kano, OST),
product-market fit frameworks (Sean Ellis test, retention curves), market sizing
(TAM/SAM/SOM), platform strategy, product lifecycle management.
description: >-
Set product vision and strategy with a CPO methodology. Do not use this skill for
unrelated requests; route to the nearest named specialist.
license: MIT
metadata:
tags: product-strategy, cpo, product-management, competitive-analysis, market-sizing,
production-excellence/SKILL.md
+4 -9
View File
@@ -1,15 +1,10 @@
---
name: production-excellence
description: >-
Route cross-domain production evidence (readiness, migration, recovery,
capacity/cost, incident-learning) into a launch or operational decision —
go, no-go, defer, exception, or escalation — with an accountable owner
and a post-launch learning path. Compose production specialists without
copying their runbooks. Do not use for incident command, release-pipeline
mechanics, platform architecture, threat modeling, data-pipeline design,
or any task owned end-to-end by a single specialist skill; do not use
as a generic checklist detached from service ownership, risk, evidence,
and verification.
Build cross-domain production evidence from readiness, migration, recovery,
capacity/cost, and incident learning into launch or operational decisions. Do not use
this skill for a single specialist's risk packet and launch gate; use
`production-readiness` for that readiness review.
license: MIT
compatibility: Platform-agnostic methodology. No runtime dependencies, API keys, or external services required.
metadata:
production-readiness/SKILL.md
+4 -8
View File
@@ -1,14 +1,10 @@
---
name: production-readiness
description: >-
Define the minimum production evidence packet by risk class and produce
go/no-go/defer/exception launch decisions with accountable owners.
Cover ownership, user/business outcome, dependencies, SLOs, observability,
support, security, data, rollback, capacity, and cost — every category with
a named source or explicit missing-evidence outcome. Route detailed checks
to existing specialist skills. Do not use for release pipeline mechanics
(release-engineering) or incident response and SLO operations
(site-reliability-engineering).
Define risk-scaled evidence packets and go/no-go/defer/exception launch gates with
accountable owners. Do not use this skill for cross-domain production composition; use
`production-excellence` for assembling migration, recovery, capacity, and incident
evidence.
license: MIT
compatibility: Platform-agnostic methodology. No runtime dependency.
metadata:
promise-theory/SKILL.md
+3 -10
View File
@@ -1,16 +1,9 @@
---
name: promise-theory
description: >-
Design and diagnose coordination in hybrid human + AI agent workforces using
promise theory (Burgess/Bergstra): model agents as autonomous, coordination
as voluntary offers plus acceptance, and trust as calibrated assessment. Use
for delegation modeling, capability manifests and agent contracts,
coordination-failure diagnosis, trust/verification calibration, convergent
self-healing systems, and converting obligation-based designs to
promise-based. Do not use for enforceable centralized control, legal contract
drafting (promise theory is not contract law), simple single-agent prompting,
imperative push-based orchestration, or tool manuals — route those to the
tool's own skill.
Teach promise vocabulary, fundamentals, and coordination diagnosis for promise-based
systems. Do not use this skill for Semantic Spacetime models or SST CLI tooling; use
`semantic-spacetime` for those model and tool workflows.
license: MIT
---
pydanticai/SKILL.md
+6 -5
View File
@@ -1,11 +1,12 @@
---
name: pydanticai
description: >-
Build type-safe AI agents and graph-based workflows with PydanticAI and
PydanticGraph. Agent creation, function tools, capabilities, dependency
injection, structured output, streaming, multi-agent patterns, testing,
evals, and graph state machines. Use whenever you are building agents,
tool-using LLM workflows, or graph-based state machines in Python.
Build type-safe AI agents and graph-based workflows with PydanticAI and PydanticGraph.
Agent creation, function tools, capabilities, dependency injection, structured output,
streaming, multi-agent patterns, testing, evals, and graph state machines. Use whenever
you are building agents, tool-using LLM workflows, or graph-based state machines in
Python. Do not use this skill for unrelated requests; route to the nearest named
specialist.
license: MIT
metadata:
source: https://pydantic.dev/docs/ai/overview/
requirements-dev.txt
+1
View File
@@ -10,3 +10,4 @@ radon>=6.0.1
deptry>=0.25.1
bandit>=1.7
loguru>=0.7.3
PyYAML>=6.0.1
research-and-vault/SKILL.md
+5 -1
View File
@@ -1,6 +1,10 @@
---
name: research-and-vault
description: Chain web research, atomic extraction, and durable knowledge capture into a repeatable workflow when the same research-to-notes sequence is needed.
description: >-
Chain web research, atomic extraction, and durable note capture when the same
research-to-notes sequence must repeat. Do not use this skill to design or evaluate an
investigation; use `research-methodology` for research questions, methods, and evidence
assessment.
---
# Research and Vault
research-methodology/SKILL.md
+4 -1
View File
@@ -1,6 +1,9 @@
---
name: research-methodology
description: Plan, conduct, evaluate, and synthesize rigorous research. Use for journalistic, industry, or technical investigations that need credible evidence and a traceable method.
description: >-
Plan, conduct, evaluate, and synthesize rigorous research investigations with credible
evidence and a traceable method. Do not use this skill for repeated source extraction
and durable note orchestration; use `research-and-vault` for that capture workflow.
license: MIT
compatibility: No runtime dependency. Use appropriate retrieval tools and retain source URLs and access dates in the research log.
metadata:
scripts/test_validate_frontmatter_audit.py
+76
View File
@@ -0,0 +1,76 @@
#!/usr/bin/env python3
import importlib.util
import tempfile
import unittest
from pathlib import Path
_spec = importlib.util.spec_from_file_location(
"validate_frontmatter_audit", Path(__file__).parent / "validate-frontmatter-audit.py"
)
if _spec is None or _spec.loader is None:
raise RuntimeError("unable to load audit module")
_module = importlib.util.module_from_spec(_spec)
_spec.loader.exec_module(_module)
audit = _module.audit
class FrontmatterAuditTests(unittest.TestCase):
def write_skill(self, root: Path, name: Path, description: str, body: str = "") -> None:
path = root / name
path.mkdir(parents=True)
(path / "SKILL.md").write_text(
f"---\nname: {name.name}\ndescription: {description}\n---\n\n{body}", encoding="utf-8"
)
def test_accepts_imperative_positive_and_boundary_metadata(self) -> None:
with tempfile.TemporaryDirectory() as directory:
root = Path(directory)
self.write_skill(
root, Path("example"), "Query PromQL metrics. Do not use this skill for LogQL."
)
report = audit(root)
self.assertTrue(report["ok"])
self.assertEqual(report["files_audited"], 1)
def test_rejects_noun_opener_and_missing_boundary(self) -> None:
with tempfile.TemporaryDirectory() as directory:
root = Path(directory)
self.write_skill(root, Path("example"), "A metrics helper for dashboards.")
report = audit(root)
self.assertFalse(report["ok"])
self.assertEqual(
{item["rule"] for item in report["violations"]},
{"imperative-opener", "negative-boundary"},
)
def test_accepts_substantive_when_not_to_use_section(self) -> None:
with tempfile.TemporaryDirectory() as directory:
root = Path(directory)
self.write_skill(
root,
Path("example"),
"Query PromQL metrics.",
"## When not to use\nUse grafana for dashboard editing.\n",
)
self.assertTrue(audit(root)["ok"])
def test_discovers_nested_bundle_skills_but_excludes_profiles(self) -> None:
with tempfile.TemporaryDirectory() as directory:
root = Path(directory)
self.write_skill(
root,
Path("bundle/skills/nested"),
"Query PromQL metrics. Do not use this skill for LogQL.",
)
self.write_skill(
root,
Path("agent-council/profiles/skills/profile"),
"Query PromQL metrics. Do not use this skill for LogQL.",
)
report = audit(root)
self.assertTrue(report["ok"])
self.assertEqual(report["files_audited"], 1)
if __name__ == "__main__":
unittest.main()
scripts/validate-frontmatter-audit.py
Executable
+176
View File
@@ -0,0 +1,176 @@
#!/usr/bin/env python3
"""Audit canonical skill descriptions for actionable routing metadata."""
# Keep the verb vocabulary readable as a single audited list.
# ruff: noqa: SIM905
from __future__ import annotations
import argparse
import json
import re
import sys
from pathlib import Path
from typing import Any
import yaml # type: ignore[import-untyped]
IMPERATIVE_VERBS = set(
(
"add administer analyze apply assess audit automate author backup browse build "
"calculate capture chain check clean compare configure connect control convert "
"create debug define deploy design diagnose discover document draft edit "
"evaluate export extract fetch find fix format generate guide identify "
"implement import ingest inspect install interact investigate load maintain "
"make manage migrate model monitor operate optimize organize parse plan play "
"prepare process publish query read refactor release remove render repair "
"research resolve restore review reverse-engineer route run scan scaffold "
"scrape search secure select send set simulate start stop structure summarize "
"sync teach test track train transform translate troubleshoot update use "
"validate verify visualize write"
).split()
)
BOUNDARY = re.compile(
r"\b(?:do not use(?: this skill)? for|not for|when not to use|unlike|distinct from)\b",
re.IGNORECASE,
)
HEADING = re.compile(r"^\s*#{1,6}\s+When not to use\s*#*\s*$", re.IGNORECASE)
BOUNDARY_WORD = re.compile(
r"\b(?:avoid|belongs?|choose|defer|do not|don't|does not|never|not|only|"
r"outside|prefer|prerequisite|required?|requires?|rather than|route|see|"
r"skip|use|when)\b",
re.IGNORECASE,
)
STOPWORDS = set(
(
"this that with from into when where which your their they them for and the "
"use skill tasks work across before after only rather than does not have has "
"will without using need needs agent"
).split()
)
def files(root: Path) -> list[Path]:
"""Return every canonical entry point, matching validate-skills.rb."""
return sorted(
path
for path in root.glob("**/SKILL.md")
if "agent-council/profiles/skills/" not in path.relative_to(root).as_posix()
)
def parse(path: Path) -> tuple[dict[str, Any] | None, str, str | None]:
"""Parse frontmatter and return the remaining markdown body."""
text = path.read_text(encoding="utf-8")
match = re.match(r"\A---\n(.*?)\n---\n", text, re.DOTALL)
if not match:
return None, text, "missing YAML frontmatter"
try:
data = yaml.safe_load(match.group(1))
except yaml.YAMLError as exc:
return None, text, f"invalid YAML: {exc}"
if not isinstance(data, dict):
return None, text, "frontmatter must be a mapping"
return data, text[match.end() :], None
def has_body_boundary(body: str) -> bool:
"""Return whether a substantive When-not-to-use section exists."""
lines = body.splitlines()
for index, line in enumerate(lines):
if not HEADING.match(line):
continue
section: list[str] = []
for candidate in lines[index + 1 :]:
if re.match(r"^\s*#{1,6}\s+", candidate):
break
visible = re.sub(r"<!--.*?-->", "", candidate).strip()
if visible and not re.fullmatch(r"[-*_]{3,}", visible):
section.append(visible)
if any(
len(re.findall(r"[A-Za-z0-9]+", line)) >= 3 and BOUNDARY_WORD.search(line)
for line in section
):
return True
return False
def audit(root: Path) -> dict[str, Any]:
"""Audit all canonical descriptions below *root*."""
violations: list[dict[str, str]] = []
skill_files = files(root)
for path in skill_files:
relative = path.relative_to(root).as_posix()
data, body, error = parse(path)
if error:
violations.append({"path": relative, "rule": "frontmatter", "message": error})
continue
if data is None:
continue
description = data.get("description")
if not isinstance(description, str) or not description.strip():
violations.append(
{"path": relative, "rule": "description", "message": "description is empty"}
)
continue
cleaned = re.sub(r"\ADeprecated:\s*", "", description.strip(), flags=re.IGNORECASE)
opener = re.match(r"[A-Za-z]+(?:-[A-Za-z]+)?", cleaned)
if not opener or opener.group().lower() not in IMPERATIVE_VERBS:
violations.append(
{
"path": relative,
"rule": "imperative-opener",
"message": f"starts with {opener.group() if opener else ''!r}",
}
)
terms = {
term.lower()
for term in re.findall(r"[A-Za-z][A-Za-z0-9-]{3,}", description)
if term.lower() not in STOPWORDS
}
if len(terms) < 2:
violations.append(
{
"path": relative,
"rule": "positive-trigger",
"message": "needs at least two concrete trigger terms",
}
)
if not BOUNDARY.search(description) and not has_body_boundary(body):
violations.append(
{
"path": relative,
"rule": "negative-boundary",
"message": "name a nearest alternative or explicit non-use boundary",
}
)
return {
"files_audited": len(skill_files),
"violations": violations,
"ok": not violations,
}
def main() -> int:
parser = argparse.ArgumentParser(description="Audit canonical skill frontmatter descriptions")
parser.add_argument("root", nargs="?", default=".")
parser.add_argument("--json", action="store_true")
args = parser.parse_args()
report = audit(Path(args.root).resolve())
if args.json:
print(json.dumps(report, indent=2, sort_keys=True))
else:
print(f"Audited {report['files_audited']} canonical descriptions")
for violation in report["violations"]:
print(f"{violation['path']}: {violation['rule']}: {violation['message']}")
result = "PASS" if report["ok"] else f"FAIL ({len(report['violations'])} violations)"
print(result)
return 0 if report["ok"] else 1
if __name__ == "__main__":
sys.exit(main())
semantic-spacetime/SKILL.md
+3 -11
View File
@@ -1,17 +1,9 @@
---
name: semantic-spacetime
description: >-
Model and diagnose shared semantic ground between agents with Semantic
Spacetime (Mark Burgess, 2014-2025): a discrete graph model of meaning over
time, where local proper time replaces global clocks, causality is
cooperative promises, and gamma(3,4) graphs expose semantic drift, world
model divergence, and absorbing states. Use for designing convergent
self-healing coordination, modeling intent and trajectories over time,
mapping promises onto spacetime, diagnosing semantic drift or dead-ends,
and analyzing temporal blindness in agents. Do not use for physics or
relativity, pure vector embeddings or RAG without temporal-causal structure,
enforceable centralized control, simple single-agent prompting, or tool
manuals — route those to the appropriate skill.
Model and analyze Semantic Spacetime (SST) graphs, distances, trajectories, drift, and
model files. Do not use this skill for promise-theory vocabulary and fundamentals
without SST modeling; use `promise-theory` for the substrate concepts.
license: MIT
---
site-reliability-engineering/SKILL.md
+4 -1
View File
@@ -1,6 +1,9 @@
---
name: site-reliability-engineering
description: Design, operate, and improve reliable production systems with SLOs, incident command, observability, error budgets, and operational practices.
description: >-
Design, operate, and improve reliable production systems with SLOs, incident command,
observability, error budgets, and operational practices. Do not use this skill for
unrelated requests; route to the nearest named specialist.
license: MIT
compatibility: Python 3.9+ is required only for the bundled calculation and summary scripts.
metadata:
strategy-frameworks/SKILL.md
+5 -4
View File
@@ -1,10 +1,11 @@
---
name: strategy-frameworks
description: >-
Structure organizational strategy work: strategic direction, competitive and
industry analysis, growth options, capital allocation, acquisitions, and
portfolio choices. Use when framing consequential choices about where to
compete, how to pursue an opportunity, or how to compare strategic options.
Structure organizational strategy work: strategic direction, competitive and industry
analysis, growth options, capital allocation, acquisitions, and portfolio choices. Use
when framing consequential choices about where to compete, how to pursue an opportunity,
or how to compare strategic options. Do not use this skill for unrelated requests; route
to the nearest named specialist.
license: MIT
metadata:
source_repo: https://github.com/magnus919/hermes-profiles
systematic-debugging/SKILL.md
+6 -5
View File
@@ -1,10 +1,11 @@
---
name: systematic-debugging
description: '4-phase root cause debugging protocol: understand bugs before fixing.
Use for ANY technical issue — test failures, production bugs, unexpected behavior,
performance problems, build failures, or integration issues. ESPECIALLY when under
time pressure, when "one quick fix" seems obvious, or when previous fix attempts
have failed.'
description: >-
Diagnose root causes with a four-phase debugging protocol. Use for ANY technical issue —
test failures, production bugs, unexpected behavior, performance problems, build
failures, or integration issues. ESPECIALLY when under time pressure, when "one quick
fix" seems obvious, or when previous fix attempts have failed. Do not use this skill for
unrelated requests; route to the nearest named specialist.
license: MIT
compatibility: Platform-agnostic. Some sections cover macOS-specific sandbox debugging.
Requires access to source code, version control (git), and testing tools appropriate
tailscale/SKILL.md
+6 -4
View File
@@ -1,9 +1,11 @@
---
name: tailscale
description: 'Deploy and manage the self-hosted Tailscale/Headscale ecosystem: a
Headscale control server, tailscale clients, ACL policies, node lifecycle, subnet
routing, DERP relays, and backup/migration. Use when the user mentions Tailscale,
Headscale, tailnet, mesh VPN, WireGuard mesh, or self-hosted VPN infrastructure.'
description: >-
Deploy and manage the self-hosted Tailscale/Headscale ecosystem: a Headscale control
server, tailscale clients, ACL policies, node lifecycle, subnet routing, DERP relays,
and backup/migration. Use when the user mentions Tailscale, Headscale, tailnet, mesh
VPN, WireGuard mesh, or self-hosted VPN infrastructure. Do not use this skill for
unrelated requests; route to the nearest named specialist.
license: MIT
compatibility: Requires bash, Python 3.8+, jq, curl, and access to a Headscale server
or the `headscale` CLI. Tailscale client (`tailscale`) must be installed on target
three/SKILL.md
+4 -1
View File
@@ -1,6 +1,9 @@
---
name: three
description: Build browser-based Three.js and WebGL scenes, animations, and interactive 3D visualizations with a small vanilla JavaScript starting point.
description: >-
Build browser-based Three.js and WebGL scenes, animations, and interactive 3D
visualizations with a small vanilla JavaScript starting point. Do not use this skill for
unrelated requests; route to the nearest named specialist.
---
# Three.js
tmdb/SKILL.md
+4 -1
View File
@@ -1,6 +1,9 @@
---
name: tmdb
description: Query TMDb metadata for films and television, then enrich results with details, credits, providers, and external IDs. Do not use this skill for torrent search, streaming playback, or personal watch-history tracking.
description: >-
Query TMDb metadata for films and television, then enrich results with details, credits,
providers, and external IDs. Do not use this skill for personal watch history,
watchlists, or tracking; use `trakt` for user activity and watch-state workflows.
license: MIT
compatibility: Requires TMDB_ACCESS_TOKEN or TMDB_API_KEY, Python 3.8+, and requests.
metadata:
traefik/SKILL.md
+5 -3
View File
@@ -1,8 +1,10 @@
---
name: traefik
description: Deploy, configure, and troubleshoot Traefik v3 reverse proxy — covers
all providers, routing, TLS/ACME, middlewares, and production patterns with YAML
examples. Load when setting up or debugging a Traefik instance.
description: >-
Deploy, configure, and troubleshoot Traefik v3 reverse proxy — covers all providers,
routing, TLS/ACME, middlewares, and production patterns with YAML examples. Load when
setting up or debugging a Traefik instance. Do not use this skill for unrelated
requests; route to the nearest named specialist.
license: MIT
compatibility: Compatible with any agent supporting the Agent Skills format (Hermes
Agent, Claude Code, GitHub Copilot, OpenCode, Cursor, etc.)
trakt/SKILL.md
+4 -3
View File
@@ -1,9 +1,10 @@
---
name: trakt
description: >-
Discover and compare Trakt.tv trending, popular, and anticipated movies and shows
from the terminal. Do not use this skill for TMDb catalog metadata, credits, images,
or provider lookups; use the tmdb skill for those tasks.
Discover and compare Trakt.tv trending, popular, and anticipated movies and shows, and
manage user-scoped history and watchlists from the terminal. Do not use this skill for
general TMDb catalog metadata, credits, images, or provider lookups; use `tmdb` for
those tasks.
license: MIT
compatibility: Requires TRAKT_CLIENT_ID, Python 3.8+, and requests. Public discovery
reads use an application Client ID; OAuth is only needed for user-scoped operations.
web-accessibility/SKILL.md
+5 -5
View File
@@ -1,11 +1,11 @@
---
name: web-accessibility
description: >-
Design, build, and review accessible web interfaces with native semantics,
keyboard and focus behavior, forms and recovery, responsive input, motion,
assistive-technology testing, and WCAG 2.2-informed evidence. Use for a11y,
WCAG, ARIA, screen-reader, keyboard, focus, dialog, form, widget, or
accessibility review work across frameworks.
Design, build, and review accessible web interfaces with native semantics, keyboard and
focus behavior, forms and recovery, responsive input, motion, assistive-technology
testing, and WCAG 2.2-informed evidence. Use for a11y, WCAG, ARIA, screen-reader,
keyboard, focus, dialog, form, widget, or accessibility review work across frameworks.
Do not use this skill for unrelated requests; route to the nearest named specialist.
license: MIT
compatibility: Works with any agent framework supporting the Agent Skills format; no runtime dependency.
metadata:
woodpecker-ci/SKILL.md
+5 -5
View File
@@ -1,11 +1,11 @@
---
name: woodpecker-ci
description: >-
Operate Woodpecker CI from installation through production troubleshooting:
configure servers and agents, connect Forgejo/Gitea or another forge, write and
validate pipelines, manage secrets and plugins, use Docker or Kubernetes
backends, run the CLI, and diagnose failed builds. Use when setting up,
administering, or debugging Woodpecker CI.
Operate Woodpecker CI from installation through production troubleshooting: configure
servers and agents, connect Forgejo/Gitea or another forge, write and validate
pipelines, manage secrets and plugins, use Docker or Kubernetes backends, run the CLI,
and diagnose failed builds. Use when setting up, administering, or debugging Woodpecker
CI. Do not use this skill for unrelated requests; route to the nearest named specialist.
license: MIT
compatibility: Requires access to a Woodpecker instance for administration; Docker Compose, Kubernetes, or woodpecker-cli are optional depending on the backend.
metadata:
workflow-architect/SKILL.md
+6 -5
View File
@@ -1,10 +1,11 @@
---
name: workflow-architect
description: Discover your actual workflow through conversation or observation, then
generate a tailored skills bundle that encodes it as loadable agent skills with
trigger conditions. Use when you want to understand your own process, formalize
it, or share it with collaborators. Also use when a session feels aimless — this
skill gives it structure.
description: >-
Discover your actual workflow through conversation or observation, then generate a
tailored skills bundle that encodes it as loadable agent skills with trigger conditions.
Use when you want to understand your own process, formalize it, or share it with
collaborators. Also use when a session feels aimless — this skill gives it structure. Do
not use this skill for unrelated requests; route to the nearest named specialist.
license: MIT
compatibility: Hermes Agent — uses skill_view(), memory tool, session context scanning,
and write_file for bundle generation. Output bundles are standard Agent Skills.
yc-default-alive-calculator/SKILL.md
+4 -6
View File
@@ -1,11 +1,9 @@
---
name: yc-default-alive-calculator
description: Evaluate whether a startup is on a trajectory to profitability before
running out of cash — Paul Graham's "Default Alive / Default Dead" framework. Takes
revenue, burn rate, cash on hand, and growth rate; computes runway, burn multiple,
and months to breakeven. Ships a deterministic CLI calculator. Load when founders
ask about runway, burn rate, default alive, whether they need to raise money, or
financial sustainability analysis.
description: >-
Evaluate startup runway, burn, revenue, and profitability trajectory using the Default
Alive / Default Dead framework. Do not use this skill for weekly growth experiments or
operating growth decisions; use `yc-weekly-growth-compass` for those decisions.
license: MIT
compatibility: Python 3.9+ with standard library only (no external dependencies).
The default-alive.py script uses only math, json, and sys.
yc-weekly-growth-compass/SKILL.md
+4 -7
View File
@@ -1,12 +1,9 @@
---
name: yc-weekly-growth-compass
description: Use Paul Graham's "Startup = Growth" framework as an operational decision
tool. Computes weekly growth rates, benchmarks against YC tiers (1% concerning, 5-7%
good, 10%+ exceptional), projects compound growth over time, and frames every startup
decision through the question "does this serve your target growth rate?" Ships a deterministic
CLI calculator. Load when founders ask about growth rate, weekly growth, startup
traction, metrics, or whether they're moving fast enough; do not use for general
financial modeling or engineering work unrelated to growth metrics.
description: >-
Make weekly startup growth decisions using growth rate, user behavior, and experiment
evidence. Do not use this skill for runway, burn, or profitability trajectory analysis;
use `yc-default-alive-calculator` for financial sustainability.
license: MIT
compatibility: Python 3.9+ with standard library only (no external dependencies).
The growth-compass.py script uses only math, json, and sys.