# J5ik2o Reviewing Skills

> Use when reviewing or improving Claude Code, Codex, or compatible agent skills. Checks SKILL.md frontmatter, trigger boundary, progressive disclosure, no-op instructions, duplication, sediment, sprawl, examples, and validation readiness. Trigger for skill review, SKILL.md review, skill quality check, trigger debugging, or improving an existing skill.

- Skill: `j5ik2o/j5ik2o-reviewing-skills` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add j5ik2o/j5ik2o-reviewing-skills`
- Raw SKILL.md: https://api.skillmd.com/api/skills/j5ik2o/j5ik2o-reviewing-skills/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: j5ik2o (https://skillmd.com/u/j5ik2o)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/j5ik2o/j5ik2o-reviewing-skills

---


# Reviewing Skills

Review skills for predictable agent behavior, not just readability.

## Workflow

1. Identify the target skill directory and read `SKILL.md` completely.

2. Read `references/best-practices.md` before producing findings.

3. Check frontmatter name and description for trigger precision and exclusions.

4. Check the body for clear steps, completion criteria, progressive disclosure, duplication, no-ops, sediment, and sprawl.

5. Inspect bundled references, scripts, assets, and evals when present.

6. Return prioritized findings before optional rewrites.

## Report Shape

Use: `Critical`, `Warning`, `Info`, and `Suggested rewrite` when a concrete replacement is useful.

## Detailed Reference

For non-trivial implementation, review, or refactoring work, read `references/details.md` before giving final guidance. It contains the detailed rules, examples, smells, and migration notes that do not belong in the short invocation body.

## Output

Lead with actionable findings and file references. If asked to fix, make the smallest changes that improve invocation, execution, and validation.