Skip to content

feat: add --skip-checks to exclude specific checks#43

Merged
dacharyc merged 1 commit intoagent-ecosystem:mainfrom
mvvmm:feat/skip-check-ids
Apr 19, 2026
Merged

feat: add --skip-checks to exclude specific checks#43
dacharyc merged 1 commit intoagent-ecosystem:mainfrom
mvvmm:feat/skip-check-ids

Conversation

@mvvmm
Copy link
Copy Markdown
Contributor

@mvvmm mvvmm commented Apr 19, 2026

Adds skipCheckIds as an exclude-list counterpart to the existing checkIds include-list. Useful when you want to disable one or two checks without enumerating all the others.

Behaviour:

  • Skipped checks emit status: "skip" without running
  • Excluded from scoring (matching existing skip handling)
  • Does not cascade-skip dependent checks — dependents run in standalone mode, consistent with how checkIds filtering works

Supported via:

  • CLI: --skip-checks <ids>
  • Config file: skipChecks: [...]
  • Programmatic API: skipCheckIds in RunnerOptions
# Disable a single check
afdocs check https://docs.example.com --skip-checks markdown-content-parity
# agent-docs.config.yml
skipChecks:
  - markdown-content-parity
const report = await runChecks('https://docs.example.com', {
  skipCheckIds: ['markdown-content-parity'],
});

Adds an exclude-list counterpart to the existing checkIds include-list.
Checks in skipCheckIds emit status: 'skip' without running, are excluded
from scoring, and do not cascade-skip dependent checks (dependents run
in standalone mode, matching checkIds filtering behaviour).

Supported via:
- CLI: --skip-checks <ids>
- Config: skipChecks: [...]
- Programmatic API: skipCheckIds in RunnerOptions
Copy link
Copy Markdown
Member

@dacharyc dacharyc left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for this, @mvvmm - it's a nice ergonomic improvement! I'm going to merge it as-is and make a couple of small follow ups - I'm going to add validation when --checks and --skip-checks overlap, and update the programmatic API doc example so it doesn't show both being used simultaneously, which is potentially confusing.

Really appreciate this batch of PRs! 🎉

@dacharyc dacharyc merged commit fdf9e4e into agent-ecosystem:main Apr 19, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants