Use when writing skills for PSS discovery or improving suggestion accuracy. Used by pss-agent-profiler. Trigger with /pss-authoring.
How this skill is triggered — by the user, by Claude, or both
Slash command
/perfect-skill-suggester:pss-authoringThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Guidance for writing skills that PSS discovers effectively, maintaining index health, and interpreting suggestions accurately. Complements pss-usage (core commands and workflows).
Guidance for writing skills that PSS discovers effectively, maintaining index health, and interpreting suggestions accurately. Complements pss-usage (core commands and workflows).
/pss-reindex-skills/pss-status to verify index health regularlyCopy this checklist and track your progress:
/pss-reindex-skills)The canonical index is a CozoDB store (pss-skill-index.db), not the legacy skill-index.json file. What authoring-side reindexing actually does:
pss_discover.py walks user / project / plugin / marketplace directories and emits one JSONL line per element.--pass1-batch mode reads that JSONL and enriches each line with deterministic keywords, intents, categories, domains, languages, and frameworks.pss_merge_queue.py writes the enriched rows directly into CozoDB via pycozo[embedded] under an fcntl lock, preserving each entry's original first_indexed_at timestamp across rebuilds.Python is the sole writer; the Rust --build-db flag has been removed. skill-index.json is no longer auto-generated — run pss export --json on demand if you want a diffable snapshot for code review. Nothing about authoring your SKILL.md changes: frontmatter rules, keyword selection, and category choices remain unchanged.
Improved skill metadata and index quality. Skills with proper frontmatter appear in PSS suggestions with higher confidence.
keywords and categories/pss-reindex-skills after metadata changesInput: A skill with generic description "Does testing" Output: Improved to "Use when writing pytest unit tests with fixtures and mocking. Trigger with /python-testing."
${CLAUDE_PLUGIN_ROOT}/schemas/pss-categories.jsonCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub emasoft/emasoft-plugins --plugin perfect-skill-suggester