# 230 Fn 23 Zgk4 1a30e731

> fn-23-zgk.4 Update skill docs and documentation

- Skill: `tools-only/230-fn-23-zgk4-1a30e731` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/230-fn-23-zgk4-1a30e731`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/230-fn-23-zgk4-1a30e731/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/tools-only/230-fn-23-zgk4-1a30e731

---

# fn-23-zgk.4 Update skill docs and documentation

## Description
Update all skill documentation and other docs with new ID format examples.

**Size:** M
**Files:** 
- `plugins/flow-next/skills/*/SKILL.md` (~11 files)
- `plugins/flow-next/skills/*/steps.md`, `workflow.md`, etc.
- `plugins/flow-next/README.md`
- `plugins/flow-next/docs/flowctl.md`
- `.flow/usage.md`
- `plugins/flow-next/skills/flow-next-setup/templates/usage.md`

## Approach

1. Update skill SKILL.md files:
   ```bash
   grep -r "fn-[0-9]-[a-z0-9]\{3\}" plugins/flow-next/skills/
   ```
   Replace `fn-1-abc` style examples with `fn-1-add-feature` style

2. Update README.md ID Format section (line ~1294):
   - Explain new format: `fn-N-slug` where slug is derived from title
   - Note backwards compat with `fn-N` and `fn-N-xxx`

3. Update flowctl.md ID Format section (line ~46):
   - Same explanation as README

4. Update usage.md files:
   - `.flow/usage.md` (lines 25-28)
   - `templates/usage.md` (same section)

## Key context

Keep examples realistic:
- `fn-1-add-oauth` not `fn-1-abc`
- `fn-2-fix-login-bug` not `fn-2-xyz`
- Show variety: short slugs, multi-word slugs
## Acceptance
- [ ] All SKILL.md files updated (~11 files)
- [ ] README.md ID Format section explains new format
- [ ] flowctl.md ID Format section updated
- [ ] .flow/usage.md updated
- [ ] templates/usage.md updated
- [ ] Examples use descriptive slugs throughout
- [ ] Backwards compatibility note present (old formats still work)
- [ ] No broken example IDs (all match new regex)
## Done summary
Updated all skill docs and documentation with new descriptive slug ID format examples. Replaced random 3-char suffix examples (fn-1-abc) with meaningful slugs (fn-1-add-oauth, fn-2-fix-login-bug) across 12 files including SKILL.md files, README, flowctl.md, and usage.md templates.
## Evidence
- Commits: c9e9547f0ca2d05a8fad80f03bd089d8adde20b1
- Tests: grep -r 'fn-[0-9]-[a-z]{3}' plugins/flow-next/skills/ (verified no old-format examples remain)
- PRs: