levalencia Paths: File paths (
shared/,references/,../ln-*) are relative to skills repo root. If not found at CWD, locate this SKILL.md directory and go up one level for repo root.
ln-161-skill-creator
Type: L3 Worker (standalone-capable) Category: 1XX Documentation Pipeline Coordinator: ln-160-docs-skill-extractor (optional)
Creates .claude/commands/*.md files from procedural documentation sections. Transforms declarative prose into imperative executable instructions.
Overview
| Aspect | Details |
|---|---|
| Input | Procedural doc sections (from ln-160 contextStore or standalone scan) |
| Output | .claude/commands/*.md files in target project |
| Template | references/command_template.md |
Input Modes
| Mode | Trigger | Behavior |
|---|---|---|
| Worker | Invoked by ln-160 with contextStore | Use provided sections directly |
| Standalone | Invoked directly with $ARGUMENTS |
Self-discover + classify docs |
Standalone Discovery
When invoked directly (not via ln-160):
- If
$ARGUMENTS= file paths -> read those docs, extract procedural sections - If
$ARGUMENTS= "all" or empty -> scandocs/recursively - Classify sections using same rules as ln-160 Phase 2
MANDATORY READ: Load ../ln-160-docs-skill-extractor/references/classification_rules.md (standalone mode only)
- Present extraction plan to user via AskUserQuestion
- Create approved commands
- Recommend user to run ln-162-skill-reviewer for quality review
Workflow (Worker Mode)
Phase 1: Prepare
Receive contextStore with approved procedural sections:
approved_sections:
- source_file: docs/project/runbook.md
section_header: "Deployment"
line_range: [45, 92]
command_name: deploy.md
- source_file: tests/README.md
section_header: "Running Tests"
line_range: [15, 48]
command_name: run-tests.md
MANDATORY READ: Load references/command_template.md
Phase 2: Transform and Create
For each approved section:
Read source -- extract section content from source file at specified line range
Detect allowed-tools -- infer from content:
| Content Pattern | Tool |
|---|---|
| bash/sh code blocks, shell commands | Bash |
| File read/load references | Read |
| File modify/update instructions | Edit |
| Search/find in files | Grep, Glob |
| Skill invocations | Skill |
| User confirmation steps | AskUserQuestion |
Transform content using rules below
Write file to
.claude/commands/{command_name}
Transformation Rules
| Rule | From | To |
|---|---|---|
| Voice | Declarative ("The system uses X") | Imperative ("Run X") |
| Code blocks | Preserve as-is | Keep unchanged |
| Numbered lists | Description-style | Ordered workflow steps with ### headers |
| Verification | Implicit ("should work") | Explicit verification commands |
| Doc metadata | SCOPE tags, Maintenance sections | Remove |
| Troubleshooting | Prose | Table format (Issue / Solution) |
| Prerequisites | Mentioned inline | Dedicated Prerequisites table |
| Related docs | Inline references | Related Documentation section with relative links |
Phase 3: Report
Return to coordinator (or display to user in standalone mode):
created:
- file: .claude/commands/deploy.md
source: docs/project/runbook.md#Deployment
lines: 85
tools: [Bash, Read]
- file: .claude/commands/run-tests.md
source: tests/README.md#Running Tests
lines: 62
tools: [Bash]
summary: "Created 2 commands from 2 procedural sections"
Critical Rules
- Template-driven: All output follows
references/command_template.mdstructure - Preserve source: Never modify or delete source documentation files
- No invention: Only extract content that exists in source docs. Do NOT add commands, steps, or paths not found in the original
- Imperative voice: Every instruction must be actionable -- no passive descriptions
- Relative paths: All file references in created commands use paths relative to project root
- Idempotent: If command file already exists, skip (do not overwrite)
Definition of Done
- Source sections read at specified line ranges
- Allowed-tools detected per content patterns
- Content transformed to imperative voice (all transformation rules applied)
- Files written to
.claude/commands/{command_name} - Existing command files not overwritten (idempotent)
- Report returned with created file list and summary
Version: 1.0.0 Last Updated: 2026-03-13