CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sq-site-dependabot

Reviews, validates, and safely merges Dependabot pull requests for the sq.io site (site/, Bun lockfile). Use when clearing site dependency PRs, triaging Dependabot failures, or checking Lighthouse impact before merge.

Quality

91%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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.

An exemplary operational skill: fully executable commands, a consent-gated merge loop with layered validation and stale-head guards, and a clean one-level-deep reference structure. The only notable improvement is trimming minor duplication in the reference index and alternate commands.

Suggestions

Drop the 'Reference index' section (its seven links all appear inline at their point of use) or keep only the index and remove the repeated inline citations.

Remove the alternate manual bootstrap one-liner ('Or: gh api user -q .login && cd site && bun install && make check-netlify') from Phase 0; the check-tools.sh entry plus the tool-bootstrap.md reference already cover it.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence throughout — it never explains what Dependabot, Netlify, or Lighthouse are — and every phase is operational. It falls just short of 5 because the 'Reference index' section duplicates links already given inline and Phase 0 includes an alternate one-liner command that could be trimmed.

4 / 5

Actionability

Guidance is fully executable: concrete commands with exact flags and jq filters (`gh pr list --author 'app/dependabot' ...`), `make ci` / `make site-netlify-validate`, a real PR example for `merge-next.sh` with env vars, and a copy-ready verdict template. All referenced scripts exist in the bundle.

5 / 5

Workflow Clarity

The multi-phase process is clearly sequenced with explicit validation checkpoints (Phase 0 'Stop on failure', stale-head guard on headRefOid, Layer A checks, Layer B required in Full mode, poll loop with max ~5 min), feedback loops for error recovery (debug-netlify-pr.sh, merge-failures.md), and consent gating on the destructive merge step.

5 / 5

Progressive Disclosure

SKILL.md acts as a lean overview with well-signaled, one-level-deep references that all exist in references/ (7 files) and scripts/ (3 files), with details appropriately split out (risk tiers, package notes, build debugging, merge failures) and an index for navigation.

5 / 5

Total

19

/

20

Passed

Description

87%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 description that clearly and concisely states both capability and triggering context with concrete, natural trigger phrases. Its only weakness is slightly incomplete keyword coverage (no lockfile/bun.lock synonyms).

DimensionReasoningScore

Specificity

The description lists three concrete actions ('Reviews, validates, and safely merges Dependabot pull requests') scoped to a specific target ('sq.io site (site/, Bun lockfile)'), matching the 'several specific actions; minor gaps in coverage' anchor. It is not 5 because capabilities like risk tiering and verdict reporting only appear indirectly in the 'when' clause, and not 3 because it goes well beyond naming 1-2 actions.

4 / 5

Completeness

It explicitly answers both what ('Reviews, validates, and safely merges Dependabot pull requests for the sq.io site') and when ('Use when clearing site dependency PRs, triaging Dependabot failures, or checking Lighthouse impact before merge') with concrete trigger phrases, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Natural user phrases are present ('clearing site dependency PRs', 'triaging Dependabot failures', 'checking Lighthouse impact before merge'), giving good keyword coverage. It falls short of 5 because common synonyms and file terms such as 'lockfile', 'bun.lock', or 'dependency updates' are missing.

4 / 5

Distinctiveness Conflict Risk

The niche is unmistakable — Dependabot PRs for the sq.io site with a Bun lockfile and Lighthouse checks — giving it clear, distinct triggers with minimal overlap risk against generic dependency or CI skills.

5 / 5

Total

18

/

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: 9 suspicious

Warning

Total

15

/

16

Passed

Repository

neilotoole/sq

Path

.agents/skills/sq-site-dependabot/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.