agent-instructions

Name: agent-instructions
Availability: InStock
Author: nima

Standardize project-specific instruction files for AI coding agents.

25|3|Updated Jul 14, 2026

Search Tags:#automation #context #onboarding #agent #coding #instructions

Ready to run

npx skills add https://github.com/nimadorostkar/Claude-Skills-collection --skill agent-instructions-nimadorostkar

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: agent-instructions
Source: https://github.com/nimadorostkar/Claude-Skills-collection/tree/main/skills/agent-tooling/agent-instructions
Command: npx skills add https://github.com/nimadorostkar/Claude-Skills-collection --skill agent-instructions-nimadorostkar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the common issue of coding agents making repetitive, incorrect assumptions about a codebase by providing a structured, high-signal instruction file.

Core Features & Use Cases

Context Optimization: Teaches how to encode project-specific conventions, build commands, and architectural constraints that an agent cannot infer from code alone.
Failure Mitigation: Provides a framework for documenting specific "traps" or common mistakes to prevent the agent from wasting turns on incorrect commands.
Use Case: Use this skill when setting up a new repository or when an agent repeatedly fails to use the correct test runner or ignores project-specific domain error handling patterns.

Quick Start

Use the agent-instructions skill to draft a CLAUDE.md file that defines our project build commands and domain error handling conventions.

Frequently Asked Questions about agent-instructions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I create project instructions for AI coding agents to stop them from making incorrect assumptions?▼

To create project instructions for AI coding agents, use a structured instruction file that encodes project-specific conventions, build commands, and architectural constraints. This minimizes token waste and prevents repetitive, incorrect assumptions by providing high-signal context.

What is a CLAUDE.md file and when do I need one for repository onboarding?▼

A CLAUDE.md file is a project-specific instruction file for AI coding agents used during repository onboarding. You need one when an agent repeatedly fails to use the correct test runner or ignores project-specific domain error handling patterns.

How do I document common failure points and traps to prevent coding agents from using incorrect commands?▼

Document common failure points and traps by creating a framework within your agent instruction file that explicitly lists specific mistakes and non-obvious architectural constraints. This prevents the agent from wasting turns on incorrect commands and mitigates hallucinations.

Can I use agent instruction files to optimize context and token usage for my coding automation?▼

Yes, you can use agent instruction files to optimize context and token usage. By clearly identifying project-specific commands and conventions, you provide high-signal context that minimizes token waste and improves task accuracy for coding automation.

What is the best way to standardize agent configuration for non-obvious architectural constraints?▼

The best way to standardize agent configuration for non-obvious architectural constraints is to define a structured instruction file. This ensures coding agents consistently apply project-specific conventions and domain error handling without guessing.