Use when the user wants to query the PSS index, search/list/inspect elements, run lifecycle or history queries, build a plugin from a profile, or anywhere a `pss …` CLI command is needed. Loaded by pss-agent-profiler.
How this skill is triggered — by the user, by Claude, or both
Slash command
/perfect-skill-suggester:pss-cli-referenceThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
**Loaded by `pss-agent-profiler`** and **Used by** any agent that routes a natural-language request to the PSS CLI surface (62 subcommands).
Loaded by pss-agent-profiler and Used by any agent that routes a natural-language request to the PSS CLI surface (62 subcommands).
The PSS Rust binary (bin/pss-<platform>-<arch>) exposes 62 read-only subcommands across six categories: search/inspect, find-by-attribute, lifecycle filters, temporal queries, indexing/maintenance, plugin authoring. Defaults to JSON, --format table for human display. <10 ms against 8000+ entries. Store: CozoDB at $CLAUDE_PLUGIN_DATA/pss-skill-index.db.
PSS enabled; pss health --verbose passes. If empty, run /pss-reindex-skills.
BIN="$CLAUDE_PLUGIN_ROOT/bin/pss-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m)".--format table|json, --limit N, --as-of <DATE>./pss-search, /pss-setup-agent, /pss-make-plugin-from-profile).Shell recipes: references/workflows.md.
| User says… | Command |
|---|---|
| "what's installed" | pss summary, pss list, pss stats, pss tree |
| "find a skill for X" | pss search "X", pss find-by-keyword X, /pss-search X |
| "details of X" | pss inspect X, pss get X, /pss-get-description X |
| "skills for <attribute>" | pss find-by-{language,framework,tool,platform,domain} X |
| "installed since <when>" | pss list-added-since 1w, /pss-added-since 1w |
| "changed since <when>" | pss list-updated-since 24h, pss last-changes, pss changes-summary |
| "snapshot at <date>" | pss as-of <DATE>, pss show X --as-of <DATE> |
| "history of X" | pss timeline X, pss version-history X, pss lifespan X |
| "diff between dates" | pss diff X <D1> <D2>, pss compare-snapshots <D1> <D2> |
| "what disappeared" | pss removed-since <DATE>, pss currently-missing-but-once-was |
| "duplicates across scopes" | pss dedup-candidates, pss multi-scope <NAME>, pss scope-diff |
| "in plugin / marketplace X" | pss by-plugin <name>, pss by-marketplace <name>, pss plugin-history <name> |
| "tune / build plugin from profile" | /pss-setup-agent, /pss-change-agent-profile, /pss-make-plugin-from-profile |
| "rebuild / health / export" | /pss-reindex-skills, pss health, pss db-stats, pss export --json |
Dates: RFC 3339, <YYYY-MM-DD> (UTC midnight), relative (1d, 2w, 24h), tokens (now, yesterday).
uv run scripts/pss_build.py.health exit 2 → /pss-reindex-skills. Exit 1 → delete $CLAUDE_PLUGIN_DATA/pss-skill-index.db then reindex.get/inspect empty → find-by-name <substring>; use --source to disambiguate.Query subcommands accept --format json (default) or --format table (Unicode box drawing). Empty result sets exit 0 with [] or an empty table.
BIN="$CLAUDE_PLUGIN_ROOT/bin/pss-$(uname -s)-$(uname -m)"
"$BIN" summary
"$BIN" search docker --top 5 --format table
"$BIN" version-history skill:python@plugin:perfect-skill-suggester:
docs/pss-cli-reference.md documents every subcommand. Companion skill: pss-usage.
npx claudepluginhub emasoft/emasoft-plugins --plugin perfect-skill-suggesterCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.