Tag By Topic
Assigns 1-4 topic tags to a seed body from the controlled vocabulary in substacker shared-context/topic-ledger.md. Prevents tag sprawl at small-corpus scale by requiring existing-tag match or logged addition. Uses keyword + title match; logs near-miss candidates to pending-tags. Use after format normalization and before dedupe. Trigger keywords — tag, topics, categorize, classify, taxonomy, controlled vocabulary, topic ledger.
Install
/plugin marketplace add lyndonkl/claudeThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add lyndonkl/claude --skill tag-by-topicgit clone --depth 1 https://github.com/lyndonkl/claude.git /tmp/claude
mkdir -p ~/.claude/skills
cp -r /tmp/claude/skills/tag-by-topic ~/.claude/skills/tag-by-topicPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Tag by Topic
## Table of Contents
- [Workflow](#workflow)
- [Controlled vocabulary rules](#controlled-vocabulary-rules)
- [Worked example](#worked-example)
- [Guardrails](#guardrails)
**Related skills:** Called by `ingest-inbox-item` step 2. Writes to `topic-ledger.md` pending-tags section when proposing additions. Upstream of `update-topic-ledger` (which records the finalized counts per tag).
## Workflow
```
Tag one seed:
- [ ] Step 1: Read shared-context/topic-ledger.md — collect current tag set
- [ ] Step 2: Score each existing tag against body + title (keyword + weighted title match)
- [ ] Step 3: Select top 1-4 tags above threshold
- [ ] Step 4: If top-1 score below threshold, propose new tag in kebab-case; log to pending-tags
- [ ] Step 5: Return {topics: [str], pending_tags: [str]}
```
### Step 2: Scoring
For each existing tag, compute:
- `keyword_match` = number of times tag-words appear in body (normalized by body length)
- `title_match` = 3× if tag-words appear in title, else 0
- `score = keyword_match + title_match`
Threshold for selection: `score ≥ 0.3` (tunable — start at 0.3, adjust if tagging is noisy).
### Step 3: Select top 1–4
- If 0 tags above threshold → assign `unclassified` and log this as a signal that vocabulary may need extension.
- If 1–4 tags above threshold → return them, highest-score first.
- If >4 above threshold → keep top 4 by score.
### Step 4: New-tag proposalDetails
- Skill name
tag-by-topic- Repository
- lyndonkl/claude
- Path
skills/tag-by-topic/SKILL.md- Repo updated
- 1 September 2026
FAQ
What does the Tag By Topic skill do?
Assigns 1-4 topic tags to a seed body from the controlled vocabulary in substacker shared-context/topic-ledger.md. Prevents tag sprawl at small-corpus scale by requiring existing-tag match or logged addition. Uses keyword + title match; logs near-miss candidates to pending-tags. Use after format normalization and before dedupe. Trigger keywords — tag, topics, categorize, classify, taxonomy, controlled vocabulary, topic ledger.
How do I install the Tag By Topic skill?
Claude Code plugin: /plugin marketplace add lyndonkl/claude. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Tag By Topic popular?
It lives in lyndonkl/claude, which has 200 GitHub stars and 25 forks.
Related skills
Abstraction Concrete Examples
200lyndonkl/claude
Builds structured abstraction ladders that translate high-level principles into concrete, actionable examples across 3-5 levels. Bridges communication gaps, reveals hidden assumptions, and tests whether abstract ideas work in practice. Use when explaining concepts at different expertise levels, moving between abstract principles and concrete implementation, identifying edge cases by testing ideas against scenarios, designing layered documentation, decomposing complex problems into actionable steps, or bridging strategy-execution gaps.
Academic Letter Architect
200lyndonkl/claude
Guides the creation of evidence-based academic recommendation letters, reference letters, and award nominations that combine concrete examples, meaningful comparisons, and genuine enthusiasm. Use when writing recommendation letters for students, postdocs, or colleagues, or when user mentions recommendation letter, reference, nomination, letter of support, endorsement, or needs help with strong advocacy and comparative statements.
Adr Architecture
200lyndonkl/claude
Documents significant architectural and technical decisions with full context, alternatives considered, trade-offs analyzed, and consequences understood. Creates a decision trail that helps teams understand why decisions were made. Use when choosing between technology options, making infrastructure decisions, establishing standards, migrating systems, or when user mentions ADR, architecture decision, technical decision record, or decision documentation.
Term Interrogation
200lyndonkl/claude
Walks a finished document line by line, finds every word and phrase standing in for a concept, and breaks each one down until a reader with no background can follow it. Targets the assumed-knowledge phrase, the kind that sounds ordinary while hiding everything that matters ("moat", "flywheel", "product-market fit", "at scale"), not merely the rare word. Explains each term where it is used, then re-reads its own explanation and unpacks any new term that explanation introduced, repeating until every word bottoms out in ordinary language. Produces a term ledger recording what was flagged, how it
Show Me Your Work
100adriannoes/awesome-agentic-ai
Keep a reviewable decision trail for long-running or unattended work: a TSV log with one row per decision (what, why, evidence, result). Local by default; commit it when a reviewer needs the trail to trust the result. Use for /show-me-your-work, autonomous or multi-phase runs, or work a human reviews after stepping away.
Update Topic Ledger
200lyndonkl/claude
Maintains substacker shared-context/topic-ledger.md as an append-and-update index of all topics in the corpus. Each topic row tracks seed/draft/published counts, last-touched date, top-3 seed ids by density, and a hot/warm/cold temperature indicator. Use after any seed is created, promoted to draft, published, or killed. Trigger keywords — ledger, topic index, update index, topic ledger, hot/cold topics.
Browse the most popular Claude skills, all other skills, or write your own with the skills generator.