René's URL Explorer Experiment


Title: Add `usethis-agents` skill with auto-generated skills directory by Copilot · Pull Request #1630 · usethis-python/usethis-python · GitHub

Open Graph Title: Add `usethis-agents` skill with auto-generated skills directory by Copilot · Pull Request #1630 · usethis-python/usethis-python

X Title: Add `usethis-agents` skill with auto-generated skills directory by Copilot · Pull Request #1630 · usethis-python/usethis-python

Description: Agent reference material (function lists, module trees, skill directories) should be extracted from source via automation hooks, not maintained by hand. This PR codifies that principle as a skill and applies it to the skills directory itself. New skill: usethis-agents Documents the one-source-of-truth principle for agent configuration: use docstrings/frontmatter as the canonical source and prek hooks to extract them into docs/ files, synced into markdown via markers. Covers: When and how to apply the principle AGENTS.md maintenance (sync blocks, skills registry, validation hooks) The skill content is kept generic — it describes the principle and procedures without project-specific references, referring only to .agents/skills/ generically. New hook: export-skills-directory hooks/export-skills-directory.py scans .agents/skills/usethis-*/SKILL.md, extracts name and description from YAML frontmatter, writes a Markdown bullet list to docs/skills-directory.txt Modeled after export-module-tree.py — same CLI pattern (--skills-dir, --output-file, --prefix) Config changes .pre-commit-config.yaml: added export-skills-directory hook AGENTS.md: added usethis-agents to skills registry; usethis-specific skills section now uses markers to stay in sync with the generated file ⌨️ Start Copilot coding agent tasks without leaving your editor — available in VS Code, Visual Studio, JetBrains IDEs and Eclipse.

Open Graph Description: Agent reference material (function lists, module trees, skill directories) should be extracted from source via automation hooks, not maintained by hand. This PR codifies that principle as a skill a...

X Description: Agent reference material (function lists, module trees, skill directories) should be extracted from source via automation hooks, not maintained by hand. This PR codifies that principle as a skill a...

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

X: @github

direct link

Domain: github.com

