CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

repo-conventions

Repository conventions for this Bun starter — Bun-only tooling, workspace layout, quality gates, Lefthook hooks, Conventional Commits, Tailwind CSS, SvelteKit, type checking with `bun check`, and reference repositories in repos/. Use when starting work in this repository, choosing tools, running checks, committing, or when AGENTS.md / CLAUDE.md point here.

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

86%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 exemplary conventions reference: token-dense, assuming Claude's competence, with executable commands, exact paths, and explicit guardrails instead of explanations. The pre-commit and version-pinning sections even include the fix-and-retry loops the rubric prizes. The only quibbles are unsignaled version numbers and the absence of an end-to-end change workflow.

DimensionReasoningScore

Conciseness

The body is telegraphic and dense with repo-specific facts Claude could not know (catalog workspaces, `exactOptionalPropertyTypes`, no `tailwind.config.js`, `bun check` vs `tsc`), with essentially no concept explanation. It misses a 5 only because bare time-sensitive version numbers ("1.4.4", "SvelteKit 3") appear outside any old-patterns/deprecated section, which the rubric penalizes.

4 / 5

Actionability

The `bun run` command block is copy-paste ready and annotated, script names are exact (`scripts/check-bun-version.ts`, `scripts/certs.ts`), and policies are stated as concrete directives ("Do not introduce npm, yarn, or pnpm", "Never bypass hooks (`--no-verify`, `LEFTHOOK=0)`"). For an instruction-only skill this fully meets the top anchor.

5 / 5

Workflow Clarity

The workflows that exist include a feedback loop (pre-commit: "format is checked, not fixed — run `bun run fmt` / `md:fmt`, then stage") and coupled-change guidance ("change all of them together"), so it sits above anchor 3's implicit checkpoints. It is not a 5 because most of the body is a policy reference rather than a sequenced process — there is no end-to-end sequence for a typical change, though no destructive/batch cap applies.

4 / 5

Progressive Disclosure

Sections are well organized with clear headers, references are one level deep and clearly signaled ("Details in docs/local-https.md", "(docs/security.md)", and a table routing to the svelte / bdd-bun-test / agent-browser skills), and nothing inlined here clearly belongs in a separate bundle file. This matches the top anchor for a compact overview with well-signaled external references.

5 / 5

Total

18

/

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 is written in third person, free of fluff, explicitly states both what the skill covers and when to use it, and is tightly scoped to this repository so it will not trigger for the wrong skill. The only weakness is that capabilities are expressed as a list of topic nouns rather than concrete actions, and a few natural trigger synonyms (lint, format, verify) are absent.

DimensionReasoningScore

Specificity

The description enumerates several specific concrete elements — "Bun-only tooling", "Lefthook hooks", "Conventional Commits", "type checking with `bun check`", "reference repositories in repos/" — with only minor coverage gaps. It falls short of a 5 because these are topic nouns rather than performed actions (no verbs at all), and above a 3 because far more than 1-2 concrete items are named.

4 / 5

Completeness

Both parts are explicit: the "what" ("Repository conventions for this Bun starter — ... type checking with `bun check`, and reference repositories in repos/") and a concrete multi-clause "when" ("Use when starting work in this repository, choosing tools, running checks, committing, or when AGENTS.md / CLAUDE.md point here"). The "when" is specific and multi-triggered, so it exceeds the anchor-4 case where triggers "could be more explicit".

5 / 5

Trigger Term Quality

"starting work in this repository", "choosing tools", "running checks", "committing", and "when AGENTS.md / CLAUDE.md point here" are natural phrases a user would say, backed by distinctive keywords (Lefthook, Conventional Commits, bun check). Not a 5 because common variations like "lint", "format", "verify", or "ci" are missing; not a 3 because coverage is good rather than partial.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche — conventions for one specific Bun-based starter — with distinct triggers (bun check, Lefthook, repos/, AGENTS.md/CLAUDE.md pointers), so conflict risk is minimal. The Tailwind/SvelteKit mentions only marginally overlap with related skills, which the skill itself routes to explicitly, keeping this at 5 rather than 4.

5 / 5

Total

18

/

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

referenced_paths_exist

Referenced path issues: 5 missing

Warning

Total

15

/

16

Passed

Repository

williamrjribeiro/resume

Path

.agents/skills/repo-conventions/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.