@shinyaz

Naming Kiro skills consistently with existing patterns improves discoverability

1 min read

I was about to create a skill for static page creation and initially named it add-page. Then I looked at the existing skills — content creation ones all followed a {type}-guide pattern: post-guide, til-guide.

add-page starts with a verb, which groups it with action-oriented skills like fix-lint and debug-build. But page-guide immediately signals "content creation guide" alongside its siblings:

# Content creation ({type}-guide)
post-guide
til-guide
page-guide     ← fits naturally here
 
# Actions ({verb}-{target})
fix-lint
debug-build
run-tests

Skill naming matters beyond aesthetics. Agents use the name and description fields for auto-selection, but consistent naming patterns also help humans scan and manage the skill directory without second-guessing where things belong.

Share this post

Shinya Tahara

Shinya Tahara

Solutions Architect @ AWS

I'm a Solutions Architect at AWS, providing technical guidance primarily to financial industry customers. I share learnings about cloud architecture and AI/ML on this site.The views and opinions expressed on this site are my own and do not represent the official positions of my employer.