agent-instructions
Installation
SKILL.md
agent-instructions Skill
Purpose: Create or refresh instruction files that guide agent behavior and reduce repeated mistakes without rewriting the repository or enforcing tool choices that contradict the codebase.
Use this skill when
- Instruction files are missing, incomplete, or stale (no recent audit or updates)
- Agents repeatedly make the same mistake in a repository (e.g., always choosing a tool not suitable for this codebase, using wrong file paths, or using anti-patterns)
- A file-type or path-specific instruction file does not exist but the codebase has clear conventions (e.g., a TypeScript project with strict tsconfig, or a Terraform repo with specific backend patterns)
- Agent instruction files (AGENTS.md for Pi, copilot-instructions.md for Copilot) have grown large or overly generic and need to be split into focused per-path guides
- You need to document non-obvious operational constraints (signing requirements, security policies, deployment gates, testing procedures, environment setup)
- A repository has learned rules (lessons from prior corrections) that should be captured proactively