CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

rules-management

Manage project-level agent behavioural rules recorded in a single rules file. Use when the user says 'new rule', 'add a rule', 'record that', 'make a rule that', 'note this', 'take note of', 'new instruction', or asks to codify an agent directive. Read the rules file to check existing rules before adding a new one. DO NOT use for ephemeral notes, one-off instructions, or instructions that belong in the project's own agent-facing docs. Triggers: 'new rule', 'add a rule', 'record that', 'make a rule', 'codify this', 'rule about', 'create a directive', 'note this', 'take note of', 'new instruction'.

Quality

85%

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

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

A highly actionable body with copy-paste commands, an exact entry format, a clearly sequenced workflow with a validation step, and a well-organized reference bundle. The main weakness is repetition: the same directives (read-before-append, prefer generate over hand-typing) are stated multiple times across sections, and a couple of sections (Where Rules Live, the When to Use trigger list) restate information already conveyed elsewhere.

Suggestions

Cut the one-sentence 'Where Rules Live' section and state the path (.claude/RULES.md) directly in Prerequisites; the current 'path shown in Quick Start above' indirection costs a section to convey one fact.

State the read-before-append and prefer-generate-over-hand-typing directives once each (in the numbered workflow) instead of repeating them in Prerequisites, Anti-Patterns, and Mindset.

Add an error-recovery step to the workflow: 'If validate-rules.sh validate fails, fix the entry and re-run before treating the change as done' -- this closes the feedback-loop gap and would raise workflow clarity to anchor 5.

DimensionReasoningScore

Conciseness

The body is mostly efficient but repeats itself noticeably: the read-before-append directive appears in Prerequisites, step 1 of When to Use, the first Anti-Pattern, and Mindset; 'When to Use' restates the description's full trigger list; the one-sentence 'Where Rules Live' section adds nothing beyond Quick Start; and 'TYPICALLY this is the same command as the Quick Start validation step' is meta-commentary. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') better than anchor 4, where over-explanation would be only minor.

3 / 5

Actionability

Fully executable, copy-paste-ready commands cover the common case: 'cat .claude/RULES.md', './scripts/validate-rules.sh validate .claude/RULES.md', and './scripts/validate-rules.sh generate "<title>" "<directive>" "<rationale>"', backed by a concrete entry template and real schema/template bundle files. This matches anchor 5.

5 / 5

Workflow Clarity

A clear numbered 1-5 sequence (read, dedupe-check, append via generate, inform user, validate before done) with an explicit validation checkpoint before treating the change as complete. It falls short of anchor 5 because there is no error-recovery feedback loop saying what to do when 'validate-rules.sh validate' fails (fix and re-validate), which the anchor-5 example includes.

4 / 5

Progressive Disclosure

The References section clearly signals existing one-level-deep files (references/rule-format.md, assets/schemas/rule-entry.schema.json, assets/templates/rule-entry.yaml) and the Quick Start orients the reader immediately. However, the body's 'Rule Format' section duplicates the core of references/rule-format.md inline rather than fully splitting it out, a minor organization gap that fits anchor 4 rather than anchor 5.

4 / 5

Total

16

/

20

Passed

Description

91%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 states what the skill does, when to use it with a comprehensive set of natural trigger phrases, and when not to use it. The only weaknesses are minor: 'Manage' as the lead verb is slightly generic, and a few trigger phrases overlap with note-taking skills.

DimensionReasoningScore

Specificity

The description names the domain ('project-level agent behavioural rules recorded in a single rules file') and several concrete actions ('Read the rules file to check existing rules before adding a new one') plus explicit negative scope ('DO NOT use for ephemeral notes, one-off instructions...'). It exceeds anchor 3 (only 1-2 actions) but falls short of anchor 5 since coverage has gaps (no amend/merge/delete of rules).

4 / 5

Completeness

It explicitly answers 'what' (manage/read/dedupe/append project rules in a single rules file) and 'when' ('Use when the user says...' with concrete trigger phrases), plus a when-not clause. This clearly matches the anchor-5 example structure of explicit what AND when with concrete triggers.

5 / 5

Trigger Term Quality

Comprehensive natural-language trigger coverage with many synonyms a user would actually say: "new rule", "add a rule", "record that", "make a rule that", "note this", "take note of", "new instruction", plus an explicit consolidated 'Triggers:' list. No common variation is missing, matching anchor 5 rather than anchor 4.

5 / 5

Distinctiveness Conflict Risk

The niche (a single project rules file) is clear and mostly distinct, but phrases like "note this", "take note of", and "record that" are things users also say when they want general note-taking or memory capture, creating minor overlap risk with closely related skills. The 'DO NOT use for ephemeral notes' clause only partially mitigates this, so anchor 4 fits better than anchor 5.

4 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 4 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

pantheon-org/tekhne

Path

skills/agentic-harness/rules-management/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.