enhance-bmad-skills

Enhance Skill

Overview

AI-driven skill for reviewing and adapting BMAD-converted skills. Detects path references that need adaptation and prompts the user for how to handle each case.

When to Use

Use this skill when you need to:

• Review a converted skill for path adaptation needs
• Scan all skills for remaining {project-root} references
• Migrate external content into a skill
• Adapt paths to use relative skill structure

Commands

• ES or enhance-bmad-skills - Start skill enhancement workflow
• SP or scan-paths - Scan for path references in one or all skills
• AR or adapt-references - Adapt detected path references with user prompts
• MF or migrate-file - Migrate external file into skill structure

Workflow

Step 1: Path Detection

When reviewing a skill, look for these patterns:

{project-root}/_bmad/...       # Most common - internal BMAD references
{project-root}/...             # User project paths
../../module/skill/...         # Already-adapted relative paths

For each {project-root} reference found, categorize it:

Step 2: User Prompt

For each Actionable reference, present options:

Found: {project-root}/_bmad/bmm/data/documentation-standards.md
  in: skills/bmm/tech-writer/SKILL.md (line 25)

Options:
  [A] Adapt - Change to relative path (../../data/documentation-standards.md)
  [M] Migrate - Copy file into skill, update reference
  [D] Document - Mark as external dependency
  [K] Keep - Leave as-is (if documentation example)

Choose [A/M/D/K]:

Step 3: Execute Choice

[A] Adapt Path:

• Replace {project-root}/_bmad/module/path with relative ../../module/path
• Verify target file exists in skills structure
• If not found, suggest migration instead

[M] Migrate Content:

• Determine target location: skills/{module}/{skill}/data/{filename}
• Copy file to skill directory
• Update reference to use relative path ./data/{filename}
• Report migration details

[D] Document External:

• Add to skill's "External Dependencies" section
• Note file purpose and requirement

[K] Keep As-Is:

• Mark as documentation example
• No changes made

Path Transformation Reference

Common Transformations

Common Adaptation Scenarios

You may encounter these common patterns that require specific handling:

1. Data File References

   • Pattern: References to centralized data files (e.g., _bmad/bmm/data/...).
   • Action: Migrate these files into the skill's own data/ directory to make it self-contained.

2. Knowledge Bases

   • Pattern: References to knowledge directories (e.g., _bmad/bmm/testarch/knowledge/).
   • Action: Migrate the directory into the skill and update the path to be relative.

3. Cross-Module Examples

   • Pattern: References to other modules in examples (e.g., _bmad/cis/tasks/... in a different module).
   • Action: Keep In Place (Document) or Adapt to a relative path if the target skill is also installed.

Quick Scan Command

To scan all skills for remaining path issues:

Scan all skills in skills/ directory for {project-root} references.
Categorize each as: Actionable, Documentation, or External.
Report skills needing attention with line numbers.

Guidelines

• Always verify target file exists before adapting paths
• Prefer migration for small files (<100 lines)
• Keep documentation examples as-is - they teach BMAD patterns
• Update skill's Related Skills section if paths change workflow references

Examples

Enhance a specific skill:

Enhance skills/bmm/tech-writer/SKILL.md

Scan all skills:

SP

Migrate a file into skill:

MF skills/bmm/tech-writer documentation-standards.md from ../../data/