# Label Context Mapping > Maps GitHub labels to Skills and Context documents. Use when creating issues (github-issue-creation) or working on issues (fix-issue command). Use when this capability is needed. - Skill: `tomevault-io/label-context-mapping` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/label-context-mapping` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/label-context-mapping/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/label-context-mapping --- # Label → Context Mapping Central mapping from GitHub labels to Skills and Context documents. **SSOT**: This skill defines the operational mappings. Label definitions are in [Task Classification](../../../docs/guidelines/task-classification.md). ## When to Use - **Creating issues**: Determine which labels to apply - **Working on issues**: Determine which skills and contexts to load ## Label Categories ### Type Labels → Context Documents | Label | Context Document | | ---------------- | ------------------------------------- | | `bug` | `docs/task-contexts/bug-fix.md` | | `enhancement` | `docs/task-contexts/feature-add.md` | | `refactoring` | `docs/task-contexts/refactoring.md` | | `documentation` | `docs/task-contexts/documentation.md` | | `security` | `docs/task-contexts/security.md` | | `technical-debt` | `docs/task-contexts/refactoring.md` | | `test` | `docs/task-contexts/test.md` | ### Language Labels → Skills | Label | Skill | Verification | | ----------------- | ------------------------ | ----------------------------------------------------------------------------------- | | `lang:go` | `go-development` | `make go-lint && make tidy && make check-build && make go-test` | | `lang:typescript` | `typescript-development` | See skill for app-specific commands (Bun for xrpl-grpc-server, npm for eth-contracts) | | `lang:solidity` | `solidity-development` | `truffle compile && truffle test` | ### Scope Labels → Skills | Label | Skill | Verification | | ---------------- | ----------------------------------- | ------------------------------------------------ | | `scope:docs` | `docs-update` | Markdown formatting | | `scope:devops` | `devops` | `yamllint`, workflow test | | `scope:scripts` | `shell-scripts` | `make shfmt` | | `scope:makefile` | `makefile-update` | `make mk-lint` | | `scope:db` | `db-migration` (+ `go-development`) | `make atlas-fmt && make atlas-lint && make sqlc` | | `scope:config` | - | Syntax validation | | `scope:proto` | - | `make proto` | ### Chain Labels → Context Documents | Label | Context Documents | | ------------- | ------------------------------------------------------------------- | | `chain:btc` | `docs/task-contexts/chain-specific.md`, `docs/chains/btc/README.md` | | `chain:bch` | `docs/task-contexts/chain-specific.md`, `docs/chains/bch/README.md` | | `chain:eth` | `docs/task-contexts/chain-specific.md`, `docs/chains/eth/README.md` | | `chain:erc20` | `docs/task-contexts/chain-specific.md`, `docs/chains/eth/README.md` | | `chain:xrp` | `docs/task-contexts/chain-specific.md`, `docs/chains/xrp/README.md` | | `chain:all` | `docs/task-contexts/chain-specific.md` | ### Test Scope Labels → Verification | Label | Verification | | ------------------ | -------------------------------------- | | `unit-test` | `make go-test` | | `integration-test` | `make go-test-integration` | | `e2e-test` | `make btc-e2e-*` or chain-specific E2E | ## Loading Procedure ### From Issue Labels ``` 1. Parse issue labels 2. Load contexts: - Type label → Context document - Chain label → Chain context (if present) 3. Load skills: - Always: git-workflow - Lang/Scope label → Development skill 4. Apply verification commands from skill ``` ### Mapping Examples | Labels | Skills Loaded | Contexts Loaded | | --------------------------------------------- | ------------------------------------------------ | ----------------------------- | | `bug`, `lang:go`, `chain:btc` | `git-workflow`, `go-development` | bug-fix.md, chains/btc.md | | `enhancement`, `lang:typescript`, `chain:xrp` | `git-workflow`, `typescript-development` | feature-add.md, chains/xrp.md | | `documentation`, `scope:docs` | `git-workflow`, `docs-update` | documentation.md | | `refactoring`, `scope:db`, `lang:go` | `git-workflow`, `db-migration`, `go-development` | refactoring.md, db-change.md | | `test`, `lang:go`, `unit-test` | `git-workflow`, `go-development` | test.md | | `security`, `lang:go` | `git-workflow`, `go-development` | security.md | ## Label Selection Rules ### Required Labels Every issue must have: 1. **One Type label** (`bug`, `enhancement`, `refactoring`, `documentation`, `security`, `technical-debt`, `test`) 2. **One Language OR Scope label** (`lang:*` or `scope:*`) ### Optional Labels - **Chain label**: Only for cryptocurrency-specific code - **Test Scope label**: Only when Type is `test` ## Quick Reference ``` Required: [Type] + [Language OR Scope] Optional: [Test Scope] + [Chain] Type label → Context document (what to do) Lang/Scope label → Skill (how to do) Chain label → Chain context (domain knowledge) ``` ## Related - [Task Classification SSOT](../../../docs/guidelines/task-classification.md) - Label definitions - [GitHub Labels](.github/labels.yml) - Label configuration - `github-issue-creation` - Uses this mapping for issue creation - `fix-issue` command - Uses this mapping for issue work --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/hiromaily) — claim your Tome and manage your conversions.