Agent Skill
2/7/2026

oes-module-architect

Use this skill when creating or reviewing OES track modules (Old East Slavic, X-XIII century). Provides guidance on historical linguistics, primary source analysis, grammar reconstruction, and paleography. Always read the template first.

L
learn
0GitHub Stars
2Views
npx skills add learn-ukrainian/learn-ukrainian.github.io

SKILL.md

Nameoes-module-architect
DescriptionUse this skill when creating or reviewing OES track modules (Old East Slavic, X-XIII century). Provides guidance on historical linguistics, primary source analysis, grammar reconstruction, and paleography. Always read the template first.

Learn Ukrainian

Мова -- душа народу | Language is the soul of a nation

License: MIT Deploy Modules

A free, open-source Ukrainian language course from A1 to C2, based on the Ukrainian State Standard 2024 and aligned with CEFR.

Start Learning


What is this?

A comprehensive Ukrainian language curriculum with 1,503 modules across 14 tracks:

  • 6 core CEFR levels (A1 -- C2) covering grammar, vocabulary, and communication
  • 8 specialization tracks -- history, biographies, literature, professional Ukrainian, Old East Slavic, and Ruthenian
  • Theory-first approach -- understand grammar deeply, not just memorize phrases
  • Interactive exercises -- quizzes, matching, fill-in-the-blank, error correction
  • Cultural context -- decolonization perspective, authentic Ukrainian sources
  • 100% free -- no ads, no subscriptions, no paywalls

Tracks

Core Levels

LevelModulesDescription
A164Beginner -- Cyrillic alphabet, basic grammar, practical scenarios
A276Elementary -- All 7 cases, aspect intro, practical scenarios
B1100Intermediate -- Aspect mastery, motion verbs, communication
B285Upper-Intermediate -- Passive voice, registers, professional basics
C1106Advanced -- Stylistics, literature, complex grammar
C291Mastery -- Native-level proficiency

Specialization Tracks

TrackModulesDescription
HIST140Ukrainian history from origins to present
ISTORIO136Advanced historiography -- primary sources, imperial mechanisms
BIO176Notable Ukrainians through history
LIT221Ukrainian classics and literary analysis
B2-PRO40Professional -- business communication, technical domains
C1-PRO50Professional mastery -- executive, academic, specialized
OES103Old East Slavic -- historical linguistics (X--XIII century)
RUTH115Ruthenian -- Middle Ukrainian (XIV--XVIII century)

Why Learn Ukrainian?

  • 45 million speakers worldwide
  • Rich literary tradition -- Shevchenko, Franko, Lesya Ukrainka
  • Unique grammar -- 7 cases, verbal aspect, motion verb system
  • Growing global interest -- solidarity with Ukraine

Getting Started

Online (Recommended)

Visit learn-ukrainian.github.io and start with A1.

Local Development

git clone https://github.com/learn-ukrainian/learn-ukrainian.github.io.git
cd learn-ukrainian.github.io
npm install

# Start the website (Astro Starlight)
npm run dev:starlight
# Opens at http://localhost:4321/

Requirements: Node.js 20+, Python 3.12+ (for build scripts and audits)

Project Structure

learn-ukrainian/
├── curriculum/l2-uk-en/        # Source curriculum
│   ├── plans/{track}/          # Module plans (source of truth)
│   ├── {track}/                # Content, activities, vocabulary
│   │   ├── meta/               # Build configuration
│   │   ├── activities/         # Interactive exercises (YAML)
│   │   ├── vocabulary/         # Vocabulary lists (YAML)
│   │   ├── research/           # Research notes (seminar tracks)
│   │   └── status/             # Audit results (auto-generated)
│   └── curriculum.yaml         # Module manifest
├── starlight/                  # Website (Astro Starlight)
│   └── src/content/docs/       # Published module pages (MDX)
├── scripts/                    # Build tools, audits, batch processing
├── schemas/                    # JSON Schema for YAML validation
└── docs/                       # Architecture docs, best practices

Standards & Quality

  • CEFR-aligned -- Common European Framework of Reference for Languages
  • Ukrainian State Standard 2024 -- Official language proficiency requirements
  • Automated audits -- every module checked for word count, vocabulary, activities, naturalness
  • Cross-agent review -- AI-assisted build pipeline with adversarial quality gates

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Areas where help is especially welcome:

  • Native speaker review of Ukrainian text
  • Activity design and testing
  • Bug reports and content corrections

License

MIT -- free to use, modify, and distribute.


Слава Україні! 🇺🇦

Star us on GitHub to support Ukrainian language education.

Skills Info
Original Name:oes-module-architectAuthor:learn