CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fly-mpg-backup-restore

Use when working with Fly Managed Postgres backups, Fly MPG proxy access, pg_dump or pg_restore from a proxied production database, or when testing app/backfill behavior on a restored local copy of prod.

56

Quality

70%

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/fly-mpg-backup-restore/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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 deliberately thin orchestration skill: clean, lean, and honest about deferring to a canonical recipe. Its weaknesses are the flip side of that design — the body has no executable content, the recipe it depends on sits outside the skill bundle behind a fragile relative path that does not resolve here, and verification steps are named as recipe scope but never given as explicit checkpoints in the skill itself.

Suggestions

Bring the recipe inside the skill bundle (e.g. copy it to references/recipe.md and link relatively) or inline the few critical commands (MPG proxy setup, pg_dump/pg_restore invocations) so the skill is self-contained and the link cannot dangle.

State the expected restore-verification outcome explicitly (e.g. what query or row count confirms the restore succeeded before starting the app), so the checkpoint does not depend entirely on the external recipe.

Drop or compress the 'When to trigger' section (it duplicates the frontmatter description) and the maintainer-facing 'Keep the skill focused' bullet to tighten token efficiency.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no concept explanations, no restated Postgres knowledge, every bullet is a directive. It misses 5 because the 'When to trigger' section substantially duplicates the frontmatter description's trigger list, and 'Keep the skill focused on orchestration and verification, not duplicating the full runbook' is maintainer-facing rather than agent guidance — minor tokens that could be trimmed. It is above 3 because there is no unnecessary explanation, only these small redundancies.

4 / 5

Actionability

Guidance is concrete in its delegation — it names the exact canonical scope (proxy setup, URL rewriting, pg_dump/pg_restore, extension precreation, restore verification) and the specific file 'docker-compose.restore-test.yaml' with a clear precondition for its use. But the body contains no executable commands at all, and its sole source of executable steps is a reference outside the bundle at '../../../docs/recipes/fly-mpg-backup-restore.md', a relative path that does not resolve from the skill's directory. It is above 2 (more than high-level hints — precise file names and scope rules) but below 4 (nothing in the body is directly executable, and the primary pointer is fragile).

3 / 5

Workflow Clarity

The 'Treat the recipe as canonical for' bullet implies a real phase sequence (proxy setup → URL rewriting → pg_dump/pg_restore → extension precreation → restore verification → restored-db app startup), and 'Use docker-compose.restore-test.yaml only after the recipe has created the restored database container' gives one explicit ordering constraint. However, the body provides no explicit validation checkpoints or error-recovery loops of its own, and the rubric caps workflow clarity at 3 for destructive/batch database operations without validation steps in the skill itself. It is above 2 because an ordered phase list plus one sequencing rule is present, but the cap and the fully deferred verification keep it from 4.

3 / 5

Progressive Disclosure

Sections are well organized, and the single reference is one level deep and clearly signaled ('Use the human-facing recipe as the source of truth for the exact commands and restore procedure'). However, there are no bundle files at all — no references/, scripts/, or assets/ — and the one detailed material the skill depends on lives outside the skill bundle at a relative path ('../../../docs/recipes/fly-mpg-backup-restore.md') that does not resolve from the skill's location, making navigation fragile and the skill non-self-contained. This is more than a minor organization gap (ruling out 4) but the reference is clearly signaled and nothing inlined belongs elsewhere (ruling out 2).

3 / 5

Total

13

/

20

Passed

Description

70%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 strong, specific description with natural trigger phrasing and minimal conflict risk. Its main weakness is that it is entirely trigger-framed: the capability side ('what this skill does') is only implied by the when-clauses rather than stated explicitly.

Suggestions

Lead with a short third-person capability statement (e.g. 'Orchestrates pg_dump/pg_restore of a Fly Managed Postgres database through the MPG proxy and verifies a restored local copy') before the 'Use when...' trigger clause.

Add a few natural trigger variations users might say, such as 'database dump', 'restore production data locally', or 'copy prod locally'.

DimensionReasoningScore

Specificity

The description names several concrete operations — 'Fly Managed Postgres backups', 'Fly MPG proxy access', 'pg_dump or pg_restore from a proxied production database', 'testing app/backfill behavior on a restored local copy of prod' — which are specific tools and actions, not vague abstractions. It falls short of 5 because everything is framed as trigger conditions rather than an explicit statement of what the skill does, leaving minor gaps in capability coverage.

4 / 5

Completeness

The 'when' is explicit and strong ('Use when working with... or when testing app/backfill behavior on a restored local copy of prod'), and the enumerated trigger operations convey the 'what' — backing up, restoring, dumping/restoring via the proxy — reasonably concretely. It sits between anchor 4 and 5: the when has concrete trigger phrases, but the what is only carried implicitly inside the when-clauses with no standalone capability statement, which keeps it below 5. It is above 3 because both what and when are effectively communicated, not just one.

4 / 5

Trigger Term Quality

Natural user phrasing is well covered: 'backups', 'pg_dump', 'pg_restore', 'restore', 'backfill', 'restored local copy of prod', 'proxy', plus both the full name 'Fly Managed Postgres' and the abbreviation 'Fly MPG'. A few natural variations are missing (e.g. 'database dump', 'restore production data locally', 'snapshot'), so it is good but not comprehensive enough for 5, and clearly above the partial-coverage anchor at 3.

4 / 5

Distinctiveness Conflict Risk

This is a clear niche — Fly.io Managed Postgres backup/restore through the MPG proxy — with distinct triggers (MPG, proxied production database, restored local copy of prod) that virtually no other skill would claim. Conflict risk is minimal, matching the top anchor.

5 / 5

Total

17

/

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

getlarge/themoltnet

Path

.agents/skills/fly-mpg-backup-restore/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.