hiromaily

label-context-mapping

@hiromaily/label-context-mapping
hiromaily
119
31 forks
Updated 1/18/2026
View on GitHub

Maps GitHub labels to Skills and Context documents. Use when creating issues (github-issue-creation) or working on issues (fix-issue command).

Installation

$skills install @hiromaily/label-context-mapping
Claude Code
Cursor
Copilot
Codex
Antigravity

Details

Path.claude/skills/label-context-mapping/SKILL.md
Branchmain
Scoped Name@hiromaily/label-context-mapping

Usage

After installing, this skill will be available to your AI coding assistant.

Verify installation:

skills list

Skill Instructions


name: label-context-mapping description: Maps GitHub labels to Skills and Context documents. Use when creating issues (github-issue-creation) or working on issues (fix-issue command).

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.

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

LabelContext Document
bugdocs/task-contexts/bug-fix.md
enhancementdocs/task-contexts/feature-add.md
refactoringdocs/task-contexts/refactoring.md
documentationdocs/task-contexts/documentation.md
securitydocs/task-contexts/security.md
technical-debtdocs/task-contexts/refactoring.md
testdocs/task-contexts/test.md

Language Labels → Skills

LabelSkillVerification
lang:gogo-developmentmake go-lint && make tidy && make check-build && make gotest
lang:typescripttypescript-developmentnpm run lint && npm run build && npm test
lang:soliditysolidity-developmenttruffle compile && truffle test

Scope Labels → Skills

LabelSkillVerification
scope:docsdocs-updateMarkdown formatting
scope:devopsdevopsyamllint, workflow test
scope:scriptsshell-scriptsmake shfmt
scope:makefilemakefile-updatemake mk-lint
scope:dbdb-migration (+ go-development)make atlas-fmt && make atlas-lint && make sqlc
scope:config-Syntax validation
scope:proto-make proto

Chain Labels → Context Documents

LabelContext Documents
chain:btcdocs/task-contexts/chain-specific.md, docs/task-contexts/chains/btc.md
chain:bchdocs/task-contexts/chain-specific.md, docs/task-contexts/chains/bch.md
chain:ethdocs/task-contexts/chain-specific.md, docs/task-contexts/chains/eth.md
chain:erc20docs/task-contexts/chain-specific.md, docs/task-contexts/chains/eth.md
chain:xrpdocs/task-contexts/chain-specific.md, docs/task-contexts/chains/xrp.md
chain:alldocs/task-contexts/chain-specific.md

Test Scope Labels → Verification

LabelVerification
unit-testmake gotest
integration-testmake gotest-integration
e2e-testmake 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

LabelsSkills LoadedContexts Loaded
bug, lang:go, chain:btcgit-workflow, go-developmentbug-fix.md, chains/btc.md
enhancement, lang:typescript, chain:xrpgit-workflow, typescript-developmentfeature-add.md, chains/xrp.md
documentation, scope:docsgit-workflow, docs-updatedocumentation.md
refactoring, scope:db, lang:gogit-workflow, db-migration, go-developmentrefactoring.md, db-change.md
test, lang:go, unit-testgit-workflow, go-developmenttest.md
security, lang:gogit-workflow, go-developmentsecurity.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 - Label definitions
  • GitHub Labels - Label configuration
  • github-issue-creation - Uses this mapping for issue creation
  • fix-issue command - Uses this mapping for issue work