fix(skills): strip redundant [workflow.md](workflow.md) links repo-wide
Replace `[workflow.md](workflow.md)` with bare `workflow.md` in all 34 SKILL.md files. Redundant markdown link syntax adds noise for LLM consumers. Also update the validator example to match. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Alex Verkhovsky
parent
de565221d8
commit
cb16a4fac2
|
|
@ -3,4 +3,4 @@ name: bmad-create-product-brief
|
||||||
description: 'Create product brief through collaborative discovery. Use when the user says "lets create a product brief" or "help me create a project brief"'
|
description: 'Create product brief through collaborative discovery. Use when the user says "lets create a product brief" or "help me create a project brief"'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-domain-research
|
||||||
description: 'Conduct domain and industry research. Use when the user says "lets create a research report on [domain or industry]"'
|
description: 'Conduct domain and industry research. Use when the user says "lets create a research report on [domain or industry]"'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-market-research
|
||||||
description: 'Conduct market research on competition and customers. Use when the user says "create a market research report about [business idea]".'
|
description: 'Conduct market research on competition and customers. Use when the user says "create a market research report about [business idea]".'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-technical-research
|
||||||
description: 'Conduct technical research on technologies and architecture. Use when the user says "create a technical research report on [topic]".'
|
description: 'Conduct technical research on technologies and architecture. Use when the user says "create a technical research report on [topic]".'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-create-ux-design
|
||||||
description: 'Plan UX patterns and design specifications. Use when the user says "lets create UX design" or "create UX specifications" or "help me plan the UX"'
|
description: 'Plan UX patterns and design specifications. Use when the user says "lets create UX design" or "create UX specifications" or "help me plan the UX"'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-edit-prd
|
||||||
description: 'Edit an existing PRD. Use when the user says "edit this PRD".'
|
description: 'Edit an existing PRD. Use when the user says "edit this PRD".'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-validate-prd
|
||||||
description: 'Validate a PRD against standards. Use when the user says "validate this PRD" or "run PRD validation"'
|
description: 'Validate a PRD against standards. Use when the user says "validate this PRD" or "run PRD validation"'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-check-implementation-readiness
|
||||||
description: 'Validate PRD, UX, Architecture and Epics specs are complete. Use when the user says "check implementation readiness".'
|
description: 'Validate PRD, UX, Architecture and Epics specs are complete. Use when the user says "check implementation readiness".'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-create-architecture
|
||||||
description: 'Create architecture solution design decisions for AI agent consistency. Use when the user says "lets create architecture" or "create technical architecture" or "create a solution design"'
|
description: 'Create architecture solution design decisions for AI agent consistency. Use when the user says "lets create architecture" or "create technical architecture" or "create a solution design"'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-create-epics-and-stories
|
||||||
description: 'Break requirements into epics and user stories. Use when the user says "create the epics and stories list"'
|
description: 'Break requirements into epics and user stories. Use when the user says "create the epics and stories list"'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-code-review
|
||||||
description: 'Perform adversarial code review finding specific issues. Use when the user says "run code review" or "review this code"'
|
description: 'Perform adversarial code review finding specific issues. Use when the user says "run code review" or "review this code"'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-correct-course
|
||||||
description: 'Manage significant changes during sprint execution. Use when the user says "correct course" or "propose sprint change"'
|
description: 'Manage significant changes during sprint execution. Use when the user says "correct course" or "propose sprint change"'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-create-story
|
||||||
description: 'Creates a dedicated story file with all the context the agent will need to implement it later. Use when the user says "create the next story" or "create story [story identifier]"'
|
description: 'Creates a dedicated story file with all the context the agent will need to implement it later. Use when the user says "create the next story" or "create story [story identifier]"'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-dev-story
|
||||||
description: 'Execute story implementation following a context filled story spec file. Use when the user says "dev this story [story file]" or "implement the next story in the sprint plan"'
|
description: 'Execute story implementation following a context filled story spec file. Use when the user says "dev this story [story file]" or "implement the next story in the sprint plan"'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-retrospective
|
||||||
description: 'Post-epic review to extract lessons and assess success. Use when the user says "run a retrospective" or "lets retro the epic [epic]"'
|
description: 'Post-epic review to extract lessons and assess success. Use when the user says "run a retrospective" or "lets retro the epic [epic]"'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-sprint-planning
|
||||||
description: 'Generate sprint status tracking from epics. Use when the user says "run sprint planning" or "generate sprint plan"'
|
description: 'Generate sprint status tracking from epics. Use when the user says "run sprint planning" or "generate sprint plan"'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-sprint-status
|
||||||
description: 'Summarize sprint status and surface risks. Use when the user says "check sprint status" or "show sprint status"'
|
description: 'Summarize sprint status and surface risks. Use when the user says "check sprint status" or "show sprint status"'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-document-project
|
||||||
description: 'Document brownfield projects for AI context. Use when the user says "document this project" or "generate project docs"'
|
description: 'Document brownfield projects for AI context. Use when the user says "document this project" or "generate project docs"'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-generate-project-context
|
||||||
description: 'Create project-context.md with AI rules. Use when the user says "generate project context" or "create project context"'
|
description: 'Create project-context.md with AI rules. Use when the user says "generate project context" or "create project context"'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-qa-generate-e2e-tests
|
||||||
description: 'Generate end to end automated tests for existing features. Use when the user says "create qa automated tests for [feature]"'
|
description: 'Generate end to end automated tests for existing features. Use when the user says "create qa automated tests for [feature]"'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-quick-dev-new-preview
|
||||||
description: 'Implements any user intent, requirement, story, bug fix or change request by producing clean working code artifacts that follow the project''s existing architecture, patterns and conventions. Use when the user wants to build, fix, tweak, refactor, add or modify any code, component or feature.'
|
description: 'Implements any user intent, requirement, story, bug fix or change request by producing clean working code artifacts that follow the project''s existing architecture, patterns and conventions. Use when the user wants to build, fix, tweak, refactor, add or modify any code, component or feature.'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-quick-dev
|
||||||
description: 'Implement a Quick Tech Spec for small changes or features. Use when the user provides a quick tech spec and says "implement this quick spec" or "proceed with implementation of [quick tech spec]"'
|
description: 'Implement a Quick Tech Spec for small changes or features. Use when the user provides a quick tech spec and says "implement this quick spec" or "proceed with implementation of [quick tech spec]"'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-quick-spec
|
||||||
description: 'Very quick process to create implementation-ready quick specs for small changes or features. Use when the user says "create a quick spec" or "generate a quick tech spec"'
|
description: 'Very quick process to create implementation-ready quick specs for small changes or features. Use when the user says "create a quick spec" or "generate a quick tech spec"'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-advanced-elicitation
|
||||||
description: 'Push the LLM to reconsider, refine, and improve its recent output.'
|
description: 'Push the LLM to reconsider, refine, and improve its recent output.'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-brainstorming
|
||||||
description: 'Facilitate interactive brainstorming sessions using diverse creative techniques and ideation methods. Use when the user says help me brainstorm or help me ideate.'
|
description: 'Facilitate interactive brainstorming sessions using diverse creative techniques and ideation methods. Use when the user says help me brainstorm or help me ideate.'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-editorial-review-prose
|
||||||
description: 'Clinical copy-editor that reviews text for communication issues. Use when user says review for prose or improve the prose'
|
description: 'Clinical copy-editor that reviews text for communication issues. Use when user says review for prose or improve the prose'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-editorial-review-structure
|
||||||
description: 'Structural editor that proposes cuts, reorganization, and simplification while preserving comprehension. Use when user requests structural review or editorial review of structure'
|
description: 'Structural editor that proposes cuts, reorganization, and simplification while preserving comprehension. Use when user requests structural review or editorial review of structure'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-help
|
||||||
description: 'Analyzes what is done and the users query and offers advice on what to do next. Use if user says what should I do next or what do I do now'
|
description: 'Analyzes what is done and the users query and offers advice on what to do next. Use if user says what should I do next or what do I do now'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-index-docs
|
||||||
description: 'Generates or updates an index.md to reference all docs in the folder. Use if user requests to create or update an index of all files in a specific folder'
|
description: 'Generates or updates an index.md to reference all docs in the folder. Use if user requests to create or update an index of all files in a specific folder'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-party-mode
|
||||||
description: 'Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations. Use when user requests party mode.'
|
description: 'Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations. Use when user requests party mode.'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-review-adversarial-general
|
||||||
description: 'Perform a Cynical Review and produce a findings report. Use when the user requests a critical review of something'
|
description: 'Perform a Cynical Review and produce a findings report. Use when the user requests a critical review of something'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-review-edge-case-hunter
|
||||||
description: 'Walk every branching path and boundary condition in content, report only unhandled edge cases. Orthogonal to adversarial review - method-driven not attitude-driven. Use when you need exhaustive edge-case analysis of code, specs, or diffs.'
|
description: 'Walk every branching path and boundary condition in content, report only unhandled edge cases. Orthogonal to adversarial review - method-driven not attitude-driven. Use when you need exhaustive edge-case analysis of code, specs, or diffs.'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-shard-doc
|
||||||
description: 'Splits large markdown documents into smaller, organized files based on level 2 (default) sections. Use if the user says perform shard document'
|
description: 'Splits large markdown documents into smaller, organized files based on level 2 (default) sections. Use if the user says perform shard document'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -3,4 +3,4 @@ name: bmad-create-prd
|
||||||
description: 'Create a PRD from scratch. Use when the user says "lets create a product requirements document" or "I want to create a new PRD"'
|
description: 'Create a PRD from scratch. Use when the user says "lets create a product requirements document" or "I want to create a new PRD"'
|
||||||
---
|
---
|
||||||
|
|
||||||
Follow the instructions in [workflow.md](workflow.md).
|
Follow the instructions in ./workflow.md.
|
||||||
|
|
|
||||||
|
|
@ -118,7 +118,7 @@ If no findings are generated, the skill passes validation.
|
||||||
- CORRECT: `./steps/step-01-init.md` (from workflow.md at skill root to a step)
|
- CORRECT: `./steps/step-01-init.md` (from workflow.md at skill root to a step)
|
||||||
- CORRECT: `./template.md` (from workflow.md to a sibling)
|
- CORRECT: `./template.md` (from workflow.md to a sibling)
|
||||||
- CORRECT: `../template.md` (from steps/step-01.md to a skill-root file)
|
- CORRECT: `../template.md` (from steps/step-01.md to a skill-root file)
|
||||||
- CORRECT: `[workflow.md](workflow.md)` (markdown link to sibling — bare relative)
|
- CORRECT: `workflow.md` (bare relative filename for sibling)
|
||||||
- CORRECT: `./step-02-plan.md` (from steps/step-01.md to a sibling step)
|
- CORRECT: `./step-02-plan.md` (from steps/step-01.md to a sibling step)
|
||||||
- WRONG: `./steps/step-02-plan.md` (from a file already inside steps/ — resolves to steps/steps/)
|
- WRONG: `./steps/step-02-plan.md` (from a file already inside steps/ — resolves to steps/steps/)
|
||||||
- WRONG: `{installed_path}/template.md`
|
- WRONG: `{installed_path}/template.md`
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue