Known Good

Name: Known Good
Author: boshu2

boshu2/agentops

2 installs
416 repo stars
Updated August 5, 2026
boshu2/agentops

Known-good is a Claude Code skill fixture that satisfies all 15 auditor checks so the auditor returns PASS or WARN.

About

Known-good is a minimal but complete SKILL.md test fixture for the AgentOps skill auditor. It satisfies all 15 auditor checks across Pass 1 and Pass 2, including canonical frontmatter, front-loaded constraints with Why rationales, an explicit Output Specification, and a Quality Rubric. Integration tests use it to confirm the auditor returns a PASS or WARN verdict on conforming input.

Test fixture that satisfies all 15 skill auditor checks
Includes canonical frontmatter, front-loaded constraints, and a quality rubric
Confirms the auditor returns PASS or WARN on conforming input

Known Good by the numbers

2 all-time installs (skills.sh)
Ranked #611 of 782 Skill Development skills by installs in the Skillselion catalog
Data as of Aug 5, 2026 (Skillselion catalog sync)

At a glance

known-good capabilities & compatibility

Use cases: testing

From the docs

What known-good says it does

A minimal but complete SKILL.md that satisfies all 15 auditor checks.

SKILL.md

Used by `tests/integration/test_skill_auditor.bats` to confirm the auditor returns PASS or WARN on conforming input.

SKILL.md

npx skills add https://github.com/boshu2/agentops --skill known-good

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/boshu2/agentops/known-good.svg)](https://skillselion.com/skills/boshu2/agentops/known-good)

Installs	2
repo stars	★ 416
Last updated	August 5, 2026
Repository	boshu2/agentops ↗

What it does

Confirm the skill auditor returns PASS or WARN on a fully conforming fixture.

Who is it for?

Skip if: Real-world use; it is a test fixture, not a runtime skill.

When should I use this skill?

You need to verify the skill auditor returns PASS or WARN on conforming input.

What you get

The auditor returns verdict PASS or WARN on the conforming fixture.

By the numbers

satisfies all 15 auditor checks
8 Pass-2 checks
SKILL.md under 250 lines

Files

SKILL.mdMarkdownGitHub ↗

/known-good — Auditor PASS test fixture

A minimal but complete SKILL.md that satisfies all 15 auditor checks. Used by tests/integration/test_skill_auditor.bats to confirm the auditor returns PASS or WARN on conforming input.

⚠️ Critical Constraints

This is a test fixture, not a runtime skill. Do not invoke. Why: auditor tests pin the exact content; runtime use would surprise contributors.
Frontmatter shape is canonical. YAML description: | block scalar with explicit Triggers and Use-when markers. Why: exercises description-has-triggers form (a) AND form (b) simultaneously.
Constraints are front-loaded. This ## ⚠️ Critical Constraints section appears before any other H2. Why: tests constraints-frontloaded heuristic.
Every constraint has a Why. Each bullet ends with **Why:** <reason>. Why: tests rationale-present heuristic.

Workflow

Phase 1: Setup

Read the fixture, parse frontmatter.

Checkpoint: frontmatter has name, description, metadata.tier.

Phase 2: Validate

Run all 8 Pass-2 checks.

Checkpoint: all 8 checks return pass or n/a.

Phase 3: Emit verdict

Aggregate via max-severity rule.

Checkpoint: verdict is PASS (no warns, no fails).

Output Specification

Format: stdout marker known-good confirming the fixture loaded cleanly. Filename: none — runtime fixture only. Exit code: 0.

Quality Rubric

[ ] Frontmatter passes Pass 1 (heal-skill structural)
[ ] Constraints section is front-loaded (first H2 after title)
[ ] Every constraint has a Why: rationale
[ ] Each Phase has a Checkpoint
[ ] Output Specification is explicit
[ ] Quality Rubric exists with checkboxes
[ ] SKILL.md is under 250 lines

Examples

# Run auditor against this fixture; expect exit 0 and verdict PASS or WARN
bash skills/skill-auditor/scripts/audit.sh tests/fixtures/skills/known-good