Skill Format

Light cleanup of research materials - remove UI artifacts and apply basic formatting.

Usage

/meta-claude:skill:format <research-dir>

What This Does

Runs format_skill_research.py to:

Remove GitHub UI elements (navigation, headers, footers)
Remove redundant blank lines
Ensure code fences have proper spacing
Ensure lists have proper spacing

Philosophy: "Car wash" approach - remove chunks of mud before detail work.

Does NOT restructure content for skill format.

Instructions

Your task is to format and clean markdown research files.

Extract the research directory path from $ARGUMENTS (provided by user as research directory)
Verify the directory exists using a test command
If directory doesn't exist, show the error from the Error Handling section

Run the cleanup script with the provided directory path:

${CLAUDE_PLUGIN_ROOT}/../../scripts/format_skill_research.py "$ARGUMENTS"

Display the script output showing which files were processed

The script processes all .md files recursively in the directory.

Expected Output

Found N markdown files to clean
Processing: file1.md
✓ Cleaned: file1.md
Processing: file2.md
✓ Cleaned: file2.md

✓ Formatted N files in <research-dir>

Error Handling

If directory not found:

Error: Directory not found: <research-dir>

Suggest: Check path or run /meta-claude:skill:research first

If no markdown files:

No markdown files found in <research-dir>

Action: Skip formatting, continue workflow

Examples

Format research:

/meta-claude:skill:format docs/research/skills/docker-master/
# Output: ✓ Formatted 5 files in docs/research/skills/docker-master/

Already clean:

/meta-claude:skill:format docs/research/skills/clean-skill/
# Output: No markdown files found (or no changes needed)

2.0 KiB Raw Blame History