okhp3-sharepoint-library-taxonomy-drift-report
OverKill Hill P³ · overkillhill.com · github.com/OKHP3
Outcome
Produce a traceable report comparing observed library organization to supplied
information architecture, with drift findings and owner-reviewable remediation.
Scope
Use only for a named library and a declared taxonomy, folder, metadata, or view
standard. It reports divergence; it does not redesign the information
architecture or change content.
Host contract
| Item |
Contract |
| Target host |
Copilot in SharePoint, preview support status |
| Native surface |
Accessible library metadata, folders, and views when exposed |
| Portable core |
Standard comparison, drift classification, and remediation reporting |
| Host adapter |
Reads only native capability and current-user-permitted information |
| Mutation |
No reorganization or metadata update without an exact confirmed supported action |
| Evidence |
Analytical design only; no live taxonomy comparison has occurred |
Activation evidence preflight
- Confirm the named Library and the selected files or inspection scope required
by this task.
- In a real SharePoint test, confirm either explicit invocation of this skill
or the SharePoint skill indicator card. The presence of this package alone
is not evidence that the host discovered or loaded it.
- If the host cannot load the skill or expose the required Library context,
return
NOT SUPPORTED, identify the missing capability, and do not claim
that the review or draft was completed.
- Keep the result analytical until a test records the site, user role, input
scope, and observed host behavior.
Procedure
Confirm the target library, declared information architecture, scope, and
accountable owner for taxonomy decisions.
Inspect accessible tags, folders, content types, and views only when the
host exposes them. Record unavailable surfaces as NOT INSPECTED.
Classify findings as MISSING_TAXONOMY_VALUE, UNAPPROVED_VALUE,
FOLDER_DRIFT, VIEW_DRIFT, NEEDS STANDARD, or NOT INSPECTED.
Return this report:
| Surface |
Expected standard |
Observed state |
Drift finding |
Visitor impact |
Proposed owner action |
Validate that every finding compares an observed state with a supplied
standard, not a preference inferred by the skill.
For requested corrections, show the exact move, metadata, or view change
and require explicit confirmation plus supported capability and permission.
Safe outcomes
NEEDS INPUT: target library, information architecture, scope, or owner is missing.NOT SUPPORTED: the host cannot inspect the needed surface or perform a requested action.INSUFFICIENT PERMISSION: the user cannot access the library or change its organization.
Boundaries
- Do not invent taxonomy values, design a new architecture, or infer policy.
- Do not alter folders, tags, views, content types, or files by default.
- Do not use external systems or custom code.
Validation
Read evals/evals.json for analytical comparison, missing-standard, and
reorganization-boundary cases. Version 1.0.0 has no live host evidence.
References
v1.1 maturation record
The analytical learning ledger
preserves the frozen v1.0 input, official-source constraint, review limits, and
the concrete activation-evidence revision. It is not a live tenant test.
About
Built by Jamie Hill · OverKill Hill P³
Published at github.com/OKHP3
Part of the OKHP3/skillz Agent Skill library.
MIT License -- free to use, fork, and adapt. A nod to the source is appreciated.
1---2name: okhp3-sharepoint-library-taxonomy-drift-report3description: Compare a SharePoint library's accessible tags, folders, and views with a supplied information architecture and report drift. Use when ad hoc uploads make a library harder to navigate. Do not use to rename, move, or retag files automatically.4license: MIT5---67# okhp3-sharepoint-library-taxonomy-drift-report89**OverKill Hill P³** · [overkillhill.com](https://overkillhill.com) · [github.com/OKHP3](https://github.com/OKHP3)1011## Outcome1213Produce a traceable report comparing observed library organization to supplied14information architecture, with drift findings and owner-reviewable remediation.1516## Scope1718Use only for a named library and a declared taxonomy, folder, metadata, or view19standard. It reports divergence; it does not redesign the information20architecture or change content.2122## Host contract2324| Item | Contract |25|---|---|26| Target host | Copilot in SharePoint, preview support status |27| Native surface | Accessible library metadata, folders, and views when exposed |28| Portable core | Standard comparison, drift classification, and remediation reporting |29| Host adapter | Reads only native capability and current-user-permitted information |30| Mutation | No reorganization or metadata update without an exact confirmed supported action |31| Evidence | Analytical design only; no live taxonomy comparison has occurred |3233## Activation evidence preflight34351. Confirm the named Library and the selected files or inspection scope required36 by this task.372. In a real SharePoint test, confirm either explicit invocation of this skill38 or the SharePoint skill indicator card. The presence of this package alone39 is not evidence that the host discovered or loaded it.403. If the host cannot load the skill or expose the required Library context,41 return `NOT SUPPORTED`, identify the missing capability, and do not claim42 that the review or draft was completed.434. Keep the result analytical until a test records the site, user role, input44 scope, and observed host behavior.4546## Procedure47481. Confirm the target library, declared information architecture, scope, and49 accountable owner for taxonomy decisions.502. Inspect accessible tags, folders, content types, and views only when the51 host exposes them. Record unavailable surfaces as `NOT INSPECTED`.523. Classify findings as `MISSING_TAXONOMY_VALUE`, `UNAPPROVED_VALUE`,53 `FOLDER_DRIFT`, `VIEW_DRIFT`, `NEEDS STANDARD`, or `NOT INSPECTED`.544. Return this report:5556 | Surface | Expected standard | Observed state | Drift finding | Visitor impact | Proposed owner action |57 |---|---|---|---|---|---|58595. Validate that every finding compares an observed state with a supplied60 standard, not a preference inferred by the skill.616. For requested corrections, show the exact move, metadata, or view change62 and require explicit confirmation plus supported capability and permission.6364## Safe outcomes6566- `NEEDS INPUT`: target library, information architecture, scope, or owner is missing.67- `NOT SUPPORTED`: the host cannot inspect the needed surface or perform a requested action.68- `INSUFFICIENT PERMISSION`: the user cannot access the library or change its organization.6970## Boundaries7172- Do not invent taxonomy values, design a new architecture, or infer policy.73- Do not alter folders, tags, views, content types, or files by default.74- Do not use external systems or custom code.7576## Validation7778Read `evals/evals.json` for analytical comparison, missing-standard, and79reorganization-boundary cases. Version 1.0.0 has no live host evidence.8081## References8283- [Extend Copilot in SharePoint with skills](https://learn.microsoft.com/en-us/sharepoint/copilot-in-sharepoint-skills)8485## v1.1 maturation record8687The analytical [learning ledger](benchmarks/learning-ledger-2026-09-01.json)88preserves the frozen v1.0 input, official-source constraint, review limits, and89the concrete activation-evidence revision. It is not a live tenant test.9091## About9293Built by [Jamie Hill](https://overkillhill.com) · [OverKill Hill P³](https://overkillhill.com)94Published at [github.com/OKHP3](https://github.com/OKHP3)95Part of the [OKHP3/skillz](https://github.com/OKHP3/skillz) Agent Skill library.96MIT License -- free to use, fork, and adapt. A nod to the source is appreciated.
OKHP3