route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:2ab91ddb-ebb5-1781-b777-76c2c3bd0860
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idCA9E:DF2CA:9F6DC:E8A5F:6A4CF5B8
html-safe-nonce2366ac70f7b0782d2750e0a735cc402081b2223bc9de5cc57f1f6b192c8ed6be
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDQTlFOkRGMkNBOjlGNkRDOkU4QTVGOjZBNENGNUI4IiwidmlzaXRvcl9pZCI6IjU2MzgyNjc5MDkyOTk4MjgxNTIiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ==
visitor-hmac958474b8f9aefd8372524b1b553cbc7f043643c5f9842b62c0635ce175df1a7f
hovercard-subject-tagpull_request:3463302537
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/1630/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:altAgent reference material (function lists, module trees, skill directories) should be extracted from source via automation hooks, not maintained by hand. This PR codifies that principle as a skill a...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None31e4db13a9e20081f2fac78f441659a6576e582bbb15e153f9c7fb6473aa29f5
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
release8307e9ba117a26e92a64fb1daf085d795a6552ed
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/usethis-python/usethis-python/pull/1630/changes#start-of-content
https://github.com/
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fusethis-python%2Fusethis-python%2Fpull%2F1630%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%2F1630%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/1630/changes
Reloadhttps://github.com/usethis-python/usethis-python/pull/1630/changes
Reloadhttps://github.com/usethis-python/usethis-python/pull/1630/changes
Please reload this pagehttps://github.com/usethis-python/usethis-python/pull/1630/changes
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/add-usethis-agents-skillhttps://github.com/usethis-python/usethis-python/tree/copilot/add-usethis-agents-skill
Conversation 10 https://github.com/usethis-python/usethis-python/pull/1630
Commits 4 https://github.com/usethis-python/usethis-python/pull/1630/commits
Checks 20 https://github.com/usethis-python/usethis-python/pull/1630/checks
Files changed https://github.com/usethis-python/usethis-python/pull/1630/files
Please reload this pagehttps://github.com/usethis-python/usethis-python/pull/1630/changes
Add usethis-agents skill with auto-generated skills directory https://github.com/usethis-python/usethis-python/pull/1630/changes#top
Show all changes 4 commits https://github.com/usethis-python/usethis-python/pull/1630/files
e005e67 Initial plan Copilot Mar 29, 2026 https://github.com/usethis-python/usethis-python/pull/1630/commits/e005e673ec0448c2d0b8775096ba9e3e4c920026
3c69a29 Add usethis-agents skill with auto-generated skills directory Copilot Mar 29, 2026 https://github.com/usethis-python/usethis-python/pull/1630/commits/3c69a2947080b7f2da237e53b7fa4ec89d8d3b37
cbce013 Remove skills directory and usethis-specific references from usethis-… Copilot Mar 29, 2026 https://github.com/usethis-python/usethis-python/pull/1630/commits/cbce0139683663c17ebef8aa95f87ab3b9140954
1eec8eb Address review: bullet format, sync markers, simpler description Copilot Mar 29, 2026 https://github.com/usethis-python/usethis-python/pull/1630/commits/1eec8eb4aa8cd1a9d55a69b49222d392dc53cb90
Clear filters https://github.com/usethis-python/usethis-python/pull/1630/files
Please reload this pagehttps://github.com/usethis-python/usethis-python/pull/1630/changes
Please reload this pagehttps://github.com/usethis-python/usethis-python/pull/1630/changes
SKILL.md https://github.com/usethis-python/usethis-python/pull/1630/changes#diff-707c6bd79a346951d526e04ca7bf48fe896347f0f03100aa24110282a40c69bb
.pre-commit-config.yaml https://github.com/usethis-python/usethis-python/pull/1630/changes#diff-63a9c44a44acf85fea213a857769990937107cf072831e1a26808cfde9d096b9
AGENTS.md https://github.com/usethis-python/usethis-python/pull/1630/changes#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9
skills-directory.txt https://github.com/usethis-python/usethis-python/pull/1630/changes#diff-c87d3011f99c594a44d10eb38b5e3d0a7b5b47bcccdd990083e1d2e76319ec3f
export-skills-directory.py https://github.com/usethis-python/usethis-python/pull/1630/changes#diff-83b63835430fb4f92862850647ee21b534a9c50ae8afcdb3a5443def270cd988
.agents/skills/usethis-agents/SKILL.mdhttps://github.com/usethis-python/usethis-python/pull/1630/changes#diff-707c6bd79a346951d526e04ca7bf48fe896347f0f03100aa24110282a40c69bb
View file https://github.com/usethis-python/usethis-python/blob/1eec8eb4aa8cd1a9d55a69b49222d392dc53cb90/.agents/skills/usethis-agents/SKILL.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/usethis-python/usethis-python/pull/1630/{{ revealButtonHref }}
.pre-commit-config.yamlhttps://github.com/usethis-python/usethis-python/pull/1630/changes#diff-63a9c44a44acf85fea213a857769990937107cf072831e1a26808cfde9d096b9
View file https://github.com/usethis-python/usethis-python/blob/1eec8eb4aa8cd1a9d55a69b49222d392dc53cb90/.pre-commit-config.yaml
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/usethis-python/usethis-python/pull/1630/{{ revealButtonHref }}
https://github.com/usethis-python/usethis-python/pull/1630/changes#diff-63a9c44a44acf85fea213a857769990937107cf072831e1a26808cfde9d096b9
https://github.com/usethis-python/usethis-python/pull/1630/changes#diff-63a9c44a44acf85fea213a857769990937107cf072831e1a26808cfde9d096b9
AGENTS.mdhttps://github.com/usethis-python/usethis-python/pull/1630/changes#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9
View file https://github.com/usethis-python/usethis-python/blob/1eec8eb4aa8cd1a9d55a69b49222d392dc53cb90/AGENTS.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/usethis-python/usethis-python/pull/1630/{{ revealButtonHref }}
https://github.com/usethis-python/usethis-python/pull/1630/changes#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9
https://github.com/usethis-python/usethis-python/pull/1630/changes#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9
docs/skills-directory.txthttps://github.com/usethis-python/usethis-python/pull/1630/changes#diff-c87d3011f99c594a44d10eb38b5e3d0a7b5b47bcccdd990083e1d2e76319ec3f
View file https://github.com/usethis-python/usethis-python/blob/1eec8eb4aa8cd1a9d55a69b49222d392dc53cb90/docs/skills-directory.txt
Open in desktop https://desktop.github.com
Please reload this pagehttps://github.com/usethis-python/usethis-python/pull/1630/changes
https://github.co/hiddenchars
https://github.com/usethis-python/usethis-python/pull/1630/{{ revealButtonHref }}
hooks/export-skills-directory.pyhttps://github.com/usethis-python/usethis-python/pull/1630/changes#diff-83b63835430fb4f92862850647ee21b534a9c50ae8afcdb3a5443def270cd988
View file https://github.com/usethis-python/usethis-python/blob/1eec8eb4aa8cd1a9d55a69b49222d392dc53cb90/hooks/export-skills-directory.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/usethis-python/usethis-python/pull/1630/{{ revealButtonHref }}
Please reload this pagehttps://github.com/usethis-python/usethis-python/pull/1630/changes
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.