aldescription

$npx mdskill add paleo/alignfirst/aldescription

Generates PR/MR descriptions from completed changes.

  • Solves the need for summarizing implemented work in pull requests.
  • Depends on the alignfirst skill and its description protocol.
  • Decides by executing the description protocol from alignfirst.
  • Delivers results as a structured PR/MR description.

SKILL.md

.github/skills/aldescriptionView on GitHub ↗
---
name: aldescription
description: "Write a description summarizing implemented work. Generates PR/MR descriptions from completed changes."
disable-model-invocation: true
---

Read the *alignfirst* skill (`../alignfirst/SKILL.md`) and its `references/description-protocol.md` if not already loaded.

Execute the _description_ protocol from the *alignfirst* skill. Do not use your own plan mode.

More from paleo/alignfirst

SkillDescription
alAlign-and-Do Protocol (AAD). Use for smaller tasks that don't need formal specs or plans.
alignfirstCollaborative problem-solving protocols. Write technical specifications (spec, or alspec), create implementation plans (plan, or alplan), or use Align-and-Do Protocol (AAD). Also generates PR/MR descriptions (aldescription) and code review reports (alreview).
alignfirst-setup-guide>-
almergeResolve merge or rebase conflicts. Investigates both sides, resolves the conflicts (with a special case for lock files), and writes a brief summary.
alplanCreate implementation plan(s) from a technical specification.
alreadRead all specs and summaries in the current task directory to prepare context.
alreviewWrite a code review report comparing the current branch to a base branch.
alspecCreate a technical specification (spec) for a feature or task.
openclaw-coder-playbookOperating-instructions dispatcher for the openclaw-coder autonomous-programmer workspace. Routes every user message by surface — thread → working session, channel/DM → channel handling — and carries the global rules. The workspace AGENTS.md loads this skill first on every user message.
sharp-writingConventions for writing sharp, concise prose and Markdown, for human readers and AI agents. Read before writing documentation, READMEs, instructions, agent skills, or any prose text.