What does this skill do, and when should you use it?
This skill guides the creation of a new SCSS Modules theme for a new World Service language/service in the BBC Simorgh application. It uses the Mundo theme as a reference implementation, covering steps: inspect the reference theme, create a new service directory, create palette.scss, the main theme file, the chameleon logo, and register it in loadableConfig.ts. The skill emphasizes often-missed steps and provides a checklist for completeness.
Reads the structure and files of the reference theme (Mundo) to guide the creation of a new theme. Creates a new service directory at a specified path with files like palette.scss (mapping palette tokens to CSS custom properties), the main <service>.ts entry (importing fonts, palette, brand SVG, etc.), and the chameleon logo <service>.tsx. Modifies loadableConfig.ts to register the new theme for dynamic import. Finally, presents the result for feedback and iteration.
- A developer needs to add a theme for a new World Service language (e.g., adding Swahili) — this skill provides the steps.
- When migrating an existing Emotion theme to the SCSS Modules system, this skill references the current standard.
- When adding a new service theme in the Simorgh project and wanting to ensure all necessary components (like chameleon logo) are not missed.
- To maintain consistency across theme implementations by following a documented process.
How do you install this skill?
- The skill does not mention user confirmation or explicit permission for file modifications; execute with caution.
- The skill relies on reference files in the repo but provides no tests; verify steps before implementation.
- Access to BBC services from mainland China may be restricted; consider network reachability when using this skill.
- Local filesystem
Clone the repository containing the skill (e.g., git clone [email protected]:bbc/simorgh.git), then ensure the skill is in .github/skills/add-new-service-theme/.
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/bbc/simorgh.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/.github/skills/add-new-service-theme" ~/.claude/skills/
rm -rf "$tmp"Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.
How do you use this skill?
Once installed, send your agent any of these to trigger it:
- add a theme for a new service
In an Agent Skills-compatible client, when the user requests 'add a theme for a new service' or similar, the skill will execute steps: inspect the Mundo theme, create the directory, add necessary files, and register. Alternatively, follow the steps manually as described in SKILL.md.
What are this skill's strengths and limitations?
- Provides a clear step-by-step guide with an explicit reference implementation (Mundo theme).
- Includes a checklist to avoid missing critical steps (like chameleon logo and loadableConfig registration).
- Based on standard SCSS Modules and CSS custom properties, aligning with modern frontend practices.
- Specific to the BBC Simorgh codebase, limiting generalizability.
- No built-in test or validation; developers must manually verify.
- Relies on project-specific structure, may not directly apply outside.
How does this skill compare with similar options?
Side by side with related skills; every score comes from the same FSRS standard.
| Skill | FS score | Stars | Last updated | License |
|---|---|---|---|---|
| Add New Service Theme (SCSS Modules) this page | 45 · Not recommended | ★ 1.7k | 3d ago | NOASSERTION |
| Frontend Conventions Skill | 50 · Use with care | ★ 5.2k | 3d ago | Apache-2.0 |
| React Component Conversion Expert | 47 · Use with care | ★ 1.7k | 3d ago | NOASSERTION |
| OpenChamber Performance Engineering Skill | 62 · Recommended | ★ 11k | 3d ago | MIT |
| Locale UI Patterns — OpenChamber UI Localization Rules | 61 · Recommended | ★ 11k | 3d ago | MIT |
How did FollowSkills review this skill?
The skill only describes steps to create theme files, with no sensitive data handling, external writes, or dangerous operations; the repo has security policy and CodeQL, but no evidence that this skill specifically follows least privilege or user confirmation. No red-line risk, but permissions and confirmation mechanisms are unclear; deductions applied.
Steps are clear but lack error handling and failure feedback. Static assessment cannot verify execution; no tests for the skill. Reliability capped at 'happy path plausible but thin' = 7.
Use case is clear but boundaries/non-fit scenarios not declared; trigger description is precise but environment fit (e.g., network reachability) not addressed. Score 7 for 'clear scenario but limited evidence'.
Document is well-structured with purpose, steps, checklist, but lacks versioning, changelog, maintenance ownership, and author info; referenced files not provided. Score 7.
Skill aims to add a new theme; steps are detailed but no verified output or examples; marginal value limited. Static assessment cannot verify results, capped at 7.
Based solely on source files, no execution evidence; no tests or CI coverage for the skill, so score low at 3.
Open a dimension to read why it scored that way
Evidence confidence：Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.
See the full review method →