Favicon of docs-impact-classifier

docs-impact-classifier Skill

AI Agent SkillDocumentationPythonOpen source

Use this skill to classify the documentation impact of a pull request diff, returning one of three verdicts -- no-change, in-place edit, or structural change -- with bounded LLM cost. Activate as a sibling skill of docs-sync; the orchestrator calls this first, before any panel spawn, to keep cost floor at 1 LLM call wh Published by microsoft in apm.

What is docs-impact-classifier Skill?

Use this skill to classify the documentation impact of a pull request diff, returning one of three verdicts -- no-change, in-place edit, or structural change -- with bounded LLM cost. Activate as a sibling skill of docs-sync; the orchestrator calls this first, before any panel spawn, to keep cost floor at 1 LLM call wh Published by microsoft in apm. This profile combines repository metadata with install, compatibility, and usage signals so developers can quickly decide whether it fits their agent workflow before opening the source repository.

Trust signal
95/100
Maintenance signal
90/100
Adoption signal
87/100

Automated repository signals based on public metadata such as recency, license, installation evidence, and adoption. These are not a security audit or endorsement.

Key capabilities

  • Includes SKILL.md support
  • Reusable instructions support
  • Testing
  • Documentation
  • Testing use cases
  • Documentation use cases

Technical details

Copy skill directory
  • Install or run with Copy skill directory

When to use docs-impact-classifier Skill

  • Use it for testing.
  • Use it for documentation.

Built with

PythonCopy skill directory

Editorial notes

Source

  • Creator: microsoft
  • Repository: microsoft/apm
  • Skill file: .agents/skills/docs-impact-classifier/SKILL.md

What it does

Use this skill to classify the documentation impact of a pull request diff, returning one of three verdicts -- no-change, in-place edit, or structural change -- with bounded LLM cost. Activate as a sibling skill of docs-sync; the orchestrator calls this first, before any panel spawn, to keep cost floor at 1 LLM call wh

Skill instructions

docs-impact-classifier Single responsibility: given a PR diff and the .apm/docs-index.yml corpus map, emit ONE classification verdict. This skill is the cost gate for the entire docs-sync system. ~70% of PRs should exit at verdict nochange with zero panel spawn. Architecture This is a 3-layer funnel inside a single skill invocation: - L0 deterministic path gate -- pure file-path matching, no LLM. - L1 symbol extraction + corpus grep -- pure text processing, no LLM. - L2 LLM classifier -- bounded ~8 KB context envelope, 1 call. The skill returns the verdict from the earliest layer that can decide. Step 1: L0 deterministic path gate (no LLM) Read .apm/docs-index.yml to load noimpactpaths[] and usersurfacepaths[]. Get the changed file list from the PR diff (gh pr diff --name-only). if every changed file matches noimpactpaths AND none match usersurfacepaths: return {verdict: "nochange", confidence: "high", source: "L0", scopepages: []} This handles: - Test-only PRs (tests/) - CI workflow P

Explore related resources

Frequently asked questions

What is docs-impact-classifier?

docs-impact-classifier is a open-source AI agent skill with Copy skill directory. Use this skill to classify the documentation impact of a pull request diff, returning one of three verdicts -- no-change, in-place edit, or structural change -- with bounded LLM cost.

Who is docs-impact-classifier best for?

docs-impact-classifier is best for reusing agent instructions, scripts, and references, testing workflows, documentation workflows.

How do I install docs-impact-classifier?

Install or run docs-impact-classifier using Copy skill directory. Check docs-impact-classifier for the latest setup command.

Is docs-impact-classifier actively maintained?

docs-impact-classifier may need a closer maintenance check before production use.

Share:

Stars
3,219
Forks
283
Last commit
10 days ago
Repository age
10 months
License
MIT

Auto-fetched from GitHub.

Similar to docs-impact-classifier