Skip to content
Skills Library
Programming · Planning

envelope

/envelope

Author, approve, and export execution envelopes for AFK slices in a standalone strong-model session. Use only when the user explicitly invokes /envelope with a ticket id, approved Work Contract/spec file, or batch. Other skills may recommend it but must never auto-route into it. Ends with an approved, validated, repo-committed bundle under .beislid/exports/ that an external runner executes later.

Repository
beislid ↗
Licence
MIT
Last repository change
30.08.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
12
Scripts
0
HTML comments
1
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 30.08.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.

What it does and when to use it

Author, approve, and export execution envelopes for AFK slices in a standalone strong-model session. Use only when the user explicitly invokes /envelope with a ticket id, approved Work Contract/spec file, or batch. Other skills may recommend it but must never auto-route into it. Ends with an approved, validated, repo-committed bundle under .beislid/exports/ that an external runner executes later.

Original author description

Author, approve, and export execution envelopes for AFK slices in a standalone strong-model session. Use only when the user explicitly invokes /envelope with a ticket id, approved Work Contract/spec file, or batch. Other skills may recommend it but must never auto-route into it. Ends with an approved, validated, repo-committed bundle under .beislid/exports/ that an external runner executes later.

How it works

  1. Read workflow.md
  2. Step protocol loading
  3. Checklist and required outputs
  4. Global tripwires
  5. Run end
  6. Key principles
Original SKILL.md headings · 51 lines, 711 words
SKILL.md preview
---
name: envelope
description: Author, approve, and export execution envelopes for AFK slices in a standalone strong-model session. Use only when the user explicitly invokes /envelope with a ticket id, approved Work Contract/spec file, or batch. Other skills may recommend it but must never auto-route into it. Ends with an approved, validated, repo-committed bundle under .beislid/exports/ that an external runner executes later.
---

# Envelope

Turn approved planning context into exported execution envelopes: one `execution-envelope-v0` per AFK-ready slice, packaged as an `approved-slice-plan-export-v0` bundle that `rondo run-once --manifest <slice-manifest>` can execute in a fresh session with zero additional context.

**Trigger is explicit only.** The human chooses which model/session pays for authoring. When `kickoff` classifies work as multi_slice/AFK-suitable it may *recommend* running `/envelope` in a strong-model session; it never auto-routes here, and this skill never auto-routes back.

**Don't use this for:** interactive implementation (use `kickoff`), PR handoff (`ready-for-review`), or running exported work (that's rondo's job — Beislið owns envelope/export semantics; rondo owns execution and run evidence; no runtime service).

Project config: `<repo>/.beislid/workflow.md`. Probe lazily per `probe-semantics.md`; policy-check side effects per `action-policy-protocol.md`. Output copy lives in `envelope-templates.md`. AFK eligibility is judged against a versioned rubric, resolved repo-override-first: a `beislid:envelope` block in workflow.md may set `rubric_path` (a repo-relative `.md`, no `..`); otherwise the skill default `afk-rubric.md` applies.

## Read workflow.md

Read `<repo>/.beislid/workflow.md` and validate line 1 is exactly `<!-- beislid-workflow: v1 -->`; hard-fail and stop if missing or wrong (run `/setup` for fresh projects). Initialize the probe cache exactly as `kickoff` does (`repo_hash`, `workflow_hash`, `${BEISLID_STATE_DIR:-$HOME/.local/state/beislid}/probes/<repo_hash>.json`, fresh/stale/cold). Print orientation prose from `envelope-templates.md` (≤240 chars).

For durable evidence, `probe(nopal_seam)`; on ok, best-effort `nopal ledger init --skill envelope --flow envelope --json`, else `beislid run-ledger init --skill envelope --flow envelope` (`nopal-seam-protocol.md`), with ticket/branch context when known. Warn on ledger failure; never block.

## Step protocol loading

Complete steps in order. At each step entry, read the step aux file and follow it as the authoritative protocol. If a step file cannot be read, hard-fail and stop:

