# skill-quality-auditor

> Generated by docmd

## Documentation Files

- [ADR-001: Native Go eval runner for skill evaluation](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-001-native-eval-runner/)
- [ADR-002: Port SkillLens Mode/ModeSet data structures into analysis package](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-002-skilllens-mode-types/)
- [ADR-003: Replace global flag vars with per-command option structs](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-003-global-vars-to-option-structs/)
- [ADR-004: Implement shell script functionality in Go CLI](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-004-go-cli-script-parity/)
- [ADR-005: Restructure D6 scorer for contextual action weighting](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-005-freedom-calibration-remediation/)
- [ADR-006: Register dimension scorers in a registry slice for OCP compliance](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-006-dimension-registry/)
- [ADR-007: Two-tier eval gate with BYOK architecture for skill evaluation](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-007-two-tier-eval-gate/)
- [ADR-008: Distribute skill-auditor via Homebrew tap](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-008-homebrew-distribution/)
- [ADR-009: Add D10 empirical validation dimension](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-009-d10-empirical-validator/)
- [ADR-010: Add demonstration concreteness sub-criterion to D1 scorer](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-010-d1-demonstration-concreteness/)
- [ADR-011: Restructure D2 scorer around PKO structural model](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-011-d2-pko-structural-model/)
- [ADR-012: Extend D3 anti-pattern format to include SYMPTOM and CONSEQUENCE](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-012-d3-extended-anti-pattern-format/)
- [ADR-013: Add mutation resistance criterion to D4 specification compliance scorer](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-013-d4-mutation-resistance/)
- [ADR-014: Add negative-condition scoring to D5 progressive disclosure](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-014-d5-negative-condition-scoring/)
- [ADR-015: Add discriminativeness signal to D7 pattern recognition scorer](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-015-d7-discriminativeness-signal/)
- [ADR-016: Add outcome linkage criterion to D8 practical usability scorer](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-016-d8-outcome-linkage/)
- [ADR-017: Add mutation coverage scoring to D9 eval validation](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-017-d9-mutation-coverage/)
- [ADR-018: CI gating guardrails for native eval runner](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-018-ci-eval-guardrails/)
- [ADR-019: Migrate dev tooling to hk, markdownlint-cli2, and mise auto-bootstrap hooks](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-019-dev-tooling-migration/)
- [ADR-020: Multi-method distribution strategy](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-020-multi-method-distribution/)
- [ADR-021: Split reporter package into single-mandate files for SRP compliance](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-021-reporter-srp-split/)
- [ADR-022: Standardize CLI flag naming and output format conventions](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-022-cli-flag-conventions/)
- [ADR-023: Keep CLI binary and tile.json versions in sync via release-please](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-023-version-sync-policy/)
- [ADR-024: Adopt A/B test evaluation mode from SkillEval](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-024-ab-test-eval-mode/)
- [ADR-025: Provider-agnostic LLM client for the native eval runner](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-025-provider-agnostic-llm-client/)
- [ADR-026: Port EvoSkill core loop to Go as --evolve mode](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-026-evoskill-core-loop/)
- [ADR-027: Treat .context/audits/ files as first-class context — validated and indexed](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-027-treat-audits-as-first-class-context/)
- [ADR-028: Externalise hardcoded scoring patterns to YAML config](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-028-scoring-pattern-config/)
- [ADR-029: Local skills migrated to .context/plugins/ as Tessl file-based plugins](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-029-local-skills-as-tessl-plugins/)
- [ADR-030: pr-author skill is GitHub-only for v0.1.0; GitLab deferred to v0.2.0](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-030-pr-author-github-only/)
- [ADR-031: analysis_quality patterns stay outside the D1-D9 dimension model](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-031-analysis-quality-outside-dimension-model/)
- [ADR-032: User-configurable scoring pattern overrides](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-032-user-configurable-scoring-patterns/)
- [ADR-033: Post-merge ADR/plan status sync via merge-status-sync.sh](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-033-post-merge-status-sync/)
- [ADR-034: Advisory snyk/agent-scan integration for cmd/assets/ skill security](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-034-agent-scan-skill-security-scanning/)
- [ADR-035: Package skill-quality-auditor as a composite GitHub Action](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-035-github-action-packaging/)
- [ADR-036: Advisory-only Plumber CI/CD security workflow](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-036-plumber-cicd-security-advisory-workflow/)
- [ADR-037: Plumber CI/CD gate — fail on Critical, track lower severities as issues](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-037-plumber-critical-fail-issue-tracking/)
- [ADR-038: Plumber non-Critical findings — single rollup issue, not one issue per finding](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-038-plumber-single-rollup-issue/)
- [ADR-039: Plumber PR comment — single comment per PR, edited in place](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-039-plumber-pr-comment/)
- [ADR-040: PR-Agent as an advisory PR review bot, describe+review only](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-040-pr-agent-advisory-review-bot/)
- [ADR-041: PR-Agent advisory review bot — Gemini free tier, no Plumber allowlist entry](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-041-pr-agent-gemini-free-tier/)
- [ADR-042: skill-quality.yml's LLM-judge uses Mistral; internal/llmclient gains Retry-After-aware backoff](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-042-llm-judge-provider-and-backoff/)
- [ADR-043: Marker-based lookup for all automated PR comment upserts](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-043-marker-based-pr-comment-upsert/)
- [ADR-044: check-docs-drift.sh gates PRs on newly introduced drift](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-044-docs-drift-pr-gate/)
- [ADR-045: check-docs-drift.sh gains a reviewed-baseline sidecar](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-045-docs-drift-reviewed-baseline/)
- [ADR-046: known-issue becomes a first-class .context/ file type, driven by session-reflection](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-046-known-issues-context-type/)
- [ADR-047: verify the .tessl/plugins mirror via CI-only diff, don't track it](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-047-tessl-mirror-ephemeral-diff/)
- [ADR-048: .tessl mirror drift check rollout — advisory-first, gated spike, sibling gating](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-048-tessl-mirror-drift-rollout/)
- [ADR-049: a `value` frontmatter field makes "highest value next" a queryable axis](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-049-context-value-frontmatter-field/)
- [ADR-050: .context frontmatter enum values are UPPER_CASE](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-050-uppercase-frontmatter-enums/)
- [ADR-051: a `themes` frontmatter field adds a queryable subject axis to .context/](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-051-context-themes-frontmatter-field/)
- [ADR-052: governance known-issue debt is triaged by value, not batch-fixed](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-052-governance-known-issue-triage/)
- [ADR-053: Release assets use a draft-then-publish flow (immutable releases)](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-053-release-draft-then-publish/)
- [ADR-054: All GitHub Actions pinned by commit SHA (first-party exemption removed)](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-054-sha-pin-all-actions/)
- [ADR-055: Dependency updates held for a 7-day cooldown unless security-critical](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-055-dependency-update-cooldown/)
- [ADR-056: Release-please PRs are auto-merged on a schedule via a GitHub App token](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-056-scheduled-release-automerge/)
- [ADR-057: CalVer YYYY.0M.PATCH considered and rejected (stay on SemVer)](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-057-calver-versioning/)
- [ADR-058: plan-review gains an execution-location lens, owned by Risk + Strategic](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-058-plan-review-execution-location-lens/)
- [ADR-059: Markdown placement by category, authored docs under docs/, minimal root](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-059-docs-root-layout/)
- [ADR-060: DEFERRED lifecycle status for parked context items](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-060-deferred-lifecycle-status/)
- [ADR-061: ADR immutability begins at acceptance, not creation](https://pantheon-org.github.io/skill-quality-auditor/ADR/adr-061-adr-immutability-from-acceptance/)
- [Aggregation planning](https://pantheon-org.github.io/skill-quality-auditor/architecture/aggregation-flow/)
- [Batch flow](https://pantheon-org.github.io/skill-quality-auditor/architecture/batch-flow/)
- [Duplication detection](https://pantheon-org.github.io/skill-quality-auditor/architecture/duplication-flow/)
- [Eval runner](https://pantheon-org.github.io/skill-quality-auditor/architecture/eval-runner/)
- [Evaluate flow](https://pantheon-org.github.io/skill-quality-auditor/architecture/evaluate-flow/)
- [Init, update, prune](https://pantheon-org.github.io/skill-quality-auditor/architecture/init-update-prune/)
- [Architecture overview](https://pantheon-org.github.io/skill-quality-auditor/architecture/overview/)
- [Remediation flow](https://pantheon-org.github.io/skill-quality-auditor/architecture/remediation-flow/)
- [Trend tracking](https://pantheon-org.github.io/skill-quality-auditor/architecture/trend-flow/)
- [Validate & analyze](https://pantheon-org.github.io/skill-quality-auditor/architecture/validate-analyze/)
- [Adding a dimension scorer](https://pantheon-org.github.io/skill-quality-auditor/development/adding-a-scorer/)
- [Adding an init target agent](https://pantheon-org.github.io/skill-quality-auditor/development/adding-an-agent/)
- [Development setup](https://pantheon-org.github.io/skill-quality-auditor/development/setup/)
- [Skills and rules](https://pantheon-org.github.io/skill-quality-auditor/development/skills-and-rules/)
- [skill-quality-auditor](https://pantheon-org.github.io/skill-quality-auditor/)
- [D1: Knowledge Delta (20 points)](https://pantheon-org.github.io/skill-quality-auditor/reference/d1-knowledge-delta/)
- [D2: Mindset & Procedures (15 points)](https://pantheon-org.github.io/skill-quality-auditor/reference/d2-mindset-procedures/)
- [D3: Anti-Pattern Coverage (15 points)](https://pantheon-org.github.io/skill-quality-auditor/reference/d3-anti-pattern-coverage/)
- [D4: Specification Compliance (15 points)](https://pantheon-org.github.io/skill-quality-auditor/reference/d4-specification-compliance/)
- [D5: Progressive Disclosure (15 points)](https://pantheon-org.github.io/skill-quality-auditor/reference/d5-progressive-disclosure/)
- [D6: Freedom Calibration (15 points)](https://pantheon-org.github.io/skill-quality-auditor/reference/d6-freedom-calibration/)
- [D7: Pattern Recognition (10 points)](https://pantheon-org.github.io/skill-quality-auditor/reference/d7-pattern-recognition/)
- [D8: Practical Usability (15 points)](https://pantheon-org.github.io/skill-quality-auditor/reference/d8-practical-usability/)
- [D9: Eval Validation (20 points)](https://pantheon-org.github.io/skill-quality-auditor/reference/d9-eval-validation/)
- [Scoring dimensions](https://pantheon-org.github.io/skill-quality-auditor/reference/scoring-dimensions/)