René's URL Explorer Experiment


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

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

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

Description: 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 Create a skills registry in AGENTS.md 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. Comments on the Issue (you are @copilot in this section) Fixes #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.

Open Graph Description: 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...

X Description: 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 lis...

Opengraph URL: https://github.com/usethis-python/usethis-python/pull/1532

X: @github

direct link

Domain: github.com

route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:8c29ac11-7845-406e-4398-156b49fc4117
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idD7E4:E69AB:EBCD80:14C3D22:6A4CAF12
html-safe-nonce326675ff378de255a7ca90c84cfbd70908914865f834452d0a0de8507266fe1e
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEN0U0OkU2OUFCOkVCQ0Q4MDoxNEMzRDIyOjZBNENBRjEyIiwidmlzaXRvcl9pZCI6IjIwNDcwODczNTA0MjUzNjYyOTAiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ==
visitor-hmacd4b29281e7eb6c4202613435d3989c39f1ae77a2e5ea297d5ac420f2c82f4f5f
hovercard-subject-tagpull_request:3442764842
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/usethis-python/usethis-python/pull/1532/files
twitter:imagehttps://avatars.githubusercontent.com/in/1143301?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/in/1143301?s=400&v=4
og:image:altAgents 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...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None3d11bb817438277de2a940854450e83a7d32b6aeb5014e9e6b00a6423900251c
turbo-cache-controlno-preview
diff-viewunified
go-importgithub.com/usethis-python/usethis-python git https://github.com/usethis-python/usethis-python.git
octolytics-dimension-user_id216362695
octolytics-dimension-user_loginusethis-python
octolytics-dimension-repository_id842189705
octolytics-dimension-repository_nwousethis-python/usethis-python
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id842189705
octolytics-dimension-repository_network_root_nwousethis-python/usethis-python
turbo-body-classeslogged-out env-production page-responsive full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
releaseae90d426644ca15e89bacceb72e51f4e9dbf85f7
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/usethis-python/usethis-python/pull/1532/files#start-of-content
https://github.com/
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fusethis-python%2Fusethis-python%2Fpull%2F1532%2Ffiles
GitHub CopilotWrite better code with AIhttps://github.com/features/copilot
GitHub Copilot appDirect agents from issue to mergehttps://github.com/features/ai/github-app
MCP RegistryNewIntegrate external toolshttps://github.com/mcp
ActionsAutomate any workflowhttps://github.com/features/actions
CodespacesInstant dev environmentshttps://github.com/features/codespaces
IssuesPlan and track workhttps://github.com/features/issues
Code ReviewManage code changeshttps://github.com/features/code-review
GitHub Advanced SecurityFind and fix vulnerabilitieshttps://github.com/security/advanced-security
Code securitySecure your code as you buildhttps://github.com/security/advanced-security/code-security
Secret protectionStop leaks before they starthttps://github.com/security/advanced-security/secret-protection
Why GitHubhttps://github.com/why-github
Documentationhttps://docs.github.com
Bloghttps://github.blog
Changeloghttps://github.blog/changelog
Marketplacehttps://github.com/marketplace
View all featureshttps://github.com/features
Enterpriseshttps://github.com/enterprise
Small and medium teamshttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
App Modernizationhttps://github.com/solutions/use-case/app-modernization
DevSecOpshttps://github.com/solutions/use-case/devsecops
DevOpshttps://github.com/solutions/use-case/devops
CI/CDhttps://github.com/solutions/use-case/ci-cd
View all use caseshttps://github.com/solutions/use-case
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
View all industrieshttps://github.com/solutions/industry
View all solutionshttps://github.com/solutions
AIhttps://github.com/resources/articles?topic=ai
Software Developmenthttps://github.com/resources/articles?topic=software-development
DevOpshttps://github.com/resources/articles?topic=devops
Securityhttps://github.com/resources/articles?topic=security
View all topicshttps://github.com/resources/articles
Customer storieshttps://github.com/customer-stories
Events & webinarshttps://github.com/resources/events
Ebooks & reportshttps://github.com/resources/whitepapers
Business insightshttps://github.com/solutions/executive-insights
GitHub Skillshttps://skills.github.com
Documentationhttps://docs.github.com
Customer supporthttps://support.github.com
Community forumhttps://github.com/orgs/community/discussions
Trust centerhttps://github.com/trust-center
Partnershttps://github.com/partners
View all resourceshttps://github.com/resources
GitHub SponsorsFund open source developershttps://github.com/sponsors
Security Labhttps://securitylab.github.com
Maintainer Communityhttps://maintainers.github.com
Acceleratorhttps://github.com/accelerator
GitHub Starshttps://stars.github.com
Archive Programhttps://archiveprogram.github.com
Topicshttps://github.com/topics
Trendinghttps://github.com/trending
Collectionshttps://github.com/collections
Enterprise platformAI-powered developer platformhttps://github.com/enterprise
GitHub Advanced SecurityEnterprise-grade security featureshttps://github.com/security/advanced-security
Copilot for BusinessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/premium-support
Pricinghttps://github.com/pricing
Search syntax tipshttps://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax
documentationhttps://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fusethis-python%2Fusethis-python%2Fpull%2F1532%2Ffiles
Sign up https://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=usethis-python%2Fusethis-python
Reloadhttps://github.com/usethis-python/usethis-python/pull/1532/files
Reloadhttps://github.com/usethis-python/usethis-python/pull/1532/files
Reloadhttps://github.com/usethis-python/usethis-python/pull/1532/files
Please reload this pagehttps://github.com/usethis-python/usethis-python/pull/1532/files
usethis-python https://github.com/usethis-python
usethis-pythonhttps://github.com/usethis-python/usethis-python
Notifications https://github.com/login?return_to=%2Fusethis-python%2Fusethis-python
Fork 5 https://github.com/login?return_to=%2Fusethis-python%2Fusethis-python
Star 19 https://github.com/login?return_to=%2Fusethis-python%2Fusethis-python
Code https://github.com/usethis-python/usethis-python
Issues 163 https://github.com/usethis-python/usethis-python/issues
Pull requests 4 https://github.com/usethis-python/usethis-python/pulls
Actions https://github.com/usethis-python/usethis-python/actions
Security and quality 0 https://github.com/usethis-python/usethis-python/security
Insights https://github.com/usethis-python/usethis-python/pulse
Code https://github.com/usethis-python/usethis-python
Issues https://github.com/usethis-python/usethis-python/issues
Pull requests https://github.com/usethis-python/usethis-python/pulls
Actions https://github.com/usethis-python/usethis-python/actions
Security and quality https://github.com/usethis-python/usethis-python/security
Insights https://github.com/usethis-python/usethis-python/pulse
Sign up for GitHub https://github.com/signup?return_to=%2Fusethis-python%2Fusethis-python%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Fusethis-python%2Fusethis-python%2Fissues%2Fnew%2Fchoose
nathanjmcdougallhttps://github.com/nathanjmcdougall
mainhttps://github.com/usethis-python/usethis-python/tree/main
copilot/create-skills-registry-in-agents-mdhttps://github.com/usethis-python/usethis-python/tree/copilot/create-skills-registry-in-agents-md
Conversation 9 https://github.com/usethis-python/usethis-python/pull/1532
Commits 8 https://github.com/usethis-python/usethis-python/pull/1532/commits
Checks 20 https://github.com/usethis-python/usethis-python/pull/1532/checks
Files changed https://github.com/usethis-python/usethis-python/pull/1532/files
Please reload this pagehttps://github.com/usethis-python/usethis-python/pull/1532/files
Create skills registry in AGENTS.md with validation hook https://github.com/usethis-python/usethis-python/pull/1532/files#top
Show all changes 8 commits https://github.com/usethis-python/usethis-python/pull/1532/files
420a547 Initial plan Copilot Mar 25, 2026 https://github.com/usethis-python/usethis-python/pull/1532/commits/420a547c6d2f92b99a4a509906fae4ad04774a96
856f7f6 Create skills registry in AGENTS.md and add prek hook to validate it Copilot Mar 25, 2026 https://github.com/usethis-python/usethis-python/pull/1532/commits/856f7f6eb531b292a3c91f2e2e0b4400f0ac787d
6e69464 Apply prettier formatting to AGENTS.md table Copilot Mar 25, 2026 https://github.com/usethis-python/usethis-python/pull/1532/commits/6e6946499c2b683283e5ec6048f909a34d9b9aec
ee56ee0 Merge branch 'main' into copilot/create-skills-registry-in-agents-md nathanjmcdougall Mar 25, 2026 https://github.com/usethis-python/usethis-python/pull/1532/commits/ee56ee020b5bfc8e8a024ca1c028af7bc533fc0b
54a5d78 Merge branch 'main' into copilot/create-skills-registry-in-agents-md nathanjmcdougall Mar 25, 2026 https://github.com/usethis-python/usethis-python/pull/1532/commits/54a5d788cdad0821f87673b205c150e823008470
ee508ba Rewrite check-skills-documented hook in Python per bespoke hook skill Copilot Mar 25, 2026 https://github.com/usethis-python/usethis-python/pull/1532/commits/ee508bae54633a3e385f5cfd85af710139a627a1
616ee15 Merge remote-tracking branch 'origin/main' into copilot/create-skills… Copilot Mar 25, 2026 https://github.com/usethis-python/usethis-python/pull/1532/commits/616ee15efabf6a85fe583a05074a071866caf069
3659f72 Disable INP001 and D ruff rules for hooks/, add usethis-python-test-a… Copilot Mar 25, 2026 https://github.com/usethis-python/usethis-python/pull/1532/commits/3659f7285972857a0cf5e551e0c8068e5b135b4b
Clear filters https://github.com/usethis-python/usethis-python/pull/1532/files
Please reload this pagehttps://github.com/usethis-python/usethis-python/pull/1532/files
Please reload this pagehttps://github.com/usethis-python/usethis-python/pull/1532/files
.pre-commit-config.yaml https://github.com/usethis-python/usethis-python/pull/1532/files#diff-63a9c44a44acf85fea213a857769990937107cf072831e1a26808cfde9d096b9
AGENTS.md https://github.com/usethis-python/usethis-python/pull/1532/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9
check-skills-documented.py https://github.com/usethis-python/usethis-python/pull/1532/files#diff-7661db0a47174d5db899a44a3bf436706119c0ec744d7bb8a08efcff08b8b179
pyproject.toml https://github.com/usethis-python/usethis-python/pull/1532/files#diff-50c86b7ed8ac2cf95bd48334961bf0530cdc77b5a56f852c5c61b89d735fd711
.pre-commit-config.yamlhttps://github.com/usethis-python/usethis-python/pull/1532/files#diff-63a9c44a44acf85fea213a857769990937107cf072831e1a26808cfde9d096b9
View file https://github.com/usethis-python/usethis-python/blob/3659f7285972857a0cf5e551e0c8068e5b135b4b/.pre-commit-config.yaml
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/usethis-python/usethis-python/pull/1532/{{ revealButtonHref }}
https://github.com/usethis-python/usethis-python/pull/1532/files#diff-63a9c44a44acf85fea213a857769990937107cf072831e1a26808cfde9d096b9
https://github.com/usethis-python/usethis-python/pull/1532/files#diff-63a9c44a44acf85fea213a857769990937107cf072831e1a26808cfde9d096b9
AGENTS.mdhttps://github.com/usethis-python/usethis-python/pull/1532/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9
View file https://github.com/usethis-python/usethis-python/blob/3659f7285972857a0cf5e551e0c8068e5b135b4b/AGENTS.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/usethis-python/usethis-python/pull/1532/{{ revealButtonHref }}
https://github.com/usethis-python/usethis-python/pull/1532/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9
hooks/check-skills-documented.pyhttps://github.com/usethis-python/usethis-python/pull/1532/files#diff-7661db0a47174d5db899a44a3bf436706119c0ec744d7bb8a08efcff08b8b179
View file https://github.com/usethis-python/usethis-python/blob/3659f7285972857a0cf5e551e0c8068e5b135b4b/hooks/check-skills-documented.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/usethis-python/usethis-python/pull/1532/{{ revealButtonHref }}
pyproject.tomlhttps://github.com/usethis-python/usethis-python/pull/1532/files#diff-50c86b7ed8ac2cf95bd48334961bf0530cdc77b5a56f852c5c61b89d735fd711
View file https://github.com/usethis-python/usethis-python/blob/3659f7285972857a0cf5e551e0c8068e5b135b4b/pyproject.toml
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/usethis-python/usethis-python/pull/1532/{{ revealButtonHref }}
https://github.com/usethis-python/usethis-python/pull/1532/files#diff-50c86b7ed8ac2cf95bd48334961bf0530cdc77b5a56f852c5c61b89d735fd711
https://github.com/usethis-python/usethis-python/pull/1532/files#diff-50c86b7ed8ac2cf95bd48334961bf0530cdc77b5a56f852c5c61b89d735fd711
Please reload this pagehttps://github.com/usethis-python/usethis-python/pull/1532/files
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width

URLs of crawlers that visited me.