Back to skills
SkillHub ClubWrite Technical DocsFull StackTech Writer

chemistry-reader-tags

Apply Chemistry Reader markdown tags to educational content. Triggers when working on files in 05-publication/, applying pedagogical markup, or preparing content for the web reader.

Packaged view

This page reorganizes the original catalog entry around fit, installability, and workflow context first. The original raw source lives below.

Stars
0
Hot score
74
Updated
March 20, 2026
Overall rating
C2.1
Composite score
2.1
Best-practice grade
B84.0

Install command

npx @skill-hub/cli install sigurdurvilhelmsson-namsbokasafn-efni-chemistry-reader-tags

Repository

SigurdurVilhelmsson/namsbokasafn-efni

Skill path: .claude/skills/chemistry-reader-tags

Apply Chemistry Reader markdown tags to educational content. Triggers when working on files in 05-publication/, applying pedagogical markup, or preparing content for the web reader.

Open repository

Best for

Primary workflow: Write Technical Docs.

Technical facets: Full Stack, Tech Writer.

Target audience: everyone.

License: Unknown.

Original source

Catalog source: SkillHub Club.

Repository owner: SigurdurVilhelmsson.

This is still a mirrored public skill entry. Review the repository before installing into production workflows.

What it helps with

  • Install chemistry-reader-tags into Claude Code, Codex CLI, Gemini CLI, or OpenCode workflows
  • Review https://github.com/SigurdurVilhelmsson/namsbokasafn-efni before adding chemistry-reader-tags to shared team environments
  • Use chemistry-reader-tags for development workflows

Works across

Claude CodeCodex CLIGemini CLIOpenCode

Favorites: 0.

Sub-skills: 0.

Aggregator: No.

Original source / Raw SKILL.md

---
name: chemistry-reader-tags
description: Apply Chemistry Reader markdown tags to educational content. Triggers when working on files in 05-publication/, applying pedagogical markup, or preparing content for the web reader.
---

# Chemistry Reader Markdown Tagging

You are applying pedagogical markdown tags for the Chemistry Reader application, used by Icelandic secondary school students (ages 15-19).

## When to Apply Tags

Look for opportunities to tag:
- **Definitions**: Key terms students need to learn -> `:::definition`
- **Practice problems**: Calculations or conceptual questions -> `:::practice-problem`
- **Warnings**: Safety or common mistakes -> `:::warning`
- **Key concepts**: Essential ideas -> `:::key-concept`
- **Checkpoints**: Self-assessment moments -> `:::checkpoint`
- **Misconceptions**: Common student errors -> `:::common-misconception`
- **Notes**: Important information -> `:::note`
- **Examples**: Worked examples -> `:::example`

## Core Principles

1. **Don't over-tag** - Not every paragraph needs a callout
2. **Use the right tag** - See `implemented-tags.md` for distinctions
3. **Icelandic titles** - Tags render with Icelandic headers (Athugid, Vidvorun, etc.)
4. **mhchem for chemistry** - Always use `$\ce{H2O}$` not `$\text{H}_2\text{O}$`

## Quick Reference

| Content Type | Tag |
|-------------|-----|
| Term + definition | `:::definition{term="..."}` |
| Worked example | `:::example` |
| Student exercise | `:::practice-problem` + `:::answer` |
| Safety/caution | `:::warning` |
| Important note | `:::note` |
| Must-know concept | `:::key-concept` |
| Self-check | `:::checkpoint` |
| Wrong thinking | `:::common-misconception` |

## References

- `implemented-tags.md` - Complete syntax for each tag
- `frontmatter-schema.md` - Required YAML frontmatter
- `mhchem-reference.md` - Chemical notation syntax
- `tagging-decisions.md` - When to use which tag

## Output Location

Tagged files go to: `books/{book}/05-publication/chapters/`
chemistry-reader-tags | SkillHub