CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

loop-constraints

Read loop-constraints.md at the start of every run and enforce every rule. This skill runs BEFORE triage or any action skill. Constraints are binding.

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/loop-constraints/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%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 a tight, imperative guardrail procedure with explicit per-action checkpoints, escalation thresholds, a mandatory output format, and a sensible default-constraint fallback. Its only weaknesses are small: a couple of filler lines and two unspecified mechanics (how to detect loop-pause-all, how to count rules in a file whose format is not described).

DimensionReasoningScore

Conciseness

The body is lean and imperative with no concept explanations or padding, but minor tokens could be trimmed — "You are the guardrail" and "Load every rule into your working memory" state things Claude would do anyway. This fits 'Efficient; minor instances of over-explanation that could be trimmed' rather than the every-token-earns-its-place level 5.

4 / 5

Actionability

Guidance is mostly executable: exact filenames (loop-constraints.md, docs/safety.md), a copy-paste output line, a specific flag check (loop-pause-all), and a concrete denylist (.env, auth/, payments/, secrets/, credentials/). It stops short of fully executable because it never says how to check loop-pause-all activity or how to count rules from the external file's unknown format — minor gaps per the 'Mostly executable guidance' anchor.

4 / 5

Workflow Clarity

The skill has a clear numbered startup sequence (read → load → check pause flag → apply), explicit validation checkpoints before every risky action ("Before pushing: re-read the Push & Merge section. If ANY rule blocks it, stop and tell the human"), feedback loops (escalate after 3 failed fix attempts, human approval before merge), and a defined fallback path when the file is absent. This matches 'Clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes'.

5 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files (no references/, scripts/, or assets/ exist) and no need for external references beyond the runtime file loop-constraints.md it is designed to read. Per the simple-skill guideline, well-organized sections alone qualify it for the top anchor: clear overview with appropriately split, navigable sections.

5 / 5

Total

18

/

20

Passed

Description

62%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.

The description is honest and sequenced correctly, with an explicit run-order trigger and distinct positioning within its skill family, but it is thin: it names only one or two concrete actions, leans on ecosystem jargon rather than natural user phrasing, and delegates all substance to an external file. It reads as a routing instruction rather than a capability summary.

Suggestions

Enumerate the concrete constraint categories enforced (e.g., push/merge gating, path denylists, test enforcement, budget limits) so 'enforce every rule' conveys actual capabilities.

Add natural trigger terms users would say, such as 'guardrails', 'safety rules', 'limits', or 'restrictions', alongside the existing 'constraints' and 'rules'.

Add an explicit 'Use when...' clause stating the situations that call for this skill (e.g., 'Use when a run must be gated by constraint rules before any action skill executes').

DimensionReasoningScore

Specificity

"Read loop-constraints.md at the start of every run and enforce every rule" names the domain and 1-2 concrete actions (read a specific file, enforce its rules), matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It is not a 4 because it never enumerates the several specific actions the skill actually performs (push gating, path denylists, test enforcement, escalation).

3 / 5

Completeness

The 'what' is stated ("Read loop-constraints.md ... and enforce every rule") and the 'when' has equivalent explicit trigger guidance ("at the start of every run"; "This skill runs BEFORE triage or any action skill"), so the missing-'Use when' cap at 3 does not apply. It is not a 5 because the 'when' describes run sequencing rather than concrete user trigger phrases, and the 'what' delegates substance to an external file — 'when' could be more explicit and specific.

4 / 5

Trigger Term Quality

Relevant keywords exist ("loop-constraints.md", "triage", "action skill", "constraints", "rules") but common variations a user would naturally say are missing ("guardrails", "safety rules", "limits", "restrictions"), fitting 'Some relevant keywords but missing common variations or synonyms'. Not a 4 because keyword coverage is narrow and largely internal jargon rather than natural user phrasing.

3 / 5

Distinctiveness Conflict Risk

Distinct triggers (specific filename loop-constraints.md, explicit precedence "BEFORE triage or any action skill", references to sibling skills loop-triage/loop-budget) give it a mostly distinct niche with only minor overlap risk against closely related loop-family skills. It is not a 5 because phrases like "enforce every rule" and "Constraints are binding" are broad and could bleed into other safety/guardrail skills.

4 / 5

Total

14

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

cobusgreyling/loop-engineering

Path

skills/loop-constraints/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.