docs-impact-localizer

Solid

Use this skill to translate a classifier's in-place verdict into a precise, page-by-page work plan for the docs-sync panel. Activate after docs-impact-classifier returns verdict in_place; reads the candidate page list, fetches the actual page contents, narrows scope to specific sections within each page, and emits the per-page task brief the panel fans out against.

AI & Automation 2,694 stars 216 forks Updated today MIT

Install

View on GitHub

Quality Score: 91/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# docs-impact-localizer Single responsibility: given a list of candidate pages from the classifier, produce a per-page task brief the docs-sync panel can fan out against. You are NOT the verdict-maker (classifier owns that). You are NOT the writer (doc-writer owns that). You are the **work planner**. ## When to invoke The docs-sync orchestrator invokes you ONLY when the classifier returned `verdict: in_place`. For `no_change` you don't run. For `structural` the architect runs first; you may run after, scoped to existing pages that need amendment. ## Inputs - `scope_pages[]` from the classifier - The PR diff (`gh pr diff $PR`) - `.apm/docs-index.yml` (per-page metadata) - Optional: the structural architect's TOC delta (if you run after the architect on a structural verdict) ## Step 1: load page contents For each path in `scope_pages[]`, read the file. Pages are typically 3-10 KB; total budget for this step is bounded by the candidate count (the classifier should have kept it to <= 6). ## Step 2: narrow scope inside each page For each page, identify the SPECIFIC section(s) that need to change: - Read the page's H2/H3 structure - For each diff symbol from the classifier output, find the section most directly documenting it - Capture line ranges: `lines 120-145` not `the whole page` The output is a `sections_to_edit[]` per page, where each entry is: ```yaml page: docs/src/content/docs/consumer/install.md sections_to_edit: - section: "## From Git" line_range...

Details

Author
microsoft
Repository
microsoft/apm
Created
8 months ago
Last Updated
today
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

docs-impact-architect

Use this skill when the docs-impact-classifier returns a structural verdict, signalling that the documentation TOC must change to accommodate the PR. Proposes TOC deltas (new pages, moves, merges) and emits new-page outline stubs that the doc-sync panel later fleshes out. Holds the 3-promise narrative (consume / produce / govern) and the persona ramps as hard constraints.

2,694 Updated today
microsoft
AI & Automation Solid

docs-impact-classifier

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 when no docs work is needed. Reads .apm/docs-index.yml as the corpus map; never reads the full corpus.

2,694 Updated today
microsoft
AI & Automation Solid

docs-sync

Use this skill whenever a pull request is opened, reopened, or synchronized in microsoft/apm to assess whether and how the documentation corpus must change to stay truthful with the proposed code change. Activate even when the PR title or body says nothing about docs -- the skill must run on every PR to detect silent drift between code and docs. Classifies impact as no-change, in-place edit (one to a few paragraphs), or structural change (new page or TOC reshape), then orchestrates a CDO + doc-writer + python-architect + editorial-owner + growth-hacker loop to produce a patch-ready advisory. Does NOT review code quality, security, or test coverage. Does NOT auto-merge or auto-push doc edits.

2,694 Updated today
microsoft
Code & Development Solid

docs-corpus-audit

Use this skill to run a holistic regrounding pass on the entire microsoft/apm documentation corpus against current source code, page-by-page, and emit surgical fixes for stale claims. Activate when the maintainer wants a WHOLE-CORPUS audit (not per-PR review) -- typical triggers include "audit the docs", "reground the corpus", "check every page against code", "pre-release docs sweep", "the docs have drifted everywhere", or "we just reshaped the TOC, find dead links". Wave-batched and S7-verified; scales to the full ~112-page corpus in ~10 minutes wall-time. This is a SIBLING to docs-sync, not a replacement: docs-sync is per-PR (triggered by a diff); this skill is per-corpus (triggered by a maintainer ask). They share agent personas, schemas, and the docs index, but their triggers MUST NOT collide. Does NOT auto-merge, does NOT push without maintainer review, and does NOT replace per-PR drift detection.

2,694 Updated today
microsoft
AI & Automation Solid

docs-orchestrator

Use this skill when orchestrating documentation generation and updates within a session. Maps session scope to audience-specific docs tasks (User / Dev / Vault), dispatches the docs-writer agent with source-grounded prompts, and reports coverage gaps to session-end. Gated on `docs-orchestrator.enabled: true` in Session Config. Zero overhead when disabled.

48 Updated yesterday
Kanevry