zereight 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
namematches the folder you expect. ~/.pi/agent/settings.jsonlists~/.agents/skills(and cwd.pi/settings.jsonis not overriding).ls -la ~/.agents/skills/<name> .cursor/skills/<name>— broken symlinks → re-runensure-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.jsonshould be > 0 aftersync-t3-cursor-skills.sh.
Related
ljg-skill-map— global~/.agents/skillslayoutskill-cleaner— duplicate roots / token auditscripts/sync-t3-cursor-skills.sh— T3 Cursor cache backfill