---
name: myai-content-rules-setup
description: Runs an interactive wizard for configuring brand voice, style guidelines, and content generation rules. Use when setting up content-rules.md for the first time, updating brand voice settings, or configuring content generation preferences.
argument-hint: [--quick] [--update] [--preview]
allowed-tools: [Read, Write, Edit, AskUserQuestion, Glob, Grep]
---

# Content Rules Setup Skill

Interactive setup wizard that creates or updates a `content-rules.md` file. This file controls how the content-writer orchestrator generates content for your brand.

## Modes

### Full Setup (default)
```bash
/myaidev-method:content-rules-setup
```
Runs the complete wizard with questions covering:
- Brand identity & voice
- Target audience
- Writing style guidelines
- Content formatting preferences
- SEO requirements
- Topics & boundaries
- Visual content preferences
- Prohibited words/phrases

### Quick Setup
```bash
/myaidev-method:content-rules-setup --quick
```
Asks only essential questions and uses smart defaults:
1. Brand name and description
2. Target audience and expertise level
3. Voice/tone preference
4. Main content topics
5. Words/topics to avoid

### Update Mode
```bash
/myaidev-method:content-rules-setup --update
```
Reads existing `content-rules.md` and lets you modify specific sections.

### Preview Mode
```bash
/myaidev-method:content-rules-setup --preview
```
Displays a summary of current content-rules.md settings.

## Process

### Step 1: Check for Existing Rules
- Look for `content-rules.md` in: `./`, `./.claude/`, `./docs/`
- If found and not in `--update` mode, ask if user wants to update or start fresh

### Step 2: Gather Information
Use `AskUserQuestion` for each configuration area. Present clear options with descriptions.

**Question Categories (Full Mode):**

1. **Brand Identity** (3 questions)
   - Brand name and tagline
   - What does your brand do? (1-2 sentence description)
   - Brand personality traits (select 3-5)

2. **Audience** (3 questions)
   - Primary audience description
   - Technical expertise level
   - Key pain points / what they're looking for

3. **Voice & Tone** (4 questions)
   - Primary tone (professional, conversational, technical, academic, playful)
   - Formality level (1-5 scale)
   - First/second/third person preference
   - Humor: never, subtle, moderate, frequent

4. **Writing Style** (5 questions)
   - Sentence length preference (concise, moderate, detailed)
   - Paragraph length (1-3, 2-4, 3-5 sentences)
   - Active/passive voice ratio
   - Use of contractions (never, sometimes, always)
   - Jargon level (avoid all, use sparingly, embrace industry terms)

5. **Formatting** (4 questions)
   - Preferred list style (bullets vs. numbers)
   - Heading depth (H2 only, H2+H3, H2+H3+H4)
   - Use of bold/italic emphasis
   - Code block usage (never, when relevant, frequently)

6. **SEO** (3 questions)
   - Target keyword density (0.5-1%, 1-2%, 2-3%)
   - Meta description style
   - CTA approach (subtle, moderate, direct)

7. **Topics** (3 questions)
   - Primary content topics (3-5)
   - Secondary/related topics
   - Topics to explicitly avoid

8. **Visual Preferences** (2 questions)
   - Preferred image style (photorealistic, illustration, diagram, minimal)
   - Color scheme preferences

9. **Prohibited** (2 questions)
   - Banned words/phrases
   - Banned topics or claims

### Step 3: Generate content-rules.md
Produce a well-structured markdown file that the content-writer orchestrator can parse.

## Output Format

```markdown
# Content Generation Rules

## Brand Identity
- **Name**: {brand_name}
- **Description**: {brand_description}
- **Personality**: {trait1}, {trait2}, {trait3}

## Target Audience
- **Primary**: {audience_description}
- **Expertise Level**: {level}
- **Looking For**: {needs}

## Voice & Tone
- **Primary Tone**: {tone}
- **Formality**: {level}/5
- **Person**: {first/second/third}
- **Humor**: {level}
- **Contractions**: {policy}

## Writing Style
- **Sentence Length**: {preference}
- **Paragraph Length**: {max} sentences max
- **Voice**: {active_ratio}% active voice
- **Jargon**: {policy}

## Formatting
- **Lists**: {style}
- **Headings**: Up to {depth}
- **Emphasis**: {policy}
- **Code Blocks**: {policy}

## SEO Guidelines
- **Keyword Density**: {range}
- **Meta Descriptions**: {style}
- **CTAs**: {approach}

## Content Topics
### Primary
- {topic1}
- {topic2}
- {topic3}

### Avoid
- {avoid1}
- {avoid2}

## Visual Content
- **Style**: {preference}
- **Colors**: {scheme}

## Prohibited
### Words & Phrases
- {word1}
- {phrase1}

### Topics
- {topic1}

## Custom Rules
{any_additional_rules}
```

### Step 4: Save and Confirm
- Save to `./content-rules.md` (default) or user-specified location
- Display summary of configured rules
- Suggest testing with: `/myaidev-method:content-writer "test topic"`

## Integration

This skill is tightly coupled with the content-writer orchestrator (v2):
- Content rules are automatically discovered by the orchestrator
- Rules are injected into every subagent prompt
- Ensures consistent brand voice across research, planning, writing, and SEO phases

## Related Skills
- `/myaidev-method:content-writer` — Uses the generated rules
- `/myaidev-method:content-verifier` — Checks content against rules
- `/myaidev-method:coordinate-content` — Applies rules in batch workflows