Skip to content

feat(ai-cli-harness-better-practices): add /wrap-up-docs skill - #470

Merged
JacobPEvans-personal merged 3 commits into
mainfrom
feat/wrap-up-docs
Aug 24, 2026
Merged

feat(ai-cli-harness-better-practices): add /wrap-up-docs skill#470
JacobPEvans-personal merged 3 commits into
mainfrom
feat/wrap-up-docs

Conversation

@JacobPEvans-personal

@JacobPEvans-personal JacobPEvans-personal commented Aug 23, 2026

Copy link
Copy Markdown
Member

Summary

Adds /wrap-up-docs, a read-only companion skill to handoff and wrap-up that expands session evidence into a single paste-ready prompt for a weaker local model whose sole job is updating public and private documentation. Routing between public and private docs is rule-based, with sensitive or ambiguous items defaulting private.

Changes

  • Add new skill ai-cli-harness-better-practices/skills/wrap-up-docs/SKILL.md (+175 lines): exhaustive per-item changelog prompt with git-first evidence gathering, zero-instruction-inference scope fences, full-URL rule, and required per-item output report
  • Register the command in repo-root AGENTS.md plugin table and the ai-cli-harness-better-practices/README.md command list
  • Add Related Skills cross-references to /wrap-up-docs in skills/handoff/SKILL.md and skills/wrap-up/SKILL.md

Test Plan

  • Pre-commit suite green: markdown lint, agentskills.io validator, cclint frontmatter checks
  • Token budgets verified: description 746 chars (cap 1536); body ~2k tokens (max 3500), inline prompt template retained per self-contained-skill rule
  • Fresh-subagent test against a synthetic evidence pack produced the exact expected artifact shape: all items inventoried, security item routed private, ambiguous config item defaulted private, full URLs only, skipped sources declared

Note

Low Risk
Documentation-only skill addition with no runtime, auth, or data-handling changes. Residual gap: the new skill is not listed in plugin.json, so discovery may depend on directory layout rather than the plugin manifest.

Overview
Adds /wrap-up-docs, a read-only companion to /handoff and /wrap-up. It expands (does not compress) session evidence into one paste-ready prompt so a weaker local model can update docs without inferring from the original conversation.

The new skill inventories every technical change (path, substance, SHAs, full PR URLs, why), routes each item public vs private with sensitive/ambiguous defaulting private, and fences the consumer to documentation-only edits plus a per-item skip/update report. Git is optional; skipped sources are declared in the prompt.

Docs and related-skill links in AGENTS.md, the plugin README, /handoff, and /wrap-up now list the command. plugin.json still does not register ./skills/wrap-up-docs.

Reviewed by Cursor Bugbot for commit bccf54f. Bugbot is set up for automated code reviews on this repo. Configure here.

Copilot AI lite review requested due to automatic review settings August 23, 2026 21:58

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@cursor

cursor Bot commented Aug 23, 2026

Copy link
Copy Markdown

Bugbot couldn't run - usage limit reached

Bugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit.

A user or team admin can review and increase usage limits in the Cursor dashboard.

(requestId: serverGenReqId_e0166568-3bcb-4326-9a6d-e7ea3cbb8b37)

@JacobPEvans-personal JacobPEvans-personal added the validated:pass agent-validated status is success on head SHA label Aug 23, 2026
@cursor

cursor Bot commented Aug 23, 2026

Copy link
Copy Markdown

Bugbot couldn't run - usage limit reached

Bugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit.

A user or team admin can review and increase usage limits in the Cursor dashboard.

(requestId: serverGenReqId_17e30f2d-44cb-4b4c-97da-cb16d29ab53d)

@JacobPEvans-personal
JacobPEvans-personal merged commit ffeb30f into main Aug 24, 2026
29 checks passed
@JacobPEvans-personal
JacobPEvans-personal deleted the feat/wrap-up-docs branch August 24, 2026 00:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

validated:pass agent-validated status is success on head SHA

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants