CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

loopx-material

Operate an explicitly activated LoopX Material Lifecycle for a connected project. Use for material-store inventory, lossless migration, candidate/archive transitions, exact-read-backed ranking, ranked-entry rebuilds, bounded Explore intake, owner-gated apply, rollback, and audit. Do not use for ordinary one-off reading or research when the project has not activated Material Lifecycle.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

77%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 skill delivers an exceptionally rigorous, well-sequenced lifecycle workflow with strong validation and rollback discipline, and its guidance is mostly concrete thanks to real CLI commands and exact field names. Its weaknesses are structural: everything is inlined in one ~293-line file with dense spec prose (especially the rerank rules) that belongs in reference files, and a few operational steps lack executable commands.

Suggestions

Move the three ranking-quality rules in Section 6 (stratification tiers, VOI cost divisors, load-bearing audit, orthogonal cap defaults) into a references/ranking-rules.md file and keep only a short summary plus the CLI commands in SKILL.md.

Show the exact invocation of plan_material_single_move (as is already done for plan-wave-rerank) so the single-move path is copy-paste executable like the rest of the workflow.

Trim the introductory enumeration of all host surfaces and skills directories to the one example plus a one-line pointer to 'loopx project-skill install --help' to cut token cost without losing actionability.

DimensionReasoningScore

Conciseness

The body never explains concepts Claude already knows and assumes competence throughout, but Section 6's nested ranking-quality rules and the intro's enumeration of every host surface and skills directory are over-long spec prose that could be trimmed. It sits between 'minor instances of over-explanation' (4) and 'every token earns its place' (5), closer to 4.

4 / 5

Actionability

Concrete commands are present ('loopx project-skill install --project . --skill loopx-material --surface codex --execute', 'loopx material-lifecycle architecture --format json', 'loopx material-lifecycle plan-wave-rerank --input <path-or-->') along with exact field names, defaults, and dispositions (top_window/ranked_backlog/no_change, max_orthogonal_in_top_window default 0). Minor gaps remain: the invocation shape of plan_material_single_move is never shown, and steps like 'record source revision and read scope' name no command.

4 / 5

Workflow Clarity

Eight numbered workflow steps with explicit validation throughout: snapshot requires a verified backup, Step 4 requires repair-or-rollback before reporting intake complete, Step 8 is an apply-gate checklist (digests match, parse errors zero, counts exact, CAS revision, rollback rehearsed, owner gate) with post-apply readback and mismatch handling, plus a dedicated Stop Conditions section. This matches the anchor for clear sequence with explicit validation, feedback loops, and checklists.

5 / 5

Progressive Disclosure

The single 293-line SKILL.md has no bundle files and no references at all; spec-detail content that belongs in separate files is inlined, including the three dense ranking-quality rules in Section 6, the CLI surface/directory enumeration, and the adapter contract details. Internal section organization is good, but the rubric's intent that SKILL.md be an overview pointing to detailed materials is not met.

3 / 5

Total

16

/

20

Passed

Description

92%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 that explicitly covers what the skill does, when to use it, and when not to use it, with nine concrete capability keywords and a clear negative trigger. Its only weakness is jargon-heavy phrasing that misses more natural user-facing synonyms for a couple of operations.

DimensionReasoningScore

Specificity

The description lists nine concrete actions ('material-store inventory, lossless migration, candidate/archive transitions, exact-read-backed ranking, ranked-entry rebuilds, bounded Explore intake, owner-gated apply, rollback, and audit') in third-person voice, giving comprehensive coverage of the skill's operations rather than the 'minor gaps' of the 4 anchor.

5 / 5

Completeness

It explicitly answers 'what' ('Operate an explicitly activated LoopX Material Lifecycle for a connected project' plus the action list), 'when' ('Use for material-store inventory, lossless migration...'), and adds a negative trigger ('Do not use for ordinary one-off reading or research when the project has not activated Material Lifecycle'), matching the both-what-and-when-with-concrete-triggers anchor.

5 / 5

Trigger Term Quality

Good keyword coverage of terms a user in this ecosystem would say (migration, inventory, archive, ranking, rebuild, rollback, audit), but the phrasing leans on system jargon ('exact-read-backed ranking', 'bounded Explore intake') and offers no synonyms or common variations, so it falls short of the comprehensive-synonym coverage of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

'LoopX Material Lifecycle' is a clearly proprietary niche, the described operations are unlike generic skill domains, and the explicit 'Do not use for ordinary one-off reading or research' exclusion further reduces mis-trigger risk.

5 / 5

Total

19

/

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

huangruiteng/CS-Notes

Path

.agents/skills/loopx-material/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.