Citizen Analyst Skills Router
Last updated: November 20, 2026
Discover the right Citizen Analyst skills for a task from the single routing source of truth (index.json — the same index the live FastAPI product loads), and get each skill’s real on-disk path. This replaces guessing skill names or assuming they live at Claude-Skills/{id}/SKILL.md (several Citizen Analyst skills are product-local, so that path 404s).
A UserPromptSubmit hook (scripts/hooks/route_hint.py) already surfaces the top skills automatically when a prompt clearly maps to Citizen Analyst work. Use this skill when you want the full ranked list, want to route a task the hook didn’t flag, or are chaining skills deliberately.
When to use
Run this FIRST, before doing the work, whenever a task touches: authoring/formatting a KB article, accountability profiles, investigative/OSINT research, voting & election law, constitutional/legal analysis, democratic-health monitoring, DMA scoring, or timelines/infographics.
How to route
From the repository root:
make route Q="<the task in plain words>"
# machine-readable (for chaining):
python scripts/ca_route.py --json "<task>"
# add an LLM narrowing pass (needs ANTHROPIC_API_KEY):
make route LLM=1 Q="<task>"
The output ranks skills by relevance and prints each one’s resolved SKILL.md path. A ⚠ NO FILE flag means the skill is listed but unresolved — report it, don’t invoke it.
Then
- Read the top 1–3 methodology skill files the resolver returned.
- Apply them. Respect each skill’s own framing rules (e.g.
judicial-decision-analytics-specialist
is a facts-only layer; commentary is layered by patriot-editorial-framework).
Composition shortcuts
Common chains (the router will surface the pieces; apply in this order):
- New accountability profile:
patriot-private-citizen-inclusion-gate→
accountability-profile-verification → malice-evaluator → patriot-sanity-check
- Author an article:
patriot-editorial-framework(structure) + fact/domain skills it cites - Investigation:
investigation-workflow-designer→ domain OSINT skills →timeline-builder
Maintenance
index.json is the source of truth (built from agent-base/skills/classifications.yaml by build_skill_index.py). After adding/renaming skills, run make route-sync and make test-all. Full catalog: operations/requirements/agents/PU-SKILLS-ROUTER.md.
