CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

reindex

Plan and verify PsychSift index generations, backfills, promotions, cleanup, health checks, and rollback without touching live data automatically. Use for reindex jobs, generation changes, index migrations, or backfill operations.

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

72%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is an admirably lean, domain-expert checklist with real file and function specifics, but it stays at the planning level: no executable verification commands and no error-recovery loops for what are inherently destructive batch operations. Step 5's safeguard clause is also packed into one sprawling sentence that would benefit from structure.

Suggestions

Add concrete executable commands or script invocations for the 'deterministic generation-state proof' (step 4) and health checks (step 2), so verification is copy-paste runnable rather than described.

Introduce explicit feedback loops for the destructive/batch operations — e.g., 'if the proof fails or a health check regresses, halt, report, and revert to the rollback boundary before retrying' — to lift workflow clarity past the batch-operation cap.

Break step 5's six-clause run-on sentence into a short sub-list (ranking-protected surfaces, canary preservation, reaping safeguards, storage cleanup, owner approval) so each safeguard is scannable and individually checkable.

DimensionReasoningScore

Conciseness

The 7-step body is lean and assumes Claude's competence — it names "idempotency, resumability, concurrency, partial promotion" with zero tutorial padding, and even the dense step 5 is pure domain-specific substance rather than verbosity. Every token earns its place.

5 / 5

Actionability

Concrete specifics exist ("src/lib/chunking.ts" in "ragRankingPatterns", "src/lib/reindex-pipeline.ts", "filterReapableAbandonedGenerations", "eval-canary"), but no executable commands, scripts, or query examples are given — directives like "Add or run the smallest deterministic generation-state proof" describe the goal without the how, leaving key details missing.

3 / 5

Workflow Clarity

A clear 1–7 sequence exists with verification present (steps 2–4: health-check inspection, invariants check, deterministic proof), but this is a destructive/batch domain (live promotion, cleanup, generation reaping) and there are no explicit validate-then-fix-then-retry feedback loops or error-recovery checkpoints, capping the score at 3 per the rubric's feedback-loop guidance.

3 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files and no content that warrants extraction to separate references; the single ordered list is well-organized for a skill of this size, satisfying the simple-skill exception for a top score.

5 / 5

Total

16

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it states concrete capabilities tied to a specific system and includes an explicit, multi-scenario 'Use when' trigger clause. The only weakness is reliance on two generic verbs over the object list and slightly limited synonym coverage in the triggers.

DimensionReasoningScore

Specificity

The description lists several specific operations ("index generations, backfills, promotions, cleanup, health checks, and rollback") anchored to a named system, but relies on only two generic verbs ("Plan and verify"), leaving minor coverage gaps relative to the comprehensive multi-verb anchor 5.

4 / 5

Completeness

It explicitly answers both questions: a clear "what" ("Plan and verify PsychSift index generations, backfills, promotions, cleanup, health checks, and rollback") and an explicit "when" with four concrete trigger scenarios, matching the anchor-5 pattern; the 'when' clause is explicit and specific, so not a 4.

5 / 5

Trigger Term Quality

"Use for reindex jobs, generation changes, index migrations, or backfill operations" provides good natural keyword coverage a user would plausibly say, though common synonyms and variations (e.g., "reindexing", "index rebuild") are missing.

4 / 5

Distinctiveness Conflict Risk

"PsychSift index generations" pins the skill to a distinct niche with domain-locked triggers ("reindex jobs, generation changes, index migrations, backfill operations"), giving minimal overlap risk with generic skills.

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

BigSimmo/PsychSift

Path

.agents/skills/reindex/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.