pinion-innovation-content/README.md

# Innovation Content: Educational Content Development Modes & Skills

**Version:** 1.1.1

A comprehensive suite of Roo Code modes and skills designed for educational content developers and producers.

## Overview

This project provides specialized modes and skills that enable educational content teams to:
- Design curricula aligned with educational standards
- Write engaging instructional content
- Develop valid and reliable assessments
- Produce multimedia educational content
- Design engaging learning experiences
- Ensure accessibility compliance

## Quick Start

### Modes

| Mode | Slug | Purpose | Skills |
|------|------|---------|--------|
| 📝 Curriculum Designer | `curriculum-designer` | Design curricula, learning objectives, course structures | 5 |
| 📖 Instructional Writer | `instructional-writer` | Write lesson content, exercises, learner documentation | 5 |
| 🧪 Assessment Developer | `assessment-dev` | Create assessments, quizzes, rubrics, evaluation criteria | 5 |
| 🎬 Content Producer | `content-producer` | Produce video scripts, interactive content, multimedia assets | 5 |
| 🎨 Learning Experience Designer | `lx-designer` | Design learning journeys, interactive features, engagement | 5 |
| ♿ Accessibility Auditor | `accessibility-auditor` | Audit content for WCAG compliance and inclusive design | 5 |

### Skills

30 specialized skills supporting the 6 modes above:

#### Curriculum Designer Skills
| Skill | Description |
|-------|-------------|
| `learning-objective-validator` | Validate objectives against Bloom's Taxonomy |
| `competency-mapper` | Map objectives to competency frameworks |
| `curriculum-gap-analyzer` | Identify gaps in curriculum coverage |
| `standards-compliance-checker` | Verify alignment with educational standards |
| `prerequisite-analyzer` | Validate prerequisite chains |

#### Instructional Writer Skills
| Skill | Description |
|-------|-------------|
| `readability-analyzer` | Analyze content readability (Flesch-Kincaid, SMOG) |
| `tone-consistency-checker` | Ensure consistent voice and tone |
| `active-learning-designer` | Design active learning exercises |
| `explanation-quality-checker` | Evaluate explanation effectiveness |
| `formative-assessment-writer` | Generate formative assessment questions |

#### Assessment Developer Skills
| Skill | Description |
|-------|-------------|
| `assessment-validator` | Validate assessment alignment to objectives |
| `item-analysis-tool` | Statistical analysis of assessment items |
| `rubric-generator` | Create analytic and holistic rubrics |
| `bias-detector` | Identify bias in assessment items |
| `adaptive-logic-designer` | Design adaptive assessment logic |

#### Content Producer Skills
| Skill | Description |
|-------|-------------|
| `storyboard-validator` | Validate multimedia storyboards |
| `media-asset-manager` | Manage multimedia educational assets |
| `scorm-packager` | Package content for LMS delivery (SCORM/xAPI) |
| `caption-quality-checker` | Validate caption and transcript quality |
| `interactive-content-builder` | Create H5P and interactive content |

#### LX Designer Skills
| Skill | Description |
|-------|-------------|
| `journey-mapper` | Map learner journeys and pathways |
| `engagement-analyzer` | Analyze learner engagement patterns |
| `gamification-designer` | Design gamification elements |
| `microlearning-architect` | Design microlearning structures |
| `ui-spec-generator` | Generate UI specifications |

#### Accessibility Auditor Skills
| Skill | Description |
|-------|-------------|
| `wcag-compliance-checker` | Audit WCAG 2.1/2.2 compliance |
| `screen-reader-simulator` | Simulate screen reader experience |
| `color-contrast-analyzer` | Analyze color contrast ratios |
| `cognitive-accessibility-checker` | Evaluate cognitive accessibility |
| `remediation-advisor` | Provide accessibility remediation guidance |

## Installation

