CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sqlitecpp-workflow

SQLiteCpp workflow for branches, implementation, tests, commits, pull requests, and CHANGELOG updates. Use when changing the repository.

Quality

82%

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

81%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-structured workflow skill: concrete file layouts, command and format examples, a validated multi-step process with recovery paths, and clean cross-skill references. The only notable issue is mild redundancy around the CHANGELOG-separate-commit rule, which is stated three times.

Suggestions

State the CHANGELOG-must-be-a-separate-final-commit rule once (in 'CHANGELOG conventions') and reference it from the checklist and commit sections to trim repetition.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no explanations of git or CI basics, and every section conveys repo-specific rules Claude could not infer. Minor trimmable redundancy keeps it below 5: the CHANGELOG-must-be-a-separate-final-commit rule is stated in the checklist, the CHANGELOG conventions, and the Git commits section, and "ASCII only, no em dashes" appears twice. Not 3 because there is no padding or over-explanation.

4 / 5

Actionability

Guidance is concrete and executable for an instruction-only skill: exact file paths (include/SQLiteCpp/<Class>.h, src/<Class>.cpp, tests/<Class>_test.cpp), a command (gh pr create against master), entry formats (- <description> (#NNN), Version X.Y.Z - <year> ???), and step-by-step commit ordering. Minor gaps — no worked example of a good commit message or CHANGELOG line — hold it at 4 rather than 5; it is well above 3 because the guidance is specific rather than pseudocode-level.

4 / 5

Workflow Clarity

The 'Required workflow' is a clearly sequenced 5-step process with an explicit validation checkpoint ("Build and run the relevant tests"), a reporting step, a recovery path for accidentally starting on master, and a change checklist; the CHANGELOG workflow adds a second numbered sequence with branch-reordering rules. This matches the 5 anchor (clear sequence, explicit validation, error-recovery feedback, checklist).

5 / 5

Progressive Disclosure

A single well-sectioned file with clear headers and no nested references; cross-skill links ([[sqlitecpp-release]], sqlitecpp-git-branching, humanizer) are one level deep and clearly signaled. Good structure with a minor gap: the ~30-line CHANGELOG conventions section is self-contained enough that it could live in a reference file, so it does not fully meet the 5 anchor's 'content appropriately split'.

4 / 5

Total

17

/

20

Passed

Description

75%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 solid description that states what the workflow covers (branching, implementation, tests, commits, PRs, CHANGELOG) and when to use it, in concise third-person form. Its main weakness is a generic trigger clause that could be sharpened with the concrete phrases users actually say.

Suggestions

Make the trigger clause concrete by mirroring natural user phrasing, e.g., 'Use when making any change to the SQLiteCpp repository: fixing bugs, adding classes or methods, writing tests, or preparing commits and pull requests.'

Add a synonym or two for high-frequency triggers, such as mentioning PRs by abbreviation (already done) and 'commit messages' or 'update the changelog' so the description matches how users actually phrase requests.

DimensionReasoningScore

Specificity

The description names the domain ("SQLiteCpp workflow") and lists several concrete work items — "branches, implementation, tests, commits, pull requests, and CHANGELOG updates" — matching the anchor for several specific actions with minor gaps (e.g., build-file updates are not surfaced in the description). Not 5 because the items are topical nouns rather than a comprehensive set of concrete actions, and not 3 because coverage clearly exceeds 1-2 actions.

4 / 5

Completeness

Both parts are explicit: what ("SQLiteCpp workflow for branches, implementation, tests, commits, pull requests, and CHANGELOG updates") and when ("Use when changing the repository"). The 'when' is present but could be more specific (e.g., naming the SQLiteCpp repository or common request types), matching the 4 anchor; it is not 5 because the trigger is not a set of concrete trigger phrases, and not 3 because the 'when' clause is explicit, not weakly implied.

4 / 5

Trigger Term Quality

Terms like "commits", "pull requests", "CHANGELOG", and "tests" are natural phrases a user would say, but the trigger clause "Use when changing the repository" is generic and common variations like "open a PR", "make a commit", or "fix a bug in SQLiteCpp" are missing. Good coverage with a few natural terms absent fits the 4 anchor better than 3 (which would miss common keywords) or 5 (which would include synonyms).

4 / 5

Distinctiveness Conflict Risk

The SQLiteCpp domain and workflow scope give it a clear niche with minimal conflict against general skills. Minor overlap risk remains with sibling repo skills (e.g., sqlitecpp-git-branching and the release process) because "when changing the repository" is broad, fitting the 'mostly distinct; minor overlap risk' anchor rather than the fully distinct 5.

4 / 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

SRombauts/SQLiteCpp

Path

.claude/skills/sqlitecpp-workflow/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.