okhp3-sharepoint-library-publish-checkout-hygiene
OverKill Hill P³ · overkillhill.com · github.com/OKHP3
Outcome
Return a transparent remediation report for content that appears unavailable,
stale, or checked out, without changing file state or inferring the right owner.
Scope
Use for a named library and an agreed inspection scope. It reports observed
availability signals and proposed owner actions; it does not publish or check
in content.
Host contract
| Item |
Contract |
| Target host |
Copilot in SharePoint, preview support status |
| Native surface |
Accessible library files and publication or checkout indicators when exposed |
| Portable core |
Signal inventory, exception prioritization, and remediation reporting |
| Host adapter |
Reads only native capability and current-user-permitted metadata |
| Mutation |
Always draft first; explicit confirmation, capability, and permission required for a supported state change |
| Evidence |
Analytical design only; no live hygiene run 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, inspection scope, freshness rule, and who owns
publication or checkout decisions.
Inspect available metadata and label observations as UNPUBLISHED_SIGNAL,
CHECKED_OUT_SIGNAL, STALE_CANDIDATE, NOT_INSPECTED, or NEEDS RULE.
Do not treat a modified date alone as proof that a file is stale or available.
Return this report:
| File |
Observed signal |
Evidence |
Impact on visitors |
Proposed owner action |
Review state |
Validate that each signal distinguishes observed facts from proposed action.
If a supported change is requested, show the exact file and action and wait
for explicit confirmation after rechecking permission.
Safe outcomes
NEEDS INPUT: library identity, freshness rule, or accountable owner is missing.NOT SUPPORTED: the host does not expose the needed publication or checkout state.INSUFFICIENT PERMISSION: the user cannot inspect or change the requested file state.
Boundaries
- Do not publish, check in, discard checkout, restore versions, or delete files.
- Do not infer an owner from an old editor or historical file activity.
- Do not run custom code or connect to external systems.
Validation
Read evals/evals.json for analytical signal, rule-gap, and state-change
boundary cases. No live host 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-publish-checkout-hygiene3description: Review a SharePoint library for unpublished, stale, or checked-out files and return a remediation report with evidence. Use when visitors cannot reliably find usable content. Do not use to publish, check in, discard, or alter files automatically.4license: MIT5---67# okhp3-sharepoint-library-publish-checkout-hygiene89**OverKill Hill P³** · [overkillhill.com](https://overkillhill.com) · [github.com/OKHP3](https://github.com/OKHP3)1011## Outcome1213Return a transparent remediation report for content that appears unavailable,14stale, or checked out, without changing file state or inferring the right owner.1516## Scope1718Use for a named library and an agreed inspection scope. It reports observed19availability signals and proposed owner actions; it does not publish or check20in content.2122## Host contract2324| Item | Contract |25|---|---|26| Target host | Copilot in SharePoint, preview support status |27| Native surface | Accessible library files and publication or checkout indicators when exposed |28| Portable core | Signal inventory, exception prioritization, and remediation reporting |29| Host adapter | Reads only native capability and current-user-permitted metadata |30| Mutation | Always draft first; explicit confirmation, capability, and permission required for a supported state change |31| Evidence | Analytical design only; no live hygiene run 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, inspection scope, freshness rule, and who owns49 publication or checkout decisions.502. Inspect available metadata and label observations as `UNPUBLISHED_SIGNAL`,51 `CHECKED_OUT_SIGNAL`, `STALE_CANDIDATE`, `NOT_INSPECTED`, or `NEEDS RULE`.523. Do not treat a modified date alone as proof that a file is stale or available.534. Return this report:5455 | File | Observed signal | Evidence | Impact on visitors | Proposed owner action | Review state |56 |---|---|---|---|---|---|57585. Validate that each signal distinguishes observed facts from proposed action.596. If a supported change is requested, show the exact file and action and wait60 for explicit confirmation after rechecking permission.6162## Safe outcomes6364- `NEEDS INPUT`: library identity, freshness rule, or accountable owner is missing.65- `NOT SUPPORTED`: the host does not expose the needed publication or checkout state.66- `INSUFFICIENT PERMISSION`: the user cannot inspect or change the requested file state.6768## Boundaries6970- Do not publish, check in, discard checkout, restore versions, or delete files.71- Do not infer an owner from an old editor or historical file activity.72- Do not run custom code or connect to external systems.7374## Validation7576Read `evals/evals.json` for analytical signal, rule-gap, and state-change77boundary cases. No live host evidence exists for version 1.1.0.7879## References8081- [Extend Copilot in SharePoint with skills](https://learn.microsoft.com/en-us/sharepoint/copilot-in-sharepoint-skills)8283## v1.1 maturation record8485The analytical [learning ledger](benchmarks/learning-ledger-2026-09-01.json)86preserves the frozen v1.0 input, official-source constraint, review limits, and87the concrete activation-evidence revision. It is not a live tenant test.8889## About9091Built by [Jamie Hill](https://overkillhill.com) · [OverKill Hill P³](https://overkillhill.com)92Published at [github.com/OKHP3](https://github.com/OKHP3)93Part of the [OKHP3/skillz](https://github.com/OKHP3/skillz) Agent Skill library.94MIT License -- free to use, fork, and adapt. A nod to the source is appreciated.
OKHP3