1. Copy mode configurations from `modes/*/mode-config.yaml` to your `.roomodes` file
2. Copy skills to your skills directory (`.agents/skills/` or global skills location)
3. Ensure XML instruction files are in `.roo/rules-[slug]/` directories

## Project Structure

```
innovation-content/
├── README.md                    # This file
├── CHANGELOG.md                 # Version history
├── AGENTS.md                    # Agent configuration
├── docs/                        # Documentation
│   ├── plan.md                  # Development plan
│   ├── srs.md                   # Software Requirements Specification
│   ├── support-team-guide.md    # Installation and troubleshooting guide
│   ├── user-guide.md            # User guide with tips and workflows
│   ├── plan-ES.md               # Spanish version of development plan
│   ├── srs-ES.md                # Spanish version of SRS
│   ├── support-team-guide-ES.md # Spanish version of support team guide
│   └── user-guide-ES.md         # Spanish version of user guide
├── modes/                       # Mode configurations and rules
│   ├── curriculum-designer/     # 1 mode-config.yaml + 7 XML rules
│   ├── instructional-writer/    # 1 mode-config.yaml + 7 XML rules
│   ├── assessment-dev/          # 1 mode-config.yaml + 7 XML rules
│   ├── content-producer/        # 1 mode-config.yaml + 7 XML rules
│   ├── lx-designer/             # 1 mode-config.yaml + 7 XML rules
│   └── accessibility-auditor/   # 1 mode-config.yaml + 7 XML rules
├── skills/                      # 30 skill definitions
│   └── [skill-name]/SKILL.md    # Each skill has YAML frontmatter + markdown
└── tests/                       # Validation tests (planned)
```

## Mode Workflow

### Primary Workflow
```
Curriculum Designer → Instructional Writer → Content Producer
        ↓                    ↓                    ↓
Assessment Developer ← LX Designer ← Accessibility Auditor
```

### Handoff Sequence
1. **Curriculum Designer** creates learning objectives and course structure
2. **Instructional Writer** receives objectives and writes lesson content
3. **Assessment Developer** creates aligned assessments
4. **Content Producer** produces multimedia content and packages for LMS
5. **LX Designer** designs learner journeys and engagement strategies
6. **Accessibility Auditor** audits all content and provides remediation guidance

### Cross-Mode Collaboration
```
┌─────────────────────────────────────────────────────────────┐
│                    Curriculum Designer                       │
│  (learning-objective-validator, competency-mapper, ...)      │
└──────────────────────┬──────────────────────────────────────┘
                       │ objectives, structure
                       ▼
┌─────────────────────────────────────────────────────────────┐
│                   Instructional Writer                       │
│  (readability-analyzer, active-learning-designer, ...)       │
└──┬──────────────────────────────┬────────────────────────────┘
   │ lesson content               │ assessment requirements
   ▼                              ▼
┌──────────────────────┐  ┌───────────────────────────────────┐
│   Content Producer   │  │     Assessment Developer          │
│  (storyboard, SCORM) │  │  (rubric-generator, bias-detector)│
└──────────┬───────────┘  └──────────────┬────────────────────┘
           │                              │
           ▼                              ▼
┌─────────────────────────────────────────────────────────────┐
│                  LX Designer                                 │
│  (journey-mapper, gamification-designer, ...)                │
└──────────────────────┬──────────────────────────────────────┘
                       │ complete content package
                       ▼
┌─────────────────────────────────────────────────────────────┐
│                Accessibility Auditor                         │
│  (wcag-compliance-checker, remediation-advisor, ...)         │
└─────────────────────────────────────────────────────────────┘
```

## Development

See [docs/plan.md](docs/plan.md) for the development plan and [docs/srs.md](docs/srs.md) for detailed requirements.

## Contributing

1. Follow the mode configuration format (YAML)
2. Ensure XML rule files are well-formed
3. Document all skills with SKILL.md format
4. Update CHANGELOG.md with all changes
5. Run validation tests before submitting

## License

Internal use - Educational Content Development Team