write-concept
Use when creating or improving educational concept files - includes curriculum research for new concepts, always updates translations before validation
When & Why to Use This Skill
The Write Concept skill is a comprehensive tool designed for educational content creators to build and refine structured concept files. It streamlines the entire workflow from initial curriculum research and official document analysis to rule-based content generation, multi-language translation updates, and automated technical validation. By ensuring alignment with national standards and maintaining strict schema compliance, it significantly enhances the quality and consistency of educational databases.
Use Cases
- Curriculum-Aligned Content Creation: Automatically research official country-specific curriculum documents to extract learning objectives and difficulty progressions for new educational modules.
- Automated Content Localization: Synchronize educational concept updates across multiple language files (JSON) simultaneously, ensuring that names and descriptions are consistent for global users.
- Technical Validation and QA: Use built-in validation scripts to check concept files against strict schemas and rules, preventing common errors like missing fields or incorrect data structures.
- Version Control for Educational Assets: Systematically manage educational content updates by automatically incrementing versions and documenting change notes for better audit trails.
| name | write-concept |
|---|---|
| description | Use when creating or improving educational concept files - includes curriculum research for new concepts, always updates translations before validation |
Write Concept
Process
1. Understand
- Clarify: country, subject, grade, concept scope
- Ask user if anything is unclear
2. Research (new concepts only)
- Skip if curriculum info provided (e.g., from bulk-generate-concepts)
- Otherwise: WebSearch
"[country] [subject] curriculum [grade]" - Find official curriculum documents
- Extract: concept scope, learning objectives, difficulty progression
3. Read rules
docs/concept-rules.mdcontent/schema.ts
4. Write/edit concept file
- Location:
content/subjects/{subject}/official/{id}.md - Follow concept-rules.md for all field requirements
- Always update:
version(increment) andversion_notes(describe changes) - Prerequisites: Check
content/subjects/{subject}/official/for existing concept IDs
5. Update translations
- Update ALL files:
packages/frontend/public/locales/*/subjects/{subject}.json - Key:
concepts.{concept-id}withnameanddescription
6. Validate
bun run check:concepts {subject}/{concept-id}
Red Flags
- "I'll skip curriculum research" → You won't know what to put in fields
- "I'll add examples to help the AI" → CARDINAL RULE violation
- "Problem types look similar but different" → Not distinct enough