CtrlK
BlogDocsLog inGet started
Tessl Logo

fix-contribution

Fix common issues in geographic data contributions to the CSC database. Use this skill whenever you need to fix, correct, repair, patch, or resolve issues in a data contribution or PR. Trigger on: "@copilot fix this", "auto-fix" label on issues, "can you fix", "please correct", "help me fix", "what's wrong with my PR", removing auto-managed fields, correcting country codes, fixing mismatched foreign keys, or formatting JSON. Also use when a PR has validation errors and you need to commit fixes directly. Read common-fixes.md in this directory for fix patterns and examples.

60

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.github/skills/fix-contribution/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%Weight 40%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, actionable skill body that is held back by duplicated content, missing re-validation feedback loops, and references to bundle files (common-fixes.md, states.json, countries.json) that are not actually present.

Suggestions

Add an explicit Step 3.5: re-run the PR Validator (or re-read the validation report) to confirm all errors are resolved before committing, giving the workflow a validate-fix-retry loop.

Bundle the referenced files or remove the references: either provide common-fixes.md/states.json/countries.json in references/, or stop citing them so navigation is not broken.

De-duplicate Step 2 and 'Common Fix Patterns' — keep the fix procedures in one place and have the other section point to them, and add one concrete before/after JSON record example to make the guidance copy-paste ready.

DimensionReasoningScore

Conciseness

The body is mostly lean and avoids explaining concepts Claude already knows, but the 'Common Fix Patterns' section largely restates Step 2 (country/state code lookup, removing auto-managed fields), adding redundant tokens. It is a 2 rather than 3 because of this duplication, and above 1 because there is no conceptual padding or fluff.

2 / 3

Actionability

Guidance is concrete and specific (exact fields to remove: 'id, created_at, updated_at, flag'; files to search: 'states.json', 'countries.json'; commit message template 'fix: correct [description] in [filename]'), but the 'Common Fix Patterns' are pseudocode-style numbered steps rather than executable examples, and no before/after JSON worked example appears in the body. It is a 2 rather than 3 because the patterns are not copy-paste ready and a concrete worked example is absent.

2 / 3

Workflow Clarity

Steps are clearly sequenced (Identify → Apply Fixes → Commit → Explain), but there is no explicit re-validation checkpoint after applying fixes before committing, which the rubric flags for batch/destructive operations (this skill edits multiple records and commits directly to PRs). It is a 2 rather than 3 because the validate-fix-retry feedback loop is missing, and above 1 because the sequence itself is clear.

2 / 3

Progressive Disclosure

The body is organized into clear sections, but it references files that are not bundled ('common-fixes.md', 'states.json', 'countries.json' are absent from references/scripts/assets), and the 'Common Fix Patterns' content that the description says lives in common-fixes.md is duplicated inline. It is a 2 rather than 3 because the referenced files do not exist and content that should be external is inline.

2 / 3

Total

8

/

12

Passed

Description

90%Weight 40%Scale 1-3

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, specific description with explicit what/when triggers and good natural-language coverage. The only weakness is second-person voice ('you need to'), which the rubric penalizes on specificity.

DimensionReasoningScore

Specificity

The description names the domain ('geographic data contributions to the CSC database') and lists concrete actions ('removing auto-managed fields, correcting country codes, fixing mismatched foreign keys, or formatting JSON'), which is normally a 3; however it uses second-person voice ('Use this skill whenever you need to fix'), which the rubric penalizes by reducing specificity by one. It is above 1 because it lists multiple specific concrete actions rather than vague language.

2 / 3

Completeness

It explicitly answers both what ('Fix common issues in geographic data contributions to the CSC database') and when ('Use this skill whenever...', 'Trigger on:', 'Also use when a PR has validation errors'). It is a 3 rather than 2 because the trigger guidance is explicit, not merely implied.

3 / 3

Trigger Term Quality

It gives broad natural-language coverage a user would actually say: 'can you fix', 'please correct', 'help me fix', "what's wrong with my PR", plus the '@copilot fix this' and 'auto-fix' label triggers. It is a 3 rather than 2 because it spans many common phrasings, not just one or two.

3 / 3

Distinctiveness Conflict Risk

The niche is narrow and distinct (CSC geographic-data PR auto-fix workflow with specific triggers like the 'auto-fix' label), making conflict with other skills unlikely. It is a 3 rather than 2 because the triggers are specific to this domain rather than generic.

3 / 3

Total

11

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
dr5hn/countries-states-cities-database
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.