Speclj Structure Check

Use after every spec file edit to catch Speclj nesting errors before running tests

5 starsTesting & QA

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add unclebob/speclj-structure-check --skill speclj-structure-check
Manual install
git clone --depth 1 https://github.com/unclebob/speclj-structure-check.git /tmp/speclj-structure-check
mkdir -p ~/.claude/skills
cp -r /tmp/speclj-structure-check/.claude/skills/speclj-structure-check ~/.claude/skills/speclj-structure-check

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Speclj Structure Check

## When to use

**Run after every spec file edit** — before running tests.

## How to run

```bash
clj -M:spec-structure-check <file-or-dir>
```

Optional `--tree` flag shows indented Speclj form tree with line numbers:
```bash
clj -M:spec-structure-check --tree <file-or-dir>
```

## What it checks

Speclj nesting rules:
- `(describe)` is top-level only — never nested inside another `describe` or `context`
- `(context)` can nest inside `describe` or other `context` blocks
- `(it)` is a leaf — no structural Speclj forms inside it (`describe`, `context`, `it`, `before`, `before-all`, `after`, `with-stubs`, `with`, `around`)

## Output

- `OK` — file has valid structure
- `ERROR line N: (form) inside (parent) at line M` — nesting violation

## Workflow

1. Edit a spec file
2. Run `clj -M:spec-structure-check <file>`
3. If errors: fix parens before running tests
4. If OK: run tests

## Key insight

If a test disappears from Speclj `-f d` output, it's almost certainly a paren error — an `(it ...)` accidentally nested inside another `(it ...)`. Don't debug assertions; fix parens. Run this checker to find the problem instantly.

## Setup

Add to your project's `deps.edn`:
Read the full skill on GitHub

Details

Skill name
speclj-structure-check
Path
.claude/skills/speclj-structure-check/SKILL.md
Repo updated
3 June 2026

FAQ

What does the Speclj Structure Check skill do?

Use after every spec file edit to catch Speclj nesting errors before running tests

How do I install the Speclj Structure Check skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add unclebob/speclj-structure-check --skill speclj-structure-check. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Speclj Structure Check popular?

It lives in unclebob/speclj-structure-check, which has 5 GitHub stars and 0 forks.

Related skills

Layer Quality

10

layerai/skills

Use when judging Layer output before it ships: scoring generated files against a workspace's output scoring rules, reading back verdicts on a file, reviewing a batch against the brief, or choosing which candidate to deliver. Also when a studio has automated quality standards, or a set must be checked for consistency before handoff. Keywords: quality gate, scoring, review, batch, verdict, approve, QA, consistency check.

Testing & QA

River Trash Boom Robot Design

5

dungnotnull/river-trash-boom-robot-design-agent-skill

Autonomous River Trash-Boom Design & Testing — Production-grade harness for Autonomous River Debris-Boom Robotics & Hydraulics evidence-backed analysis with real-time data aggregation, recognized domain methods, and self-improving knowledge pipeline.

Testing & QA

Landing Page Ab Test Readout

9

mardab96/landing-pages-claude-skills

Decides whether an A/B result is a decision or a coincidence, and says plainly when the honest answer is that the test cannot conclude. Use when a test has run and someone wants to declare a winner.

Testing & QA

Lead Free Heat Resistant Ceramics

5

dungnotnull/lead-free-heat-resistant-ceramics-agent-skill

Lead-Free Heat-Resistant Ceramic Glaze & Body Formulation — Production-grade Ceramic Materials & Lead-Free Glaze Engineering analysis harness. Use this skill whenever analyzing ceramic materials, formulating lead-free glazes, designing clay bodies, evaluating thermal expansion fit, testing food-safety compliance, or recommending firing schedules. This skill provides evidence-backed, risk-disclosed analysis with authoritative sourcing.

Testing & QA

Offer Clarity Diagnosis

9

mardab96/landing-pages-claude-skills

Tests whether the offer on the page is specific enough to be believed and acted on, or whether it is a category description wearing an offer's clothes. Use when traffic and message match are fine but the page still does not convert.

Testing & QA

Inversion Engine

5

unstatusthequo/inversion-engine

Structured inversion analysis for strategic decisions, plans, and initiatives. Systematically maps every path to failure so the path to success becomes obvious by elimination. Produces scored risk registers, countermeasure plans, and decision briefs -- not just narrative brainstorming. Use this skill whenever the user asks to stress test a plan, run a pre-mortem, do failure analysis, red team a strategy, audit assumptions, map risks, run inversion on a decision, identify what could go wrong, pressure test an idea, do a Munger-style analysis, or any variation of "help me figure out how this fai

Testing & QA

Browse the most popular Claude skills, all testing & qa skills, or write your own with the skills generator.