okhp3-sharepoint-library-metadata-review
OverKill Hill P³ · overkillhill.com · github.com/OKHP3
Scope
Inspect an accessible SharePoint document library against the supplied metadata
schema and quality rules. Produce a prioritized, item-level exception report
and a separate proposed-change set without altering metadata.
Host contract
| Item |
Contract |
| Target host |
Copilot in SharePoint, preview support status |
| Native surface |
A document library, its exposed schema, and items accessible to the current user |
| Portable core |
Schema comparison, exception classification, prioritization, and remediation draft |
| Host adapter |
Reads metadata only through current supported native SharePoint capabilities |
| Mutation |
Read-only review. A metadata update requires exact target-value review and explicit confirmation. |
| Evidence |
Analytical package design only. No live library metadata review has run. |
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 library, review population, authoritative fields, required
values, controlled vocabularies, and any governance owner.
Read the available schema and items. State the fields and files excluded by
capability or permission limits.
Check only supplied or schema-derived rules. Classify an exception as
MISSING_REQUIRED_VALUE, INVALID_CONTROLLED_VALUE,
INCONSISTENT_FORMAT, STALE_METADATA, DUPLICATE_CANDIDATE, or
NEEDS RULE.
Never infer metadata just because a filename or file body appears similar.
Offer a suggestion only when the source supports it and mark it proposed.
Return this report:
| Priority |
File |
Field or rule |
Observed value |
Finding |
Evidence |
Proposed owner action |
Validate that each finding is tied to an observed field or supplied rule.
Keep unverified interpretations outside the proposed-change set.
If remediation is requested, enumerate every file and field value, ask for
explicit confirmation, then verify host support and current-user permission
before a supported update.
Priority defaults
| Priority |
Meaning |
P1 |
A required metadata or classification gap prevents safe use or retrieval. |
P2 |
A controlled-value, duplicate, or lifecycle finding needs owner review. |
P3 |
A presentation or consistency issue can wait without changing meaning. |
Safe outcomes
NEEDS INPUT: list of required fields, library identity, or quality rules is
missing.NOT SUPPORTED: the host cannot inspect the needed metadata or perform the
requested confirmed operation.INSUFFICIENT PERMISSION: the user lacks access to the library or update
permission for a confirmed change.
Boundaries
- Do not alter library columns, views, folders, retention, labels, or file
content.
- Do not claim an exhaustive result beyond the inspected accessible items.
- Do not bypass item-level, library, or site permissions.
Validation
Use evals/evals.json to validate analytical normal, missing-rule, and repair
request boundaries. No live runtime or tenant evidence exists for version 1.1.0.
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-metadata-review3description: Review SharePoint document-library metadata for completeness, controlled-value conformance, and inconsistent records. Use when a library owner needs a traceable exception report and proposed fixes before any metadata update. Do not use to silently edit files, fields, or library settings.4license: MIT5---67# okhp3-sharepoint-library-metadata-review89**OverKill Hill P³** · [overkillhill.com](https://overkillhill.com) · [github.com/OKHP3](https://github.com/OKHP3)1011## Scope1213Inspect an accessible SharePoint document library against the supplied metadata14schema and quality rules. Produce a prioritized, item-level exception report15and a separate proposed-change set without altering metadata.1617## Host contract1819| Item | Contract |20|---|---|21| Target host | Copilot in SharePoint, preview support status |22| Native surface | A document library, its exposed schema, and items accessible to the current user |23| Portable core | Schema comparison, exception classification, prioritization, and remediation draft |24| Host adapter | Reads metadata only through current supported native SharePoint capabilities |25| Mutation | Read-only review. A metadata update requires exact target-value review and explicit confirmation. |26| Evidence | Analytical package design only. No live library metadata review has run. |2728## Activation evidence preflight29301. Confirm the named Library and the selected files or inspection scope required31 by this task.322. In a real SharePoint test, confirm either explicit invocation of this skill33 or the SharePoint skill indicator card. The presence of this package alone34 is not evidence that the host discovered or loaded it.353. If the host cannot load the skill or expose the required Library context,36 return `NOT SUPPORTED`, identify the missing capability, and do not claim37 that the review or draft was completed.384. Keep the result analytical until a test records the site, user role, input39 scope, and observed host behavior.4041## Procedure42431. Confirm the library, review population, authoritative fields, required44 values, controlled vocabularies, and any governance owner.452. Read the available schema and items. State the fields and files excluded by46 capability or permission limits.473. Check only supplied or schema-derived rules. Classify an exception as48 `MISSING_REQUIRED_VALUE`, `INVALID_CONTROLLED_VALUE`,49 `INCONSISTENT_FORMAT`, `STALE_METADATA`, `DUPLICATE_CANDIDATE`, or50 `NEEDS RULE`.514. Never infer metadata just because a filename or file body appears similar.52 Offer a suggestion only when the source supports it and mark it proposed.535. Return this report:5455 | Priority | File | Field or rule | Observed value | Finding | Evidence | Proposed owner action |56 |---|---|---|---|---|---|---|57586. Validate that each finding is tied to an observed field or supplied rule.59 Keep unverified interpretations outside the proposed-change set.607. If remediation is requested, enumerate every file and field value, ask for61 explicit confirmation, then verify host support and current-user permission62 before a supported update.6364## Priority defaults6566| Priority | Meaning |67|---|---|68| `P1` | A required metadata or classification gap prevents safe use or retrieval. |69| `P2` | A controlled-value, duplicate, or lifecycle finding needs owner review. |70| `P3` | A presentation or consistency issue can wait without changing meaning. |7172## Safe outcomes7374- `NEEDS INPUT`: list of required fields, library identity, or quality rules is75 missing.76- `NOT SUPPORTED`: the host cannot inspect the needed metadata or perform the77 requested confirmed operation.78- `INSUFFICIENT PERMISSION`: the user lacks access to the library or update79 permission for a confirmed change.8081## Boundaries8283- Do not alter library columns, views, folders, retention, labels, or file84 content.85- Do not claim an exhaustive result beyond the inspected accessible items.86- Do not bypass item-level, library, or site permissions.8788## Validation8990Use `evals/evals.json` to validate analytical normal, missing-rule, and repair91request boundaries. No live runtime or tenant evidence exists for version 1.1.0.9293## References9495- [Extend Copilot in SharePoint with skills](https://learn.microsoft.com/en-us/sharepoint/copilot-in-sharepoint-skills)9697## v1.1 maturation record9899The analytical [learning ledger](benchmarks/learning-ledger-2026-09-01.json)100preserves the frozen v1.0 input, official-source constraint, review limits, and101the concrete activation-evidence revision. It is not a live tenant test.102103## About104105Built by [Jamie Hill](https://overkillhill.com) · [OverKill Hill P³](https://overkillhill.com)106Published at [github.com/OKHP3](https://github.com/OKHP3)107Part of the [OKHP3/skillz](https://github.com/OKHP3/skillz) Agent Skill library.108MIT License -- free to use, fork, and adapt. A nod to the source is appreciated.
OKHP3