Home / chan4lk / specclaw · plugins/specclaw/skills/propose/SKILL.md · GitHub

propose skillB

propose is agent-read markdown (skill) from chan4lk/specclaw: Draft a new change proposal. INVOKE IMMEDIATELY whenever the user mentions a proposal, feature idea, change request, new initiative, or anything they want to add/build/implement — do NOT gather details conversationally first. The skill itself will ask for any missing information after invocation. Creates .specclaw/changes/<name>/proposal.md with problem statement, solution, scope, impact, and open questions. When party.enabled is set, also runs the adversarial review panel over the draft — askin.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# specclaw propose

**First, run** `specclaw-ensure-init .specclaw` — idempotently creates `.specclaw/` if it doesn't exist (silent if already initialized; auto-inits using the current directory's basename as the project name).

**Timing (change 028).** Open a phase span when you start and close it when the artifact is written — `specclaw-timer start .specclaw <change> propose --kind phase --label propose || true`, then `specclaw-timer stop .specclaw <change> propose || true`. Cheap, and it finally answers how long this phase costs us. Both calls end in `|| true`: a stopwatch is never a reason to stop.

Create a new proposal for a change.

**If the user hasn't yet provided enough detail to draft the proposal (e.g. they just said "i have a proposal" with no specifics), ask once for the essentials inside this skill — what's the idea, what problem does it solve — then proceed to the steps below. Do not wait for a separate turn to invoke this skill.**

1. **Target-foundation gate** (brownfield rebuilds only — inert everywhere else). **Run this before creating or renaming anything:**

```bash
specclaw-bf-bootstrap foundation-check .specclaw
```
…

Read the whole file at its exact version.

How to install

Latest version
mdr add chan4lk/specclaw/propose@git:20260922.6c45ce3
Exact content
mdr add chan4lk/specclaw/propose@sha256:1b9dec1356a1efc1

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_r7xoguguzvxy5l7f.svg)](https://markdownregistry.com/a/art_r7xoguguzvxy5l7f)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260922.6c45ce3 latest2026-09-22 6c45ce3 34,389 BB view · diff
git:20260919.8369be22026-09-19 8369be2 31,303 BB view · diff
git:20260918.99e7afb2026-09-18 99e7afb 29,781 BB view · diff
git:20260918.fdd89782026-09-18 fdd8978 29,397 BB view · diff
git:20260918.b95a65d2026-09-18 b95a65d 30,740 BB view · diff
git:20260904.c65816a2026-09-04 c65816a 27,654 BB view · diff
git:20260816.3eee53b2026-08-16 3eee53b 10,381 BB view

Audit of the latest version

B  16 of 17 checks passed. Deterministic, no model, same answer every run.
  • fail: Frontmatter declares a name
  • pass: Frontmatter block present
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (34389 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

chan4lk/specclaw · 12 stars · license MIT · pushed 2026-09-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_r7xoguguzvxy5l7f
GET https://markdownregistry.com/api/v1/resolve?ref=chan4lk/specclaw/propose
GET https://markdownregistry.com/api/v1/blob/1b9dec1356a1efc1778296a8a7647db21df7fd34d7aeb30b11db5c9712c7b638

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from chan4lk/specclaw

specclaw skill
chan4lk/specclaw · .agents/skills/specclaw/SKILL.md · Run the SpecClaw spec-driven lifecycle in this repository when a request needs proposal, planning, build, verification…
git:20260920.e1dc68c · audit A · 12 stars
CLAUDE.md claude
chan4lk/specclaw · CLAUDE.md
git:20260918.26bbfe4 · audit A · 12 stars
llms-full.txt@docs llmstxt
chan4lk/specclaw · docs/llms-full.txt
git:20260717.fc3814b · audit A · 12 stars
llms.txt@docs llmstxt
chan4lk/specclaw · docs/llms.txt
git:20260717.fc3814b · audit A · 12 stars
CLAUDE.md@plugins/specclaw claude
chan4lk/specclaw · plugins/specclaw/CLAUDE.md
git:20260922.902b03b · audit B · 12 stars
archive skill
chan4lk/specclaw · plugins/specclaw/skills/archive/SKILL.md · Move a completed change to .specclaw/changes/archive/ under its existing name. Closes the GitHub Issue (if sync is…
git:20260918.fdd8978 · audit B · 12 stars
auth-azdo skill
chan4lk/specclaw · plugins/specclaw/skills/auth-azdo/SKILL.md · Interactive setup for Azure DevOps authentication. Prompts for organization, project, and repo, validates a Personal…
git:20260515.4f3e739 · audit B · 12 stars
auth-jira skill
chan4lk/specclaw · plugins/specclaw/skills/auth-jira/SKILL.md · Interactive setup for Jira authentication. Prompts for domain, email, project key, and issue type, validates an…
git:20260515.4f3e739 · audit B · 12 stars
author-spec skill
chan4lk/specclaw · plugins/specclaw/skills/author-spec/SKILL.md · Interactively co-author spec.md for an approved proposal via the spec-author subagent. The agent walks the user through…
git:20260524.1179910 · audit B · 12 stars
auto skill
chan4lk/specclaw · plugins/specclaw/skills/auto/SKILL.md · Run the propose → plan → build → verify lifecycle autonomously across the queue of active changes. Advanced — requires…
git:20260515.d5537a5 · audit B · 12 stars
azdo-issue skill
chan4lk/specclaw · plugins/specclaw/skills/azdo-issue/SKILL.md · Create or update an Azure Boards Work Item that mirrors this proposal. Targets Azure DevOps Boards (Features / User…
git:20260706.ade5fa1 · audit B · 12 stars
bf-analyze skill
chan4lk/specclaw · plugins/specclaw/skills/bf-analyze/SKILL.md · Analyze an existing (possibly legacy) codebase and write a grounded `.specclaw/analysis/codebase-report.md` covering…
git:20260920.62cf3f0 · audit B · 12 stars

Every file in chan4lk/specclaw

Other files named propose

propose skill
mirkobozzetto/arsenal · plugins/propose/skills/propose/SKILL.md · Design a concrete technical proposal with evidence and tradeoffs when a decision needs design. No implementation or…
git:20260922.f331667 · audit A · 16 stars

Browse by kind, by grade B, or by owner.