optimize-agent-instructions

Audit and rewrite AI agent instruction files using Karpathy principles.

5|3|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/richfrem/agent-plugins-skills --skill optimize-agent-instructions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: optimize-agent-instructions
Source: https://github.com/richfrem/agent-plugins-skills/tree/main/plugins/agent-agentic-os/skills/optimize-agent-instructions
Command: npx skills add https://github.com/richfrem/agent-plugins-skills --skill optimize-agent-instructions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Audits and rewrites the AI agent instruction files in a repo to produce authoritative, concise guidelines that govern agent behavior across CLAUDE.md, GEMINI.md, and Copilot instructions, removing stale or foreign content and applying Karpathy principles.

Core Features & Use Cases

  • Enforces a 12-point quality checklist across instruction files
  • Preserves project-specific rules while updating instructions to be more authoritative
  • Ensures platform-specific notes are present and consistent across files

Quick Start

Trigger an audit of agent instruction files to align them with Karpathy principles.

Frequently Asked Questions about optimize-agent-instructions

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

FAQPage Schema
How do I audit and rewrite AI agent instruction files like CLAUDE.md and Copilot instructions?

Auditing agent instruction files involves checking them against a 12-point quality checklist to enforce Karpathy principles and remove stale content. This process produces consistent, authoritative guidance across CLAUDE.md, GEMINI.md, and Copilot instructions.

What are Karpathy principles for AI agent instruction files?

Karpathy principles for agent instruction files enforce authoritative, concise guidelines that govern agent behavior. They are applied through a 12-point quality checklist to ensure instructions remain clear and consistent across different platforms.

Does the agent instruction audit work with GEMINI.md files?

Yes, the agent instruction audit works with GEMINI.md files by applying platform-specific notes and adding Gemini tool mapping. It ensures consistent, authoritative guidance across GEMINI.md, CLAUDE.md, and Copilot instructions within your repository.

How do I keep project-specific rules when updating Copilot instructions?

When updating Copilot instructions, the audit process preserves your existing project-specific rules. It removes stale or foreign content while applying a standardized 12-point checklist to maintain your customized agent behavior.

What's the best way to standardize agent instructions across multiple frameworks?

The best way to standardize agent instructions across multiple frameworks is to apply a standardized 12-point checklist and platform-specific notes. This enforces consistent, authoritative guidance across projects while eliminating stale or foreign content.

Why do I need to remove stale or foreign content from instruction files?

Removing stale or foreign content from instruction files is necessary to produce authoritative, concise guidelines that accurately govern agent behavior. This ensures your AI agents follow current, relevant project rules instead of outdated instructions.