CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

data-ops

Script catalog, data migration pipelines, and reconciliation tools for POSCursor

52

Quality

65%

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 ./.agents/skills/data-ops/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 content is a genuinely useful, command-dense operations catalog with a well-sequenced migration workflow that includes verification steps. Its main weaknesses are dead weight (the tmp_* delete-me section and duplicate script entries) and the absence of an error-recovery loop after the verification commands.

Suggestions

Delete the '⚠️ Legacy/Temporary (Safe to Delete)' section (and the tmp_* files themselves) rather than spending tokens cataloging them; likewise collapse the extract-excel.js/.ts duplicate into one row.

Add a short 'If verification fails' loop after the migration bash block, e.g., 'If counts mismatch: run scripts/verify_dupes.js to find duplicates, then scripts/reconcile-master-import.js; re-run verify_excel_vs_supabase.js before proceeding.'

State prerequisites once up front (npm deps, required .env keys, expected Excel filename/location) instead of leaving them as inline comments in the bash block.

DimensionReasoningScore

Conciseness

The body is mostly efficient — dense tables with one line per script — but includes unnecessary padding: an 11-row 'Legacy/Temporary (Safe to Delete)' tmp_* catalog that documents scripts the skill itself says should be deleted, plus duplicate entries (e.g., 'extract-excel.js' and its '.ts' twin). This fits 'Mostly efficient but includes some unnecessary explanation or could be tightened'; it is not level 4 because the tmp_* section and duplicates are noise that earns no tokens.

3 / 5

Actionability

Every catalog row carries a runnable command ('node scripts/migrate_savings_cbu_v2.mjs'), and the 'Running a Migration' block is a copy-paste bash sequence including verification commands and named utility functions with the rollover formula. Minor gaps keep it below 5: no dependency/installation guidance, no enumeration of required .env variables, and the pipeline steps describe internal behavior rather than executable commands.

4 / 5

Workflow Clarity

The migration pipeline has a clear sequence (7 ordered steps, a runnable bash block, and a 4-step post-migration list ending in 'Run scripts/verify_balances.js to confirm'), so validation checkpoints are present for this batch DB-writing operation — the destructive/batch cap of 3 does not apply. It falls short of level 5 because there is no feedback loop: nothing says what to do when verify_excel_vs_supabase.js or verify_balances.js reports discrepancies, even though fix/reconcile scripts exist in the catalog.

4 / 5

Progressive Disclosure

The body is well structured: categorized sections (Auth, Migration, Verification, Fixes, Sync, Reports, Backup, Schema, Specialized) with per-category tables, followed by a focused pipeline deep-dive; the detailed logic appropriately lives in the referenced scripts/ files rather than being inlined. It is not level 5 because navigation is purely within one long file — the catalog and pipeline could be split with clearly signaled one-level-deep references, and the catalog's breadth (including throwaway tmp_* scripts) dilutes the overview.

4 / 5

Total

15

/

20

Passed

Description

48%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 short and anchors to a specific project, but it is a verbless noun list with no usage trigger. Adding third-person action verbs (e.g., 'Migrates Excel data to Supabase, reconciles balances...') and an explicit 'Use when...' clause would materially improve it.

Suggestions

Rewrite as third-person actions: 'Catalogs and runs data-operation scripts for POSCursor: migrates Excel data to Supabase, reconciles balances, verifies database integrity.'

Add an explicit trigger clause, e.g., 'Use when migrating Excel borrower/payment data to Supabase, reconciling POSCursor balances, or running verification/backup scripts.'

Include natural trigger keywords users would actually say: 'Excel import', 'Supabase', 'backup/restore', 'verify balances', '.xlsx'.

DimensionReasoningScore

Specificity

The description 'Script catalog, data migration pipelines, and reconciliation tools for POSCursor' names three concrete tool categories and the target project, but contains no action verbs at all — it is a noun-phrase inventory rather than a statement of what the skill does. This matches the anchor 'Names the domain but actions are minimal or generic' ('Processes PDF files') and is below the level-3 anchor, which requires 1-2 concrete actions.

2 / 5

Completeness

The 'what' is reasonably clear (a catalog of ops/migration/reconciliation tooling), but there is no 'when' — no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It does not reach level 4 because the 'when' is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Terms like 'data migration', 'reconciliation', and 'POSCursor' are natural phrases a user on this project would say, but the description misses common variations and synonyms (e.g., 'Excel import', 'Supabase', 'backup', 'verify balances', '.xlsx'). This fits 'Some relevant keywords but missing common variations or synonyms' and falls short of the good-coverage level-4 anchor.

3 / 5

Distinctiveness Conflict Risk

The project-specific name 'POSCursor' gives this a clear niche and low conflict risk against generic skills, fitting 'Mostly distinct; minor overlap risk'. It is not a 5 because the trigger phrases are not explicit, so a broader 'data migration' or 'script' skill in the same environment could still overlap.

4 / 5

Total

12

/

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: 15 missing

Warning

Total

15

/

16

Passed

Repository

zazakia/JetFarm

Path

.agents/skills/data-ops/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.