playbook/outfitter-agents/.agents/notes/202512221158-skill-naming-s...

56 lines
2.0 KiB
Markdown

# Skill Naming Standardization
**Date**: 2025-12-22
**Scope**: All skills in `baselayer/skills/`
## Summary
Standardized all 18 skill names to use kebab-case consistently. Both directory names and YAML frontmatter `name:` fields now follow the same convention.
## Naming Patterns Applied
| Pattern | Examples |
|---------|----------|
| `*-dev` | bun-dev, hono-dev, react-dev, typescript-dev |
| `*-engineering` | software-engineering, performance-engineering, security-engineering |
| `*-authoring` / `*-check` | skills-authoring, skills-check, subagent-authoring, subagent-check |
| Descriptive | test-driven-development, debugging-and-diagnosis, research-and-report |
## Complete Rename List
| Old Name | New Name |
|----------|----------|
| senior-developer | software-engineering |
| architect | software-architecture |
| expertise-performance | performance-engineering |
| expertise-security | security-engineering |
| typescript-development | typescript-dev |
| dev-bun | bun-dev |
| dev-hono | hono-dev |
| dev-react | react-dev |
| tdd | test-driven-development |
| analysis | investigation |
| fresh-eyes-review | code-review |
| debugging | debugging-and-diagnosis |
| challenge-complexity | complexity-analysis |
| skill-authoring | skills-authoring |
| skill-check | skills-check |
| agent-authoring | subagent-authoring |
| agent-check | subagent-check |
| research | research-and-report |
## Cross-References Updated
Each rename included updates to all files referencing the old name:
- `baselayer/README.md` — skills table
- `baselayer/agents/*.md` — agent skill loading references
- `.claude/rules/*.md` — SUBAGENTS.md, COMMANDS.md, FORMATTING.md
- Other `SKILL.md` files with cross-skill references
- `.agents/plans/` documentation
## Notes
- **test-driven-development** keeps "tdd" in description for discoverability
- `subagent-*` naming aligns with Claude Code terminology (subagents vs agents)
- `skills-*` plural form distinguishes from singular skill references