skill · built into metaphor
/python
Python/pathlib idioms and pytest habits
- Built in
- Slash command
you ›/python
metaphor ›Loaded the python skill. What should I work on?
What the agent is told
This is the skill's SKILL.md, exactly what Metaphor reads before the task.
Prefer small, idiomatic changes that match the project's packaging and test runner.
Idioms
- Follow existing style (formatter/linter already in the repo: ruff, black, etc.).
- Prefer type hints where the surrounding module uses them.
- Keep imports sorted and avoid unused dependencies.
- Use pathlib for filesystem paths when peers do.
Testing
- Add tests next to existing pytest/unittest layout.
- Prefer temp directories for file I/O tests; clean up after.
Safety
- Never write secrets, API keys, or credentials into the tree.
- Avoid
eval/execon untrusted input. - Proposed edit paths must be repo-relative.
Questions
What is the python skill?
Python/pathlib idioms and pytest habits
How do I use python in Metaphor?
It is built into Metaphor. Type /python in the composer, or describe the task and the agent loads the skill when it fits.
What is a skill?
A skill is a set of written instructions the agent reads before it starts a kind of task. It changes how the agent works, not what it is allowed to do.
More built-in skills
- /ai-ciSkillBudgeted investigation of failed GitHub Actions / PR checks — bootstrap annotations first, then failed logs, localize to code, classify flake vs real vs infraships with metaphor
- /ai-prSkillBudgeted whole-PR critique via the pr subagent — map diff, evidence findings, return a pr_review_draft for the Agent Review canvasships with metaphor
- /ai-securitySkillBudgeted security and AI-agent risk review — ai_security scan, OSV CVE/GHSA lookups, OWASP LLM/MCP/Top10 tagging, draft for Agent Review canvasships with metaphor
- /ai-sreSkillBudgeted production investigation against connected observability/logs MCP servers — scope, resolve schema, query, correlate, conclude with evidenceships with metaphor
- /boardSkillHow to work on the shared Board canvas — when to use it, locking onto one board, teaching with drawings, tool choice, placement, camera, narration and the…ships with metaphor
- /board-designSkillDesign language for the Board canvas — layout grid, hierarchy, roles and colour, typography, arrows, frames and patterns for common diagram typesships with metaphor