Skill99 repo starsupdated 4mo ago

references

The references skill provides a structured workflow for converting existing documents into Claude Code skills by analyzing content structure, determining appropriate skill organization, and guiding users through migration steps including validation, security checks, and token optimization. Use this when users want to repurpose existing documentation, guides, or technical content as reusable skills.

View source Repository: skillkit

Install in Claude Code

Copy

git clone --depth 1 https://github.com/rfxlamia/skillkit /tmp/references && cp -r /tmp/references/skills/skillkit/references/section-5-migration-workflow-doc-to- ~/.claude/skills/references

Then start a new Claude Code session; the skill loads automatically.

Definition

section-5-migration-workflow-doc-to-skill.md

# Section 5: Migration Workflow (Doc to Skill)

**Use when:** User has existing document, wants to convert to skill

**Entry Point:** User says "convert this doc to skill" or "migrate document"

**Prerequisites:**
- Document file available (markdown, text, PDF, docx)
- User confirms content ownership

### Migration Steps

1. **Decision Check** (Step 0)
   - Run decision_helper.py to confirm Skills appropriate
   - Proceed only if recommendation = "Skills"

2. **Migration Analysis** (Enhanced Step 2)
   ```bash
   python scripts/migration_helper.py user-doc.md --format json
   ```
   
   **JSON Output:**
   ```json
   {
     "analysis": {
       "content_type": "technical_guide",
       "structure_detected": "sequential_workflow",
       "token_count": 5200,
       "complexity": "medium"
     },
     "recommendations": {
       "skill_structure": "workflow-based",
       "split_needed": true,
       "references_suggested": ["detailed-examples.md", "edge-cases.md"]
     }
   }
   ```

3. **Structure Creation** (Step 2)
   - Create skill folder
   - Initialize SKILL.md with frontmatter
   - Organize content per recommendations

4. **Execute Steps 3-8**
   - Validation (Step 3)
   - Security (Step 4)
   - Token optimization (Step 5)
   - Progressive disclosure (Step 6)
   - Testing (Step 7)
   - Quality assessment (Step 8)

5. **Package** (Step 9)
   - Run package_skill.py
   - Deploy and test

**Tool Guide:** `knowledge/tools/22-migration-helper-guide.md`

---