trellis-release

Audits Trellis task release.md files and generates batch release operation sheets.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/SilentFlower/flower-trellis --skill trellis-release-silentflower
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: trellis-release
Source: https://github.com/SilentFlower/flower-trellis/tree/main/.agents/skills/trellis-release
Command: npx skills add https://github.com/SilentFlower/flower-trellis --skill trellis-release-silentflower

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before a release, teams must verify that each task's release.md accurately reflects SQL changes, configuration updates, deployment scripts, and external system dependencies. This Skill cross-checks task documents and git evidence to detect documentation drift and consolidates everything into a confirmed release operation sheet. ## Core Features & Use Cases - Batch release sheet generation: Aggregates multiple Trellis tasks into a single .trellis/releases/<release-file>.md operation sheet with fixed sections for SQL, configuration, scripts, external systems, rollback, and verification. - Drift detection: Compares existing release.md files against task materials (prd.md, implement.md, check.jsonl) and git commit evidence, flagging missing, drifted, or uncertain items as Needs human review. - audit-current mode: Maintains a single task's release.md for the finish-work workflow, returning structured no-op / written / needs-review results without user confirmation. - Use Case: Before shipping version v0.3.1, ask the Skill to summarize all tasks in the batch; it reads each task's documents and git history, marks one task with a missing release.md, and produces a confirmed operation sheet with per-task source references. ## Quick Start Ask the assistant to generate a release operation sheet for the current Trellis tasks and confirm the draft before it is written to .trellis/releases/.

Frequently Asked Questions about trellis-release

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

FAQPage Schema
How do I generate a release operation sheet for multiple Trellis tasks?▼

Ask the assistant to generate a release sheet or summarize release.md files, optionally specifying task slugs, a version name, or a date range. The Skill reads each task's documents and git evidence, drafts a sheet, and writes it to .trellis/releases/ only after your confirmation.

How does the Skill detect release.md drift?▼

It compares each existing release.md against task.json, prd.md, implement.md, check.jsonl, and recent git commit file lists. Inconsistencies, missing release signals, or insufficient evidence are marked as suspected drift or Needs human review in the batch sheet.

Can this Skill execute deployments or run SQL scripts?▼

No. The Skill only organizes and verifies release items; it never executes SQL, deployment scripts, external system operations, commits, or pushes. Actual release execution should follow your project's SOP.

What is the audit-current mode used for?▼

audit-current checks only the active task and maintains its single-task release.md, typically invoked by the finish-work workflow. It returns a structured no-op, written, or needs-review result without user confirmation and never creates batch release files.

What happens if the target release file already exists?▼

The Skill never overwrites existing files in .trellis/releases/. It appends numeric suffixes like -2 or -3 to the generated filename and reports the conflict handling before writing.