The `.agents/skills` directory contains agent skills.

| Skill | Description |

| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |

| `github-actions-update` | Update GitHub Actions workflows |

| `usethis-file-remove` | Remove files from the project |

| `usethis-pre-commit` | Guidance on pre-commit hooks — this project uses prek, not pre-commit directly |

| `usethis-prek-add-hook` | Add a prek hook for dev |

| `usethis-prek-hook-bespoke-create` | Write bespoke prek hooks as Python scripts for custom project-specific checks |

| `usethis-python-code` | Guidelines for Python code design decisions such as when to share vs. duplicate code |

| `usethis-python-code-modify` | Modify Python code (e.g. refactor, add new code, or delete code) |

| `usethis-python-enum` | Style and testing conventions for working with Python enums |

| `usethis-python-functions` | Guidelines for Python function design, including return types and signature simplicity |

| `usethis-python-module-layout-modify` | Modify the Python module layout (create, move, rename, or delete modules) |

| `usethis-python-ruff` | Guidelines for complying with Ruff linter rules instead of suppressing them |

| `usethis-python-test-affected-find` | Identify tests that are potentially affected by code changes, to catch regressions before CI |

| `usethis-qa-import-linter` | Use the Import Linter software on the usethis project |

| `usethis-qa-static-checks` | Perform static code checks |

| `usethis-skills-create` | Create new agent skills (SKILL.md files) following best practices for content quality, structure, and discoverability |

| `usethis-skills-modify` | Modify agent skills (SKILL.md files) |

| `usethis-test-with-coverage` | Write tests that achieve full code coverage and verify coverage locally before pushing |

from __future__ import annotations

import sys

from pathlib import Path

AGENTS_MD = Path("AGENTS.md")

SKILLS_DIR = Path(".agents/skills")

def main() -> int:

if not AGENTS_MD.is_file():

print(f"ERROR: {AGENTS_MD} not found.", file=sys.stderr)

return 1

if not SKILLS_DIR.is_dir():

print(f"ERROR: {SKILLS_DIR} directory not found.", file=sys.stderr)

return 1

agents_md_content = AGENTS_MD.read_text()

missing = [

d.name

for d in sorted(SKILLS_DIR.iterdir())

if d.is_dir() and d.name not in agents_md_content

]

if missing:

print(

"ERROR: The following skills are not mentioned in AGENTS.md:",

file=sys.stderr,

)

for skill in missing:

print(f" - {skill}", file=sys.stderr)

print(file=sys.stderr)

print("Please add them to the skills registry in AGENTS.md.", file=sys.stderr)

return 1

print("All skills are documented in AGENTS.md.")

return 0

if __name__ == "__main__":

raise SystemExit(main())

lint.per-file-ignores."hooks/**" = [ "D", "INP001" ]