Create and maintain AI instruction files (CLAUDE.md, AGENTS.md, .cursor/rules/, etc.) with proper structure.
Use when: creating AI instruction files, separating universal vs project-specific rules, configuring AI tools.
Keywords: CLAUDE.md, AGENTS.md, cursorrules, windsurfrules, clinerules, AI instructions, system prompt.
Instrucciones de origen · Vista previa de solo lectura
name
ai-instruction-standards
scope
partial
description
Create and maintain AI instruction files (CLAUDE.md, AGENTS.md, .cursor/rules/, etc.) with proper structure.
Use when: creating AI instruction files, separating universal vs project-specific rules, configuring AI tools.
Keywords: CLAUDE.md, AGENTS.md, cursorrules, windsurfrules, clinerules, AI instructions, system prompt.
Version: 2.0.0
Last Updated: 2026-04-28
Applicability: All AI coding tools
Core Standard: This skill implements AI Instruction File Standards. For comprehensive methodology documentation, refer to the core standard.
AI Skills Hierarchy | AI 技能層級
This skill is part of a three-layer AI collaboration system:
Layer
Skill
Question it Answers
Behavior (Immediate)
/ai-collaboration
"How should AI respond accurately?"
Configuration (Session)
/ai-instruction-standards (this)
"What to write in CLAUDE.md / AGENTS.md?"
Architecture (Long-term)
/ai-friendly-architecture
"How to structure code for AI?"
Purpose
This skill helps create and maintain AI instruction files with proper separation between universal standards and project-specific configurations, across all major AI coding tools.
Quick Reference
Supported AI Tools (2026-04-28)
CLI / Agent Tools (Terminal)
Tool
Primary File
Workflow Mechanism
MCP
Claude Code
CLAUDE.md + .claude/rules/*.md
Skills (.claude/skills/ → /{name})
✅
Gemini CLI
GEMINI.md
.gemini/commands/*.toml → /{name}
✅
OpenAI Codex CLI
AGENTS.md (+ AGENTS.override.md)
Team commands; /review built-in
✅
OpenCode
AGENTS.md (CLAUDE.md compatible)
Built-in only (/init/undo/share)
✅
AI-native IDE / Editor Integration
Tool
Primary File
Workflow Mechanism
MCP
Cursor
.cursor/rules/*.mdc ⚠️
@-mentions; /multitask
✅
GitHub Copilot
.github/copilot-instructions.md
.github/prompts/*.prompt.md → /{name}
✅
Windsurf
.windsurfrules / .windsurf/rules/*.md
.windsurf/workflows/*.md → /{name}
✅
Cline
.clinerules
None
✅
⚠️ Cursor: .cursorrules is deprecated — migrate to .cursor/rules/*.mdc
Cross-Tool Universal Standard: AGENTS.md
AGENTS.md is the emerging de-facto cross-tool instruction standard:
Recommendation: Use AGENTS.md as the universal baseline for cross-tool projects, then add tool-specific files for advanced features (Skills, Workflows, Prompts).
Core Principle: Universal vs Project-Specific
Type
Contains
Example
Universal
Generic rules
"Run tests before committing"
Project-Specific
Concrete commands
"Run npm test before committing"
Recommended Layout
# [Project Name] - AI Instructions## Universal Standards
<!-- Rules applicable to ANY project -->
- Commit message format
- Code review checklist
- Testing standards
- Anti-hallucination rules
---
## Project-Specific Configuration
<!-- Unique to THIS project -->
### Tech Stack
[Your technologies here]
### Quick Commands
[Your build/test/deploy commands]
### File Structure
[Your project structure]
Run a code review:
1. Run `git diff HEAD`2. Check for BLOCKING issues (security, correctness)
3. Check for IMPORTANT issues (design, tests)
4. Output findings with BLOCKING/IMPORTANT/SUGGESTION prefixes
