What problem does it solve?
This Skill empowers users to define specialized AI agent behaviors and tool access through custom agent files, ensuring AI agents perform tasks precisely according to repository-specific standards and requirements. It helps optimize AI performance for specific development workflows.
Core Features & Use Cases
- Flexible Agent Scoping: Define instructions repository-wide, path-specific, or as custom agent profiles for task-specific workflows.
- Granular Tool Control: Specify exactly which tools (e.g.,
read, edit, search, pr) an agent is allowed to use, enhancing security and focus.
- Custom Instructions: Provide natural language prompts and guidelines to shape the agent's behavior and output style.
- Integration with gh-aw: Seamlessly integrate custom agents into GitHub Agentic Workflows via the
imports field.
- Use Case: A team wants an AI agent to strictly follow frontend development guidelines. This skill guides them to create a
.github/instructions/frontend.instructions.md file with applyTo: "src/frontend/**" and specific instructions.
Quick Start
Consult the custom-agents skill to create a readme-creator.md agent profile that specializes in generating clear and comprehensive README files.