Skip to content

Guide agents to prefer general skills over narrow stub skills#1741

Merged
nathanjmcdougall merged 3 commits intomainfrom
copilot/update-agent-config-for-skills
Apr 1, 2026
Merged

Guide agents to prefer general skills over narrow stub skills#1741
nathanjmcdougall merged 3 commits intomainfrom
copilot/update-agent-config-for-skills

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 1, 2026

Agents were creating overly narrow skills (e.g. usethis-file-placement) instead of identifying that a more general skill (usethis-file-create) was the right abstraction level. The "when in doubt, create a new skill" default encouraged this.

Updates usethis-skills-create skill (v1.6 → v1.7):

  • Reversed default guidance: "When in doubt" now favors adding to an existing general skill rather than creating a new narrow one
  • New "Choosing the right scope" section with the hierarchy brainstorming technique — work from ultra-specific to fully general to reveal skill gaps:
    usethis-file-create-placement → usethis-file-create → usethis-file → usethis
    
    Then create at the most general level where guidance remains cohesive, not the most specific.
  • Updated procedure: Scope validation via hierarchy brainstorming is now step 1, before creating any files
  • Updated quality checklist: Two new checks — hierarchy validation and "not too narrow" verification

Copilot AI and others added 2 commits April 1, 2026 18:50
…kills

Add "Choosing the right scope" section with hierarchy brainstorming
technique to help agents identify skill gaps and prefer general skills
over narrowly focused ones. Update procedure, quality checklist, and
reverse "when in doubt" guidance to prefer adding to existing skills.

Bump version 1.6 -> 1.7.

Agent-Logs-Url: https://github.com/usethis-python/usethis-python/sessions/a133d726-d57e-415d-a0a2-a85ae895c6a8

Co-authored-by: nathanjmcdougall <18602289+nathanjmcdougall@users.noreply.github.com>
Copilot AI changed the title [WIP] Update agent config to prevent creation of narrowly scoped skills Guide agents to prefer general skills over narrow stub skills Apr 1, 2026
Copilot AI requested a review from nathanjmcdougall April 1, 2026 18:52
@nathanjmcdougall nathanjmcdougall marked this pull request as ready for review April 1, 2026 19:01
@nathanjmcdougall nathanjmcdougall merged commit dad5d10 into main Apr 1, 2026
1 check passed
@nathanjmcdougall nathanjmcdougall deleted the copilot/update-agent-config-for-skills branch April 1, 2026 19:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Agent config to guide against creating skills with too narrow a scope

2 participants