16 deterministic Claude AI skills for Project Fluent localization — FTL syntax + TypeScript integration coverage.
Built on the Agent Skills open standard.
Without skills, Claude confuses Fluent FTL with ICU MessageFormat:
# Wrong — ICU MessageFormat syntax, NOT Fluent
welcome = Welcome, {username}! You have {count, plural, one {# message} other {# messages}}.
With this skill package, Claude produces correct Fluent FTL:
# Correct — Fluent FTL syntax with proper select expression
welcome = Welcome, { $username }! You have { $count ->
[one] { $count } message
*[other] { $count } messages
}.| Category | Count | Skills |
|---|---|---|
| fluent-core/ | 3 | architecture, bundle-api, langneg |
| fluent-syntax/ | 5 | messages, selectors, terms, attributes, functions |
| fluent-impl/ | 4 | react, locale-loading, locale-switching, project-setup |
| fluent-errors/ | 2 | parsing, resolution |
| fluent-agents/ | 2 | review, project-scaffolder |
See INDEX.md for the complete skill catalog with descriptions and links.
| Area | Topics | Package |
|---|---|---|
| FTL Syntax | Messages, placeables, selectors, terms, attributes, comments, functions | Fluent Syntax 1.0 |
| Bundle API | FluentBundle, FluentResource, formatPattern, getMessage, error handling | @fluent/bundle 0.18+ |
| React Integration | LocalizationProvider, Localized, useLocalization, DOM overlays, SSR | @fluent/react 0.15+ |
| Language Negotiation | negotiateLanguages, locale matching, fallback chains, Accept-Language | @fluent/langneg 0.7+ |
| Error Handling | Parse errors, resolution errors, debugging workflow, anti-patterns | All packages |
| Package | Versions | Notes |
|---|---|---|
| @fluent/bundle | 0.18+ (current: 0.19.1) | Core runtime |
| @fluent/react | 0.15+ (current: 0.15.2) | React bindings |
| @fluent/langneg | 0.7+ (current: 0.7.0) | Language negotiation |
| @fluent/syntax | 0.19+ (current: 0.19.0) | Parser/serializer (tooling) |
# Option 1: Clone the full package
git clone https://github.com/OpenAEC-Foundation/Fluent-i18n-Claude-Skill-Package.git
cp -r Fluent-i18n-Claude-Skill-Package/skills/source/ ~/.claude/skills/fluent/
# Option 2: Add as git submodule
git submodule add https://github.com/OpenAEC-Foundation/Fluent-i18n-Claude-Skill-Package.git .claude/skills/fluentUpload individual SKILL.md files as project knowledge.
After installation, skills activate automatically based on context:
- Write FTL messages — ask Claude to create localization files → activates
fluent-syntax-messages - Add plurals — handle plural forms → activates
fluent-syntax-selectors - Set up React i18n — integrate Fluent with React → activates
fluent-impl-react - Debug parse errors — paste an FTL error → activates
fluent-errors-parsing - Scaffold a project — set up i18n infrastructure → activates
fluent-agents-project-scaffolder - Review code — validate FTL + TypeScript → activates
fluent-agents-review
| Document | Purpose |
|---|---|
| INDEX.md | Complete skill catalog with links |
| ROADMAP.md | Project status (single source of truth) |
| REQUIREMENTS.md | Quality guarantees and per-area requirements |
| DECISIONS.md | Architectural decisions with rationale |
| SOURCES.md | Official reference URLs and verification rules |
| WAY_OF_WORK.md | 7-phase development methodology |
| LESSONS.md | Lessons learned during development |
| CHANGELOG.md | Version history |
This package was developed using the 7-phase research-first methodology, proven across multiple skill packages:
- Setup + Raw Masterplan — Project structure and governance files
- Deep Research — Comprehensive analysis of Fluent specification, source code, and community resources
- Masterplan Refinement — Skill inventory refinement based on research findings
- Topic-Specific Research — Deep-dive per skill topic
- Skill Creation — Deterministic skill files following Agent Skills standard
- Validation — Correctness, completeness, and consistency checks
- Publication — GitHub release and documentation
| Project | Description |
|---|---|
| ERPNext Skill Package | 28 skills for ERPNext/Frappe development |
| Blender-Bonsai Skill Package | 73 skills for Blender, Bonsai, IfcOpenShell & Sverchok |
| Tauri Skill Package | 27 skills for Tauri 2 desktop development |
| OpenAEC Foundation | Parent organization |
Part of the OpenAEC Foundation ecosystem.