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

Do not use this skill when

Installs
5
GitHub Stars
4
First Seen
Sep 1, 2026