CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

engram-project-structure

Repository structure and placement rules for Engram. Trigger: Creating files, packages, handlers, templates, styles, or tests in this repo.

Quality

86%

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.

A tight, well-organized instruction-only skill: every rule carries non-obvious repo-specific knowledge (paths, package boundaries, artifact-to-location mappings) with zero padding. The only gap is a handful of partial paths in the File Creation Rules that keep it from fully copy-paste-ready guidance.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no explanations of what handlers, templates, SQL, or package layers are; every rule states only repo-specific knowledge Claude could not infer. Matches the anchor "Lean and efficient; assumes Claude's competence; every token earns its place".

5 / 5

Actionability

Concrete, repo-specific guidance throughout: exact paths ("internal/cloud/dashboard/*.templ", "internal/cloud/dashboard/static/styles.css", "store/cloudstore", "_templ.go") and an artifact-to-location mapping ("New route -> handler + tests in dashboard/server package"). Not a 5 because a few targets are partial — "dashboard/server package" and "docs/catalog" lack full paths, leaving minor ambiguity about exact locations.

4 / 5

Workflow Clarity

This is a simple single-task decision skill (no multi-step process), and the single action — deciding where a new artifact goes — is unambiguous via the explicit artifact-to-location table and placement rules. No destructive or batch operations exist, so no validation checkpoints are required under the rubric's simple-skill exception.

5 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external reference files (none exist in references/, scripts/, or assets/, and the body references none), and is organized into four clear, well-labeled sections — matching the rubric's guidance that such skills can score 5 with just well-organized sections.

5 / 5

Total

19

/

20

Passed

Description

73%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 compact, repo-scoped description with an explicit trigger clause and good natural trigger vocabulary. Its main weakness is the "what" half — a category label ("structure and placement rules") with no stated actions or outcomes, leaving the description thinner on capability than the rubric's top anchors.

Suggestions

Lead the description with a third-person action statement naming concrete capabilities, e.g. "Decides where new code belongs in the Engram repo: maps routes to handler packages, DB behavior to store/cloudstore, and UI partials to templ components."

Broaden trigger vocabulary with natural variations and synonyms users would actually say, such as "adding a test", "new route", "new UI page", or "where should this file go".

State the concrete outcome of using the skill (a correct placement decision and the exact target paths) rather than the abstract category "structure and placement rules".

DimensionReasoningScore

Specificity

"Repository structure and placement rules for Engram" names the domain specifically, and the trigger enumerates concrete artifact types ("files, packages, handlers, templates, styles, or tests"), but the description states no actions the skill performs — it falls between anchor 2 (generic minimal actions) and anchor 3 (domain plus 1-2 concrete actions).

3 / 5

Completeness

Both parts are present: a "what" ("Repository structure and placement rules for Engram") and an explicit "when" ("Trigger: Creating files, packages, handlers, templates, styles, or tests in this repo"). Not a 5 because the "what" is a terse label rather than an explicit statement of what the skill does or decides.

4 / 5

Trigger Term Quality

"Creating files, packages, handlers, templates, styles, or tests in this repo" covers good natural trigger vocabulary a developer would say, but misses common variations and synonyms such as "adding", "new route", "where does this go", and file extensions (.templ, .css, .go).

4 / 5

Distinctiveness Conflict Risk

The description is scoped to a single repository ("for Engram", "in this repo") with niche placement-focused triggers, giving it a clear niche with minimal conflict risk against general-purpose skills.

5 / 5

Total

16

/

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

Gentleman-Programming/engram

Path

skills/project-structure/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.