CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

init-rulebook

Load and manage a personal agent rulebook. Use when asked to reload agent rules at session start or after compaction, set up agent rules, fine-tune rule loading, check rulebook status or diagnose unrelated rules being loaded, link dotfiles, configure a host startup pointer to the rulebook, or update this skill or its rulebook. Not for project `.agent-memory/` or repository instruction-file pointers.

Quality

89%

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

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

An exemplary instruction-only skill body: highly actionable mode routing and load rules, explicit validation and error-reporting checkpoints, and textbook progressive disclosure with correctly gated, verified bundle files. The only weakness is minor redundancy from restating a few prohibitions and boundaries in multiple sections.

DimensionReasoningScore

Conciseness

Dense, assumes Claude's competence throughout — no explanation of what AGENTS.md, compaction, or symlinks are — and every section carries operational rules. Falls short of the 5 anchor only due to minor repetition that could be trimmed: the prohibition on substituting a `rules/` directory or repository `AGENTS.md` appears in both "Resolve the index" and the inventory step, and the metadata-only read boundary is stated then restated for `status` and setup.

4 / 5

Actionability

Although code-free, the guidance is fully executable for an instruction skill: a numbered index-resolution order with explicit tie-breakers ("An explicit request selects this invocation's path without rewriting the persistent pointer"), a mode table with entry and done-when conditions, and exact selection rules ("Load every rule in its always-on group, plus each conditional rule whose documented trigger matches"). Matches the top anchor for concrete, case-covering guidance.

5 / 5

Workflow Clarity

Clear sequences with explicit validation checkpoints and feedback loops: report-and-ask on ambiguity ("report the problem and ask for the intended path"), error reporting instead of silent assumptions ("If either path cannot be resolved or read, report that error rather than assuming equality or a mismatch"), a pass/fail definition for `status`, and a done-when checklist per mode including "discovery is verified in a fresh session, or reported untested". Setup's write operations are guarded (links must resolve "without replacing other files"), so the destructive-operation cap does not apply.

5 / 5

Progressive Disclosure

Clear overview with well-signaled references, all verified to exist: onboarding.md is gated to four modes ("For `setup`, `fine-tune`, `link-dot-files`, or `update`, read..."), public-example.md is gated to "only when the user wants a sample rule set", and the body explicitly notes "Startup and reload need neither reference". References are one level deep — onboarding.md's link to public-example.md is also directly reachable from SKILL.md — and evals live in assets/ with an author-only gate, so nothing is buried.

5 / 5

Total

19

/

20

Passed

Description

83%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: third-person, concise, with an explicit Use-when trigger list and a negative-scope clause that reduces conflict risk. The only gaps are a few missing natural synonyms (e.g. "AGENTS.md", "agent instructions") and slightly abstract action phrasing that keeps specificity and trigger coverage at 4 rather than 5.

DimensionReasoningScore

Specificity

Lists many specific actions — "reload agent rules at session start or after compaction", "fine-tune rule loading", "check rulebook status or diagnose unrelated rules being loaded", "link dotfiles", "configure a host startup pointer" — covering all of the skill's modes. Falls just short of the 5 anchor because the actions are verb phrases without the concrete artifacts the top anchor shows (e.g. the `AGENTS.md` file or `~/.agents/` path are absent from the description).

4 / 5

Completeness

Explicitly answers both questions: what ("Load and manage a personal agent rulebook") and when ("Use when asked to... or update this skill or its rulebook"), with concrete trigger phrases plus an explicit exclusion ("Not for project `.agent-memory/` or repository instruction-file pointers"). Matches the 5 anchor exactly; not 4 because the when-clause is fully explicit rather than merely present.

5 / 5

Trigger Term Quality

Good natural-phrase coverage: "reload agent rules", "set up agent rules", "rulebook status", "link dotfiles", "session start", "after compaction" — phrases a user would plausibly say. A few natural synonyms are missing, such as "AGENTS.md", "agent instructions", or "refresh/apply my rules", so it does not reach the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

A clear niche (personal agent-rulebook lifecycle) with distinct triggers and an explicit negative boundary that disambiguates it from project-memory skills. Not 5 because closely related agent-config/memory skills could still compete for generic requests like "set up agent rules" or "update this skill".

4 / 5

Total

17

/

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: 1 deeper-than-1-level

Warning

referenced_paths_exist

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

Warning

Total

14

/

16

Passed

Repository

t4sh/skills4sh

Path

skills/init-rulebook/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.