Agent Skills

The PTB can package agent skills for use by projects and provides shared validation for their common structure and content rules.

Packaged skills maintained by the PTB

The following skill directories are provided by the PTB. Installing packaged skills can replace a project-local skill with the same name, so choose local skill names with this list in mind.

Skill directory	Intended use
api-contract-audit	Audits a Python library for mismatches between type annotations, docstrings, user-facing documentation, and runtime behavior.
exasol-python-toolbox	Guides agents in using PTB setup, Nox sessions, checks, workflows, updates, releases, and configuration.

Run the validation with:

poetry run -- nox -s skills:check

The session validates every skill packaged in exasol.toolbox.skills. It checks that each skill has SKILL.md with complete frontmatter, contains no unfinished TODO markers or forbidden repository-specific metadata, and has no duplicated Markdown lines. Nox command examples are kept in the skill’s references/nox-sessions.md file.

These shared checks are intentionally separate from skill-specific tests. The test suite validates the structure of every packaged skill and validates the structure of every available eval_cases.yml. When adding a skill, add its expected files and behavior assertions to the shared skill test patterns.

Installing packaged skills

Projects can install all skills packaged by their current PTB dependency with:

poetry run -- nox -s skills:install

The session copies each packaged skill into its own directory below .agents/skills. Existing files in those skill directories are replaced so the installed copies stay aligned with the PTB version.