From agent-almanac
Detect missing glyphs, icons, and HD variants by comparing registries against glyph mapping files, icon directories, and manifests. Reports gaps for skills, agents, and teams across all palettes.
npx claudepluginhub pjt222/agent-almanacThis skill is limited to using the following tools:
Detect missing glyphs, missing icons, and stale manifests by comparing registries against glyph mapping files, icon directories, and manifests. Produces a structured gap report covering skills, agents, and teams.
Run the viz pipeline to render icons from existing glyphs. Entry point for the viz subproject covering palette generation, data building, manifest creation, and icon rendering for skills, agents, and teams. Always use build.sh as the pipeline entry point — never call Rscript directly.
Inventories and organizes project images, icons, logos, fonts, visual tokens, and graphic references. Use to map existing assets, prevent visual inconsistencies, and support UI/UX, frontend, and image generation.
Validates asset manifests against PNGs on disk, probes sprite sheets/tilesets for non-empty grid frames, reports PNG dimensions for 2D game projects like Love2D.
Share bugs, ideas, or general feedback.
Detect missing glyphs, missing icons, and stale manifests by comparing registries against glyph mapping files, icon directories, and manifests. Produces a structured gap report covering skills, agents, and teams.
skill, agent, team, or all (default: all)cyberpunk — the reference palette)Collect all entity IDs from the source-of-truth registries.
skills/_registry.yml — extract all skill IDs across all domainsagents/_registry.yml — extract all agent IDsteams/_registry.yml — extract all team IDsExpected: Three lists of entity IDs with counts matching total_skills, total_agents, total_teams.
On failure: If a registry file is missing, report the path and skip that entity type.
Collect all mapped entity IDs from the glyph mapping files.
viz/R/glyphs.R — extract all keys from SKILL_GLYPHS listviz/R/agent_glyphs.R — extract all keys from AGENT_GLYPHS listviz/R/team_glyphs.R — extract all keys from TEAM_GLYPHS listExpected: Three lists of mapped IDs.
On failure: If a glyph file is missing, report it and mark all entities of that type as unmapped.
Diff registry IDs against mapped IDs.
registry_skill_ids - mapped_skill_idsregistry_agent_ids - mapped_agent_idsregistry_team_ids - mapped_team_idsExpected: Lists of entity IDs that exist in registries but have no glyph function mapped.
On failure: If diff computation fails, verify ID formats match between registry and glyph files (e.g., underscores vs hyphens).
Verify that mapped glyphs have corresponding rendered icon files.
viz/public/icons/<palette>/<domain>/<skillId>.webpviz/public/icons/<palette>/agents/<agentId>.webpviz/public/icons/<palette>/teams/<teamId>.webpviz/public/icons-hd/ with the same structureExpected: Lists of entities with glyphs but missing rendered icons (standard and/or HD).
On failure: If the icon directory doesn't exist, the pipeline hasn't been run yet — report all as missing.
Compare manifest counts against registry counts.
viz/public/data/icon-manifest.json — count entriesviz/public/data/agent-icon-manifest.json — count entriesviz/public/data/team-icon-manifest.json — count entriesExpected: Manifest counts match registry counts. Discrepancies indicate stale manifests.
On failure: If manifest files don't exist, the data pipeline needs to run first (node build-data.js && node build-icon-manifest.js).
Walk viz/public/icons*/ and flag WebP files whose <palette>/<domain>/<skillId> triple does not appear in icon-manifest.json.
find viz/public/icons* -name "*.webp"<domain>/<id> from its path<domain>/<id> has an entry in icon-manifest.json# Quick orphan count per palette
node -e "
const fs = require('fs');
const manifest = JSON.parse(fs.readFileSync('viz/public/data/icon-manifest.json'));
const ids = new Set(manifest.map(e => e.domain + '/' + e.id));
const orphans = require('child_process')
.execSync('find viz/public/icons -name \"*.webp\"').toString().trim().split('\n')
.filter(p => { const parts = p.split('/'); const id = parts.slice(-2).join('/').replace('.webp',''); return !ids.has(id); });
console.log('Orphans:', orphans.length);
orphans.forEach(p => console.log(' ', p));
"
Expected: Zero orphans. Any orphans indicate skills re-homed to a different domain without cleanup (18 orphans per re-homing = 9 palettes × 2 sizes).
On failure: Delete orphans manually — they have no corresponding manifest entry and will not be served. Re-home events are rare, so manual cleanup is acceptable.
Produce a structured summary.
=== Icon Pipeline Audit ===
MISSING GLYPHS (no glyph function):
Skills: 5 missing — [list]
Agents: 2 missing — [list]
Teams: 0 missing
MISSING ICONS (glyph exists, no rendered WebP):
Standard (512px): 3 skills, 1 agent
HD (1024px): 8 skills, 3 agents, 1 team
STALE MANIFESTS:
icon-manifest.json: 320 entries vs 326 registry (stale)
agent-icon-manifest.json: 66 entries vs 66 registry (OK)
team-icon-manifest.json: 15 entries vs 15 registry (OK)
Expected: A complete gap report with actionable next steps.
On failure: If all checks pass with zero gaps, report "Pipeline fully in sync" as a positive outcome.
create-skill), glyph maps may use snake_case keys — ensure comparison normalizesicons-hd/) — don't confuse with standard iconsbuild.sh creates icons at the new path but does NOT delete the old path — always run Step 6 orphan check after any domain migration