CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cc-skill-project-guidelines-example

Project Guidelines Skill (Example)

Quality

46%

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/cc-skill-project-guidelines-example/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 well-structured and highly actionable, with executable code, real commands, and an explicit pre-deployment checklist — a solid project-reference document. Its weaknesses are the meta-template padding and over-long generic snippets, and the absence of any actual bundle files despite referencing related skill paths that don't exist.

Suggestions

Remove or compress the template meta-commentary and trim the fetchApi/useApi implementations to the ApiResponse interface plus one short usage example, letting Claude write standard React data-fetching code itself.

Split code patterns, testing requirements, and deployment details into reference files under references/ and link to them one level deep, replacing the currently dangling Related Skills links to non-existent files.

Add an error-recovery loop to the deployment workflow (what to do when a checklist item fails) and a post-deployment smoke test step to validate the deployed service.

DimensionReasoningScore

Conciseness

The body is mostly dense lists, diagrams, and executable code with no explaining of concepts Claude already knows, but it carries unnecessary tokens: meta-template framing ("This is an example of a project-specific skill. Use this as a template") and long generic snippets (the full fetchApi and useApi implementations) that could be trimmed to interfaces plus a short example. This fits anchor 3 ("mostly efficient but includes some... could be tightened") more than anchor 4, where over-explanation would be only minor.

3 / 5

Actionability

Concrete, executable guidance dominates: complete pytest/React test structures, exact commands ("poetry run pytest tests/ --cov=.", "gcloud run deploy backend --source ."), a filled-out environment variable template, and a pre-deployment checklist. Minor gaps keep it below anchor 5: the oddly placed "# verified supported model ID," comment, the untyped `await response.json()` return, and env placeholders that still need project-specific values.

4 / 5

Workflow Clarity

The deployment workflow pairs an explicit validation checklist ("All tests passing locally", "npm run build succeeds") with sequenced, concrete commands — meeting anchor 4's "clear sequence with most checkpoints present". It does not reach anchor 5 because there is no error-recovery feedback loop (what to do when a checklist item fails) and no post-deployment verification step.

4 / 5

Progressive Disclosure

Section structure is clear and consistent (When to Use, Architecture, File Structure, Code Patterns, Testing, Deployment, Critical Rules), but the ~350-line file inlines everything — code patterns, testing details, and deployment docs that could live in separate reference files. The "Related Skills" links (`coding-standards.md`, `backend-patterns.md`, `frontend-patterns.md`, `tdd-workflow/`) point to files that do not exist in the bundle. This matches anchor 3 ("some structure... content that should be separate is inline").

3 / 5

Total

14

/

20

Passed

Description

3%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 a bare title with no functional content: no capabilities, no trigger conditions, and no way to distinguish it from other project skills. It would almost never be selected appropriately by a description-matching mechanism.

Suggestions

Replace the title with a capability statement listing concrete actions, e.g. "Provides architecture overview, code patterns, testing requirements, and deployment workflow for this project."

Add an explicit "Use when..." clause with natural trigger phrases such as "Use when working in this repository, modifying backend routes or frontend components, running tests, or deploying to Cloud Run."

Include distinguishing keywords tied to the project's stack (Next.js, FastAPI, Supabase) to reduce overlap with other project-guidelines skills.

DimensionReasoningScore

Specificity

The description is just a title — "Project Guidelines Skill (Example)" — with no action verbs or concrete capabilities whatsoever, placing it at or below the anchor-1 example ("Helps with documents"). Anchor 2 ("Processes PDF files") requires at least one minimal or generic action, which is absent here.

1 / 5

Completeness

Neither "what does this do" nor "when should Claude use it" is stated — the description contains no capability statement and no "Use when..." clause or equivalent. This matches anchor 1 ("Missing both what and when").

1 / 5

Trigger Term Quality

There are no natural keywords a user would actually say when needing this skill; "Project Guidelines" is an entirely generic phrase with no synonyms, extensions, or trigger terms. It is weaker than anchor 2's "Works with files", which at least contains a phrase users say.

1 / 5

Distinctiveness Conflict Risk

It names a single domain ("Project Guidelines") rather than several broad ones, so it is slightly above anchor 1's entirely-generic example, but any other project-guidelines or conventions skill would collide with it. It fits anchor 2 ("Very broad; high overlap risk with many similar skills").

2 / 5

Total

5

/

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

sickn33/agentic-awesome-skills

Path

skills/cc-skill-project-guidelines-example/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.