ai-instructions

Shared skill for setting up .ai/ instruction infrastructure in any project. Works as a /ai-instructions slash command in both Claude Code and Cursor.

What it does

Scaffolds a shared .ai/ directory with project context and conventions that both Claude Code and Cursor can use, with a single source of truth and a make sync-ai target to keep them in sync.

.ai/
├── context/
│   ├── architecture.md    ← auto-generated from project analysis
│   └── conventions.md     ← coding standards, patterns
└── skills/
    └── <name>/SKILL.md    ← reusable task prompts (synced to .cursor/skills/)

Install

# Claude Code
git clone git@github.com:u2i/ai-instructions.git ~/.claude/skills/ai-instructions

# Cursor
git clone git@github.com:u2i/ai-instructions.git ~/.cursor/skills/ai-instructions

Use

In any project, run /ai-instructions to set it up.

Update

cd ~/.claude/skills/ai-instructions && git pull
cd ~/.cursor/skills/ai-instructions && git pull