Initial commit

commands/skill/format.md

@@ -0,0 +1,91 @@
+---
+description: "Light cleanup of research materials - remove UI artifacts and basic formatting"
+allowed-tools: Bash(command:*)
+argument-hint: [research-dir]
+---
+
+# Skill Format
+
+Light cleanup of research materials - remove UI artifacts and apply basic formatting.
+
+## Usage
+
+```bash
+/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.
+
+1. Extract the research directory path from `$ARGUMENTS` (provided by user as research directory)
+1. Verify the directory exists using a test command
+1. If directory doesn't exist, show the error from the Error Handling section
+1. Run the cleanup script with the provided directory path:
+
+    ```bash
+    ${CLAUDE_PLUGIN_ROOT}/../../scripts/format_skill_research.py "$ARGUMENTS"
+    ```
+
+1. Display the script output showing which files were processed
+
+The script processes all `.md` files recursively in the directory.
+
+## Expected Output
+
+```text
+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:**
+
+```text
+Error: Directory not found: <research-dir>
+```
+
+Suggest: Check path or run `/meta-claude:skill:research` first
+
+**If no markdown files:**
+
+```text
+No markdown files found in <research-dir>
+```
+
+Action: Skip formatting, continue workflow
+
+## Examples
+
+**Format research:**
+
+```bash
+/meta-claude:skill:format docs/research/skills/docker-master/
+# Output: ✓ Formatted 5 files in docs/research/skills/docker-master/
+```
+
+**Already clean:**
+
+```bash
+/meta-claude:skill:format docs/research/skills/clean-skill/
+# Output: No markdown files found (or no changes needed)
+```