# Write Concept

> Use when creating or improving educational concept files - includes curriculum research for new concepts, always updates translations before validation

- Skill: `majiayu000/write-concept-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/write-concept-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/write-concept-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/write-concept-2

---


# 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.md`
- `content/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) and `version_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}` with `name` and `description`

### 6. Validate

```bash
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