---

name: ai-tuning description: Optimize AI assistant configurations for maximum effectiveness. USE THIS SKILL when user says "improve CLAUDE.md", "better copilot instructions", "tune AI", "optimize prompts", "MCP configuration", or wants to enhance AI assistant behavior. allowed-tools:

• Bash
• Read
• Write
• Edit
• Glob
• Grep

---

AI Tuning Skill

Purpose

Optimize AI assistant configurations for maximum effectiveness, including CLAUDE.md, copilot-instructions.md, and MCP server setup.

Triggers

• "improve my CLAUDE.md"
• "better copilot instructions"
• "tune AI for this project"
• "add MCP servers"
• "optimize AI prompts"

Usage

Provide your existing AI configuration files or describe your project, and this skill will generate optimized CLAUDE.md, copilot-instructions.md, and MCP configurations following best practices.

Effective AI Instructions Principles

1. Be Specific: Vague → vague results
2. Show Examples: Code > descriptions
3. State Constraints: What NOT to do
4. Organize Hierarchically: General → specific
5. Include Commands: Quick reference

CLAUDE.md Structure

Copy# CLAUDE.md

## Project Overview
[What, architecture, technologies]

## Project Structure

[directory tree]

Copy
## Build Commands
```bash
# Install
[command]

# Test
[command]

# Lint
[command]

Code Style Requirements

[Formatter, linter, key rules with examples]

Architecture Guidelines

[Patterns, layer rules]

Important Patterns

[Code examples]

Copy
## copilot-instructions.md Structure

```markdown
# GitHub Copilot Instructions

## Project Context
[Brief description, tech stack]

## Code Generation Guidelines

### [Language] Patterns
[Conventions, type annotations, imports]

### Examples
```[language]
// GOOD
[example]

// AVOID
[counter-example]

Common Patterns

[Reusable code]

Commands

[Quick reference]

Copy
## MCP Configuration

```json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@context7/mcp-server"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "${workspaceFolder}"]
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

Optimization Techniques

1. Context Density

Copy# Instead of verbose:
"We use Python 3.12 as the language.
We use ruff for linting.
Testing is done with pytest."

# Write dense:
"Python 3.12 | ruff (lint+format) | pytest"

2. Example-Driven

Copy# Instead of:
"Use type annotations."

# Write:
"Type annotations required:
```python
def process(items: list[str]) -> dict[str, int]: ...
```"

3. Constraints Section

Copy## Constraints
- Max line length: 100 chars
- No star imports
- Error messages assigned to variables
- All public functions need docstrings

4. Command Quick Reference

Copy| Action | Command |
|--------|---------|
| Test | `uv run pytest` |
| Lint | `uv run ruff check .` |
| Format | `uv run ruff format .` |

Validation

Copy# Check AI files exist
[ -f "CLAUDE.md" ] && echo "✓ CLAUDE.md"
[ -f ".github/copilot-instructions.md" ] && echo "✓ Copilot"
[ -f ".vscode/mcp.json" ] && echo "✓ MCP"

# Check sections in CLAUDE.md
grep "^## " CLAUDE.md

# Check code examples
grep -c '```' CLAUDE.md

Quality Metrics

Pattern Library Development

Include reusable patterns:

Copy# Pattern: Error Handling
def fetch(id: str) -> User:
    """Fetch user by ID.

    Raises:
        UserNotFoundError: If not found.
    """
    result = db.query(User).filter_by(id=id).first()
    if result is None:
        raise UserNotFoundError(f"User {id} not found")
    return result

AI File Audit

Copyecho "=== AI Configuration Audit ==="

for f in CLAUDE.md .github/copilot-instructions.md .vscode/mcp.json; do
  if [ -f "$f" ]; then
    echo "✓ $f exists ($(wc -l < "$f") lines)"
  else
    echo "✗ $f MISSING"
  fi
done