skills.rest
honerlaw
honerlawCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

promote

Promote scratchpad entries into Minerva knowledge while preventing duplicate promotions.

Updated May 16, 2026
Search Tags:#knowledge management#promotion#minerva#idempotent workflows#scratchpad summarization#worktree records#proposal updating
One-click install
npx skills add https://github.com/honerlaw/agent-marketplace --skill promote-honerlaw
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: promote
Source: https://github.com/honerlaw/agent-marketplace/tree/main/plugins/minerva/skills/promote
Command: npx skills add https://github.com/honerlaw/agent-marketplace --skill promote-honerlaw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns end-of-work scratchpad notes into durable, durable, future-proof knowledge by promoting concrete outcomes and updating the persistent record to reflect what actually shipped.

Core Features & Use Cases

  • Promotes only worthwhile facts: promotes past-tense decisions, bug fixes, patterns, constraints, and deletes or quarantines dead ends and momentary digressions.
  • Keeps proposal and shipped record aligned: rewrites the work unit’s proposal (especially ## Approach) so it matches reality, and updates ## Status to Shipped (YYYY-MM-DD).
  • Archives scratchpad deterministically: moves the scratchpad into an archive folder and replaces it with a one-line summarized marker to prevent re-promotion.
  • Preserves forward-looking TODOs safely: offers a gate to keep TODOs in followups.md, seed a new minerva:propose, or discard them rather than silently dropping them.

Quick Start

Run minerva:promote with no arguments to perform an end-of-work promotion pass for the current work unit.

Frequently Asked Questions about promote

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I promote scratchpad notes into durable knowledge records?▼

Promoting scratchpad notes into durable knowledge requires resolving work targets and updating the filesystem to move past-tense decisions into a persistent knowledge base. This process archives the original scratchpad and replaces it with a summarized marker to prevent duplicate promotions.

What is the best way to keep a project proposal aligned with the shipped work record?▼

Keeping a project proposal aligned with the shipped record involves rewriting the work unit's approach section to match reality and updating the status to reflect the shipped date. This ensures the persistent record accurately documents what actually shipped.

How do I manage forward-looking TODOs when finalizing a work unit?▼

Managing forward-looking TODOs during finalization uses an interactive gate to preserve them safely. You can keep them in a followups file, seed a new proposal, or discard them rather than silently dropping them from the knowledge record.

How does idempotent scratchpad summarization prevent duplicate work promotions?▼

Idempotent scratchpad summarization prevents duplicate promotions by moving the scratchpad into an archive folder and replacing it with a one-line marker. This deterministic archival ensures the same work facts are not promoted twice into the knowledge base.

Can I promote a single mid-work scratchpad item instead of doing a full end-of-work pass?▼

You can promote a single mid-work scratchpad item by applying target resolution across work and worktree locations. This interactive single-item promotion fits within the lifecycle alongside end-of-work full passes.

Related Skills

Explore More Software Engineering Skills→
abzhawabzhaw

using-git-worktrees

Create isolated Git worktrees with gitignore safety checks and automated setup.

Community
Intermediate
catu-aicatu-ai
12

harness-land

Merge an approved pull request after confirming an archived harness plan.

Official
Intermediate
gustavofsantosgustavofsantos

knowledge

Store validated discoveries as cited facts in a persistent knowledge base.

Community
Advanced
lshtramlshtram

knowledge-integration

Distill task learnings into structured knowledge integration proposals for master guidelines.

Community
Intermediate