sddl-delivery

Drafts commit messages, PR descriptions, and ticket content from completed work artifacts.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/nico0695/ai-tools --skill sddl-delivery-nico0695
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sddl-delivery
Source: https://github.com/nico0695/ai-tools/tree/main/sdd/sdd-lite/skills/sddl-delivery
Command: npx skills add https://github.com/nico0695/ai-tools --skill sddl-delivery-nico0695

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing handoff texts for finished work is repetitive and error-prone: commit messages, pull request descriptions, and ticket updates each demand consistent, evidence-based content. This Skill drafts all three from existing change artifacts and read-only git history, without ever executing git writes or touching external APIs. ## Core Features & Use Cases - Three delivery modes: commit mode drafts one commit message for a reviewed stage, pr mode drafts a pull request description, and ticket mode drafts four-section ticket content with an evidence-derived status. - Commit-to-change correlation: A rubric classifies each commit as exact, confirmed, strong, moderate, weak, or no-match against known changes, with an interactive selection table so nothing is applied without a user decision. - Frozen targets and audit reports: Every run freezes its target (change or commit range), writes a delivery-report.md audit record, and supports English, Spanish, chat-language, or mixed output. - Use Case: After finishing a feature branch, ask for a PR description; the Skill correlates your commits with the matching change, confirms the selection, and produces a copyable PR text grouped by concern with risks and test steps. ## Quick Start Ask the assistant to draft the PR description and ticket content for the current change using the sddl-delivery stage.

Frequently Asked Questions about sddl-delivery

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

FAQPage Schema
How do I generate a PR description from my commits?▼

Run the delivery stage in pr mode: it resolves a commit range from signals like merge-base, unpushed commits, or the last tag, correlates them against known changes, and drafts a PR description grouped by concern after you confirm the selection.

How to write a commit message from a finished code change?▼

Use commit mode inside an active change. It reads the stage entry and diff, then drafts one imperative commit message under 72 characters with a one-line rationale, and optionally records the SHA after you commit it yourself.

Can this tool run git commit or push for me?▼

No. It never runs any git write command such as commit, add, push, or rebase, and never calls issue trackers or external APIs. Every output is text you copy into git, the PR form, or the tracker yourself.

How are commits matched to changes without recorded SHAs?▼

A correlation rubric classifies each commit as exact, confirmed, strong, moderate, weak, or no-match using signals like branch name, file overlap with the execution log, and date windows. Only exact matches may be preselected; everything else requires your explicit decision.

What languages can the commit, PR, and ticket drafts use?▼

Four options are offered at the delivery gate: all English, the project's chat language, all Spanish, or mixed with the commit message in English and the PR and ticket in Spanish. The choice is recorded and reused on later runs.

When is a commit message draft blocked?▼

Drafting is blocked when the target cannot be frozen, the repository state makes the range unresolvable (for example a shallow clone without an explicit range), or commit mode is requested for a diff whose review gate is still unresolved.