define-capability

Guides conversational elicitation of business capabilities into structured markdown documents.

1|Updated Mar 7, 2023
One-click install
npx skills add https://github.com/Zaba505/infra --skill define-capability-zaba505
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: define-capability
Source: https://github.com/Zaba505/infra/tree/main/.claude/skills/define-capability
Command: npx skills add https://github.com/Zaba505/infra --skill define-capability-zaba505

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Teams often jump into technical design before clearly defining what the business actually needs, leading to rework and misaligned solutions. This Skill structures a conversation that captures a business capability — purpose, stakeholders, triggers, outputs, rules, and success criteria — in purely business terms, producing a reviewable markdown document before any technical design begins. ## Core Features & Use Cases - Six-dimension elicitation: Walks through purpose, stakeholders, triggers and inputs, outputs, business rules, and success criteria, probing vague answers and mirroring back understanding. - Technical drift redirection: Detects when answers drift into implementation details (APIs, databases, frameworks) and redirects to business-level framing while parking technical ideas as open questions. - Hugo/Docsy-ready output: Produces a markdown document from a template with stable heading anchors and Docsy frontmatter, saved under docs/content/capabilities/ and validated via a local Hugo preview. - Use Case: A product manager says "help me define a capability for customer onboarding." The Skill asks focused questions one or two at a time, redirects any technical tangents, and delivers a complete capability document with open questions flagged for stakeholder review. ## Quick Start Ask the assistant to help you define a business capability for a specific business function, such as "help me define the refund processing capability for our store."

Frequently Asked Questions about define-capability

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I define a business capability before writing code?

Start a conversation describing what the business function should accomplish, and the Skill elicits six dimensions: purpose, stakeholders, triggers, outputs, business rules, and success criteria. It then produces a structured markdown document your team can review before any technical design.

What is the difference between a business capability and technical design?

A business capability describes what the business does and why, in business terms, while technical design covers how it is implemented. This Skill deliberately redirects discussion of APIs, databases, and frameworks, parking them as open questions for later design work.

Can I use this with a Hugo and Docsy documentation site?

Yes, the output template includes Docsy frontmatter and is saved under docs/content/capabilities/ so it renders in the published site. The Skill also creates the section _index.md if missing and validates the page with a local hugo server preview.

What happens if I give vague answers during the capability definition?

Vague answers like "improve customer experience" are probed with focused follow-up questions about whose experience, what changes, and how it is measured. If something is genuinely unknown, it is captured as an open question rather than invented.

When should I not use this capability definition approach?

Do not use it for technical design, architecture decisions, or implementation planning, as it explicitly covers only business-level definition. Once the capability document is finalized, downstream skills handle extracting business requirements and defining technical requirements.