ln-161-skill-creator

Paths: File paths (references/, ../ln-*) are relative to this skill directory.

ln-161-skill-creator

Type: L3 Worker (standalone-capable) Category: 1XX Documentation Pipeline

Creates .claude/commands/*.md slash command files from procedural documentation sections. It converts procedural prose into imperative command instructions without changing the source docs.

Overview

| Aspect | Details | |--------|---------| | Input | Approved procedural sections or standalone docs scan | | Output | .claude/commands/*.md files in target project | | Template | references/templates/command_template.md | | Read mode | Section-first markdown reading |

Input Modes

| Mode | Trigger | Behavior | |------|---------|----------| | Provided sections | Context contains approved_sections | Use supplied sections directly | | Standalone | Invoked directly with $ARGUMENTS | Self-discover, classify, and create commands |

Standalone Discovery

When invoked without approved_sections:

1. Read references/procedural_extraction_rules.md, references/procedural_skill_sop_guide.md, references/markdown_read_protocol.md, and references/docs_quality_contract.md
2. Scan docs-first sources:
3. docs/**/*.md
4. tests/README.md
5. tests/manual/**/*
6. README.md
7. CONTRIBUTING.md
8. Use AGENTS.md, CLAUDE.md, and docs/project/.context/doc_registry.json only to route discovery
9. Classify candidate sections with the shared procedural extraction rules
10. Present the extraction plan to the user for approval
11. Create approved commands

Workflow

Phase 1: Prepare

Receive or build this normalized input:

{
  "approved_sections": [
    {
      "source_file": "docs/project/runbook.md",
      "section_header": "Deployment",
      "line_range": [45, 92],
      "command_name": "deploy.md",
      "doc_kind": "how-to",
      "doc_role": "canonical"
    }
  ]
}

MANDATORY READ: Load references/templates/command_template.md and references/procedural_skill_sop_guide.md

Phase 2: Transform and Create

For each approved section:

1. Read the source section using the shared markdown read protocol
2. Ignore standardized doc shell content if it appears in the selected range:
3. header markers such as DOC_KIND, DOC_ROLE, READ_WHEN, SKIP_WHEN, PRIMARY_SOURCES
4. Quick Navigation
5. Agent Entry
6. Maintenance
7. Detect allowed-tools

| Content Pattern | Tool | |----------------|------| | shell commands or fenced bash / sh blocks | Bash | | file reads or config inspection | Read | | file updates | Edit | | search steps | Grep, Glob | | skill calls | Skill | | approval gates | AskUserQuestion |

1. Transform the content with these rules:

| Rule | From | To | |------|------|----| | Voice | Declarative prose | Imperative instructions | | Code blocks | Source shell blocks | Preserve when executable | | Numbered lists | Doc prose | Ordered workflow steps | | Verification | Implicit expectations | Explicit verification checks | | Risky procedural steps | Hidden assumptions | Action, key point, why, evidence, exception, automation/guard | | Decision points | Blended into prose | Explicit IF/ELSE branch with evidence required per branch | | Dependencies/preflight | Assumed environment | First executable self-check before mutation or external invocation | | Exceptions | Implied troubleshooting | Concrete pause/retry/ask path | | Doc shell | Metadata and navigation | Remove | | Source provenance | Implied only | Explicit Source section | | Related docs | Inline refs | Related Documentation section |

1. Write .claude/commands/{command_name} if the file does not already exist

Phase 3: Report

Return:

created:
  - file: .claude/commands/deploy.md
    source: docs/project/runbook.md#Deployment
    lines: 85
    tools: [Bash, Read]
summary: "Created 1 command from 1 procedural section"

Critical Rules

• Template-driven: All output follows references/templates/command_template.md.
• Preserve source: Never modify or delete source docs.
• No invention: Do not add commands, steps, or paths absent from the source.
• Imperative voice: Every retained instruction must be actionable.
• SOP/TWI extraction: Preserve action, decision point, exception, validation, dependency/preflight, and why for risky procedural steps.
• No copied doc shell: Do not copy DOC_KIND, DOC_ROLE, Quick Navigation, Agent Entry, or Maintenance into commands.
• Source provenance: Every generated command must point back to its source doc and section.
• Relative paths: File references must stay relative to project root.
• Idempotent: Skip existing command files; do not overwrite them.

Definition of Done

• [ ] Approved sections received or discovered
• [ ] Source sections read with section-first protocol
• [ ] Allowed-tools detected per command
• [ ] Content transformed into imperative workflow steps
• [ ] Risky procedural steps include action, key point, why, evidence, exception, and automation/guard where applicable
• [ ] Standard doc shell content removed from command output
• [ ] Source provenance included in each created command
• [ ] Existing command files not overwritten
• [ ] Creation report returned

Version: 1.0.0 Last Updated: 2026-03-26