Update all skill documentation and other docs with new ID format examples.
Scanned 5/31/2026
Install via CLI
openskills install tools-only/X-Skills# 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:No comments yet. Be the first to comment!
Create Mermaid diagrams for flowcharts, sequences, ERDs, and
Draft release notes and changelog entries from git history or merged PRs between two refs (tags/SHAs/branches), including breaking changes, migrations, and upgrade steps. Use when the user asks for release notes, changelog updates, or a GitHub Release draft.
Explain how claude-mem captures observations, when memory injection kicks in, and where data lives. Use when the user asks "how does claude-mem work?" or "what is this thing doing?".
Review a pull request or contribution deeply, explain it tutorial-style for a maintainer, and produce a polished report artifact such as HTML or Markdown. Use when asked to analyze a PR, explain a contributor's design decisions, compare it with similar systems, or prepare a merge recommendation.
Generate the stable Paperclip release changelog at releases/vYYYY.MDD.P.md by reading commits, changesets, and merged PR context since the last stable tag.