> 🛑 Could not read `skills/envelope/<step-file>.md`. Envelope cannot safely execute this step from memory; reinstall Beislið or restore the file.

## Checklist and required outputs

1. **Intake** — read `step-1-intake.md`. Outputs: input kind, planning context (approved structure/Work Contract or planning-skill results), candidate slices, bundle-id.
2. **Author** — read `step-2-author.md`. Outputs: one draft `execution-envelope-v0` per AFK-candidate slice with autonomy lists, proof requirements, pause conditions, dependencies, expected delivery, self-contained prompt, repo pin.
3. **Approve** — read `step-3-approve.md`. Outputs: per-envelope verdicts (approve / reject / demote-to-HITL), approval metadata, or the zero-AFK terminal state.
4. **Export** — read `step-4-export.md`. Outputs: validated bundle path, `envelope_exported` checkpoint status, commit status, handoff guidance.
5. **Revise** — *revision mode only*, loaded straight from Step 1 in place of Steps 2–4: read `step-5-revise.md`. Outputs: v+1 bundle rewritten in place with `supersedes: <sha256 of prior bundle.json>`, per-envelope delta summary, delta-only re-approval verdicts (unchanged approved envelopes carry their original approval metadata forward), validated re-export.

## Global tripwires

- **Fail-closed:** unapproved envelopes are never exported. Zero approved envelopes means no bundle, no checkpoint, no commit — print the verdict summary and recommend `kickoff` for HITL slices.
- **No implementation.** This skill plans, packages, and exports; it never starts the work it is packaging.
- **Manifest input means revision mode.** Step 1 detects it (a JSON file whose `kind`/`schema` matches export/manifest contracts) and looks for feedback: a delivery artifact with `pause_reason`/`review_feedback`, or a non-approved bundle status. With feedback, route through `step-5-revise.md`; an approved manifest with no feedback is refused with the nothing-to-revise message. Never overwrite or re-author silently.
- **Existing bundle dir is a hard stop in non-revision runs.** `.beislid/exports/<bundle-id>/` already existing means a prior export; overwriting would corrupt the supersede chain. Stop with the collision message; the user must pick a new bundle-id or delete deliberately. Revision mode is the one exception: it rewrites the same dir in place with a bumped version and `supersedes` hash.
- **Validator is the gate.** `beislid export validate <bundle-dir>` must exit 0 before checkpoint or commit. Never hand-wave a failed validation.
- **Reuse planning skills** (`spec`, `break-spec`, `blueprint`) for thinking work; never reimplement their protocols here.
- Policy-check every side effect (workspace writes, checkpoint, `git.commit`); `ask` requires approval, `deny` stops with manual fallback.

## Run end

Write back probed capability entries to the probe cache as `kickoff` does (exclude `session_skip`, preserve doctor-owned fields). Finalize the run ledger with verdicts, bundle path, validator evidence, and commit status when active.

## Key principles

- One strong-model session produces a self-contained bundle; a cheaper session executes it later.
- Explicit human verdicts per envelope, in one sitting; rejects never block the batch.
- Everything after approval is mechanical: documented JSON conventions + a read-only validator.
Files in this package (12)
  • SKILL.md 6 KB
  • action-policy-protocol.md 1 KB
  • afk-rubric.md 3 KB
  • envelope-templates.md 1 KB
  • nopal-seam-protocol.md 1 KB
  • output-templates.md 1 KB
  • probe-semantics.md 1 KB
  • step-1-intake.md 4 KB
  • step-2-author.md 4 KB
  • step-3-approve.md 3 KB
  • step-4-export.md 4 KB
  • step-5-revise.md 3 KB

Versions

RepositoryScoreLicence
This page · sandsower/beislid90MIT
tymrtn/u1f4e7100Apache-2.0
wrg32786/aigent-os90MIT

Database snapshot: 13.11.2026 · package version 25045f3d3494 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

No similar skills in the database.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.