magnus-agent-skills
AI agent skills — reusable workflows, protocols, and knowledge packs for agentic systems.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 16 Nov 2026. Its scripts were only partly scanned.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/magnus919/agent-skills with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/magnus919/agent-skills'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/magnus919--agent-skills)HTML
<a href="/listings/magnus919--agent-skills"><img src="/api/listings/magnus919--agent-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Choose an installation method by how your harness discovers skills. Shared `SKILL.md` syntax does not imply shared search paths, tools, or update behavior.
| Installation method | Use it for | Maintenance | |---------------------|------------|-------------| | [`skills` CLI](#skills-cli-cross-harness) | Supported harnesses, including OpenClaw | Update installed skills, or rerun `add` to include new catalog entries | | [Local checkout or skill directory](docs/harness-installation.md#local-checkout-or-skill-directory) | Harnesses that scan configured directories | Refresh the checkout, synchronize copies if used, then verify discovery | | [Harness-managed installation](docs/harness-installation.md#harness-managed-installation) | Native plugins, Moltis imports, ZeroClaw bundles | Use that harness's refresh and activation procedure |
See the [harness installation and maintenance guide](docs/harness-installation.md) for OpenClaw, Moltis, PicoClaw, NullClaw, ZeroClaw, NanoClaw, Grok Bot, and Meta Muse, including known compatibility limits.
`skills` CLI (cross-harness)
Install the **full catalog** for your harness with the open [`skills` CLI](https://github.com/vercel-labs/skills) (requires Node.js 22.20+ with npm, and Git). Choose your harness's command below; these install globally for use across projects.
| Harness | Install the full catalog | |---------|-------------------------| | OpenAI Codex | `npx skills add magnus919/agent-skills --skill '*' --agent codex --global --yes` | | Claude Code | `npx skills add magnus919/agent-skills --skill '*' --agent claude-code --global --yes` | | OpenCode | `npx skills add magnus919/agent-skills --skill '*' --agent opencode --global --yes` | | GitHub Copilot | `npx skills add magnus919/agent-skills --skill '*' --agent github-copilot --global --yes` | | Cursor | `npx skills add magnus919/agent-skills --skill '*' --agent cursor --global --yes` | | Gemini CLI | `npx skills add magnus919/agent-skills --skill '*' --agent gemini-cli --global --yes` | | OpenClaw | `npx skills add magnus919/agent-skills --skill '*' --agent openclaw --global --yes` | | Hermes Agent | `npx skills add magnus919/agent-skills --skill '*' --agent hermes-agent --global --yes` |
Keep the quotes around `'*'` so your shell passes the wildcard to the CLI. For a project-only install, omit `--global` and run from the project directory. For Hermes, keep `--global`: its project-scoped `.hermes/skills/` target is not auto-discovered by Hermes.
To inspect the catalog or install a smaller selection instead:
npx skills add magnus919/agent-skills --list npx skills add magnus919/agent-skills --skill systematic-debugging --agent codex --global --yes
`--skill` matches the name in `SKILL.md`. Top-level bundle umbrellas such as `neckbeard` are included.
Updating and refreshing
**Once a week, or whenever you want the latest catalog, rerun your harness's full-catalog install command above.** This refreshes the selection from this repository and includes newly added skills. Keep the same harness and global/project scope as your original install. Start a new agent session afterward unless your harness documents automatic refresh; verify that the refreshed skill is available.
To update only skills you have already installed through the CLI, including those from other repositories:
# Update globally installed skills npx skills update --global # Update project skills; run from that project's directory npx skills update --project
The [CLI update command](https://github.com/vercel-labs/skills/blob/main/docs/commands.md#skills-update) updates installed skills; rerun the full-catalog `add` command to pick up new catalog entries. Refreshes can replace installed files, so keep personal edits in a separate skill or fork.
Updates do not necessarily remove skills deleted or renamed upstream. Review obsolete entries separately, and use your installer's removal command for copies you no longer want.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 1,701 lines
- {
- "name": "magnus-agent-skills",
- "owner": {
- "name": "Magnus Hedemark"
- },
- "description": "AI agent skills — reusable workflows, protocols, and knowledge packs for agentic systems.",
- "plugins": [
- {
- "name": "actuarial-risk-modeling",
- "source": "./",
- "skills": [
- "./actuarial-risk-modeling"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "adr-authoring",
- "source": "./",
- "skills": [
- "./adr-authoring"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "agent-council",
- "source": "./",
- "skills": [
- "./agent-council"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "agent-evals-and-observability",
- "source": "./",
- "skills": [
- "./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, monitor independence, oversight quality, 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",
- "source": "./",
- "skills": [
- "./agent-production-operations"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "agent-skills",
- "source": "./",
- "skills": [
- "./agent-skills"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "ai-governance",
- "source": "./",
- "skills": [
- "./ai-governance"
- ],
- "strict": false,
- "description": "Design and operate AI governance: principles, decision rights, risk tiers, lifecycle gates, fairness, transparency, privacy, security, compliance mapping, maturity and board reporting across SaaS, API, self-hosted and agentic systems. Use to admit, update or retire Agent Skills, MCP servers and A2A capabilities; approve an agent for production actions; or decide earned-autonomy promotion, reduction or revocation. Cover GxP, ALCOA+, data integrity, electronic records, assurance and QMS interfaces for life sciences. Do not use for legal interpretation (legal-strategy), data-platform mechanics (data-architect/data-engineering), security implementation (secure-software-engineering), skill package inspection (agent-skills), or executing runtime changes (agent-production-operations)."
- },
- {
- "name": "ai-operating-economics",
- "source": "./",
- "skills": [
- "./ai-operating-economics"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "amazon-memo",
- "source": "./",
- "skills": [
- "./amazon-memo"
- ],
- "strict": false,
- "description": "Create, adapt, or revise Amazon-style narrative decision memos, six-pagers, PR/FAQs, and short decision briefs, including reading meetings and async review. Use for choosing the right memo form, evidence-led reasoning, and revising mechanical AI prose for human readers. Do not use for general copywriting, document rendering, or replacing incident reports and technical design records."
- },
- {
- "name": "analog-occultism",
- "source": "./",
- "skills": [
- "./analog-occultism"
- ],
- "strict": false,
- "description": "Use this skill to create subject-neutral images and videos in an analog occultism / industrial CRT noir aesthetic: near-monochrome archival technical atmosphere, severe low-key lighting, tactile signal degradation, industrial geometry, and quiet unresolved tension. Use for portraits, products, environments, interfaces, diagrams, abstract forms, stills, and motion. Do not use for colorful cyberpunk, vaporwave, glossy advertising, conventional horror, or clean digital renders."
- },
- {
- "name": "anydoc",
- "source": "./",
- "skills": [
- "./anydoc"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "api-design-and-evolution",
- "source": "./",
- "skills": [
- "./api-design-and-evolution"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "artifact-pyramids",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "ascii-city-engine",
- "source": "./",
- "skills": [
- "./ascii-city-engine"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "autogen",
- "source": "./",
- "skills": [
- "./autogen"
- ],
- "strict": false,
- "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",
- "source": "./",
- "skills": [
- "./backend-engineering"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "binary-analysis",
- "source": "./",
- "skills": [
- "./binary-analysis"
- ],
- "strict": false,
- "description": "Plan static inspection of unknown binary files with a deterministic CLI whose Ghidra operations are currently unimplemented and fail closed. 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."
- },
- {
- "name": "bmad",
- "source": "./",
- "skills": [
- "./bmad"
- ],
- "strict": false,
- "description": "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)."
- },
- {
- "name": "brand-designer",
- "source": "./",
- "skills": [
- "./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, customer-centered messaging handoffs, 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 for market positioning decisions or conversion experiments; use go-to-market. Route interaction behavior to product-design-and-ux."
- },
- {
- "name": "c4-diagramming",
- "source": "./",
- "skills": [
- "./c4-diagramming"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "camera-hacking",
- "source": "./",
- "skills": [
- "./camera-hacking"
- ],
- "strict": false,
- "description": "Investigate, reverse-engineer, develop, and validate digital-camera modifications and interoperability, including custom firmware, hidden settings, camera control protocols, feature unlocks, and model-specific recovery. Use for feasibility research, offline analysis, controlled experiments, and explicitly authorized installation on photographic, cinema, and action cameras across manufacturers, especially Fujifilm X and Ricoh GR. Do not use for ordinary photography advice, routine vendor firmware updates, media editing, or unauthorized camera access."
- },
- {
- "name": "capacity-and-cost-engineering",
- "source": "./",
- "skills": [
- "./capacity-and-cost-engineering"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "chief-of-staff-methodology",
- "source": "./",
- "skills": [
- "./chief-of-staff-methodology"
- ],
- "strict": false,
- "description": "Prepare accountable executive decisions, decision support, briefings, information triage, calendar choices, and institutional memory. Use for chief of staff or CoS, executive operations, founder operations, operating rhythm, strategic attention, executive office, board materials, organizational sensing, team health, leadership transitions, gatekeeping, decision memos, executive briefing, strategic time, attention allocation, calendar triage, or meeting audits for a solo operator or organization. Do not use for generic personal assistance, employee surveillance, inferred commitments, automatic task mutation, meeting facilitation, org structure design, or business operating-process design; route to the owning specialist."
- },
- {
- "name": "cli-builder",
- "source": "./",
- "skills": [
- "./cli-builder"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "cncf-landscape",
- "source": "./",
- "skills": [
- "./cncf-landscape"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "code-review",
- "source": "./",
- "skills": [
- "./code-review"
- ],
- "strict": false,
- "description": "Review a code change for correctness, security, maintainability, and test adequacy, and reach a defensible verdict. Use when reviewing a pull request, diff, patch, or AI-generated change; when scoping an oversized review into reviewable units; when writing or triaging review comments; when assigning reviewers or setting review policy; or when investigating why a defect escaped review. Covers change sizing and attention budgets, risk-tiered checklists, severity-labeled comments, verdict and residual-risk records, review metrics that resist gaming, and the measured limits of checklists and AI reviewers. Do not use for implementing the requested change, root-cause debugging of a failing test or incident (use systematic-debugging), security assessment of a whole system (use security-audit-methodology), designing new code securely (use secure-software-engineering), architecture review across systems (use software-architecture), or reverse-engineering an unfamiliar codebase (use software-architecture-analysis)."
- },
- {
- "name": "color-management",
- "source": "./",
- "skills": [
- "./color-management"
- ],
- "strict": false,
- "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": "community-guides",
- "source": "./",
- "skills": [
- "./community-guides"
- ],
- "strict": false,
- "description": "Create, adapt, or revise practical community guides with locally grounded activities, participant worksheets, facilitator instructions, and maintenance plans. Use for neighborhood preparedness, mutual support, shared projects, and community learning programs. Do not use for travel guides, promotional brochures, standalone policies, simple document formatting, or live incident response."
- },
- {
- "name": "conditional-customer-success",
- "source": "./",
- "skills": [
- "./conditional-customer-success"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "confluence-cli",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "constrained-optimization",
- "source": "./",
- "skills": [
- "./constrained-optimization"
- ],
- "strict": false,
- "description": "Define, compare, and audit constrained optimization decisions with explicit variables, units, hard and soft constraints, feasibility, Pareto tradeoffs, and honest solver evidence. Do not use for statistical modeling or ML fitting, which belong to data-scientist or ml-engineering, or for operating a named solver."
- },
- {
- "name": "copy-editor",
- "source": "./",
- "skills": [
- "./copy-editor"
- ],
- "strict": false,
- "description": "Edit manuscripts, articles, reports, fiction, technical and scholarly text, and digital content for correctness, consistency, clarity, completeness, and faithful meaning. Use for grammar, usage, house style, style sheets, author queries, references, and coordinated copyediting passes. Do not use for developmental rewriting, translation, independent fact-checking, final-layout proofreading alone, or editorial production management."
- },
- {
- "name": "crewai",
- "source": "./",
- "skills": [
- "./crewai"
- ],
- "strict": false,
- "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",
- "source": "./",
- "skills": [
- "./crm"
- ],
- "strict": false,
- "description": "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)."
- },
- {
- "name": "crowdsec",
- "source": "./",
- "skills": [
- "./crowdsec"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "cryptpad",
- "source": "./",
- "skills": [
- "./cryptpad"
- ],
- "strict": false,
- "description": "Use CryptPad encrypted collaboration for integration, automation, and diagnosis with its browser integration API, instance discovery, document import/export, and session-key lifecycle. Use for CryptPad API feasibility, embedded editors, sharing, persistence, or self-hosted instance troubleshooting. Do not use for EncryptPad/OpenPGP, generic office-file conversion, or designing an unrelated collaboration service."
- },
- {
- "name": "cyberpunk",
- "source": "./",
- "skills": [
- "./cyberpunk"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "daily-life-discovery",
- "source": "./",
- "skills": [
- "./daily-life-discovery"
- ],
- "strict": false,
- "description": "Guide a consent-based conversation that helps a person discover how an AI agent could improve their day-to-day life: routines, friction, attention, decisions, relationships, learning, and small experiments. Use when someone asks for a daily check-in, wants the agent to learn how they work, says \"grill me,\" wants a conversational journal, or asks what an AI could help with. Do not use for therapy, diagnosis, crisis support, covert monitoring, or product requirements interviews."
- },
- {
- "name": "data-architect",
- "source": "./",
- "skills": [
- "./data-architect"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "data-cleaning",
- "source": "./",
- "skills": [
- "./data-cleaning"
- ],
- "strict": false,
- "description": "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, including AI-suggested repair, entity-match review, score calibration limits, and reversible repair ledgers. 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."
- },
- {
- "name": "data-engineering",
- "source": "./",
- "skills": [
- "./data-engineering"
- ],
- "strict": false,
- "description": "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, including model-assisted transformation contracts, deterministic acceptance, bounded retries, and sink reconciliation. Do not use for statistical analysis or ML model development."
- },
- {
- "name": "data-scientist",
- "source": "./",
- "skills": [
- "./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`. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "de-spin",
- "source": "./",
- "skills": [
- "./de-spin"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "digital-twin",
- "source": "./",
- "skills": [
- "./digital-twin"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "docker-compose",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "documents",
- "source": "./",
- "skills": [
- "./documents"
- ],
- "strict": false,
- "description": "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)."
- },
- {
- "name": "dsm5",
- "source": "./",
- "skills": [
- "./dsm5"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "dspy",
- "source": "./",
- "skills": [
- "./dspy"
- ],
- "strict": false,
- "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": "electronics",
- "source": "./",
- "skills": [
- "./electronics"
- ],
- "strict": false,
- "description": "Design, review, prototype, measure, and troubleshoot electronic circuits using component evidence, worst-case calculations, interface contracts, and staged bench verification. Use for component selection, analog or digital building blocks, power and protection, sensor conditioning, schematic-to-wiring review, instrumented diagnosis, and I2C electrical integration. Do not use as a substitute for exact device documentation, ESP32 firmware operations, FPGA RTL development, named CAD-tool operation, or regulated design certification."
- },
- {
- "name": "email",
- "source": "./",
- "skills": [
- "./email"
- ],
- "strict": false,
- "description": "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)."
- },
- {
- "name": "enterprise-architecture",
- "source": "./",
- "skills": [
- "./enterprise-architecture"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "epub",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "esp32-development",
- "source": "./",
- "skills": [
- "./esp32-development"
- ],
- "strict": false,
- "description": "Build, configure, flash, test, debug, and recover firmware for ESP32-family boards, including ESP-Mosaico kit bring-up, 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, planning OTA and production security, or automating hardware tests and fault injection. Do not use as a substitute for the exact board schematic, SoC datasheet, or attached component datasheet."
- },
- {
- "name": "ffmpeg",
- "source": "./",
- "skills": [
- "./ffmpeg"
- ],
- "strict": false,
- "description": "Use this skill for local FFmpeg/FFprobe media inspection, remuxing, transcoding, filtering, evidence-bounded video review, transcript-assisted editorial plans, edit decision lists, podcast/audio cleanup, rendering, and output acceptance. It emphasizes explicit stream selection, source preservation, build-aware commands, bounded evidence, and verified new outputs. Do not use it for libav API programming, opaque whole-video understanding, automatic publishing, rights clearance, DRM circumvention, professional broadcast/color certification, or HyperFrames-authored compositions; route those tasks to their owning capabilities."
- },
- {
- "name": "financial-modeling",
- "source": "./",
- "skills": [
- "./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, outcome-linked partnerships, revenue-share fees, pricing, cap tables, or financing. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "fireflies",
- "source": "./",
- "skills": [
- "./fireflies"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "flaresolverr",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "flaresolverr-cli",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "forgejo-cli",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "forward-deployed-engineering",
- "source": "./",
- "skills": [
- "./forward-deployed-engineering"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "fpga-development",
- "source": "./",
- "skills": [
- "./fpga-development"
- ],
- "strict": false,
- "description": "Design, review, simulate, and verify FPGA logic using explicit RTL contracts, clock and reset models, CDC analysis, timing constraints, and reproducible implementation evidence. Use for synthesizable HDL, fixed-point arithmetic, handshakes, testbenches, resource tradeoffs, timing closure, and FPGA release or bring-up planning. Do not use for ordinary MCU firmware, generic circuit design, a substitute vendor-tool manual, or unsupported claims of hardware or timing signoff."
- },
- {
- "name": "frontend-engineering",
- "source": "./",
- "skills": [
- "./frontend-engineering"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "gap-analysis",
- "source": "./",
- "skills": [
- "./gap-analysis"
- ],
- "strict": false,
- "description": "Analyze gaps by comparing a defined current state with a justified target state, characterizing causes and uncertainty, prioritizing actionable interventions, and producing traceable matrices, roadmaps, and decision records. Use for capability, process, compliance, readiness, maturity, operating-model, or research-evidence gaps. Do not use for a vague list of problems, a standalone root-cause analysis, a generic SWOT, or legal or audit certification advice without a governing standard and qualified owner."
- },
- {
- "name": "genius-life",
- "source": "./",
- "skills": [
- "./genius-life"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "ghost",
- "source": "./",
- "skills": [
- "./ghost"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "github-runner",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "go-to-market",
- "source": "./",
- "skills": [
- "./go-to-market"
- ],
- "strict": false,
- "description": "Plan and evaluate go-to-market strategy using positioning, acquisition, growth economics, market-entry, competitive-response, and governed agent-assisted acquisition experiments. Use for ICP, customer-centered messaging, website narrative, outcome-linked operating partnerships, channel, CAC/LTV, beachhead, or automated-GTM strategy decisions. Do not use for campaign execution, CRM mutations, legal interpretation, product strategy, or visual brand design."
- },
- {
- "name": "grafana",
- "source": "./",
- "skills": [
- "./grafana"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "gutenberg",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "harness-engineering",
- "source": "./",
- "skills": [
- "./harness-engineering"
- ],
- "strict": false,
- "description": "Design, build, diagnose, and evolve agent harnesses: instructions, tools, execution environments, durable state, context management, verification, recovery, bounded autonomous loops, and software factories that repeatedly turn incoming work into accepted deliverables. Use for director/worker production systems, factory steering, unreliable coding agents, cross-session drift, premature completion, harness audits, or changes to the runtime around a model, including bounded typed-decision routing. Do not use for prompt rewriting alone, model training, general application architecture, or operating an already evaluated agent in production; route those concerns to their specialist skills."
- },
- {
- "name": "haystack",
- "source": "./",
- "skills": [
- "./haystack"
- ],
- "strict": false,
- "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",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "implementation-planning",
- "source": "./",
- "skills": [
- "./implementation-planning"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "incident-learning",
- "source": "./",
- "skills": [
- "./incident-learning"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "infographic",
- "source": "./",
- "skills": [
- "./infographic"
- ],
- "strict": false,
- "description": "Design, create, or improve an infographic, visual explainer, illustrated guide, comparison poster, process graphic, or data story for any audience. Use for turning evidence and ideas into a clear, polished visual explanation, including choosing information structure, visual encoding, and a distinct aesthetic. Do not use for standalone decorative artwork, complete brand identity systems, statistical analysis alone, or ordinary document formatting."
- },
- {
- "name": "jellyfin",
- "source": "./",
- "skills": [
- "./jellyfin"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "jira",
- "source": "./",
- "skills": [
- "./jira"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "job-interview-coaching",
- "source": "./",
- "skills": [
- "./job-interview-coaching"
- ],
- "strict": false,
- "description": "Use this skill to coach candidates and interviewers for job interviews: prepare truthful examples, critique interview transcripts, run interactive mock interviews and targeted practice, design structured questions and evidence-based scorecards, and improve candidate experience. Adapt to profession, seniority, and interview format. Do not use for journalism, user research, workflow discovery, general resume writing, clinical interviewing, or autonomous hiring decisions."
- },
- {
- "name": "kanban-guru",
- "source": "./",
- "skills": [
- "./kanban-guru"
- ],
- "strict": false,
- "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",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "langchain",
- "source": "./",
- "skills": [
- "./langchain"
- ],
- "strict": false,
- "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",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "lastfm",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "legal-strategy",
- "source": "./",
- "skills": [
- "./legal-strategy"
- ],
- "strict": false,
- "description": "Analyze legal and regulatory risk, IP, contracts, privacy, governance, and employment questions as structured issue-spotting for counsel. Do not use this methodology as legal advice or for technical security implementation, CRM, or delivery execution."
- },
- {
- "name": "life-coach",
- "source": "./",
- "skills": [
- "./life-coach"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "linear",
- "source": "./",
- "skills": [
- "./linear"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "litellm",
- "source": "./",
- "skills": [
- "./litellm"
- ],
- "strict": false,
- "description": "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)."
- },
- {
- "name": "llama-cpp",
- "source": "./",
- "skills": [
- "./llama-cpp"
- ],
- "strict": false,
- "description": "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 or bounded llama-completion, 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."
- },
- {
- "name": "llamaindex",
- "source": "./",
- "skills": [
- "./llamaindex"
- ],
- "strict": false,
- "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": "managing-editor",
- "source": "./",
- "skills": [
- "./managing-editor"
- ],
- "strict": false,
- "description": "Use this skill to plan, assign, coordinate, edit, verify, produce, and improve editorial work across newsrooms, magazines, books, journals, digital content, and organizational publishing, especially when coordinating contributors or delegating bounded work to subagents. Do not use it for a single copyedit or a specialized research, legal, design, or publishing-platform task; use the relevant discipline or tool skill and involve the accountable editor."
- },
- {
- "name": "meetings",
- "source": "./",
- "skills": [
- "./meetings"
- ],
- "strict": false,
- "description": "Plan, organize, facilitate, and document meetings and relationship-sensitive one-on-ones, including invitees, decision processes, proactive accessibility, private preference memory, agreed actions, and follow-through. Use for the meeting lifecycle or deciding whether to meet; do not substitute for formal performance procedures, specialist incident response, therapy, or memo writing."
- },
- {
- "name": "mermaid-diagrams",
- "source": "./",
- "skills": [
- "./mermaid-diagrams"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "meshcore-packet-capture",
- "source": "./",
- "skills": [
- "./meshcore-packet-capture"
- ],
- "strict": false,
- "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",
- "source": "./",
- "skills": [
- "./migration-engineering"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "ml-engineering",
- "source": "./",
- "skills": [
- "./ml-engineering"
- ],
- "strict": false,
- "description": "Plan and execute production ML engineering work — classifier versus generative model selection, zero-shot baselines, coding specialization, model training and fine-tuning (LoRA/QLoRA), evaluation and eval-set design, quantization decisions, inference deployment, lineage, feature parity, drift response, and regression triage, experimental weight inspection and targeted editing, 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)."
- },
- {
- "name": "mobile-development",
- "source": "./",
- "skills": [
- "./mobile-development"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "multi-agent-coordination",
- "source": "./",
- "skills": [
- "./multi-agent-coordination"
- ],
- "strict": false,
- "description": "Design, diagnose, and evaluate coordination across multiple AI agents and heterogeneous harnesses: decomposition, topology, ownership, communication, distributed context, shared memory, integration, recovery, and collective failure patterns. Use for persistent agent teams, fleets, swarms, agent handoffs, coordination loops, or extracting portable lessons from OpenRig, HERDR and Block/Buzz. Do not use for a single agent's runtime, a named tool's installation or command manual, debate alone, or operating an evaluated production agent; route those to harness-engineering, the tool's documentation, agent-council, or agent-production-operations."
- },
- {
- "name": "multi-tenant-saas-architecture",
- "source": "./",
- "skills": [
- "./multi-tenant-saas-architecture"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "neckbeard",
- "source": "./",
- "skills": [
- "./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, 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",
- "source": "./",
- "skills": [
- "./notion"
- ],
- "strict": false,
- "description": "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)."
- },
- {
- "name": "nous-branding",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "open-knowledge-format",
- "source": "./",
- "skills": [
- "./open-knowledge-format"
- ],
- "strict": false,
- "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",
- "source": "./",
- "skills": [
- "./openlibrary"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "opensource-contributions",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "operational-design",
- "source": "./",
- "skills": [
- "./operational-design"
- ],
- "strict": false,
- "description": "Design and improve operational processes, controls, metrics, vendors, and scaling models through bounded pilots and evidence. Do not use for engineering delivery, financial modeling, technology evaluation, or legal advice. 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."
- },
- {
- "name": "org-design",
- "source": "./",
- "skills": [
- "./org-design"
- ],
- "strict": false,
- "description": "Design organizational topology, talent, rewards, culture, and health decisions with explicit decision rights and validation. Do not use for legal advice, project delivery planning, financial modeling, or technology implementation. 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)."
- },
- {
- "name": "pace-plan",
- "source": "./",
- "skills": [
- "./pace-plan"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "peertube",
- "source": "./",
- "skills": [
- "./peertube"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "performance-optimization",
- "source": "./",
- "skills": [
- "./performance-optimization"
- ],
- "strict": false,
- "description": "Optimize software performance through user-journey baselines, profiling, representative benchmarks, controlled experiments, and field verification. Use when asked to make an application, service, workflow, or hot path faster or more efficient, or to build the measurement loop first. Do not use for a reliability incident, capacity forecast, generic product A/B test, or operating a named telemetry or load-testing tool without an optimization objective."
- },
- {
- "name": "platform-engineering",
- "source": "./",
- "skills": [
- "./platform-engineering"
- ],
- "strict": false,
- "description": "Use this skill when building or operating internal developer platforms: infrastructure as code, CI/CD, container orchestration, service networking, secrets, and observability, or when shaping platform products, self-service interfaces, adoption evidence, and policy guardrails. Do not use it to define release process, promotion, rollout, or rollback policy; use release-engineering for that delivery model. Route named-tool configuration and troubleshooting to the corresponding operational skill, such as kubernetes or traefik for ingress-controller configuration."
- },
- {
- "name": "playwright",
- "source": "./",
- "skills": [
- "./playwright"
- ],
- "strict": false,
- "description": "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)."
- },
- {
- "name": "postgres",
- "source": "./",
- "skills": [
- "./postgres"
- ],
- "strict": false,
- "description": "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)."
- },
- {
- "name": "privacy-engineering",
- "source": "./",
- "skills": [
- "./privacy-engineering"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "product-adoption",
- "source": "./",
- "skills": [
- "./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). Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "product-analytics-and-measurement",
- "source": "./",
- "skills": [
- "./product-analytics-and-measurement"
- ],
- "strict": false,
- "description": "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)."
- },
- {
- "name": "product-design-and-ux",
- "source": "./",
- "skills": [
- "./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, AI recommendations and generated outputs, uncertainty, human control, feedback, 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",
- "source": "./",
- "skills": [
- "./product-discovery"
- ],
- "strict": false,
- "description": "Discover external customer problems and product requirements from human stakeholders. Assess customer evidence before investing, or 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. Also grill a PRD, interrogate a proposal, poke holes in a spec, or interview its author about an existing draft, one consequential question at a time. Do not use for personal-life discovery (daily-life-discovery), general research without product requirements (research-methodology), or implementation planning."
- },
- {
- "name": "product-experimentation",
- "source": "./",
- "skills": [
- "./product-experimentation"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "product-lifecycle",
- "source": "./",
- "skills": [
- "./product-lifecycle"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "product-lifecycle-learning",
- "source": "./",
- "skills": [
- "./product-lifecycle-learning"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "product-methodology",
- "source": "./",
- "skills": [
- "./product-methodology"
- ],
- "strict": false,
- "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",
- "source": "./",
- "skills": [
- "./product-operations-and-governance"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "product-roadmapping-and-portfolio",
- "source": "./",
- "skills": [
- "./product-roadmapping-and-portfolio"
- ],
- "strict": false,
- "description": "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)."
- },
- {
- "name": "product-shaping",
- "source": "./",
- "skills": [
- "./product-shaping"
- ],
- "strict": false,
- "description": "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)."
- },
- {
- "name": "product-strategy",
- "source": "./",
- "skills": [
- "./product-strategy"
- ],
- "strict": false,
- "description": "Set product vision, positioning, market strategy, and portfolio direction with a CPO methodology. Route tactical prioritization, specifications, and backlog decisions to `product-methodology`; do not use this skill for delivery-level product decisions or unrelated requests."
- },
- {
- "name": "production-excellence",
- "source": "./",
- "skills": [
- "./production-excellence"
- ],
- "strict": false,
- "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",
- "source": "./",
- "skills": [
- "./production-readiness"
- ],
- "strict": false,
- "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",
- "source": "./",
- "skills": [
- "./programming-principles"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "promise-theory",
- "source": "./",
- "skills": [
- "./promise-theory"
- ],
- "strict": false,
- "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",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "qa-methodology",
- "source": "./",
- "skills": [
- "./qa-methodology"
- ],
- "strict": false,
- "description": "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, artifact provenance, spec-first oracles, AI-review-comment triage, acceptance-criteria testability for 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."
- },
- {
- "name": "raleigh",
- "source": "./",
- "skills": [
- "./raleigh"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "react",
- "source": "./",
- "skills": [
- "./react"
- ],
- "strict": false,
- "description": "Operate React applications as a named tool: inspect and diagnose React/Vite projects, design component boundaries and state flow, implement accessible responsive UI, and verify behavior with the project's tests. Use when a task explicitly involves React, JSX/TSX, React hooks, React Router, Vite React configuration, or React build failures. Do not use for framework-agnostic frontend strategy (route to frontend-engineering), browser automation (route to playwright), accessibility policy or audits (route to web-accessibility), or non-React mobile apps (route to mobile-development)."
- },
- {
- "name": "release-engineering",
- "source": "./",
- "skills": [
- "./release-engineering"
- ],
- "strict": false,
- "description": "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)."
- },
- {
- "name": "remote-systems-administration",
- "source": "./",
- "skills": [
- "./remote-systems-administration"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "research-and-vault",
- "source": "./",
- "skills": [
- "./research-and-vault"
- ],
- "strict": false,
- "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",
- "source": "./",
- "skills": [
- "./research-methodology"
- ],
- "strict": false,
- "description": "Plan, conduct, evaluate, and synthesize rigorous research investigations with credible evidence and a traceable method, including source-to-claim closure for media evidence. Do not use this skill for repeated source extraction and durable note orchestration; use `research-and-vault` for that capture workflow, or `ffmpeg` for media operations."
- },
- {
- "name": "resilience-and-recovery",
- "source": "./",
- "skills": [
- "./resilience-and-recovery"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "restic",
- "source": "./",
- "skills": [
- "./restic"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "secure-software-engineering",
- "source": "./",
- "skills": [
- "./secure-software-engineering"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "security-audit-methodology",
- "source": "./",
- "skills": [
- "./security-audit-methodology"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "semantic-spacetime",
- "source": "./",
- "skills": [
- "./semantic-spacetime"
- ],
- "strict": false,
- "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",
- "source": "./",
- "skills": [
- "./seo"
- ],
- "strict": false,
- "description": "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, local/national site portfolios, scaled-content quality, 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."
- },
- {
- "name": "site-reliability-engineering",
- "source": "./",
- "skills": [
- "./site-reliability-engineering"
- ],
- "strict": false,
- "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",
- "source": "./",
- "skills": [
- "./slack"
- ],
- "strict": false,
- "description": "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)."
- },
- {
- "name": "software-architecture",
- "source": "./",
- "skills": [
- "./software-architecture"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "software-architecture-analysis",
- "source": "./",
- "skills": [
- "./software-architecture-analysis"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "solarpunk",
- "source": "./",
- "skills": [
- "./solarpunk"
- ],
- "strict": false,
- "description": "Create, explore, critique, and practice solarpunk across visual art and image prompts, fiction and worldbuilding, fashion, games, education, everyday living, adaptive reuse, ecological design, parklets, guerrilla gardening, urban and rural planning, community infrastructure, and hopeful collective futures. Use for solarpunk aesthetics, stories, values, or practical paths toward equitable ecological flourishing. Do not use for generic sustainability tasks with no solarpunk intent, certified engineering, jurisdiction-specific legal advice, or operating an image or infrastructure tool; pair with the relevant specialist."
- },
- {
- "name": "solo-startup",
- "source": "./",
- "skills": [
- "./solo-startup"
- ],
- "strict": false,
- "description": "Use this skill when a solopreneur or solo startup founder needs to choose, validate, or operate a business within one person's cash, time, and support capacity, including bootstrapped services, products, and AI-assisted businesses. Translate customer evidence into a bounded offer and a sustainable operating decision. Do not use for an isolated customer interview, financial calculation, growth analysis, or calendar triage; route those to the corresponding specialist."
- },
- {
- "name": "spec-driven-development",
- "source": "./",
- "skills": [
- "./spec-driven-development"
- ],
- "strict": false,
- "description": "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)."
- },
- {
- "name": "spring-ai",
- "source": "./",
- "skills": [
- "./spring-ai"
- ],
- "strict": false,
- "description": "Diagnose and operate Spring AI projects with version-aware Maven or Gradle checks for ChatClient, advisors, retrieval, conversation memory, tool/MCP boundaries, streaming, configuration, and observability. Use for setup compatibility, local smoke checks, and failure triage; do not use for provider-specific model evaluation, general Java/Spring development, security threat modeling, or production rollout governance."
- },
- {
- "name": "strategy-frameworks",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "stripe",
- "source": "./",
- "skills": [
- "./stripe"
- ],
- "strict": false,
- "description": "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)."
- },
- {
- "name": "supabase",
- "source": "./",
- "skills": [
- "./supabase"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "system-one",
- "source": "./",
- "skills": [
- "./system-one"
- ],
- "strict": false,
- "description": "Design, integrate, evaluate, self-host, and troubleshoot typed System One decision models including TypeSafe Jev, Convai Innovations Laya, CLM, and experimental Strands Decider. Use for Choice/Score/Noul judgments and experimental Jev image/Box queries inside deterministic software, app-control loops, routing, ranking, guardrails, calibration, semantic code linting and post-edit feedback, DevOps decision support, confidence-based escalation, or private open-model inference. Do not use for syntactic/style linting, exact policy or authorization, open-ended generation, or generic LLM serving without a bounded decision contract."
- },
- {
- "name": "systematic-debugging",
- "source": "./",
- "skills": [
- "./systematic-debugging"
- ],
- "strict": false,
- "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": "tabpfn",
- "source": "./",
- "skills": [
- "./tabpfn"
- ],
- "strict": false,
- "description": "Operate and evaluate TabPFN for local tabular classification, regression and dataset-specific fine-tuning: checkpoint selection, weight licensing, environment setup, training-context leakage, calibration, resource budgeting and reproducible inference artifacts. Use for TabPFN package or checkpoint workflows. Do not use for generic model selection, operating TabICL, or language-model fine-tuning; use ml-engineering, the selected tool, or unsloth respectively."
- },
- {
- "name": "tailscale",
- "source": "./",
- "skills": [
- "./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, backup/migration, and Tailworm security exposure triage. 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": "teach-me",
- "source": "./",
- "skills": [
- "./teach-me"
- ],
- "strict": false,
- "description": "Teach a subject through source-grounded explanations, brief diagnostic tasks, practice, and adaptive feedback. Use when a learner asks to learn, understand, refresh, practice, or be tutored toward an observable goal. Do not use for a standalone factual lookup, doing the task on someone's behalf, life coaching, group-program design, or collecting research without teaching."
- },
- {
- "name": "technical-documentation",
- "source": "./",
- "skills": [
- "./technical-documentation"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "technical-program-management",
- "source": "./",
- "skills": [
- "./technical-program-management"
- ],
- "strict": false,
- "description": "Manage technical programs made of multiple related projects, products, teams, or vendors: establish the program mandate and benefits, align component work, manage cross-project dependencies and shared capacity, govern risks and decisions, coordinate transformation and adoption, and communicate program health to executives, delivery teams, and partners. Use when the work is a coordinated change larger than one project or when component projects are locally green but the combined outcome is at risk. Do not use for single-project control, detailed implementation planning, product portfolio or capital-allocation decisions, enterprise architecture design, release approval, or live incident command; route those to the named specialists."
- },
- {
- "name": "technical-project-management",
- "source": "./",
- "skills": [
- "./technical-project-management"
- ],
- "strict": false,
- "description": "Manage technical projects from initiation through delivery and closure: choose and tailor predictive, iterative, Scrum, flow-based, or hybrid approaches; coordinate teams and vendors; track milestones, risks, issues, dependencies, forecasts, scope changes, and recovery. Use when a team has no project manager, a TPM needs decision-ready analysis, a project is slipping, or commitments and handoffs need coordination. Use `technical-program-management` instead when multiple related projects, teams, vendors, shared capacity, or benefits must be coordinated toward one outcome. Adapt depth to the user's expertise. Do not use for a standalone coding task, product discovery or strategy, only writing an implementation plan, only diagnosing Kanban flow, operating a ticket tool, incident command, or a release go/no-go decision; route those to specialists."
- },
- {
- "name": "technology-radar",
- "source": "./",
- "skills": [
- "./technology-radar"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "telemetry",
- "source": "./",
- "skills": [
- "./telemetry"
- ],
- "strict": false,
- "description": "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, including bounded PromQL and LogQL query construction, semantic review, and no-data diagnosis. Do not use for observability strategy, SLI/SLO design, or paging policy (that is platform-engineering), Grafana dashboards, panels, and Grafana-side alerting (that is grafana), or Tempo/tracing operations, which remain deferred to a future named-tool skill."
- },
- {
- "name": "tempest",
- "source": "./",
- "skills": [
- "./tempest"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "terraform",
- "source": "./",
- "skills": [
- "./terraform"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "three",
- "source": "./",
- "skills": [
- "./three"
- ],
- "strict": false,
- "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",
- "source": "./",
- "skills": [
- "./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 personal watch history, watchlists, or tracking; use `trakt` for user activity and watch-state workflows."
- },
- {
- "name": "traefik",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "training-data-annotation",
- "source": "./",
- "skills": [
- "./training-data-annotation"
- ],
- "strict": false,
- "description": "Design and improve human annotation programs for machine-learning training, validation, and evaluation data, including task and label schemas, active acquisition, annotator guidance, calibration, disagreement, adjudication, provenance, and cost-quality stopping. Do not use for general statistical inference, data storage pipelines, model training, or annotation-interface implementation; route those concerns to data-scientist, data-engineering, ml-engineering, or product-design-and-ux."
- },
- {
- "name": "trakt",
- "source": "./",
- "skills": [
- "./trakt"
- ],
- "strict": false,
- "description": "Discover and compare public Trakt.tv trending, popular, and anticipated movies and shows from the terminal. Do not use this skill for personal history, watchlist, collection, or list management; the bundled CLI has no user-scoped operations. Use `tmdb` for catalog metadata, credits, images, and provider lookups."
- },
- {
- "name": "transistor",
- "source": "./",
- "skills": [
- "./transistor"
- ],
- "strict": false,
- "description": "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)."
- },
- {
- "name": "travel-guide",
- "source": "./",
- "skills": [
- "./travel-guide"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "unsloth",
- "source": "./",
- "skills": [
- "./unsloth"
- ],
- "strict": false,
- "description": "Install, operate, and troubleshoot Unsloth Core, Studio, and Desktop for local inference and model training. Use for Unsloth environment setup, LoRA/QLoRA supervised fine-tuning, coding specialization, verifier audits, chat templates, GRPO and preference training, vision and audio workflows, decision models, local coding agents and tools, dynamic quantization, checkpoint recovery, multi-GPU training, and model export to GGUF or serving engines. Do not use for framework-neutral ML strategy or operating a standalone inference server unrelated to Unsloth."
- },
- {
- "name": "vercel-eve",
- "source": "./",
- "skills": [
- "./vercel-eve"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "verification-methodology",
- "source": "./",
- "skills": [
- "./verification-methodology"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "verified-delivery",
- "source": "./",
- "skills": [
- "./verified-delivery"
- ],
- "strict": false,
- "description": "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)."
- },
- {
- "name": "vite",
- "source": "./",
- "skills": [
- "./vite"
- ],
- "strict": false,
- "description": "Operate Vite projects: inspect versions and configuration, run bounded development and production builds, diagnose dependency and asset failures, and configure environment-aware frontend delivery. Use when a task names Vite, vite.config, Vite plugins, import.meta.env, dev-server behavior, or Vite build output. Do not use for frontend architecture or visual implementation (route to frontend-engineering), CI/platform provisioning (route to platform-engineering), browser automation (route to playwright), or accessibility design (route to web-accessibility)."
- },
- {
- "name": "vllm",
- "source": "./",
- "skills": [
- "./vllm"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "waiting-list",
- "source": "./",
- "skills": [
- "./waiting-list"
- ],
- "strict": false,
- "description": "Design and build waiting-list portals for anticipated goods or services: classify whether the experience needs interest capture, verified early access, referral growth, a virtual waiting room, appointment backfill, or scarce-item allocation; choose a reversible architecture; and define the state machine, abuse controls, consent and email lifecycle, fairness, observability, and release gates. Optionally validate supplied email and phone contacts with expiring magic links or provider-managed verification, then feed eligible, consented records to a runtime-configured CRM adapter. Use for prelaunch signups, beta access, launches, bookings, reservations, traffic-spike queues, and premium or cinematic campaign experiences. Do not use for generic landing-page copy, ordinary CRM or email operations, or checkout and inventory systems in isolation; route those parts to the appropriate specialist skill."
- },
- {
- "name": "web-accessibility",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "wonderer-methodology",
- "source": "./",
- "skills": [
- "./wonderer-methodology"
- ],
- "strict": false,
- "description": "Use lateral exploration to find adjacent ideas, overlooked angles, and research paths when the user wants to expand a topic, ask what they are overlooking, or remain in a divergent ideation phase. Produce tethered leads without prematurely choosing an answer. Do not use for factual lookups, rigorous evidence synthesis, product validation, or implementation planning."
- },
- {
- "name": "woodpecker-ci",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "workflow-architect",
- "source": "./",
- "skills": [
- "./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. Do not use this skill for unrelated requests; route to the nearest named specialist."
- },
- {
- "name": "writers-helper",
- "source": "./",
- "skills": [
- "./writers-helper"
- ],
- "strict": false,
- "description": "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."
- },
- {
- "name": "yc-default-alive-calculator",
- "source": "./",
- "skills": [
- "./yc-default-alive-calculator"
- ],
- "strict": false,
- "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",
- "source": "./",
- "skills": [
- "./yc-weekly-growth-compass"
- ],
- "strict": false,
- "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."
- },
- {
- "name": "youtube-thumbnail",
- "source": "./",
- "skills": [
- "./youtube-thumbnail"
- ],
- "strict": false,
- "description": "Design, critique, and test YouTube video thumbnails and preview cards for stronger, better-qualified clicks. Use when developing thumbnail concepts, pairing a thumbnail with a title, directing image creation, checking small-screen legibility, preparing a YouTube experiment, or diagnosing thumbnail performance. Do not use for general video editing, channel strategy, or artwork for another platform."
- }
- ]
- }
README.md · README · 1,026 lines
- # agent-skills
- [](https://skills.sh/magnus919/agent-skills)
- A collection of AI agent skills — reusable workflows, protocols, and knowledge packs for agentic systems. Skills follow the Agent Skills open format, making them compatible with any agent framework that supports the standard.
- The project is also where I codify practical patterns for making agents more capable, governable, observable, and trustworthy in real work — from evaluations and production operations to AI governance, operating economics, and multi-agent collaboration.
- [Install the full catalog](#installation) · [Keep skills up to date](#updating-and-refreshing)
- ## Find a workflow
- Start with the decision or job you have. These are links to existing skills, not
- new skill names or runtime aliases. For authority, evidence, and stop conditions,
- use the [agent-trust routes](references/agent-trust-routes.md).
- | What you want to do | Start with | Boundary |
- |---|---|---|
- | Take an issue through implementation and a verified PR | [neckbeard](neckbeard/SKILL.md) | Coordinates the software delivery lifecycle; specialists retain their methods |
- | Plan implementation of an approved spec | [implementation-planning](implementation-planning/SKILL.md) | Plans dependencies and verification; does not approve the requirement or implement it |
- | Coordinate a team across agent harnesses | [multi-agent-coordination](multi-agent-coordination/SKILL.md) | Cross-agent ownership, context, communication and integration; runtime mechanics keep their owner |
- | Fix an unreliable agent or build its runtime | [harness-engineering](harness-engineering/SKILL.md) | Instructions, tools, state, recovery and bounded loops; production operation has a separate owner |
- | Review this patch or pull request | [code-review](code-review/SKILL.md) | Evidence-backed change review; does not implement the fix |
- | Finish an authorized change through merge and verify it | [verified-delivery](verified-delivery/SKILL.md) | Carries existing delivery authority; never grants merge or deployment permission |
- | Find the cause of a failing test or incident | [systematic-debugging](systematic-debugging/SKILL.md) | Diagnosis before a repair; incident management and runtime containment retain their owners |
- | Is this customer problem worth further investment? | [product-discovery](product-discovery/SKILL.md) | External problem evidence before requirements; enthusiasm is not validation |
- | Set product direction or choose the next product decision | [product-strategy](product-strategy/SKILL.md) / [product-methodology](product-methodology/SKILL.md) | Strategy versus tactical scope and priorities |
- | Support founder operations or an executive operating rhythm | [chief-of-staff-methodology](chief-of-staff-methodology/SKILL.md) | Prepare and coordinate decisions; the accountable human decides |
- | Design repeatable business operations and handoffs | [operational-design](operational-design/SKILL.md) | Business process design; software delivery and financial models keep separate owners |
- | May this agent act? | [ai-governance](ai-governance/SKILL.md) | Scoped earned-autonomy decision, then runtime enforcement |
- | May this capability enter our environment? | [ai-governance](ai-governance/SKILL.md) | Capability admission is separate from an agent's runtime authority |
- | Should we scale this AI pilot? | [ai-operating-economics](ai-operating-economics/SKILL.md) | Outcomes, full intervention costs, uncertainty and governance; adoption can be constrained or stopped |
- | Grill this specification or proposal | [product-discovery](product-discovery/SKILL.md) | Read the draft, ask one consequential question, preserve unresolved evidence |
- | Why did this agent fail, and may it resume? | [agent-trust routes](references/agent-trust-routes.md#failure-and-resumption) | Diagnosis, containment, incident evidence and renewed authority are separate decisions |
- | Can the agent weaken its own controls? | [agent-trust routes](references/agent-trust-routes.md#protected-controls) | Protect supervisory assets and independently verify current control state |
- | Can humans supervise this volume of agent work? | [agent-trust routes](references/agent-trust-routes.md#supervisory-capacity) | Assess workload, review capacity and reserved decisions; no validated new bundle is implied |
- ## Skills
- ### [actuarial-risk-modeling](actuarial-risk-modeling/SKILL.md)
- Expert statistical modeling for insurance, actuarial, and financial-risk decisions, including regression, GLMs, claims, forecasting, calibration, tail risk, and model governance.
- ### [adr-authoring](adr-authoring/SKILL.md)
- Preserve the reasoning behind consequential architecture choices so later contributors can understand, revisit, or supersede them responsibly.
- ### [agent-council](agent-council/SKILL.md)
- Multi-agent structured debate system — spawn a panel of expert agents to debate any question with convergence-aware iteration. Produces a decision landscape with confidence diagnostics, shared risks, remaining disagreements, and a principal's path narrative. Ships as a pip-installable Python package built on PydanticAI + PydanticGraph. `pip install pydantic-ai && pip install agent-council` and one API key to run your first debate.
- ### [agent-evals-and-observability](agent-evals-and-observability/SKILL.md)
- Design and review framework-neutral AI-agent evaluations, trajectory evidence, risk-tiered release gates, and privacy-aware observability. Covers datasets, grader calibration, statistical comparisons, incident-to-case learning, optional OpenTelemetry interoperability, and templates for durable evidence.
- ### [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.
- ### [agent-skills](agent-skills/SKILL.md)
- Reference for the Agent Skills open format itself — directory structure, frontmatter schema, naming conventions, and progressive disclosure model. Use this meta-skill when creating or reviewing any other skill in this repository.
- ### [ai-governance](ai-governance/SKILL.md)
- Design and operate an organization's AI governance system: 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 or maturing a governance program, tiering use-case risk, reviewing an LLM or agent system for governance and safety gaps, mapping a regulation to a compliance plan, or preparing board reporting. Do not use for legal interpretation (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)
- Decide whether an AI-enabled workflow should be adopted, scaled, constrained, redesigned, or retired by connecting workflow outcomes, worker or user effects, quality guardrails, full operating cost, telemetry, uncertainty, and accountable governance. Routes detailed financial, statistical, analytics, evaluation, runtime, governance, and launch work to the owning specialist skills.
- ### [amazon-memo](amazon-memo/SKILL.md)
- Choose, draft, and revise Amazon-style narrative decision memos, PR/FAQs, and shorter briefs. Includes evidence-led reasoning, practical human-readability revision, reading meetings, and adaptations that respect independent written cultures.
- ### [analog-occultism](analog-occultism/SKILL.md)
- Create subject-neutral images and videos in an analog occultism / industrial CRT noir aesthetic: near-monochrome archival technical atmosphere, severe low-key lighting, tactile signal degradation, industrial geometry, and quiet unresolved tension. Not for colorful cyberpunk, glossy advertising, conventional horror, or clean digital renders.
- ### [anydoc](anydoc/SKILL.md)
- Convert Word, PowerPoint, Excel, OpenDocument, RTF, EPUB, CSV, and text-based PDF documents to GitHub-Flavored Markdown locally with the Any Doc CLI. 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, for ebook packaging, or for OCR of scanned or image-only PDFs.
- ### [api-design-and-evolution](api-design-and-evolution/SKILL.md)
- Design, govern, document, review, and evolve consumer-facing HTTP, GraphQL, RPC, event, webhook, and streaming interfaces. Covers consumer jobs, domain semantics, API landscapes, ownership, lifecycle, topology, contracts, failure behavior, compatibility, deprecation, migration, and deployed-boundary verification. Do not use for product discovery, platform operations, full security assessment, ADR authoring, or delivery gates.
- ### [artifact-pyramids](artifact-pyramids/SKILL.md)
- Structure durable research work so people and agents can start with conclusions, then inspect the analysis and underlying evidence only when needed.
- ### [ascii-city-engine](ascii-city-engine/SKILL.md)
- Build portable, first-person colored ASCII city engines and small GIS-derived city packs. Covers terrain-following pedestrian physics, raycast-to-character-grid rendering, a pluggable city-provider JSON contract with an offline validator, reproducible public-GIS ingestion, and a committed downtown Raleigh sample pack. Not for WebGL/3D games, multi-level interiors, or committing full-resolution GIS archives.
- ### [autogen](autogen/SKILL.md)
- An expert-level skill for building **conversational multi-agent systems** with Microsoft's AutoGen framework. Unlike graph-based or role-based orchestration, AutoGen uses **agent-to-agent conversations** as the orchestration primitive.
- ### [backend-engineering](backend-engineering/SKILL.md)
- Design and implement backend services and APIs — REST, gRPC, GraphQL endpoint patterns, clean/hexagonal/layered services, event-driven handlers, outbox/inbox delivery, migration coexistence, database access, integrations, errors, and service-level testing. Language agnostic; routes API contracts, decomposition strategy, cross-system migration, data engineering, and platform provisioning to their owners.
- ### [binary-analysis](binary-analysis/SKILL.md)
- Plan static PE, ELF, Mach-O, and firmware investigations with a deterministic CLI. Live Ghidra operations are currently unimplemented and fail explicitly; project administration and dependency diagnostics are available. Fixture-derived results are not evidence about a supplied binary.
- ### [bmad](bmad/SKILL.md)
- Run the BMad method (Breakthrough Method of Agile AI-Driven Development) as a harness-agnostic control-plane protocol: compress human intent into a five-field contract, 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. Use for intent capture, bounded implementation, review, and resumability in any agent harness.
- ### [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. Ships 7 templates, a brand-book CLI for validation/compilation, and a generate script for brand card and mockup imagery.
- ### [c4-diagramming](c4-diagramming/SKILL.md)
- Make system boundaries, responsibilities, and relationships legible at the architectural level appropriate to the reader.
- ### [camera-hacking](camera-hacking/SKILL.md)
- Investigate, reverse-engineer, develop and validate digital-camera extensions and interoperability. Includes source-bound references across 43 manufacturer families, detailed Fujifilm X and Ricoh GR maps, experiment/recovery guidance and assessment templates. Distinguishes offline evidence from verified camera behavior.
- ### [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. Covers growth forecasting, peak sizing, degraded-mode capacity, multi-tenant demand distributions and skew, pooled/siloed headroom, tier-linked admission and fairness evidence, tenant-variable unit cost, budget/quota controls, representative load/soak evidence, and SLO-cost tradeoff records. Routes SaaS architecture, security, financial outcomes, infrastructure implementation, SRE, analytics, and general architecture to their specialist owners. Ships focused references, six fillable templates, and ten evals.
- ### [chief-of-staff-methodology](chief-of-staff-methodology/SKILL.md)
- Support chief of staff (CoS), executive operations, and founder operations: decision support, operating rhythm, strategic attention, briefing, information triage, and institutional memory for solo operators or organizations. Preserve accountable human authority and route meetings, org design, business processes, and authorized task changes to their owners.
- ### [cli-builder](cli-builder/SKILL.md)
- Build and refactor CLI tools for AI agent consumption. 10 universal patterns (non-interactive, `--json`, `--dry-run`, idempotent, lazy auth, progressive help), an agent-compatibility test suite, a Python API client pattern, and a bash scaffold template. Principles grounded in real failures from building 15+ agent-facing CLIs.
- ### [cncf-landscape](cncf-landscape/SKILL.md)
- Discover and compare cloud-native technologies from the live CNCF Landscape API, then turn the evidence into a constraint-aware shortlist with trade-offs, unknowns, and a bounded validation plan. Ships a stdlib-only query CLI, API caveats, a decision framework, an output template, and six evals.
- ### [code-review](code-review/SKILL.md)
- Review a change for correctness, security, maintainability, and test adequacy, and reach a verdict the evidence supports. Covers scoping and attention budgets, risk tiers, a 13-class defect taxonomy, severity-labeled comments, verdict and residual-risk records, AI-authored and AI-reviewed changes, and review metrics that resist gaming. Grounded in Google's engineering practices, the Microsoft and Google review studies, and recent AI-review deployments. Ships a read-only diff-scope tool with test mapping and risk flags, a review-record checker, five fillable templates, and eleven evals.
- ### [color-management](color-management/SKILL.md)
- Expert-level ICC profile color management for open-source workflows. Covers color science fundamentals (CIELAB, xyY, chromaticity), working space selection (sRGB, ProPhotoRGB, ACEScg, Rec.2020), ICC profile operations (convert, assign, extract, embed), gamut analysis, sRGB variant comparison, and color difference (dE) computation. Ships 6 Python scripts that wrap ImageMagick, ArgyllCMS, Exiftool, and LittleCMS; 5 reference files covering overview, operations, tool commands, working space data, and a full glossary. Distilled from Elle Stone's ninedegreesbelow.com and Bruce Lindbloom's color science resources.
- ### [community-guides](community-guides/SKILL.md)
- Create, adapt, and revise practical community guides with local evidence, participant activities and worksheets, facilitator instructions, and maintenance plans. Supports short workshops and longer programs, with an original apartment-community example, an offline consistency checker, and eight output-quality eval scenarios.
- ### [conditional-customer-success](conditional-customer-success/SKILL.md)
- A conditional skill for products with recurring human relationships — success plans, health evidence, renewal and expansion signals, QBRs, escalation, and closed-loop Voice of Customer. Declines to load for products without accounts, renewals, QBRs, or a customer-success team (internal tools, transactional products, public services without account-based engagement). Provides four product-model adaptations (B2B subscription, transactional, public-service, internal product), reference material on privacy and human-judgment boundaries, and four templates (applicability decision, success plan, health/risk record, escalation and feedback closure).
- ### [confluence-cli](confluence-cli/SKILL.md)
- Atlassian Confluence from the terminal. List spaces, browse pages, view content with body extraction, search with CQL, and create pages. Same API token as Jira.
- ### [constrained-optimization](constrained-optimization/SKILL.md)
- Formulate and evaluate constrained allocation, routing and scheduling decisions with explicit feasibility, objective units, exact or heuristic baselines, repeatable comparisons and honest solver-status evidence.
- ### [copy-editor](copy-editor/SKILL.md)
- Copyedit text for correctness, consistency, clarity and faithful meaning across publishing contexts. Includes intervention judgment, author queries, style sheets, protected technical material, coordinated editing passes and reusable handoff templates.
- ### [crewai](crewai/SKILL.md)
- An expert-level skill for building **role-based multi-agent teams** with CrewAI. Agents are defined as Roles with Goals and Backstories; crews are composed with sequential or hierarchical workflows.
- ### [crm](crm/SKILL.md)
- Operate HubSpot CRM from the terminal: list and search contact records, view deal pipeline stages, and move deals between stages with confirmation. Ships a bounded stdlib CLI (contacts list/get/search, deals list/update-stage, pipelines list) with `--json`, `--limit`, and a `--dry-run`/`--yes` mutation gate for stage changes.
- ### [crowdsec](crowdsec/SKILL.md)
- Deploy, configure, and manage CrowdSec — the open-source, collaborative IPS/IDPS/WAF. Covers Security Engine installation (Linux, Docker), cscli hub management, remediation components (firewall, Traefik, Nginx), AppSec WAF, profiles, notifications, blocklists, CTI, metrics, and production best practices. Ships 7 reference files for deep dives into config, AppSec, Docker, Traefik integration, database backends, hub collections, and troubleshooting.
- ### [cryptpad](cryptpad/SKILL.md)
- Integrate CryptPad encrypted collaborative editors with explicit storage and session-key ownership. Includes public instance discovery, secret-safe link inspection, browser callback templates, and operational diagnostics.
- ### [cyberpunk](cyberpunk/SKILL.md)
- Create or analyze original settings, scenes, world operations, and image direction through the material, social, and human-scale logic of William Gibson’s Sprawl fiction. Distinguishes canon, inference, and original adaptation; does not imitate Gibson’s prose or continue named canon.
- ### [daily-life-discovery](daily-life-discovery/SKILL.md)
- Guide a consent-based conversation that helps people discover how an AI agent could improve their day-to-day life, then match those needs to verified capabilities, reusable skills, and focused platform CLIs.
- ### [data-architect](data-architect/SKILL.md)
- Act as a virtual data architect. Discover data assets, assess maturity, evaluate platforms, design architectures, establish governance, and create migration plans. Covers modern data patterns (data mesh, data lakehouse, streaming, real-time analytics) with vendor evaluation frameworks and maturity models.
- ### [data-cleaning](data-cleaning/SKILL.md)
- Clean, profile, validate, reshape, and document messy data through an evidence-first, reproducible workflow with reusable plans, contracts, reports, and a dependency-free profiler.
- ### [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)
- PhD-level expertise in data science, statistics, and machine learning. Rigorous statistical methodology, experimental design, causal inference, Bayesian analysis, model selection and diagnostics, and research-grade communication. Ships five analysis scripts (power analysis, assumption diagnostics, model comparison, effect size calculator, experimental design generator) with Python + R dual-language support.
- ### [de-spin](de-spin/SKILL.md)
- Analyze propaganda, spin, selective framing, deceptive marketing, and AI-generated persuasion by tracing claims to evidence and separating literal truth from implied conclusions. Produces a calibrated assessment of what is true, false, misleading, complicated, unsupported, or unknown, with an evidence ledger and a decision-safe next step.
- ### [digital-twin](digital-twin/SKILL.md)
- Design and operate trustworthy digital twins and federated twin universes for software systems, engineering processes, infrastructure, agentic software factories, and cyber-physical operations. Covers architecture, synchronization, provenance, simulation, VVUQ, twin health, authority, governance, lifecycle, and decommissioning. Do not use for ordinary dashboards, static dependency graphs, or one named infrastructure tool without a twin-specific feedback loop.
- ### [docker-compose](docker-compose/SKILL.md)
- Define, run, debug, and harden multi-container applications with Docker Compose. Covers the Compose Specification, lifecycle and healthchecks, service networking, volumes, secrets, profiles, interpolation, overrides, Compose Watch, CI, production patterns, and troubleshooting. Ships 9 references, 5 templates, and a portable diagnostics script.
- ### [documents](documents/SKILL.md)
- Generate, inspect, validate, and fix PDF, Word (.docx), Excel (.xlsx), and PowerPoint (.pptx) documents through one shared workflow (scope, content model, template, render, validate, deliver) with per-format references, generation templates, and a stdlib validation script that performs structural sanity plus a render check with graceful degradation when no renderer is installed.
- ### [dsm5](dsm5/SKILL.md)
- Assess and explain mental health and neurocognitive questions against DSM-5-TR diagnostic criteria, and guide evidence-based conversations for clinicians, patients, and family members. Use for symptoms, possible conditions, differential diagnoses, criteria, prevalence, and specifiers — not for formal diagnosis, treatment decisions, crisis intervention, or legal/insurance determinations.
- ### [dspy](dspy/SKILL.md)
- An expert-level skill for **programmatic prompt optimization** with Stanford's DSPy framework. You write Python programs with typed signatures; DSPy optimizes the prompts automatically. This is the framework for prompt engineering that doesn't feel like engineering.
- ### [electronics](electronics/SKILL.md)
- Design, review and troubleshoot electronic circuits with component evidence, worst-case calculations, interface contracts and staged bench verification. Includes detailed references and reusable design, calibration, measurement and fault-isolation templates.
- ### [email](email/SKILL.md)
- Send and diagnose transactional email through Twilio SendGrid: send with `--dry-run`/`--yes` confirmation, check deliverability (bounces and spam reports), and verify Signed Event Webhook signatures with a self-contained ECDSA P-256 verifier. Ships a bounded stdlib CLI with `--json` and `--limit`.
- ### [enterprise-architecture](enterprise-architecture/SKILL.md)
- Connect enterprise outcomes to capabilities, value streams, application and information portfolios, operating models, decision rights, and feasible transition architectures. Keeps system design, organization design, product roadmaps, technology posture, and corporate strategy with their neighboring owners.
- ### [epub](epub/SKILL.md)
- EPUB file format expert — read, write, edit, convert, and repair EPUB2/EPUB3 ebooks.
- Ten CLI scripts: structure inspection, text extraction, knowledge extraction (LLM mode
- via env vars), scaffold creation, surgical editing, image extraction, batch processing,
- EPUB2→3 conversion, repair, and validation. Eight reference files covering format
- internals, Python libraries, spec/validation, tutorials, capability discovery,
- fixed-layout, accessibility, and media overlays. Portable across any AgentSkills harness.
- ### [esp32-development](esp32-development/SKILL.md)
- Build, configure, flash, test, debug, and recover complete ESP32 systems across ESP-IDF C/C++, Arduino/PlatformIO, MicroPython, CircuitPython, ESPHome, Zephyr, Rust, and NuttX. Covers board and pin identification, electrical safety, sensors, actuators, buses, networking, sleep, OTA, production security, native command-line tools, and evidence-first troubleshooting. Ships focused references, safe bring-up templates, a non-mutating host preflight, and safety evals.
- ### [ffmpeg](ffmpeg/SKILL.md)
- Expert FFmpeg command-line guidance for inspecting, remuxing, transcoding, filtering, combining, streaming, and troubleshooting media with explicit mappings, build-aware assumptions, and post-run verification.
- ### [financial-modeling](financial-modeling/SKILL.md)
- Build and review assumptions-led financial models, unit economics, pricing, fundraising scenarios, and SaaS operating metrics.
- ### [fireflies](fireflies/SKILL.md)
- Fireflies.ai meeting intelligence from the terminal. Query transcripts, summaries, analytics, AskFred, and workspace data through source-faithful GraphQL documents; safely preview confirmed mutations and verify Webhooks V2 signatures locally.
- ### [flaresolverr](flaresolverr/SKILL.md)
- Use a private FlareSolverr service through a dependency-free JSON CLI when ordinary HTTP retrieval is blocked by a browser challenge.
- ### [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.
- ### [forgejo-cli](forgejo-cli/SKILL.md)
- Safe Forgejo API v1 CLI for issues, pull requests, repositories, file contents, metadata, webhooks, and user settings. Includes a guarded generic `/api/v1/` route for version-specific endpoints such as Actions and admin APIs.
- ### [forward-deployed-engineering](forward-deployed-engineering/SKILL.md)
- Carry an embedded technical engagement from an ambiguous need to an adopted, measurable capability and a deliberate generalization decision across discovery, build, deployment, adoption, and field learning.
- ### [fpga-development](fpga-development/SKILL.md)
- Design and verify FPGA logic with RTL contracts, arithmetic analysis, self-checking simulation, clock/reset and CDC review, timing constraints and reproducible release evidence. Includes dense references, engineering templates and an original executable ready/valid buffer fixture.
- ### [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.
- ### [gap-analysis](gap-analysis/SKILL.md)
- Conduct evidence-based gap analyses that compare a defined current state with a justified target state, characterize uncertainty and causes, prioritize action, and produce traceable registers, roadmaps, and decision records.
- ### [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)
- Ghost CMS from the terminal. Manage posts and pages, list tags, and check site info. Admin API key from Ghost Integrations. JWT authentication handled automatically.
- ### [github-runner](github-runner/SKILL.md)
- Deploy, manage, and troubleshoot self-hosted GitHub Actions runners. Covers systemd, Docker, Kubernetes (ARC), and Scale Set Client deployments.
- ### [go-to-market](go-to-market/SKILL.md)
- CMO methodology — 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), competitive response (pricing wars, feature races, brand defense).
- ### [grafana](grafana/SKILL.md)
- Operate Grafana OSS, Enterprise, and Cloud with version-aware discovery, decision-oriented dashboards, end-to-end alert routing, explicit as-code ownership, evidence-led troubleshooting, and guarded security or production changes.
- ### [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, and classify fiction vs non-fiction. Ships a portable Python CLI with zero external dependencies.
- ### [harness-engineering](harness-engineering/SKILL.md)
- Design, build, diagnose, and evolve agent harnesses across instructions, tools, environments, durable state, context, verification, recovery, and bounded loops. Ships safe scaffolding, structural audits, explicit check execution, and evidence-based improvement patterns.
- ### [haystack](haystack/SKILL.md)
- An expert-level skill for building **production search and NLP pipelines** with Haystack. Pipelines are validated DAGs with typed components and explicit connections.
- ### [hugo-theme](hugo-theme/SKILL.md)
- Build, customize, and debug advanced Hugo CMS themes. Covers template architecture, asset pipeline (Hugo Pipes, Tailwind CSS, PostCSS, images), shortcodes and render hooks, page bundles and content adapters, Hugo Modules, performance optimization, SEO/structured data, design/UX/accessibility, custom output formats, and CI/CD. Ships 7 reference files covering each topic area.
- ### [implementation-planning](implementation-planning/SKILL.md)
- Turn an approved requirement or specification into an executable, dependency-aware delivery plan. Covers work breakdown into vertical slices, dependency mapping with critical-path analysis, ownership assignment, sequencing and parallelism, staged rollout strategy with rollback paths, and verification traceability against the original requirement. Supports cross-team, cross-repository, data migration, and staged-rollout scenarios. Does not plan unapproved work — entry gate enforces prerequisite approval.
- ### [incident-learning](incident-learning/SKILL.md)
- Convert operational incident and near-miss evidence into verified, owned improvements across product, code, tests, evals, operations, and governance. Separates observed facts from causal hypotheses and unresolved uncertainty; maps escaped-from gaps (requirements, monitoring, authority, migration, adoption); assigns domain-specific follow-up work with owners and verification methods; and requires evidence of the implemented change — not just tickets — for closure. Routes implementation to SRE, QA, verification, agent evals, product lifecycle learning, implementation planning, resilience-and-recovery, and production-readiness. Ships 4 references (discovery brief, evidence/inference taxonomy, escaped-from analysis, follow-up domains, verification and closure), 4 templates (incident-learning record, causal/evidence ledger, follow-up work map, verification and closure record), and 5 evals.
- ### [infographic](infographic/SKILL.md)
- Create source-grounded visual explanations for any audience. Separates information structure from fourteen distinct visual treatments, with capability-aware rendering, exact data/text checks, accessibility, and final polish. Includes adaptable briefs, composition prompts, and behavioral evals.
- ### [jellyfin](jellyfin/SKILL.md)
- Jellyfin media server from the terminal. Log in as a user or use an API key, check server info, browse recently added and library contents, search and inspect media, walk series/seasons/episodes, see next-up episodes, and view statistics — with MediaBrowser auth, user-id scoping, and response-shape quirks documented.
- ### [jira](jira/SKILL.md)
- Atlassian Jira from the terminal. Search issues with JQL, view details, create issues, add comments, count matches, list projects, and transition status. Includes a full JQL reference (functions, history predicates, date expressions) plus REST auth/pagination guidance. API token from id.atlassian.com.
- ### [job-interview-coaching](job-interview-coaching/SKILL.md)
- Prepare for job interviews, review transcripts, practise with interactive mock interviews, and design fair, evidence-based interviews as a hiring practitioner. Adapts to occupation, responsibility level, and assessment format.
- ### [kanban-guru](kanban-guru/SKILL.md)
- A virtual Kanban expert for engineering teams. Diagnose flow problems, design board configurations, calibrate WIP limits, establish service level expectations, set up multi-portfolio operating models, and navigate Scrum-to-Kanban transitions. Covers all seven cadences, classes of service, Little's Law, flow metrics, and the full practitioner's playbook with rich reference material.
- ### [kubernetes](kubernetes/SKILL.md)
- Operate and troubleshoot Kubernetes safely across upstream Kubernetes, k3s, RKE2, MicroK8s, k0s, Talos, OpenShift/OKD, kind, Minikube, Rancher, EKS, AKS, and GKE. Covers workloads, APIs, version skew, networking, storage, scheduling, autoscaling, security, policy, backups, upgrades, observability, and evidence-first diagnosis. Ships the agent-first `k8s-cli` wrapper, diagnostic scripts, templates, and dated source references.
- ### [langchain](langchain/SKILL.md)
- An expert-level skill for building LLM-powered applications with LangChain — the most widely adopted LLM orchestration framework. LCEL chains, RAG pipelines, agents, LangSmith observability, and LangServe deployment.
- ### [langgraph](langgraph/SKILL.md)
- Build multi-agent AI systems with LangGraph — the low-level orchestration framework for stateful, graph-based agent workflows using directed graphs. Covers all major patterns: supervisor (centralized routing node, ~94% accuracy), swarm (direct agent-to-agent handoffs, ~40% fewer LLM calls), and hierarchical teams (subgraph composition with nested state). Includes state management (checkpointers/stores), persistence, production debugging, and evaluation methodology. Ships 3 Python scripts (supervisor scaffold, swarm scaffold, eval generator), 3 runnable templates, and 8 reference files covering architecture, each pattern in depth, evals, production failures, and troubleshooting.
- ### [lastfm](lastfm/SKILL.md)
- Last.fm music data API from the terminal. Lookup user listening history, get artist/album/track metadata, discover similar music via collaborative filtering, explore global and per-country charts, search, manage tags, and scrobble listening events. API key from last.fm/api/account/create (free). Includes a music discovery pipeline for turning liked tracks into recommendations.
- ### [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).
- ### [life-coach](life-coach/SKILL.md)
- Guide bounded, user-led coaching for adult nonclinical goals, decisions, transitions, habits, ambivalence, accountability, and progress review. Keeps choices with the person, routes direct requests and specialist needs correctly, and includes expert references, original templates, safety and anti-dependency boundaries, deployment controls, and a capability-contract validator.
- ### [linear](linear/SKILL.md)
- Work with Linear teams, projects, cycles, issues, comments, workflow transitions, and documents using a small, dependency-free GraphQL CLI with bounded reads, dry-run previews, and focused reference guidance.
- ### [litellm](litellm/SKILL.md)
- Operate, configure, secure, and troubleshoot the LiteLLM AI gateway (proxy) and Python SDK: one OpenAI-compatible config routing to 100+ providers, model lists and load-balanced groups, virtual keys/teams/budgets/rate limits, caching and guardrails, observability and spend, deployment and public-facing hardening, and evidence-led failure diagnosis. Ships a read-only `litellm-health` probe (`--json`), proxy-config and deployment record templates, 9 dated references, tests, and 6 evals. Routes engine selection to ml-engineering and single-engine operation to vllm/llama-cpp.
- ### [llama-cpp](llama-cpp/SKILL.md)
- Operate llama.cpp from hardware-aware installation and GGUF selection through verified local inference, OpenAI-compatible serving, reproducible tuning, multi-GPU operation, and evidence-led troubleshooting. Uses dated upstream sources, operation and benchmark templates, and six output-quality eval cases without adding a wrapper CLI.
- ### [llamaindex](llamaindex/SKILL.md)
- An expert-level skill for building LLM applications over your data with LlamaIndex. RAG pipelines, multi-agent orchestration, event-driven workflows, knowledge graph construction, and production deployment.
- ### [managing-editor](managing-editor/SKILL.md)
- Coordinate editorial work from intake through publication across news, books, journals, magazines, digital content, and organizational publishing. Includes decision-right mapping, quality and correction workflows, contributor communication, bounded subagent delegation, and reusable planning and release templates.
- ### [meetings](meetings/SKILL.md)
- Plan purposeful meetings, relationship-sensitive one-on-ones and invitees; establish decision processes, facilitate discussion, review recurring meetings and follow agreed work. Offers accessibility options to everyone, retains stated preferences through authorized private memory, and preserves decisions, dissent and proportionate organizer follow-up. Distinguishes proposals from commitments and preserves normal authorization for invitations, notes and task writes.
- ### [mermaid-diagrams](mermaid-diagrams/SKILL.md)
- Create maintainable diagrams that render reliably in the documentation surfaces where readers actually encounter them.
- ### [meshcore-packet-capture](meshcore-packet-capture/SKILL.md)
- Operate MeshCore Companion radio packet capture over BLE, serial, or TCP. Covers MQTT publishing, TOML and environment configuration, token authentication, Docker, systemd, launchd, NixOS, and evidence-first troubleshooting.
- ### [migration-engineering](migration-engineering/SKILL.md)
- Plan and execute safe cross-system migrations, including service extraction from monoliths, with compatibility windows, dual-running, backfills, reconciliation, cutover, deprecation, and cleanup. Distinguishes rollback, roll-forward, restore, and irreversible recovery paths. Routes implementation to API, data, platform, release, and SRE specialists, while leaving decomposition decisions to the architecture owner.
- ### [ml-engineering](ml-engineering/SKILL.md)
- Machine learning engineering methodology — model training, fine-tuning (LoRA/QLoRA), evaluation, quantization, deployment, and MLOps pipeline design. Grounded in practical engineering patterns for production ML systems.
- ### [mobile-development](mobile-development/SKILL.md)
- Build, test, sign, and ship mobile apps across iOS, Android, Flutter, and React Native as ONE family skill with per-framework references: project scaffolding, builds and code signing, device and emulator testing, store submission (App Store/TestFlight and Google Play), app lifecycle and backgrounding, offline and sync, and mobile-specific testing. Ships 4 framework references (ios, android, flutter, react-native) and 6 evals. Routes web UI work to frontend-engineering and server-side work to backend-engineering.
- ### [multi-agent-coordination](multi-agent-coordination/SKILL.md)
- Design and diagnose coordination across agent harnesses: decomposition and topology, owned work, distributed context, communication, integration, recovery and shared learning. Includes research and comparative lessons from OpenRig, HERDR and Block/Buzz, practical templates, and a read-only snapshot/exposure helper. Routes runtime mechanics to harness-engineering and production controls to agent-production-operations.
- ### [multi-tenant-saas-architecture](multi-tenant-saas-architecture/SKILL.md)
- Design end-to-end multi-tenant SaaS architectures by connecting tenant semantics, control/application planes, tenancy and partitioning choices, onboarding, entitlements, metering, billing handoffs, lifecycle, restore, noisy-neighbor behavior, and tenant-aware operations. Routes security, capacity, finance, platform, API, implementation, data, migration, and privacy details to their specialist owners.
- ### [neckbeard](neckbeard/SKILL.md)
- Evidence-driven software delivery operating model — routes a change through framing, discovery, design, implementation, review, verification, delivery, and learning, choosing the smallest *safe* intervention and proving it at the real delivery boundary. Every non-trivial run leaves an inspectable evidence ledger. Composes the specialist catalog rather than replacing it. Ships a versioned evaluation harness that measures SDLC outcomes, never LOC. Not a "10x developer" persona.
- ### [notion](notion/SKILL.md)
- Operate Notion from the terminal: retrieve pages, query databases, search pages and databases, and update page properties with confirmation. Ships a bounded stdlib CLI (pages get/create/update, databases query, search) with `--json`, `--limit`, and a `--dry-run`/`--yes` mutation gate for creates and updates.
- ### [nous-branding](nous-branding/SKILL.md)
- Generate images and content consistent with the Nous Research brand identity.
- Ships four reference images (color palette card, official high-res mascot,
- brand collage) that can be used as img2img inputs. Covers the Nous Girl
- mascot specs, cyber-classical art style, texture system (risograph grain,
- CRT scan lines, photocopy noise), hex-accurate color palette, and image
- prompt templates for text-only and reference-image-driven workflows.
- > **Cross-pollination note:** This skill was developed in parallel with [plntrprotocol/nous-branding](https://github.com/plntrprotocol/nous-branding) — a sibling project created independently, in friendship, for the same purpose. We've been learning from each other's approaches throughout development, and each repo has strengths the other doesn't. If you're using ours, go check out theirs too.
- ### [open-knowledge-format](open-knowledge-format/SKILL.md)
- Google's Open Knowledge Format (OKF) v0.1 — create, validate, and consume vendor-neutral AI agent knowledge bundles. Markdown files with YAML frontmatter, organized in directory hierarchies with cross-links and progressive disclosure. Ships a validation script, concept template, example bundle, and detailed references covering the spec, bundle architecture, and real-world use cases.
- ### [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 — no API key required.
- ### [opensource-contributions](opensource-contributions/SKILL.md)
- Comprehensive open source contribution guidance — from reading CONTRIBUTING.md and filing good bug reports through branching, committing, PR creation, and the release cycle. Covers both contributor and maintainer workflows with progressive disclosure: a concise orchestrator SKILL.md loads detailed phase references on demand. Includes a portable PR template compliance checker script. Agent disclosure template for AI-assisted contributions.
- ### [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).
- ### [pace-plan](pace-plan/SKILL.md)
- Build and maintain owner-approved Primary, Alternate, Contingency, and Emergency communications plans with explicit dependencies, authorities, transition triggers, check-ins, bounded exercises, troubleshooting evidence, and corrective actions. Preserves unknown local facts instead of inventing operational details or authority.
- ### [peertube](peertube/SKILL.md)
- PeerTube federated video from the terminal. Browse videos, channels, and comment threads on any instance, search instance-local or the whole fediverse via SepiaSearch, check server stats, and log in with OAuth2 — with per-instance token persistence and pagination/search-scope quirks documented.
- ### [performance-optimization](performance-optimization/SKILL.md)
- Measure and improve software performance through user-journey baselines, profiling, representative benchmarks, controlled experiments, and field verification. Includes guidance for missing telemetry, noisy measurements, proxy validation, regression ratchets, a reusable experiment record, and six output-quality evals. Routes stack-specific implementation to existing specialist skills.
- ### [platform-engineering](platform-engineering/SKILL.md)
- Infrastructure as code, CI/CD, container orchestration, service networking — methodology and reference patterns for building and operating internal developer platforms.
- ### [playwright](playwright/SKILL.md)
- Operate Playwright for browser automation: E2E test authoring with robust locators, network interception and mocking, parallel workers, CI integration, headless scraping, and accessibility snapshot checks. Ships a `pwrun` smoke harness (`--json`), a test-suite scaffold, 8 references, and 6 evals.
- ### [postgres](postgres/SKILL.md)
- Operate PostgreSQL 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. Ships the read-only `pgdiag` collector (`--json`, `--plan-for`, `--help` without a cluster), 9 dated references, tests, and 6 evals. Routes app data access to backend-engineering and schema design to data-architect/data-engineering.
- ### [privacy-engineering](privacy-engineering/SKILL.md)
- Translate privacy principles and legal requirements into verifiable engineering artifacts — data-lifecycle records, privacy acceptance criteria, data-flow and access maps, retention/deletion verification plans, and privacy change reviews. Covers seven privacy dimensions (purpose, lifecycle/retention, access, deletion, tenant/isolation, residency, consent) as structured concerns, with specific guidance for agent traces and product analytics telemetry. Routes legal interpretation to legal-strategy and security implementation to secure-software-engineering. Ships 1 discovery brief, 5 templates, and 6 evals.
- ### [product-adoption](product-adoption/SKILL.md)
- Diagnose and design product adoption — onboarding, activation, behavior change, feature discovery, rollout segmentation, and sustained use after launch. Covers consumer, B2B, internal-tool, and public-service contexts with evidence-based decision points (proceed, pause, stop, accelerate). Distinguishes acquisition, activation, adoption, retention, and expansion as separate stages with different owners and interventions. Ships 3 references (discovery brief, adoption lifecycle concepts, non-SaaS adoption contexts, behavior change and education) and 4 templates (adoption plan, activation/time-to-value diagnostic, segmentation and rollout record, sustained-use review).
- ### [product-analytics-and-measurement](product-analytics-and-measurement/SKILL.md)
- Turn intended product outcomes into observable, governed evidence. Covers metric trees (leading/lagging indicators, countermetrics, guardrails), event and tracking plans (identity, session, data quality, ownership), instrumentation QA, funnels, cohorts, retention, adoption, dashboard contracts, privacy-aware measurement, and decision cadence. Routes statistical inference to data-scientist and data pipelines to data-engineering.
- ### [product-design-and-ux](product-design-and-ux/SKILL.md)
- Turn validated evidence and approved product scope into traceable user-facing behavior: information architecture, plain-language content, task flows, applicable state and recovery models, interface contracts, authorized usability evidence, and observable engineering handoffs. Portable and framework-neutral; routes WCAG/ARIA depth to web-accessibility and formal software acceptance to spec-driven-development. Ships 10 focused references and 6 fillable templates.
- ### [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 specs. Phase 0 upstream of any spec-driven pipeline. Ships 8 reference files covering stakeholder mapping, question patterns, gap detection, conflict resolution, transcript-to-spec distillation, AI-conducted discovery, power dynamics, and time-constrained discovery; plus 5 templates (discovery plan, interview guide, distillation worksheet, gap register, interpretation log).
- ### [product-experimentation](product-experimentation/SKILL.md)
- Run end-to-end product experiments from assumption to decision — translate assumptions into testable hypotheses, select the right method (qualitative interviews, prototypes, concierge tests, fake doors, feature flags, A/B tests), define guardrails and ethics, and produce readouts that update the roadmap and decision record. Ships 4 references (discovery brief, method selection, guardrails and ethics, experiment readout) and 4 fillable templates (assumption map, experiment brief, guardrail and decision rule record, readout learning entry). Routes statistical design to data-scientist and rollout mechanics to release-engineering.
- ### [product-lifecycle](product-lifecycle/SKILL.md)
- Route a product through its full lifecycle — discovery, strategy and 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 stop/escalation rules. A thin orchestration bundle that provides cross-skill routing and a lifecycle evidence ledger; never duplicates a specialist's methodology. Ships 2 references (phases with per-phase contracts and ledger spec, capability map), a discovery brief, an AGENTS.md loading guide, and 6 evals covering complete lifecycle trajectories, stopped/escalated paths, and evidence handoffs. Does not assume B2B SaaS; customer-success routing is conditional on product type.
- ### [product-lifecycle-learning](product-lifecycle-learning/SKILL.md)
- Close the launch-to-learning loop for product features and capabilities — compare expected vs. observed outcomes using explicit epistemic categories (expected/observed/uncertain/inferred), update the assumption ledger, assess feature health across multiple dimensions, and make disciplined continue/improve/harvest/pivot/pause/retire decisions. Covers full retirement lifecycles with deprecation communication, migration paths, customer treatment during sunset, and internal cleanup. Produces durable retained learning records that feed back into roadmap, analytics, adoption, experimentation, and specifications. Ships 4 references (discovery brief, epistemic discipline, retirement lifecycle, feedback destinations) and 6 templates (outcome review, assumption ledger update, feature health record, retirement decision, sunset plan, retained learning record).
- ### [product-methodology](product-methodology/SKILL.md)
- Product management frameworks for translating validated evidence into prioritized backlogs, documented decisions, specifications, and stakeholder communications. Covers RICE scoring, MoSCoW prioritization, opportunity solution trees, decision logs, spec drafting, and audience-specific stakeholder communication. Ships 7 reference files covering each framework and a source index, plus 2 fillable templates (decision log and spec). Picks up where product-discovery ends.
- ### [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/opportunity, portfolio, roadmap, experiment, launch, lifecycle/health) with named accountable owners, minimum evidence standards per decision type, and escalation paths. Supports lightweight mode (small teams, minimal ceremony) and high-assurance mode (regulated/safety-critical) with configurable governance patterns. Distinguishes product governance from executive governance (routes to chief-of-staff-methodology, strategy-frameworks) and technical delivery gates (routes to release-engineering, spec-driven-development). Ships 1 reference (discovery brief), 5 fillable templates (operating model, decision-rights map, review cadence, exception record, escalation record), and 6 evals.
- ### [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 with continue/pause/kill/revisit criteria, capacity allocation, dependency and confidence mapping, scenario planning, stakeholder narratives, and roadmap review cadences. Routes tactical prioritization (RICE, MoSCoW, Kano, OST) to their canonical owners. Ships 5 reference files, 3 fillable templates, a discovery brief, and 5 evals.
- ### [product-shaping](product-shaping/SKILL.md)
- Set appetites instead of estimates and shape raw ideas into bounded pitches before committing time: Basecamp's Shape Up method adapted for teams whose builders include AI agents. Covers appetite-setting, problem narrowing (grab-bag detection), breadboard/fat-marker solution sketching including non-UI work, five-ingredient pitches, betting with circuit breakers, discovered scopes with hill-state tracking, scope hammering, and hybrid-adaptation practices — budget currencies, batched steering, verification cost inside scope, and kill criteria for non-converging agent loops. Ships 6 reference files (including an independent-evidence anti-patterns record), 2 fillable templates (pitch, scope map), and 6 evals. Upstream of product-methodology; consumes validated problems from product-discovery.
- ### [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)
- Cross-domain production gate model — assembles readiness, migration, recovery, capacity/cost, and incident-learning evidence into a launch or operational decision (go/no-go/defer/exception/escalation) with an accountable owner and a post-launch learning path. Composes 12 specialist skills (production-readiness, migration-engineering, resilience-and-recovery, capacity-and-cost-engineering, incident-learning, SRE, release, platform, security, data, QA, verification) without copying their runbooks. Ships 4 references (discovery brief, evidence packet, gate model, handoff record) and 5 integrated evals covering normal release, blocked launch, data migration, dependency outage, and cost/SLO conflict.
- ### [production-readiness](production-readiness/SKILL.md)
- Assemble cross-domain production evidence into a risk-scaled launch decision. Defines three risk classes (Low/Standard/High) with proportional evidence requirements, an 11-category evidence checklist with named source or explicit gap for every category, and four launch-decision outcomes (Go/No-go/Defer/Exception) with accountable owners. Routes detailed technical checks to release-engineering, SRE, security, data, QA, platform, and implementation-planning. Ships 2 references (discovery brief, readiness record template) and 5 evals.
- ### [programming-principles](programming-principles/SKILL.md)
- Distilled coding principles from 14 classic software engineering books (Clean Code, DDD, Refactoring, Release It!, DDIA, Code Complete, and more). Cross-cutting principles organized by concern, task-to-book mapping, per-book mini and full rule sets, and a structured code-assessment workflow.
- ### [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. Covers delegation modeling, capability manifests and agent contracts, coordination-failure diagnosis, trust/verification calibration, and converting obligation-based designs to promise-based ones. Ships 7 references, 3 templates, a stdlib-only lint CLI, and 6 evals.
- ### [pydanticai](pydanticai/SKILL.md)
- Build production-grade AI agents and graph-based state machines with PydanticAI and PydanticGraph. Covers agent creation, function tools with RunContext dependencies, structured output validation, streaming (text/events/graph nodes), a 20+ capability plugin system with on-demand loading (Thinking, WebSearch, MCP, Hooks, etc.), 16 model providers with FallbackModel and concurrency limiting, multi-agent delegation and programmatic hand-off, comprehensive testing with TestModel/FunctionModel, and the PydanticEvals evaluation framework. Includes the full PydanticGraph API — both BaseNode (class-based) and GraphBuilder (function-based) with parallel map/broadcast operations, joins with reducers, decisions, Mermaid rendering, and step-by-step execution. Ships 8 reference files covering core agents, capabilities/hooks, graph, models/output, patterns/integrations, testing/evals, worked examples, and an API surface quick reference.
- ### [qa-methodology](qa-methodology/SKILL.md)
- QA and SDET methodology for senior-to-principal engineers — test strategy, automation, regression, risk-based prioritization, exploratory testing, mutation-guided test hardening, quality gates, AI code quality gates for agentic development, agentic eval design, career leveling, and SDET engineering. Ships 16 references, 6 templates, 3 assets, 2 tested scripts, and 10 evals.
- ### [raleigh](raleigh/SKILL.md)
- Query, search, and download public datasets from the City of Raleigh Open Data portal. Wraps the ArcGIS REST API to access 170+ datasets — crime reports, food inspections, building permits, bike lanes, parks, zoning, traffic, budgets, and more. No API key needed. Ships a Python CLI with catalog, search, info, query, download, and categories commands.
- ### [react](react/SKILL.md)
- React-specific component, hooks, state-flow, rendering, accessibility boundaries, testing, diagnostics, and Vite integration workflows.
- ### [release-engineering](release-engineering/SKILL.md)
- Senior-to-principal release engineering methodology — release process models and CD pipelines, progressive delivery and feature flags, versioning and artifacts, readiness gates, rollback planning, change-governance and compliance evidence, DORA metrics, and multi-team release coordination. Ships 15 references, 6 templates, 4 assets, 5 stdlib-only Python CLIs, and 8 evals.
- ### [remote-systems-administration](remote-systems-administration/SKILL.md)
- Administer and troubleshoot remote Linux, FreeBSD, NetBSD, OpenBSD, and macOS hosts safely, one system or a controlled fleet at a time. Covers SSH, Ansible, Paramiko, portable diagnostics, platform-specific services, packages, configuration, firewalls, rollback, and evidence-led verification.
- ### [research-and-vault](research-and-vault/SKILL.md)
- Run a repeatable research-to-notes sequence: gather sources, record URLs and dates, extract independent atomic claims, then create a durable note with explicit coverage gaps.
- ### [research-methodology](research-methodology/SKILL.md)
- Turn an open question into a bounded, evidence-led investigation rather than a plausible-sounding synthesis.
- ### [resilience-and-recovery](resilience-and-recovery/SKILL.md)
- Design, exercise, and evidence resilience and recovery behavior across systems and dependencies — graceful degradation, restore-based recovery, RTO/RPO decision records, game days, failover drills, data integrity verification, and recovery communication. Ships 7 references, 1 template, 1 discovery brief, and 5 evals.
- ### [restic](restic/SKILL.md)
- Install, configure, operate, secure, automate, tune, troubleshoot, and recover restic backups across local, SFTP, S3-compatible, cloud, and REST backends. Ships deep references for repository selection, backup design, retention/prune, restore drills, threat modeling, performance, observability, migration, and recovery, plus safe preflight and verification scripts and scheduling templates.
- ### [secure-software-engineering](secure-software-engineering/SKILL.md)
- Build security into software requirements, design, implementation, review, and release decisions. Covers threat modeling, authorization, data and secret handling, dependencies, tenant isolation, security evidence, incident learning, and AI boundaries without treating a checklist as proof of security.
- ### [security-audit-methodology](security-audit-methodology/SKILL.md)
- Give authorized teams a disciplined way to identify and prioritize security risks without mistaking a checklist for a security guarantee.
- ### [semantic-spacetime](semantic-spacetime/SKILL.md)
- Model and diagnose shared semantic ground between agents with Mark Burgess's Semantic Spacetime: discrete graph spacetimes where meaning evolves over time, typed gamma(3,4) edges expose semantic drift and absorbing states, and cooperative promises carry causality.
- ### [seo](seo/SKILL.md)
- Audit and improve visibility across traditional search, answer engines, and generative search, with provider-scoped evidence and reproducible measurement.
- ### [site-reliability-engineering](site-reliability-engineering/SKILL.md)
- Build practical reliability practices around the work teams actually perform: measurable service objectives, useful alerts, incident response, and learning-oriented follow-up.
- ### [slack](slack/SKILL.md)
- Operate Slack workspaces from the terminal: list channels, read messages, follow threads, search history, list files, and verify webhook signatures. Ships a bounded stdlib CLI with `--json`, `--limit`, and a `--dry-run`/`--yes` mutation gate for sends.
- ### [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 for greenfield or target architecture, modular-monolith decisions, distributed consistency and failure behavior, fitness evidence, and architecture reviews; route reverse engineering, interfaces, data, implementation, platform, security, and migration execution to their specialist owners.
- ### [software-architecture-analysis](software-architecture-analysis/SKILL.md)
- Reverse-engineer a software codebase to understand its architecture, data flow, privacy posture, feature surface, coupling, quality characteristics, data ownership, and workflow recovery — then produce an evidence-grounded clean-room design document, PRD, or migration plan under new constraints. Includes interface extraction, decomposition-readiness, and architecture health assessment guidance.
- ### [solarpunk](solarpunk/SKILL.md)
- Explore and practice solarpunk across visual art, fiction, everyday living, adaptive reuse, ecological design, community infrastructure, and hopeful collective futures. Includes globally adaptable guidance, annotated research, public examples, and creative and practical templates.
- ### [solo-startup](solo-startup/SKILL.md)
- Choose, validate, and operate a solo business within one founder's cash, time,
- distribution and support capacity. Connect customer evidence to a bounded offer,
- capacity-aware economics and a proceed/revise/stop decision, with primary-source
- research and routes to existing discovery, financial and operating skills.
- ### [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 pipeline phase. Covers the 5-phase pipeline (SPECIFY → DECOMPOSE → IMPLEMENT → VERIFY → DELIVER), 4 phase gates with APPROVED/CONDITIONS/REJECTED verdicts, 7 spec quality gates, a methodology selection matrix (BDD, OpenAPI, AsyncAPI, DbC, TLA+, ADRs, C4), NFR encoding patterns, format translation (PRD → SPEC.md → Gherkin → OpenAPI), gate recovery and revision workflows, and a worked example SPEC.md. Ships 4 templates, 9 reference files, and 2 validation scripts. Tool-agnostic — works with Claude Code, Cursor, Hermes Agent, Devin, OpenHands, and droid. Not for single small changes, the intent-to-delivery control-plane protocol (see bmad), or unvalidated problems (product-discovery).
- ### [spring-ai](spring-ai/SKILL.md)
- Build and diagnose Spring AI integrations with version-aware setup, ChatClient/advisors, retrieval, scoped memory, tool/MCP boundaries and observability. Includes a read-only Maven/Gradle diagnostic CLI with explicit static-analysis limits.
- ### [strategy-frameworks](strategy-frameworks/SKILL.md)
- Structure organizational strategy decisions about direction, industry structure, growth, capital allocation, acquisitions, and portfolios. Uses frameworks as prompts for evidence and trade-offs, not automatic recommendations.
- ### [stripe](stripe/SKILL.md)
- Read Stripe account state from the terminal — balance, payment intents, and subscriptions — with guarded subscription cancellations. Ships a read-only-first stdlib CLI with `--json`, `--limit`, and a `--dry-run`/`--yes` mutation gate for cancellations (period-end default).
- ### [supabase](supabase/SKILL.md)
- Develop, self-host, and administer Supabase across the CLI local stack, managed projects, and the official Docker deployment. Covers reproducible migrations, RLS and pgTAP testing, generated client types, Auth, REST, Realtime, Storage, Edge Functions, TLS, secrets, backups, restores, release-set upgrades, and evidence-led troubleshooting.
- ### [system-one](system-one/SKILL.md)
- Design, integrate, evaluate, self-host, and troubleshoot System One decision models such as TypeSafe Jev and Convai Innovations Laya: typed probabilistic judgments inside deterministic software, local/VPC inference, calibration, operations, and failure diagnosis.
- ### [systematic-debugging](systematic-debugging/SKILL.md)
- 4-phase root cause debugging protocol: understand bugs before fixing. Covers schema/environment divergence, exception type specificity in fallback chains, progressive characterization grids for API/retrieval failures, dependency source detection (editable dev forks), macOS sandboxed application debugging, and the Rule of Three for recognizing architectural problems. Adapted from [obra/superpowers](https://github.com/obra/superpowers) (MIT) with significant expansion from real-world use.
- ### [tabpfn](tabpfn/SKILL.md)
- Operate versioned tabular foundation-model checkpoints, labeled context, calibration and adaptation with a tested offline leakage/capacity screen and explicit weight-license boundaries.
- ### [tailscale](tailscale/SKILL.md)
- Self-hosted Tailscale/Headscale VPN ecosystem. Seven sub-skills covering Headscale server deployment, ACL/tailnet policy authoring, Tailscale client configuration, node lifecycle (auth keys, registration, tagging, decommissioning), subnet routing and exit nodes, DERP relay infrastructure, and backup/migration. Ships 23 scripts with `--json` and `--dry-run` support, 8 reference documents, and 6 templates.
- ### [teach-me](teach-me/SKILL.md)
- Learn through researched explanations, brief diagnostic tasks, adaptive practice, and corrective feedback. Separates assisted success from independent application, transfer, and delayed retention, and invites a break when the agreed goal is demonstrated.
- ### [technical-documentation](technical-documentation/SKILL.md)
- Make documentation useful at the moment someone needs to install, operate, extend, or troubleshoot a system.
- ### [technical-program-management](technical-program-management/SKILL.md)
- Manage technical programs made of multiple related projects, products, teams, or vendors: establish the program mandate and benefits, align component work, manage cross-project dependencies and shared capacity, govern risks and decisions, coordinate transformation and adoption, and communicate program health to executives, delivery teams, and partners. Complements technical-project-management rather than replacing single-project control.
- ### [technical-project-management](technical-project-management/SKILL.md)
- Manage technical projects from initiation through closure: choose and tailor delivery approaches, coordinate teams and vendors, maintain credible forecasts, handle scope changes, recover troubled projects, and hand off operations. Adapts to teams without a PM and experienced TPMs. Ships a research source ledger, four real-world cases, focused references, seven templates, a tested read-only schedule calculator, and output-quality evals. Routes detailed planning, Kanban, product choices, and release mechanics to their specialists.
- ### [technology-radar](technology-radar/SKILL.md)
- Turn technology preferences and architecture-governance choices into explicit, reviewable decisions with owners, evidence, and a proportionate adoption posture.
- ### [telemetry](telemetry/SKILL.md)
- Operate the Prometheus + OpenTelemetry + Loki observability stack as one unit: scrape config, recording and alerting rules, relabeling, retention, and HA; OpenTelemetry Collector pipelines (receivers, processors, exporters, sampling, trace/span correlation); and Loki ingest, LogQL, retention, and label design. Ships the read-only `telemetry-check` script (rule sanity + scrape-target reachability, `--json`), fixtures, tests, dated references, and 6 evals. Routes strategy to platform-engineering and dashboards to grafana.
- ### [tempest](tempest/SKILL.md)
- Hyper-local weather from a WeatherFlow Tempest station over the 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) with metric-native values and conversion guidance. Not for generic city forecasts without a station, or weather hardware from other vendors.
- ### [terraform](terraform/SKILL.md)
- Operate Terraform and OpenTofu safely 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. Ships the agent-first `tfops` wrapper with direct state-file analysis, a `--dry-run`/`--yes`/`--force` mutation gate, tests, and dated references.
- ### [three](three/SKILL.md)
- Build browser-based Three.js and WebGL scenes, animations, and interactive 3D visualizations.
- ### [tmdb](tmdb/SKILL.md)
- The Movie Database API from the terminal. Search and discover movies and TV by genre, certification, rating, and date range. Check trending, upcoming, and now playing. Free API key from themoviedb.org.
- ### [traefik](traefik/SKILL.md)
- Deploy, configure, secure, and maintain Traefik v3 reverse proxy — Docker provider, HTTP/TCP/UDP routing, TLS/ACME (Let's Encrypt), middlewares, observability, API, and production deployment. Covers the full static config schema, all 25+ built-in middlewares with YAML config, ACME certificate resolvers with DNS-01/HTTP-01/TLS-ALPN-01 challenges, Docker label reference for routers/services/middlewares, TCP/UDP routing with SNI matching, Prometheus/OpenTelemetry metrics and access logs, and production-ready Docker Compose deployments with security hardening. Ships 10 reference files covering every major feature area.
- ### [training-data-annotation](training-data-annotation/SKILL.md)
- Design reliable training-data annotation and active-learning workflows: label definitions, acquisition policies, representative audits, annotator conditions, adjudication, provenance and cost-quality stopping.
- ### [trakt](trakt/SKILL.md)
- Trakt.tv media discovery from the terminal. Browse trending, anticipated, and popular movies and TV shows. Read-only — uses only a Client ID, no OAuth required.
- ### [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.
- ### [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, research current logistics, and produce a cited PDF or responsive companion web page with private/shareable output options.
- ### [unsloth](unsloth/SKILL.md)
- Install and operate Unsloth Core, Studio, and Desktop for local inference, LoRA/QLoRA training, advanced objectives, checkpoint recovery, and verified model export. Includes offline environment and dataset checks, official-source research, and reproducible experiment guidance.
- ### [vercel-eve](vercel-eve/SKILL.md)
- Build, deploy, self-host, secure, and troubleshoot durable backend AI agents with Vercel Eve. Covers the filesystem-first agent project, typed tools, skills, subagents, connections, sandboxes, durable sessions, Vercel deployment, and the operational contracts required for a Node-hosted deployment.
- ### [verification-methodology](verification-methodology/SKILL.md)
- Replace completion claims with a disciplined evidence trail that shows what was checked, what passed, and what remains uncertain.
- ### [verified-delivery](verified-delivery/SKILL.md)
- Deliver an authorized change end to end — implement, verify, merge, and confirm the merged state — without losing the thread when a hard limit interrupts the work.
- ### [vite](vite/SKILL.md)
- Vite-specific configuration, plugins, modes, environment boundaries, dependency optimization, development server diagnostics, builds, previews, and deployment verification.
- ### [vllm](vllm/SKILL.md)
- Operate, configure, benchmark, and troubleshoot vLLM inference servers: Docker and Kubernetes deployment, quantization-aware model configuration (tensor parallelism, KV cache), the OpenAI-compatible API surface, throughput/latency benchmarking, continuous batching tuning, GPU operation, and upgrade/rollback. Ships a read-only `vllm-health` probe (`--json`), serving-config and benchmark-run-record templates, 7 dated references, tests, and 6 evals. Routes serving methodology to ml-engineering and the llama.cpp stack to llama-cpp.
- ### [waiting-list](waiting-list/SKILL.md)
- Design and build honest, resilient waitlist portals for anticipated goods and services, including interest lists, referral queues, virtual waiting rooms, appointment backfills, contact verification, runtime CRM delivery, and scarce-inventory allocation.
- ### [web-accessibility](web-accessibility/SKILL.md)
- Design, build, and review accessible web interfaces through native semantics, keyboard and focus contracts, error recovery, adaptive UI, assistive-technology testing, and WCAG 2.2-informed evidence without mistaking automated scans for conformance.
- ### [wonderer-methodology](wonderer-methodology/SKILL.md)
- Explore adjacent ideas and overlooked angles without prematurely choosing an answer. Produces bounded maps of distinct leads tethered to a seed, with explicit speculative status, search limits, and a handoff to deeper research. Adapted from hermes-profiles.
- ### [woodpecker-ci](woodpecker-ci/SKILL.md)
- Operate self-hosted Woodpecker CI from installation through production troubleshooting. Covers Forgejo/Gitea integration, server and agent setup, Docker and Kubernetes backends, workflow syntax, secrets, plugins, matrices, CLI/local execution, upgrades, security, and incident response.
- ### [workflow-architect](workflow-architect/SKILL.md)
- Discover your actual workflow through conversation or passive observation, then generate a tailored skills bundle that encodes it as loadable agent skills with trigger conditions. Dual mode: active interrogation (guided 8-15 question interview) or passive observation (analyzes session context from what you actually did). Output includes sub-skills per workflow phase, a manifest with trigger conditions, a Mermaid decision map, and optionally a kanban board if the workflow is linear. Keeps its guided interview inside the parent as a reference, with two sub-skills for observation and bundle generation, supporting references, templates, and worked examples.
- ### [writers-helper](writers-helper/SKILL.md)
- A complete writing companion for fiction and nonfiction: premise and planning, outlining and worldbuilding, research, drafting and finishing, editing and revision, creative blocks and prompts, writing habits, and the business of publishing — book proposals, query letters, synopses, agents, publishers, and book deals. Ships 10 expert references, 13 fill-in templates, and 5 Python tools (prompt generator, session planner, manuscript stats analyzer, habit journal, submission tracker). Distilled from a 44-book writing-craft and publishing library.
- ### [yc-default-alive-calculator](yc-default-alive-calculator/SKILL.md)
- Paul Graham's "Default Alive / Default Dead" framework as a deterministic CLI tool. Given revenue, burn rate, cash on hand, and growth rate, compute whether a startup will reach profitability before running out of money. Ships a month-by-month projection engine, burn multiple analysis, lever identification, and actionable verdict (ALIVE / DEAD / MARGINAL). Python 3.9+ with zero external dependencies.
- ### [yc-weekly-growth-compass](yc-weekly-growth-compass/SKILL.md)
- Paul Graham's "Startup = Growth" framework as an operational weekly practice. Computes growth rates from single-period or time-series data, benchmarks against YC tiers (1% concerning → 10%+ outstanding), projects compound growth, and frames every decision through the compass question: "Does this serve your target growth rate?" Python 3.9+ with zero external dependencies.
- ### [youtube-thumbnail](youtube-thumbnail/SKILL.md)
- Design truthful, compelling YouTube thumbnails with video-grounded concepts, title pairing, small-screen visual checks, current platform requirements, reusable briefs, and evidence-aware testing guidance.
- ---
- ## Installation
- Choose an installation method by how your harness discovers skills. Shared `SKILL.md` syntax does not imply shared search paths, tools, or update behavior.
- | Installation method | Use it for | Maintenance |
- |---------------------|------------|-------------|
- | [`skills` CLI](#skills-cli-cross-harness) | Supported harnesses, including OpenClaw | Update installed skills, or rerun `add` to include new catalog entries |
- | [Local checkout or skill directory](docs/harness-installation.md#local-checkout-or-skill-directory) | Harnesses that scan configured directories | Refresh the checkout, synchronize copies if used, then verify discovery |
- | [Harness-managed installation](docs/harness-installation.md#harness-managed-installation) | Native plugins, Moltis imports, ZeroClaw bundles | Use that harness's refresh and activation procedure |
- See the [harness installation and maintenance guide](docs/harness-installation.md) for OpenClaw, Moltis, PicoClaw, NullClaw, ZeroClaw, NanoClaw, Grok Bot, and Meta Muse, including known compatibility limits.
- ### `skills` CLI (cross-harness)
- Install the **full catalog** for your harness with the open [`skills` CLI](https://github.com/vercel-labs/skills) (requires Node.js 22.20+ with npm, and Git). Choose your harness's command below; these install globally for use across projects.
- | Harness | Install the full catalog |
- |---------|-------------------------|
- | OpenAI Codex | `npx skills add magnus919/agent-skills --skill '*' --agent codex --global --yes` |
- | Claude Code | `npx skills add magnus919/agent-skills --skill '*' --agent claude-code --global --yes` |
- | OpenCode | `npx skills add magnus919/agent-skills --skill '*' --agent opencode --global --yes` |
- | GitHub Copilot | `npx skills add magnus919/agent-skills --skill '*' --agent github-copilot --global --yes` |
- | Cursor | `npx skills add magnus919/agent-skills --skill '*' --agent cursor --global --yes` |
- | Gemini CLI | `npx skills add magnus919/agent-skills --skill '*' --agent gemini-cli --global --yes` |
- | OpenClaw | `npx skills add magnus919/agent-skills --skill '*' --agent openclaw --global --yes` |
- | Hermes Agent | `npx skills add magnus919/agent-skills --skill '*' --agent hermes-agent --global --yes` |
- Keep the quotes around `'*'` so your shell passes the wildcard to the CLI. For a project-only install, omit `--global` and run from the project directory. For Hermes, keep `--global`: its project-scoped `.hermes/skills/` target is not auto-discovered by Hermes.
- To inspect the catalog or install a smaller selection instead:
- ```bash
- npx skills add magnus919/agent-skills --list
- npx skills add magnus919/agent-skills --skill systematic-debugging --agent codex --global --yes
- ```
- `--skill` matches the name in `SKILL.md`. Top-level bundle umbrellas such as `neckbeard` are included.
- ### Updating and refreshing
- **Once a week, or whenever you want the latest catalog, rerun your harness's full-catalog install command above.** This refreshes the selection from this repository and includes newly added skills. Keep the same harness and global/project scope as your original install. Start a new agent session afterward unless your harness documents automatic refresh; verify that the refreshed skill is available.
- To update only skills you have already installed through the CLI, including those from other repositories:
- ```bash
- # Update globally installed skills
- npx skills update --global
- # Update project skills; run from that project's directory
- npx skills update --project
- ```
- The [CLI update command](https://github.com/vercel-labs/skills/blob/main/docs/commands.md#skills-update) updates installed skills; rerun the full-catalog `add` command to pick up new catalog entries. Refreshes can replace installed files, so keep personal edits in a separate skill or fork.
- Updates do not necessarily remove skills deleted or renamed upstream. Review obsolete entries separately, and use your installer's removal command for copies you no longer want.
- For native plugin installs or a mounted checkout, use the matching refresh instructions below or in the [maintenance guide](docs/harness-installation.md). Choose one installation method per harness to avoid duplicate skills.
- The [skills.sh catalog page](https://skills.sh/magnus919/agent-skills) is populated from installation telemetry rather than a separately submitted registry manifest.
- ### Repository validation
- Contributors need Python 3.10+ and Ruby 2.6+ for local development. CI currently runs the validation workflow with Python 3.12 and Ruby 3.3; the checked-in `.venv` uses the pinned development dependencies in `requirements-dev.txt`. Run the focused checks first, then the complete repository gate:
- ```bash
- python3 scripts/check-catalog-set.py
- python3 scripts/check-artifacts.py
- python3 scripts/validate-evals.py
- make validate
- ```
- `check-catalog-set.py` emits JSON by default and also accepts the explicit `--json` selector. It compares canonical top-level `SKILL.md` names with the Claude, Codex, Agents, and `llms.txt` projections, rejecting missing, extra, duplicate, retired, nested, or infrastructure entries. Regenerate projections from source metadata when needed:
- ```bash
- ruby scripts/gen-claude-marketplace.rb --write
- ruby scripts/gen-codex-plugin.rb --write
- ruby scripts/gen-llms-txt.rb --write
- ```
- The eval manifest contract is checked with `python3 scripts/validate-evals.py`; use `python3 scripts/eval-coverage.py` for the current coverage report and `python3 scripts/test-eval-validation.py` for focused validator tests. Lifecycle matrix and fake-adapter coverage are verified with `ruby scripts/validate-lifecycle-matrix.rb` and `CORPUS_OUT_DIR=/tmp/lifecycle-evals-runs-local bash lifecycle-evals/scripts/run-corpus.sh`.
- ### Harness-native installation
- Each harness controls skill discovery, activation, and execution. Follow its setup guide for directory paths, scope, and enablement; installing the files alone may not activate them.
- | Harness | Setup Guide |
- |---------|-------------|
- | **Claude Code** | See below |
- | **OpenCode** | [opencode.ai/docs/skills](https://opencode.ai/docs/skills) |
- | **OpenAI Codex** | See below |
- | **GitHub Copilot** | [docs.github.com/en/copilot/concepts/agents/about-agent-skills](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills) |
- | **Cursor** | [cursor.com/docs/context/skills](https://cursor.com/docs/context/skills) |
- | **Gemini CLI** | [geminicli.com/docs/cli/skills](https://geminicli.com/docs/cli/skills) |
- | **Hermes Agent** | See below |
- | **OpenClaw and other personal-agent harnesses** | [Installation and maintenance guide](docs/harness-installation.md) |
- ### Claude Code
- **Install the full catalog:**
- ```bash
- npx skills add magnus919/agent-skills --skill '*' --agent claude-code --global --yes
- ```
- Rerun that command periodically to refresh the catalog, including new skills.
- **Optional individual plugins:** this repository also ships a Claude Code plugin marketplace. Add it once, then install selected skills as plugins:
- ```
- /plugin marketplace add magnus919/agent-skills
- /plugin install cli-builder@magnus-agent-skills
- ```
- Every top-level skill and bundle is listed in `.claude-plugin/marketplace.json`. Installed skills are namespaced by plugin name (for example, `/cli-builder:cli-builder`). To refresh the marketplace listing, run `/plugin marketplace update magnus-agent-skills` inside Claude Code. To update an installed plugin, run this in your shell:
- ```bash
- claude plugin update cli-builder@magnus-agent-skills
- ```
- Repeat for each installed plugin, or enable auto-update for this marketplace in `/plugin` → Marketplaces. Marketplace updates do not install newly added plugins; use the full-catalog CLI route above to keep the whole set installed. See [Claude Code plugin updates](https://code.claude.com/docs/en/discover-plugins#update-one-plugin-now).
- ### Hermes Agent
- Two options depending on whether you want the whole catalog or individual skills.
- **Mount the entire repository** — clone it first:
- ```bash
- git clone https://github.com/magnus919/agent-skills.git "$HOME/agent-skills"
- ```
- Then point Hermes at the checkout in `~/.hermes/config.yaml`:
- ```yaml
- skills:
- external_dirs:
- - ~/agent-skills
- ```
- Every skill in the repository becomes available immediately (next session). Paths support `~` and `${VAR}` expansion. Refresh weekly to receive improvements and new skills, then start a new session:
- ```bash
- git -C "$HOME/agent-skills" pull --ff-only
- ```
- If you used the `skills` CLI instead, rerun its Hermes full-catalog command above.
- **Install individual skills** — add the repository as a tap, then cherry-pick:
- ```bash
- hermes skills tap add magnus919/agent-skills
- hermes skills search <query>
- hermes skills install <skill-name>
- ```
- Tap skills install into `~/.hermes/skills/` like any other hub skill. Use `hermes skills check` to see when updates are available and `hermes skills update` to refresh installed hub skills. This does not subscribe you to new catalog entries; use the mounted checkout or full-catalog CLI command for those. See the [Hermes skills CLI reference](https://hermes-agent.nousresearch.com/docs/reference/cli-commands/).
- ### OpenAI Codex
- **Install the full catalog:**
- ```bash
- npx skills add magnus919/agent-skills --skill '*' --agent codex --global --yes
- ```
- Rerun that command periodically to refresh existing skills and include new ones.
- **Native plugin alternative:** this repository also bundles all public skills in one Codex plugin. With a Codex CLI that supports `plugin add`:
- ```bash
- codex plugin marketplace add magnus919/agent-skills
- codex plugin add magnus919@magnus919
- ```
- All public skills are bundled in a single plugin. Codex discovers them from the `skills` array in `.codex-plugin/plugin.json`. Refresh the marketplace snapshot with:
- ```bash
- codex plugin marketplace upgrade magnus919
- ```
- Use Codex's plugin management UI to apply available plugin updates, then start a new session. Plugin commands vary by Codex version; check `codex plugin --help` if yours differs, or use the cross-harness CLI route above.
- **Local/repo-scoped install** (for contributors or single-skill use):
- ```bash
- mkdir -p .agents/skills
- ln -s ../../systematic-debugging .agents/skills/systematic-debugging
- ```
- Codex scans `.agents/skills/` in every directory from cwd up to the repo root.
- ### Generic / Other Frameworks
- The [agentskills.io clients page](https://agentskills.io/clients) maintains an up-to-date list of every agent framework that supports the Agent Skills format, with links to each one's setup instructions. Format support is a starting point: follow the framework's documentation for discovery and activation, and check each skill's tool, dependency, and environment requirements. See our [harness matrix](docs/harness-installation.md#harness-compatibility) for documented routes and unverified integrations.
- For another harness supported by the `skills` CLI, use its [agent identifier](https://github.com/vercel-labs/skills#supported-agents) in the full-catalog command above and rerun it periodically.
- For frameworks without built-in skill loading, clone the full repository with `git clone https://github.com/magnus919/agent-skills.git` and refresh it with `git -C agent-skills pull --ff-only`. The format is intentionally simple:
- 1. Place the skill directory in your agent's accessible file path
- 2. The agent reads `SKILL.md` when triggered by keywords in the task
- 3. Supporting files in `references/`, `templates/`, and `scripts/` are loaded on demand
- You can also instruct your agent to read specific `SKILL.md` files at session start, or reference skills in your agent's system prompt or CLAUDE.md/AGENTS.md.
- ---
- ## Contributing
- Skills follow the [Agent Skills specification](https://agentskills.io/specification.md). See [CONTRIBUTING.md](CONTRIBUTING.md) for the contributor workflow, [the Code of Conduct](CODE_OF_CONDUCT.md) for community expectations, and `AGENTS.md` for agent-specific loading and compliance guidance.
- Before submitting a new skill:
- 1. Ensure `SKILL.md` has valid YAML frontmatter (required: `name`, `description`)
- 2. The `name` field must match the parent directory name
- 3. Keep `SKILL.md` under 500 lines and 5,000 tokens
- 4. Move detailed reference material to `references/` for progressive disclosure
- 5. Run the canonical-skill validator: `ruby scripts/validate-skills.rb` (vendored `agent-council/profiles/skills/` content is intentionally excluded)
- 6. Validate with `skills-ref validate ./my-skill` if available
- ---
- ## License
- MIT — see [LICENSE.md](LICENSE.md) for full terms.
ghost/scripts/test_ghost.py · Bundled script · 555 lines · 1 finding marked
- """Offline suite for ghost/scripts/ghost — zero network egress by construction.
- Covers four behavior classes (--help, argument errors, --dry-run, mocked-client
- logic) plus JWT known-answer signing checks with fixed inputs, per-skill pipeline
- consumability chains exercised end-to-end through subprocesses and jq (pipeline
- stages feed each other's outputs verbatim; every stage's exit code is asserted),
- and Ghost-specific error signatures (409 update collision, 404 draft read,
- INVALID_AUTH_HEADER, 204 No Content deletes).
- All HTTP is short-circuited by --dry-run or replaced with unittest mocks bound at
- the cli.requests call site. No sockets are opened.
- """
- import contextlib
- import importlib.machinery
- import importlib.util
- import io
- import json
- import os
- import subprocess
- import tempfile
- import unittest
- from pathlib import Path
- from unittest.mock import Mock, patch
- SCRIPT = Path(__file__).with_name("ghost")
- # Fixed Admin API key in the official {id}:{secret} shape: 24-hex ObjectID half,
- # 64-hex 32-byte secret half. Both halves are SYNTHETIC placeholder patterns,
- # not credentials; nothing here authenticates anywhere.
- KID = "5f9d4b1c8e2a43d7b6c0a1e9"
- SECRET_HEX = "00ff" * 16
- FIXED_KEY = f"{KID}:{SECRET_HEX}"
- # Known-answer fixture computed once with iat frozen at 1700000000:
- # header/payload are compact-JSON base64url segments; SIG_B64 is HMAC-SHA256
- # over "<header>.<payload>" keyed with bytes.fromhex(SECRET_HEX).
- HEADER_B64 = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IjVmOWQ0YjFjOGUyYTQzZDdiNmMwYTFlOSJ9"
- Dismissed after review: Contains a long base64-looking blob — not necessarily malicious, but worth inspecting what it decodes to
- Line 38 on GitHub
- PAYLOAD_B64 = "eyJpYXQiOjE3MDAwMDAwMDAsImV4cCI6MTcwMDAwMDMwMCwiYXVkIjoiL2FkbWluLyJ9"
- SIG_B64 = "nxiluHMEVbp05Gi4kDYp28CCyOrwWuirtSzZeuWoisg"
- TOKEN_TTL = 300
- def load_cli():
- loader = importlib.machinery.SourceFileLoader("ghost_cli", str(SCRIPT))
- spec = importlib.util.spec_from_loader("ghost_cli", loader)
- module = importlib.util.module_from_spec(spec)
- spec.loader.exec_module(module)
- return module
- def clean_env():
- env = os.environ.copy()
- env.pop("GHOST_URL", None)
- env.pop("GHOST_ADMIN_KEY", None)
- return env
- class GhostCliTests(unittest.TestCase):
- """Subprocess-level CLI surface: help, arg errors, dry-run plans."""
- def run_cli(self, *args):
- return subprocess.run([str(SCRIPT), *args], text=True,
- capture_output=True, env=clean_env())
- def test_help_lists_all_subcommands(self):
- result = self.run_cli("--help")
- self.assertEqual(result.returncode, 0)
- for noun in ("site", "posts", "pages", "tags", "create-post",
- "get-post", "update-post", "delete-post",
- "create-page", "create-tag"):
- self.assertIn(noun, result.stdout)
- def test_no_subcommand_prints_help_and_fails(self):
- result = self.run_cli()
- self.assertNotEqual(result.returncode, 0)
- def test_missing_title_is_argument_error(self):
- result = self.run_cli("--json", "create-post")
- self.assertNotEqual(result.returncode, 0)
- self.assertIn("--title", result.stderr)
- def test_invalid_status_choice_rejected_without_crash(self):
- result = self.run_cli("--json", "create-post", "--title", "T", "--status", "archived")
- self.assertNotEqual(result.returncode, 0)
- self.assertNotIn("Traceback", result.stderr)
- def test_update_post_requires_updated_at_flag(self):
- result = self.run_cli("--json", "update-post", "abc123")
- self.assertNotEqual(result.returncode, 0)
- self.assertIn("--updated-at", result.stderr)
- def test_dry_run_site_plan_is_valid_json_without_credentials(self):
- result = self.run_cli("--dry-run", "--json", "site")
- self.assertEqual(result.returncode, 0)
- payload = json.loads(result.stdout)
- self.assertTrue(payload["dry_run"])
- def test_dry_run_human_output_requires_explicit_json_flag(self):
- # Without --json the same command stays human-readable; the flag dict
- # is per-invocation, so callers must pass --json explicitly each run.
- result = self.run_cli("--dry-run", "site")
- self.assertEqual(result.returncode, 0)
- self.assertIn("[dry-run]", result.stdout)
- with self.assertRaises(json.JSONDecodeError):
- json.loads(result.stdout)
- def test_create_post_dry_run_plan_includes_url_and_envelope(self):
- result = self.run_cli("--dry-run", "--json", "create-post", "--title", "Draft A")
- self.assertEqual(result.returncode, 0)
- payload = json.loads(result.stdout)
- self.assertTrue(payload["dry_run"])
- self.assertIn("/ghost/api/admin/posts", payload["url"])
- self.assertEqual(payload["json"], {"posts": [{"title": "Draft A", "status": "draft"}]})
- def test_update_post_dry_run_carries_collision_guard_field(self):
- result = self.run_cli("--dry-run", "--json", "update-post", "abc123",
- "--status", "published",
- "--updated-at", "2026-08-26T12:00:00.000Z")
- self.assertEqual(result.returncode, 0)
- payload = json.loads(result.stdout)
- fields = payload["fields"]
- self.assertEqual(fields["updated_at"], "2026-08-26T12:00:00.000Z")
- self.assertEqual(fields["status"], "published")
- def test_create_post_dry_run_sends_source_html_only_with_html_payload(self):
- # Ghost parses html write payloads as mobiledoc/lexical unless the
- # docs-required ?source=html query flag rides along; the plan must
- # preview exactly that request.
- result = self.run_cli("--dry-run", "--json", "create-post",
- "--title", "Doc", "--html", "<p>Hi</p>")
- self.assertEqual(result.returncode, 0)
- payload = json.loads(result.stdout)
- self.assertEqual(payload["params"], {"source": "html"})
- self.assertIn("html", payload["json"]["posts"][0])
- no_html = self.run_cli("--dry-run", "--json", "create-post",
- "--title", "Doc")
- self.assertEqual(no_html.returncode, 0)
- no_html_payload = json.loads(no_html.stdout)
- self.assertNotIn("html", no_html_payload["json"]["posts"][0])
- self.assertNotIn("source=html", no_html_payload["url"])
- self.assertIsNone(no_html_payload["params"])
- def test_update_post_dry_run_sends_source_html_only_with_html_payload(self):
- result = self.run_cli("--dry-run", "--json", "update-post", "abc123",
- "--html", "<p>Edited</p>",
- "--updated-at", "2026-08-26T12:00:00.000Z")
- self.assertEqual(result.returncode, 0)
- payload = json.loads(result.stdout)
- self.assertEqual(payload["params"], {"source": "html"})
- self.assertIn("html", payload["fields"])
- no_html = self.run_cli("--dry-run", "--json", "update-post", "abc123",
- "--status", "draft",
- "--updated-at", "2026-08-26T12:00:00.000Z")
- self.assertEqual(no_html.returncode, 0)
- no_html_payload = json.loads(no_html.stdout)
- self.assertNotIn("html", no_html_payload["fields"])
- self.assertNotIn("source=html", no_html_payload["url"])
- self.assertIsNone(no_html_payload["params"])
- def test_create_page_dry_run_sends_source_html_only_with_html_payload(self):
- result = self.run_cli("--dry-run", "--json", "create-page",
- "--title", "About", "--html", "<p>About us</p>")
- self.assertEqual(result.returncode, 0)
- payload = json.loads(result.stdout)
- self.assertEqual(payload["params"], {"source": "html"})
- self.assertIn("html", payload["json"]["pages"][0])
- no_html = self.run_cli("--dry-run", "--json", "create-page",
- "--title", "About")
- self.assertEqual(no_html.returncode, 0)
- no_html_payload = json.loads(no_html.stdout)
- self.assertNotIn("html", no_html_payload["json"]["pages"][0])
- self.assertNotIn("source=html", no_html_payload["url"])
- self.assertIsNone(no_html_payload["params"])
- def test_scheduled_post_requires_published_at_even_in_dry_run(self):
- result = self.run_cli("--dry-run", "--json", "create-post",
- "--title", "Later", "--status", "scheduled")
- self.assertNotEqual(result.returncode, 0)
- self.assertIn("--published-at", result.stderr)
- class JwtSigningTests(unittest.TestCase):
- """Known-answer JWT checks against fixed inputs (no network, no real keys)."""
- def setUp(self):
- self.cli = load_cli()
- def sign_with_fixed_clock(self, key=FIXED_KEY):
- original_time = self.cli.time.time
- self.cli.time.time = lambda: 1700000000
- try:
- client = self.cli.GhostClient(url="https://example.com", key=key)
- token = client._jwt_token()
- finally:
- self.cli.time.time = original_time
- return token
- @staticmethod
- def decode_segment(segment):
- import base64
- padded = segment + "=" * (-len(segment) % 4)
- return json.loads(base64.urlsafe_b64decode(padded))
- def test_jwt_matches_known_answer_token_exactly(self):
- token = self.sign_with_fixed_clock()
- self.assertEqual(token, f"{HEADER_B64}.{PAYLOAD_B64}.{SIG_B64}")
- def test_header_uses_hs256_kid_and_typ(self):
- header = self.decode_segment(self.sign_with_fixed_clock().split(".")[0])
- self.assertEqual(header["alg"], "HS256")
- self.assertEqual(header["typ"], "JWT")
- self.assertEqual(header["kid"], KID)
- def test_payload_audience_and_five_minute_expiry(self):
- payload = self.decode_segment(self.sign_with_fixed_clock().split(".")[1])
- self.assertEqual(payload["aud"], "/admin/")
- self.assertEqual(payload["exp"] - payload["iat"], TOKEN_TTL)
- self.assertEqual(payload["iat"], 1700000000)
- def test_signature_keys_hex_decoded_secret_not_literal_chars(self):
- import base64 as b64
- import hashlib as hl
- import hmac as hm
- header_b64, payload_b64, sig_b64 = self.sign_with_fixed_clock().split(".")
- expected = b64.urlsafe_b64encode(
- hm.new(bytes.fromhex(SECRET_HEX), f"{header_b64}.{payload_b64}".encode(), hl.sha256).digest()
- ).rstrip(b"=").decode()
- self.assertEqual(sig_b64, expected)
- literal_hex_signature = b64.urlsafe_b64encode(
- hm.new(SECRET_HEX.encode(), f"{header_b64}.{payload_b64}".encode(), hl.sha256).digest()
- ).rstrip(b"=").decode()
- self.assertNotEqual(sig_b64, literal_hex_signature)
- def test_malformed_secret_half_is_graceful_error_not_traceback(self):
- client = self.cli.GhostClient(url="https://example.com", key="5f9d4b1c8e2a43d7b6c0a1e9:not-hex!")
- stderr = io.StringIO()
- with self.assertRaises(SystemExit), contextlib.redirect_stderr(stderr):
- client._jwt_token()
- self.assertIn("hexadecimal", stderr.getvalue())
- def test_key_without_colon_names_required_format(self):
- client = self.cli.GhostClient(url="https://example.com", key="justonepart")
- stderr = io.StringIO()
- with self.assertRaises(SystemExit), contextlib.redirect_stderr(stderr):
- client._jwt_token()
- self.assertIn("id:secret", stderr.getvalue())
- class AdminApiAudienceTests(unittest.TestCase):
- cli = load_cli()
- def test_unversioned_admin_path_uses_root_admin_audience(self):
- self.assertEqual(self.cli.admin_api_audience("/ghost/api/admin/posts/"), "/admin/")
- self.assertEqual(self.cli.admin_api_audience("/ghost/api/admin/"), "/admin/")
- self.assertEqual(self.cli.admin_api_audience("nonsense"), "/admin/")
- def test_legacy_versioned_paths_scope_the_audience(self):
- self.assertEqual(self.cli.admin_api_audience("/ghost/api/v3/admin/posts/"), "/v3/admin/")
- self.assertEqual(self.cli.admin_api_audience("/ghost/api/v4/admin/"), "/v4/admin/")
- class PipelineChainTests(unittest.TestCase):
- """Per-skill contract: documented multi-step pipelines must execute stage by
- stage, with each stage consuming the previous stage's emitted output."""
- @classmethod
- def setUpClass(cls):
- cls.tmpdir = tempfile.TemporaryDirectory(prefix="ghost-pipeline-")
- @classmethod
- def tearDownClass(cls):
- cls.tmpdir.cleanup()
- def run_cli(self, *args, creds=False):
- env = clean_env()
- if creds:
- env["GHOST_URL"] = "https://example.com"
- env["GHOST_ADMIN_KEY"] = FIXED_KEY
- return subprocess.run([str(SCRIPT), *args], text=True,
- capture_output=True, env=env,
- cwd=self.tmpdir.name)
- def run_jq(self, *jq_args):
- return subprocess.run(["jq", *jq_args],
- text=True, capture_output=True, env=clean_env(),
- cwd=self.tmpdir.name)
- def write_stage_file(self, name, document):
- path = Path(self.tmpdir.name) / name
- path.write_text(json.dumps(document))
- return path.name
- def test_draft_then_publish_then_delete_chain_consumability(self):
- post_id = "624c2b3fc1a5b7e9d4a0f2aa"
- # Stage 1: mint the draft plan; jq extracts method + URL + title field.
- r1 = self.run_cli("--dry-run", "--json", "create-post", "--title", "Chain Post")
- self.assertEqual(r1.returncode, 0)
- stage1 = self.write_stage_file("stage1.json", json.loads(r1.stdout))
- check = self.run_jq("-r", ".method | select(. == \"post\") // empty", stage1)
- self.assertEqual(check.stdout.strip(), "post")
- url = self.run_jq("-r", ".url", stage1).stdout.strip()
- self.assertIn("/ghost/api/admin/posts", url)
- # Stage 2: publish plan consumes a hand-built id + updated_at guard;
- # jq asserts the collision-guard field travels into the request body.
- r2 = self.run_cli("--dry-run", "--json", "update-post", post_id,
- "--status", "published",
- "--updated-at", "2026-08-26T12:00:00.000Z")
- self.assertEqual(r2.returncode, 0)
- stage2 = self.write_stage_file("stage2.json", json.loads(r2.stdout))
- guarded_at = self.run_jq("-r", ".fields.updated_at", stage2).stdout.strip()
- self.assertRegex(guarded_at, r"^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}")
- body_type = self.run_jq("-r", '.fields.status | select(. == "published") // empty', stage2)
- self.assertEqual(body_type.stdout.strip(), "published")
- # Stage 3: teardown plan for the same post id consumed from stage 2's
- # positional argument (verbatim string, not re-typed).
- r3 = self.run_cli("--dry-run", "--json", "delete-post", post_id)
- self.assertEqual(r3.returncode, 0)
- stage3 = self.write_stage_file("stage3.json", json.loads(r3.stdout))
- self.assertEqual(self.run_jq("-r", ".method", stage3).stdout.strip(), "delete")
- def test_list_to_get_post_chain_type_contract(self):
- row = {"title": "Hello World", "slug": "hello-world", "id": "abc123"}
- # Stage 1: a listing document (as ghost posts --json would produce);
- # jq extracts .posts[0].id and asserts its JSON type is string.
- listing_name = self.write_stage_file(
- "listing.json",
- {"total": 1, "page": {}, "posts": [row]})
- extracted = self.run_jq("-r", ".posts[0].id", listing_name)
- self.assertEqual(extracted.returncode, 0, extracted.stderr)
- self.assertEqual(extracted.stdout.strip(), row["id"])
- type_check = self.run_jq("-r", ".posts[0].id | type", listing_name)
- self.assertEqual(type_check.stdout.strip(), "string")
- slug_check = self.run_jq("-r", ".posts[0].slug | type", listing_name)
- self.assertEqual(slug_check.stdout.strip(), "string")
- # Stage 2: get-post plan consumes exactly that id string positionally.
- r2 = self.run_cli("--dry-run", "--json", "get-post", extracted.stdout.strip(), creds=True)
- self.assertEqual(r2.returncode, 0)
- plan = json.loads(r2.stdout)
- self.assertTrue(plan["dry_run"])
- self.assertTrue(str(row["id"]) in plan["url"], plan["url"])
- self.assertTrue(plan["url"].startswith("https://"))
- class MockedClientTests(unittest.TestCase):
- """In-process handler logic with requests mocked at the call site."""
- def load_with_flags(self, json_mode=True):
- cli = load_cli()
- cli.GLOBAL_FLAGS = {"json": json_mode, "dry_run": False,
- "quiet": False, "verbose": False}
- return cli
- def test_cmd_posts_parses_envelope_and_pagination_totals(self):
- cli = self.load_with_flags()
- client = cli.GhostClient(url="https://example.com", key=FIXED_KEY)
- client.get_posts = Mock(return_value={
- "posts": [
- {"title": "First", "slug": "first", "status": "draft"},
- {"title": "Second", "slug": "second", "status": "published"},
- ],
- "meta": {"pagination": {"page": 2, "limit": 20, "pages": 7,
- "total": 124, "next": 3, "prev": 1}},
- })
- captured = []
- def capture_print(*args):
- captured.append(args)
- with patch("builtins.print", capture_print):
- cli.cmd_posts(client, ["--limit", "20"])
- client.get_posts.assert_called_once_with(limit=20, status=None, page=None, order=None)
- self.assertEqual(len(captured), 1, captured)
- emitted = captured[0][0] # emit() prints one argument in json mode
- payload = json.loads(emitted)
- self.assertEqual(payload["total"], 124)
- self.assertEqual(len(payload["posts"]), 2)
- self.assertEqual(payload["page"]["pages"], 7)
- def test_client_get_posts_builds_status_filter_param(self):
- cli = self.load_with_flags()
- client = cli.GhostClient(url="https://example.com", key=FIXED_KEY)
- seen = {}
- def fake_get(path, params=None):
- seen["path"] = path
- seen["params"] = params
- return {"posts": [], "meta": {"pagination": {}}}
- client._get = fake_get
- data = client.get_posts(limit=50, status="draft")
- self.assertEqual(data["posts"], [])
- self.assertEqual(seen["path"], "/posts")
- self.assertEqual(seen["params"]["filter"], "status:draft")
- self.assertEqual(seen["params"]["limit"], 50)
- def test_delete_post_tolerates_204_empty_body(self):
- cli = self.load_with_flags(json_mode=False)
- ok_empty = Mock(status_code=204)
- del ok_empty.json # a real 204 carries no JSON body at all
- cli.requests.delete = Mock(return_value=ok_empty)
- client = cli.GhostClient(url="https://example.com", key=FIXED_KEY)
- captured = []
- with patch("builtins.print", lambda *a, **k: captured.append(a)):
- cli.cmd_delete_post(client, ["abc123"])
- cli.requests.delete.assert_called_once()
- called_url = cli.requests.delete.call_args.args[0]
- self.assertEqual(called_url, "https://example.com/ghost/api/admin/posts/abc123")
- auth_header = cli.requests.delete.call_args.kwargs["headers"]["Authorization"]
- self.assertTrue(auth_header.startswith("Ghost eyJ"))
- def test_update_collision_error_message_advises_reget(self):
- cli = self.load_with_flags()
- collision = Mock(status_code=409, text="conflict")
- collision.json = Mock(return_value={
- "errors": [{"message": "Saving failed! Someone else is editing this post.",
- "type": "UpdateCollisionError", "code": "UPDATE_COLLISION"}],
- })
- cli.requests.put = Mock(return_value=collision)
- client = cli.GhostClient(url="https://example.com", key=FIXED_KEY)
- stderr = io.StringIO()
- with self.assertRaises(SystemExit), contextlib.redirect_stderr(stderr):
- client.update_post("abc123", status="published",
- updated_at="2026-01-01T00:00:00.000Z")
- message = stderr.getvalue()
- self.assertIn("409", message)
- self.assertIn("Someone else is editing this post", message)
- self.assertIn("Re-GET", message)
- def test_draft_read_on_content_api_style_404_routes_to_admin_guidance(self):
- cli = self.load_with_flags()
- missing = Mock(status_code=404, text="not found")
- missing.json = Mock(return_value={
- "errors": [{"message": "Resource not found error.",
- "type": "NotFoundError", "code": None}]})
- cli.requests.get = Mock(return_value=missing)
- client = cli.GhostClient(url="https://example.com", key=FIXED_KEY)
- stderr = io.StringIO()
- with self.assertRaises(SystemExit), contextlib.redirect_stderr(stderr):
- client._get("/posts/does-not-exist")
- message = stderr.getvalue()
- self.assertIn("404", message)
- self.assertIn("Admin API", message)
- def test_auth_header_scheme_mistake_surfaces_ghost_scheme_hint(self):
- cli = self.load_with_flags()
- bad_scheme = Mock(status_code=401)
- bad_scheme.text = ('{"errors":[{"message":"Authorization header format is '
- '"Authorization: Ghost [token]","context":null,'
- '"type":"UnauthorizedError","code":"INVALID_AUTH_HEADER"}]}')
- bad_scheme.json = Mock(return_value={"errors": [{
- "message": "Authorization header format is \"Authorization: Ghost [token]\"",
- "type": "UnauthorizedError", "code": "INVALID_AUTH_HEADER"}]})
- cli.requests.get = Mock(return_value=bad_scheme)
- client = cli.GhostClient(url="https://example.com", key=FIXED_KEY)
- stderr = io.StringIO()
- with self.assertRaises(SystemExit), contextlib.redirect_stderr(stderr):
- client._get("/posts")
- self.assertIn("Ghost [token]", stderr.getvalue())
- def test_authorization_header_uses_ghost_scheme_and_version_headers(self):
- cli = self.load_with_flags()
- ok = Mock(status_code=200)
- ok.json = Mock(return_value={"posts": []})
- cli.requests.get = Mock(return_value=ok)
- client = cli.GhostClient(url="https://example.com", key=FIXED_KEY)
- client._get("/posts")
- headers = cli.requests.get.call_args.kwargs["headers"]
- self.assertTrue(headers["Authorization"].startswith("Ghost "))
- self.assertEqual(headers["Accept-Version"], "v6.0")
- def test_request_paths_target_unversioned_admin_api(self):
- cli = self.load_with_flags()
- ok = Mock(status_code=200)
- ok.json = Mock(return_value={})
- cli.requests.get = Mock(return_value=ok)
- client = cli.GhostClient(url="https://example.com/", key=FIXED_KEY)
- client._get("/site")
- called_url = cli.requests.get.call_args.args[0]
- self.assertEqual(called_url, "https://example.com/ghost/api/admin/site")
- class HtmlSourceFlagTests(unittest.TestCase):
- """Regression: html write payloads must carry the docs-required
- ?source=html query flag; mobiledoc/lexical writes must not send it."""
- def setUp(self):
- self.cli = load_cli()
- self.cli.GLOBAL_FLAGS = {"json": True, "dry_run": False,
- "quiet": False, "verbose": False}
- ok = Mock(status_code=201)
- ok.json = Mock(return_value={"posts": []})
- self.cli.requests.post = Mock(return_value=ok)
- self.client = self.cli.GhostClient(url="https://example.com", key=FIXED_KEY)
- def _put_ok(self):
- ok = Mock(status_code=200)
- ok.json = Mock(return_value={"posts": []})
- self.cli.requests.put = Mock(return_value=ok)
- return self.cli.requests.put
- def test_create_post_with_html_sends_source_html_query_param(self):
- self.client.create_post("Doc", html="<p>Hi</p>")
- call = self.cli.requests.post.call_args
- self.assertEqual(call.kwargs["params"], {"source": "html"})
- self.assertIn("html", call.kwargs["json"]["posts"][0])
- def test_create_post_without_html_omits_source_flag(self):
- self.client.create_post("Doc")
- call = self.cli.requests.post.call_args
- self.assertNotIn("source", (call.kwargs.get("params") or {}))
- self.assertNotIn("html", call.kwargs["json"]["posts"][0])
- def test_update_post_with_html_sends_source_html_query_param(self):
- put = self._put_ok()
- self.client.update_post("abc123", html="<p>Edited</p>",
- updated_at="2026-08-26T12:00:00.000Z")
- call = put.call_args
- self.assertEqual(call.kwargs["params"], {"source": "html"})
- self.assertIn("html", call.kwargs["json"]["posts"][0])
- def test_update_post_without_html_omits_source_flag(self):
- put = self._put_ok()
- self.client.update_post("abc123", status="published",
- updated_at="2026-08-26T12:00:00.000Z")
- call = put.call_args
- self.assertNotIn("source", (call.kwargs.get("params") or {}))
- self.assertNotIn("html", call.kwargs["json"]["posts"][0])
- def test_create_page_with_html_sends_source_html_query_param(self):
- self.client.create_page("About", html="<p>About us</p>")
- call = self.cli.requests.post.call_args
- self.assertEqual(call.kwargs["params"], {"source": "html"})
- self.assertEqual(call.args[0], "https://example.com/ghost/api/admin/pages")
- self.assertIn("html", call.kwargs["json"]["pages"][0])
- def test_create_page_without_html_omits_source_flag(self):
- self.client.create_page("About")
- call = self.cli.requests.post.call_args
- self.assertNotIn("source", (call.kwargs.get("params") or {}))
- self.assertNotIn("html", call.kwargs["json"]["pages"][0])
- if __name__ == "__main__":
- unittest.main()
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.