code-standards

# Code Standards — Universal AI Tool Configuration Generator

Generate code standards files based on Linus Torvalds' "Good Taste" philosophy. Auto-detects AI tools in your project and creates the appropriate configuration files in the user's language.

## When to Use

- User wants to set up coding standards for a project
- User wants to sync code quality rules across AI coding tools
- User mentions "code standards", "init claude md", "code review", or equivalent in any language

## Instructions for Agent

### Step 1: Detect Language & Read Template

Detect the user's language. Read the matching template from this skill's `references/` directory:

- Simplified Chinese → `references/code-standards-zh-CN.md`
- Traditional Chinese → `references/code-standards-zh-TW.md`
- Japanese → `references/code-standards-ja.md`
- All other languages → `references/code-standards-en.md`

### Step 2: Detect AI Tools

```bash
PROJECT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)

[ -d "$PROJECT_ROOT/.cursor" ] && echo "CURSOR"
[ -f "$PROJECT_ROOT/AGENTS.md" ] || [ -d "$PROJECT_ROOT/.codex" ] && echo "CODEX"
[ -f "$PROJECT_ROOT/GEMINI.md" ] || [ -d "$PROJECT_ROOT/.gemini" ] && echo "GEMINI"
[ -d "$PROJECT_ROOT/.github" ] && echo "COPILOT"
[ -d "$PROJECT_ROOT/.windsurf" ] || [ -f "$PROJECT_ROOT/.windsurfrules" ] && echo "WINDSURF"
[ -f "$PROJECT_ROOT/.aider.conf.yml" ] && echo "AIDER"
[ -d "$PROJECT_ROOT/.clinerules" ] || [ -d "$PROJECT_ROOT/.roo" ] && echo "CLINE"
```

### Step 3: Generate Files

Write the template content directly. No confirmation needed — the user invoked this skill, that IS the intent.

**Always generate:** `CLAUDE.md`

**For each detected tool, also generate:**

| Tool | File | Notes |
|------|------|-------|
| Cursor | `.cursor/rules/code-standards.mdc` | Prepend `---\ndescription: "Linus Torvalds code standards"\nalwaysApply: true\n---\n` |
| Codex | `AGENTS.md` | Same content |
| Gemini | `GEMINI.md` | Same content |
| Copilot | `.github/copilot-instructions.md` | `mkdir -p .github` first |
| Windsurf | `.windsurfrules` | Same content |
| Aider | `CONVENTIONS.md` | Same content |
| Cline/Roo | `.clinerules/code-standards.md` | `mkdir -p .clinerules` first |

### Step 4: Report

Report created files in the user's language. Keep it brief.

## Response Guidelines

1. **Execute immediately** — No confirmation, no "shall I proceed?". Just write.
2. **Unconditionally overwrite existing files** — Always overwrite CLAUDE.md and other config files without asking. The invocation is explicit intent to replace.
3. **Respond in user's language** — Match the language they used to invoke.
4. **No extra commentary** — Detect, write, report. Done.

## Error Handling

| Situation | Action |
|-----------|--------|
| Not in a git repo | Use current directory as root |
| No tools detected | Only generate `CLAUDE.md` |
| Permission denied | Report error with path |
| Template not found | Fall back to English |