Skip to content

Add hierarchical naming convention guidance to usethis-skills-create#1543

Merged
nathanjmcdougall merged 2 commits intomainfrom
copilot/provide-guidance-naming-conventions
Mar 25, 2026
Merged

Add hierarchical naming convention guidance to usethis-skills-create#1543
nathanjmcdougall merged 2 commits intomainfrom
copilot/provide-guidance-naming-conventions

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Mar 25, 2026 •
edited
Loading

Skill names lacked guidance on ordering, leading to names like usethis-prek-bespoke-hook where subtopics precede topics, breaking alphabetical clustering of related skills.

  • Added ### Hierarchical naming subsection explaining the general-to-specific pattern: <project>-<domain>-<topic>-<subtopic>-<action>
  • Concrete good/bad examples using the bespoke hooks scenario
  • Alphabetical sorting heuristic for name validation
  • Added quality checklist item for hierarchical ordering
  • Bumped version to "1.1"
Original prompt

This section details on the original issue you should resolve

<issue_title>Provide guidance on naming conventions in usethis-skills-create</issue_title>
<issue_description>Main principle is to maintain organization through hierarchical naming patterns.

Bad:

usethis-prek-bespoke-hook

This would better be usethis-prek-hook-bespoke since the topic is hooks, and more specifically bespoke ones.

If the tool is narrow in scope, it's good to be specific about the action the skill involves for the topic, e.g. create, modify, etc.

So an even better name might be usethis-prek-hook-bespoke-create with view to potentially have another usethis-prek-hook-bespoke-modify separately, and potentially a higher-level usethis-prek-hook-bespoke "topic-skill" for general gudiance.</issue_description>

Comments on the Issue (you are @copilot in this section)

📍 Connect Copilot coding agent with Jira, Azure Boards or Linear to delegate work to Copilot in one click without leaving your project management tool.

@nathanjmcdougall
Add hierarchical naming convention guidance to usethis-skills-create …
436e0be 
…skill

Co-authored-by: nathanjmcdougall <18602289+nathanjmcdougall@users.noreply.github.com>
Agent-Logs-Url: https://github.com/usethis-python/usethis-python/sessions/1707b65b-698c-442d-b921-91122ac5df38
Copilot AI changed the title [WIP] Provide guidance on naming conventions in usethis-skills-create Add hierarchical naming convention guidance to usethis-skills-create Mar 25, 2026
Copilot AI requested a review from nathanjmcdougall March 25, 2026 20:04
@nathanjmcdougall nathanjmcdougall marked this pull request as ready for review March 25, 2026 20:05
@nathanjmcdougall nathanjmcdougall merged commit ceded75 into main Mar 25, 2026
@nathanjmcdougall nathanjmcdougall deleted the copilot/provide-guidance-naming-conventions branch March 25, 2026 20:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

1 more reviewer

@nathanjmcdougall nathanjmcdougall nathanjmcdougall approved these changes

Reviewers whose approvals may not affect merge requirements

Assignees

@nathanjmcdougall nathanjmcdougall

Copilot code review Copilot

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Provide guidance on naming conventions in usethis-skills-create

2 participants

@nathanjmcdougall