Name: skill-not-showing
Author: zereight

Imported from zereight/skill (.agents/skills/skill-not-showing/SKILL.md). Install upstream with npx skills add zereight/skill --skill skill-not-showing. Copyright stays with the author.

Skill Not Showing

Read-only diagnostic. Confirm with the user before changing settings or running sync scripts.

T3 Code root cause

T3 composer uses different triggers:

Trigger	Menu	Data source
`$`	Skills	`~/.t3/caches/cursor.json` → `skills[]`
`/`	Commands	same cache → `slashCommands[]` + built-in
`@`	Files	workspace search

Cursor provider probe leaves skills: [] empty. Cursor sends skills later as available_commands_update, but T3 $ picker does not read that stream today.

Fix path (T3 Code + Cursor)

Step	Command
Sync local skills into T3 cache	`bash scripts/sync-t3-cursor-skills.sh`
Dry run (counts only)	`bash scripts/sync-t3-cursor-skills.sh --dry-run`
Include a project repo	`bash scripts/sync-t3-cursor-skills.sh --project-root /path/to/repo/.cursor/skills`

Then restart T3 Code (or open a new thread) and search with:

$zereight-review — skill picker
/zereight-review — slash menu (provider command entries)

If / still shows only /model, /plan, /default, update T3 Code Alpha (pingdotgg/t3code PR #2650 adds skills to the / menu when skills[] is populated).

T3 Code common mistakes

Searching with / when expecting the $ skill picker
Typing / mid-line (trigger only works at line start)
Not restarting T3 after cache sync (provider snapshot is cached in-memory)

Pi root cause

includeDefaults is false → Pi loads only paths in ~/.pi/agent/settings.json skills[]. Extension skills (why, autocontext, …) are separate from repo SSOT under .agents/skills/.

Fix path (repo root)

Step	Command
Sync + link + verify	`bash scripts/ensure-repo-skills.sh`
Check only	`npm run verify:pi-skills`

Then restart Pi and try /skill:<name>.

If still missing

Frontmatter name matches the folder you expect.
~/.pi/agent/settings.json lists ~/.agents/skills (and cwd .pi/settings.json is not overriding).
ls -la ~/.agents/skills/<name> .cursor/skills/<name> — broken symlinks → re-run ensure-repo-skills.sh.
Extension-only list (e.g. only zereight-mode) means SSOT paths are not registered — not a content bug in the skill file.
T3: jq '.skills | length' ~/.t3/caches/cursor.json should be > 0 after sync-t3-cursor-skills.sh.

ljg-skill-map — global ~/.agents/skills layout
skill-cleaner — duplicate roots / token audit
scripts/sync-t3-cursor-skills.sh — T3 Cursor cache backfill

Install skill-not-showing and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "zereight-skill-skill-not-showing", "kind": "skill", "name": "skill-not-showing", "description": "Diagnose why a skill is missing from Pi /skill, T3 Code $ picker, or Cursor lists. Use when a skill exists on disk but does not appear, Pi shows only project or extension skills, or after adding a repo skill under .agents/skills/.", "publisher": "zereight", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Diagnose why a skill is missing from Pi /skill, T3 Code $ picker, or Cursor lists. Use when a skill exists on disk but does not appear, Pi shows only project or extension skills, or after adding a repo skill under .agents/skills/." ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/zereight/skill", "path": ".agents/skills/skill-not-showing/SKILL.md", "ref": "f14b9bcd7ce7664bf9bbd8191df47f55c86079b8", "url": "https://github.com/zereight/skill/blob/f14b9bcd7ce7664bf9bbd8191df47f55c86079b8/.agents/skills/skill-not-showing/SKILL.md", "key": "zereight/skill/.agents/skills/skill-not-showing/SKILL.md" } }, "instructions": "# Skill Not Showing\n\nRead-only diagnostic. Confirm with the user before changing settings or running sync scripts.\n\n## T3 Code root cause\n\nT3 composer uses **different triggers**:\n\n| Trigger | Menu | Data source |\n|---------|------|-------------|\n| `$` | Skills | `~/.t3/caches/cursor.json` → `skills[]` |\n| `/` | Commands | same cache → `slashCommands[]` + built-in |\n| `@` | Files | workspace search |\n\n**Cursor provider probe leaves `skills: []` empty.** Cursor sends skills later as `available_commands_update`, but T3 `$` picker does not read that stream today.\n\n### Fix path (T3 Code + Cursor)\n", "cost": { "context_tokens": 645 } }

skill-not-showing

About