Create skills registry in AGENTS.md with validation hook by Copilot · Pull Request #1532 · usethis-python/usethis-python

Copilot · 2026-03-25T03:52:41Z

Agents were ignoring available skills because AGENTS.md didn't enumerate them. Added a skills registry and a prek hook to keep it from rotting.

AGENTS.md: Added a skills registry table listing all 17 skills with descriptions. Fixed .agent/skills → .agents/skills typo.
hooks/check-skills-documented.py: Python script following the usethis-prek-hook-bespoke-create skill conventions that fails if any .agents/skills/*/ directory name isn't mentioned in AGENTS.md. Uses pure Python with pathlib, errors to stderr, success to stdout.
.pre-commit-config.yaml: Wired up the hook as a local prek hook at priority 0 via uv run --frozen --offline.
pyproject.toml: Added lint.per-file-ignores."hooks/**" = [ "D", "INP001" ] to disable docstring and implicit namespace package ruff rules for hook scripts.

When a new skill is added without updating AGENTS.md, the hook produces:

ERROR: The following skills are not mentioned in AGENTS.md:
  - my-new-skill

Please add them to the skills registry in AGENTS.md.

Original prompt

This section details on the original issue you should resolve

<issue_title>Create a skills registry in AGENTS.md</issue_title>
<issue_description>In #1528, the agent seems to completely ignore relevant skills. It's time to build a skills registry list into AGENTS.md.

To avoid it rotting, we should add a ./hooks directory at the root level where we add short hook scripts, which we set up to run via prek.

The hook should check that all skills (based on their names) are mentioned in the AGENTS.md file.</issue_description>

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

Fixes Create a skills registry in AGENTS.md #1531

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

- Update AGENTS.md with a complete skills registry table listing all skills and their descriptions - Create hooks/check-skills-documented script that verifies all skill directory names in .agents/skills/ are mentioned in AGENTS.md - Add check-skills-documented as a local prek hook in .pre-commit-config.yaml at priority 0 Co-authored-by: nathanjmcdougall <18602289+nathanjmcdougall@users.noreply.github.com> Agent-Logs-Url: https://github.com/usethis-python/usethis-python/sessions/8968f481-6345-4852-af05-448495a66340

Co-authored-by: nathanjmcdougall <18602289+nathanjmcdougall@users.noreply.github.com> Agent-Logs-Url: https://github.com/usethis-python/usethis-python/sessions/8968f481-6345-4852-af05-448495a66340

nathanjmcdougall · 2026-03-25T19:44:49Z

hooks/check-skills-documented

I'd want this in Python, not bash.

@copilot please re-write according to the priciples in the usethis-prek-hook-bespoke-create skill

Rewrote as a Python script following the usethis-prek-hook-bespoke-create skill conventions: pure Python with pathlib, errors to stderr, success to stdout, raise SystemExit(main()) pattern, and wired via uv run --frozen --offline. Also added 2 newly-created skills (usethis-prek-hook-bespoke-create, usethis-python-functions) to the registry. See commit ee508ba.

nathanjmcdougall · 2026-03-25T20:16:25Z

@copilot There's been a couple of new skills added onto main since you worked on this, please add them to pass the static checks.

- Replace bash script with Python script (hooks/check-skills-documented.py) - Follow usethis-prek-hook-bespoke-create skill conventions: pure Python, errors to stderr, success to stdout, raise SystemExit - Update .pre-commit-config.yaml entry to use uv run --frozen --offline - Add two newly-created skills to the registry: usethis-prek-hook-bespoke-create and usethis-python-functions Co-authored-by: nathanjmcdougall <18602289+nathanjmcdougall@users.noreply.github.com> Agent-Logs-Url: https://github.com/usethis-python/usethis-python/sessions/0911b302-1e44-4ea9-8b34-d57ad7e0e2f9

codspeed-hq · 2026-03-25T20:21:29Z

Merging this PR will not alter performance

✅ 2 untouched benchmarks

_{Comparing copilot/create-skills-registry-in-agents-md (3659f72) with main (398ff8d)}

Copilot · 2026-03-25T20:24:55Z

@copilot There's been a couple of new skills added onto main since you worked on this, please add them to pass the static checks.

Both usethis-prek-hook-bespoke-create and usethis-python-functions were already added to the registry in ee508ba. The CI failure was from commit 54a5d78 (prior to the fix). The CI runs for ee508ba are showing action_required (pending approval), which is why they haven't shown as passing yet.

codecov · 2026-03-25T20:36:11Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

📢 Thoughts on this report? Let us know!

nathanjmcdougall · 2026-03-25T21:11:30Z

@copilot Please disable INP001 and D rule codes in ruff config

…-registry-in-agents-md

…ffected-find to registry, merge main Co-authored-by: nathanjmcdougall <18602289+nathanjmcdougall@users.noreply.github.com> Agent-Logs-Url: https://github.com/usethis-python/usethis-python/sessions/bc26d8b8-cf79-44f7-a8e3-a1f6770b64c4

Copilot · 2026-03-25T21:15:28Z

@copilot Please disable INP001 and D rule codes in ruff config

Added lint.per-file-ignores."hooks/**" = [ "D", "INP001" ] to pyproject.toml. Also merged main and added the new usethis-python-test-affected-find skill to the registry. All static checks pass. See commit 3659f72.

Initial plan

420a547

Copilot AI assigned Copilot and nathanjmcdougall Mar 25, 2026

Copilot started work on behalf of nathanjmcdougall March 25, 2026 03:52 View session

Copilot AI and others added 2 commits March 25, 2026 03:55

Apply prettier formatting to AGENTS.md table

6e69464

Co-authored-by: nathanjmcdougall <18602289+nathanjmcdougall@users.noreply.github.com> Agent-Logs-Url: https://github.com/usethis-python/usethis-python/sessions/8968f481-6345-4852-af05-448495a66340

Copilot AI changed the title ~~[WIP] Add skills registry to AGENTS.md with validation hook~~ Create skills registry in AGENTS.md with validation hook Mar 25, 2026

Copilot AI requested a review from nathanjmcdougall March 25, 2026 03:59

Copilot finished work on behalf of nathanjmcdougall March 25, 2026 03:59

nathanjmcdougall reviewed Mar 25, 2026

View reviewed changes

nathanjmcdougall mentioned this pull request Mar 25, 2026

Create an agent skill for writing bespoke git hooks #1540

Closed

Copilot AI mentioned this pull request Mar 25, 2026

Create agent skill for writing bespoke prek hooks #1541

Merged

Merge branch 'main' into copilot/create-skills-registry-in-agents-md

ee56ee0

nathanjmcdougall had a problem deploying to codecov March 25, 2026 20:14 — with GitHub Actions Error

Copilot started work on behalf of nathanjmcdougall March 25, 2026 20:15 View session

Merge branch 'main' into copilot/create-skills-registry-in-agents-md

54a5d78

nathanjmcdougall temporarily deployed to codecov March 25, 2026 20:16 — with GitHub Actions Inactive

Copilot AI requested a review from nathanjmcdougall March 25, 2026 20:20

Copilot finished work on behalf of nathanjmcdougall March 25, 2026 20:20

Copilot started work on behalf of nathanjmcdougall March 25, 2026 20:20 View session

Copilot finished work on behalf of nathanjmcdougall March 25, 2026 20:26

Copilot AI temporarily deployed to codecov March 25, 2026 20:31 Inactive

nathanjmcdougall marked this pull request as ready for review March 25, 2026 20:31

Copilot started work on behalf of nathanjmcdougall March 25, 2026 21:11 View session

nathanjmcdougall mentioned this pull request Mar 25, 2026

Add to AGENTS.md an emphasis to always run the static checks skill #1553

Closed

Copilot AI mentioned this pull request Mar 25, 2026

Emphasize mandatory static checks in AGENTS.md #1554

Closed

Copilot AI and others added 2 commits March 25, 2026 21:13

Merge remote-tracking branch 'origin/main' into copilot/create-skills…

616ee15

…-registry-in-agents-md

Copilot AI temporarily deployed to codecov March 25, 2026 21:16 Inactive

nathanjmcdougall approved these changes Mar 25, 2026

View reviewed changes

Copilot AI requested a review from nathanjmcdougall March 25, 2026 21:16

Copilot finished work on behalf of nathanjmcdougall March 25, 2026 21:16

nathanjmcdougall merged commit c71af38 into main Mar 25, 2026
20 checks passed

nathanjmcdougall deleted the copilot/create-skills-registry-in-agents-md branch March 25, 2026 21:30

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Create skills registry in AGENTS.md with validation hook#1532

Create skills registry in AGENTS.md with validation hook#1532
nathanjmcdougall merged 8 commits intomainfrom
copilot/create-skills-registry-in-agents-md

Copilot AI commented Mar 25, 2026 •

edited

Loading

Uh oh!

nathanjmcdougall Mar 25, 2026

Uh oh!

nathanjmcdougall Mar 25, 2026

Uh oh!

Copilot AI Mar 25, 2026

Uh oh!

nathanjmcdougall commented Mar 25, 2026

Uh oh!

codspeed-hq bot commented Mar 25, 2026 •

edited

Loading

Uh oh!

Copilot AI commented Mar 25, 2026

Uh oh!

codecov bot commented Mar 25, 2026

Uh oh!

nathanjmcdougall commented Mar 25, 2026

Uh oh!

Copilot AI commented Mar 25, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

Copilot AI commented Mar 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

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

Uh oh!

nathanjmcdougall Mar 25, 2026

Choose a reason for hiding this comment

Uh oh!

nathanjmcdougall Mar 25, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 25, 2026

Choose a reason for hiding this comment

Uh oh!

nathanjmcdougall commented Mar 25, 2026

Uh oh!

codspeed-hq bot commented Mar 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Merging this PR will not alter performance

Uh oh!

Copilot AI commented Mar 25, 2026

Uh oh!

codecov bot commented Mar 25, 2026

Codecov Report

Uh oh!

nathanjmcdougall commented Mar 25, 2026

Uh oh!

Copilot AI commented Mar 25, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Copilot AI commented Mar 25, 2026 •

edited

Loading

codspeed-hq bot commented Mar 25, 2026 •

edited

Loading