CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

spring-boot-team-harness

Use when a team wants every developer's coding agent (Claude Code or Codex) to follow the same rules on a Maven Spring Boot 4 repository: setting up AGENTS.md, guardrails, shared agent settings, or build and CI checks that agents must pass before code merges. It adds ./mvnw verify gates that fail on null-safety bugs (NullAway with JSpecify), module-boundary breaches (Spring Modulith), unknown or deprecated Boot property keys, Spring mistakes that compile (ArchUnit) and unformatted code, Claude Code hooks that run those gates before a turn ends, and a CI workflow.

Quality

94%

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

88%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 strong, executable instruction skill: every command is concrete, the workflow is sequenced with real validation checkpoints and failure-recovery paths, and it documents only what the script produces rather than generic Spring knowledge. The remaining polish is splitting the overloaded step-1 paragraph and the inline CodeRulesTests rule catalog into leaner forms.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence (no padding explaining Spring Boot, Maven, or hooks), with a table efficiently mapping each produced file to its effect. However, step 1 packs rerun/idempotency/merge edge cases into a single very long paragraph, and the CodeRulesTests row inlines roughly twenty rules as one run-on sentence — both could be trimmed or split out.

4 / 5

Actionability

Commands are copy-paste ready and complete: `python3 ${CLAUDE_SKILL_DIR}/scripts/apply_harness.py . --dry-run`, `./mvnw spotless:apply`, `python3 ${CLAUDE_SKILL_DIR}/scripts/baseline.py .`, plus concrete env vars (`SONARQUBE_TOOLSETS=issues,quality-gates`). Behavioral guidance is equally specific (e.g. mark inferred conventions `(inferred)`, add the reformat commit to `.git-blame-ignore-revs`).

5 / 5

Workflow Clarity

Six steps are clearly sequenced with explicit validation checkpoints and feedback loops: dry-run preview first, "Get `./mvnw verify` green", a fallback path for existing codebases (few findings → fix with the user, many → `baseline.py`), an explicit prohibition on suppressing warnings to get green, and lock-file-tracked reruns that report edited files for manual merge.

5 / 5

Progressive Disclosure

Good structure: sections plus a navigable per-file table, and every referenced bundle path is real (`scripts/apply_harness.py`, `scripts/baseline.py`, `scripts/report.py`, `assets/pom/plugins.xml`) one level deep. Minor gap: substantial reference detail (the ~20 CodeRulesTests rules, the apply/rerun semantics) is inlined in SKILL.md rather than pointed to, though the actual code correctly lives in `assets/tests/` and `assets/project-skills/`.

4 / 5

Total

18

/

20

Passed

Description

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

An exemplary description: explicit 'Use when' triggers, a fully enumerated 'what', natural trigger terms including synonyms for both supported tools, and a distinctive Maven/Spring Boot 4 niche. It is dense but every clause carries information rather than padding.

DimensionReasoningScore

Specificity

It lists multiple concrete deliverables comprehensively: "setting up AGENTS.md, guardrails, shared agent settings, or build and CI checks", "./mvnw verify gates that fail on null-safety bugs (NullAway with JSpecify), module-boundary breaches (Spring Modulith), unknown or deprecated Boot property keys, Spring mistakes that compile (ArchUnit) and unformatted code, Claude Code hooks… and a CI workflow" — every piece of the harness is named. Score 4 would require minor coverage gaps; none are evident.

5 / 5

Completeness

Both halves are explicit: an explicit trigger clause ("Use when a team wants…") with concrete conditions, and a detailed 'what' ("It adds ./mvnw verify gates that fail on… [enumerated gates], Claude Code hooks…, and a CI workflow"). Third-person voice throughout; nothing is left to inference.

5 / 5

Trigger Term Quality

Rich natural vocabulary a user would actually say: "team wants every developer's coding agent", "Claude Code or Codex", "follow the same rules", "AGENTS.md", "guardrails", "build and CI checks that agents must pass before code merges", with synonyms covered (both tool names, both 'verify gates' and 'CI checks'). No common phrasing in this domain is missing.

5 / 5

Distinctiveness Conflict Risk

The niche is unmistakable — Maven, Spring Boot 4, NullAway/JSpecify, Spring Modulith, team-wide agent governance for Claude Code and Codex — so it would not trigger for generic Spring, PDF, or single-agent skills. At most there is trivial overlap with a generic 'write AGENTS.md' skill, which anchor 4 covers, but the stack-specific gates make conflict risk minimal.

5 / 5

Total

20

/

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: 1 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

a-pavithraa/springboot-skills-marketplace

Path

plugins/springboot-architecture/skills/spring-boot-team-harness/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.