CtrlK
BlogDocsLog inGet started
Tessl Logo

ironclaw-reborn-architecture-review

Use when writing or reviewing a change in crates/ that adds a trait, a crate, a dependency edge, a re-export, or code in ironclaw_reborn_composition — or when deciding whether an abstraction, layer, or crate boundary is justified in the IronClaw Reborn stack.

73

Quality

91%

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

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A lean, highly actionable architecture-review skill that assumes competence, gives concrete commands and file paths, sequences checks with validation, and cleanly offloads worked examples to one real reference file.

DimensionReasoningScore

Conciseness

Dense but every token is codebase-specific signal (test counts, file paths, exemplars); it assumes Claude's competence and never explains concepts Claude already knows like what a trait or crate is.

3 / 3

Actionability

Provides concrete, copy-paste-ready commands ("cargo test -p ironclaw_architecture", "grep -n 'ARCH-SPRAWL' scripts/pre-commit-safety.sh") and specific file paths ("crates/ironclaw_agent_loop/src/planner.rs:15-26") plus checkable criteria per item.

3 / 3

Workflow Clarity

A numbered six-item checkable checklist followed by an explicit Verify section with validation commands, plus noted tool blind spots and a rationalizations-vs-reality table for error recovery.

3 / 3

Progressive Disclosure

Keeps the overview/checklist inline and offloads detailed examples to a single well-signaled, one-level-deep reference ("references/worked-examples.md — the living curriculum"), which exists in the bundle.

3 / 3

Total

12

/

12

Passed

Description

82%

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 specific, distinctive description with strong natural trigger terms and an explicit "Use when" clause. Its one weakness is that the skill's actual capability is folded into the trigger clause rather than stated as a distinct "what".

Suggestions

Lead with a crisp capability statement (e.g., "Reviews changes in crates/ for speculative abstraction and crate-internal mass pooling.") before the "Use when…" trigger so the what is stated independently of the when.

Name the two failure modes the skill polices ("mass pooling inside a crate" and "speculative abstraction") in the description itself, since they currently appear only in the body.

DimensionReasoningScore

Specificity

Lists multiple concrete change scenarios ("adds a trait, a crate, a dependency edge, a re-export, or code in ironclaw_reborn_composition") plus the review action ("deciding whether an abstraction, layer, or crate boundary is justified"), not vague language.

3 / 3

Completeness

The "when" is explicit and detailed ("Use when writing or reviewing a change in crates/…"), but the "what" the skill does is only implied — it never states a standalone capability such as reviewing for speculative abstraction or mass pooling, which appears only in the body.

2 / 3

Trigger Term Quality

Covers natural terms an engineer in this codebase would actually say — "adding a trait", "a crate", "dependency edge", "re-export", "crate boundary", "abstraction" — with good variation coverage.

3 / 3

Distinctiveness Conflict Risk

Scoped to a named stack ("IronClaw Reborn stack"), "crates/", and "ironclaw_reborn_composition" with very specific triggers, making it unlikely to fire for the wrong skill.

3 / 3

Total

11

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

15

/

16

Passed

Repository
nearai/ironclaw
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.