Agent skill

Discuss

by swingerman in swingerman/engineer

A skill your agent uses when exploring a feature idea before committing, or revisiting a parked one.

MITAuto-check passed

Install Discuss

skills CLI
$ npx skills add swingerman/engineer --skill discuss -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install swingerman/engineer discuss --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/swingerman/engineer.git skills-src && mkdir -p .claude/skills && cp -r skills-src/engineer/skills/discuss .claude/skills/discuss && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
discuss
GitHub stars
154
Token cost
~1.5k tokens
SKILL.md length
667 words
Files
1
Skills in repo
27
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when exploring a feature idea before committing, or revisiting a parked one.

  • Works in 6 steps: Resolve + load — resolve the methodology… → Open — if handed an intent.md (an… → Brainstorm (divergent) — explore intent,… → …
  • Exploring a feature idea before committing
  • SKILL.md covers When to use, Workflow, Handoff and References
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Discuss is an agent skill from swingerman/engineer. Use when exploring a feature idea before committing, or revisiting a parked one. Triggers — "/engineer.discuss", "/engineer.discuss <slug", "I have an idea about", "should we build", "let's think about".

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Disciplined Agentic Engineering — a methodology kit for Claude Code: acceptance-test-first specs, explicit checkpoints, and autonomy you can actually leave running. The engineer… The licence is MIT.

When your agent uses it

  • Exploring a feature idea before committing
  • Revisiting a parked one
  • — /engineer.discuss
  • /engineer.discuss <slug

Example prompts

  • “/engineer.discuss”
  • “/engineer.discuss <slug”
  • “I have an idea about”
  • “/discuss”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Resolve + load — resolve the methodology root + manifest via ${CLAUDE_PLUGIN_ROOT}/scripts/dae_resolve.py (see references/resolving.md)…
  2. Open — if handed an intent.md (an originator-authored intent, see ${CLAUDE_PLUGIN_ROOT}/references/intent.md), read it as the opening…
  3. Brainstorm (divergent) — explore intent, scope, alternatives; one question per turn. Surface charter signals (e.g. payment paths cap…
  4. Surface the outcome — at a natural inflection, recommend an outcome (build / park / drop); the user confirms. Never auto-execute. If the…
  5. Execute the outcome
  6. Handoff — for park/promote, write a -discuss.md handoff into the new feature folder. For drop, the log line is the record — no handoff.

What it can do on your machine

Read from SKILL.md and the folder at commit 32947eb. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • notion.so

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Discuss loads about 1.5k tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 667 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~53
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from swingerman/engineer at commit 32947eb, republished under its MIT licence (© swingerman). 667 words, ~1,456 tokens.

Download SKILL.mdSave it as .claude/skills/discuss/SKILL.md (or your agent's skills folder).
name
discuss
description
Use when exploring a feature idea before committing, or revisiting a parked one. Triggers — "/engineer.discuss", "/engineer.discuss <slug>", "I have an idea about", "should we build", "let's think about".

discuss

The upstream funnel of DAE — a divergent brainstorm (forked from superpowers:brainstorming) that ends in one of three outcomes: drop, park, or promote. Most ideas die here; some park as features/NNN-slug/ with status: parked; survivors promote to status: ready.

When to use

  • Fresh — /engineer.discuss, no argument. New exploration.
  • Continue — /engineer.discuss <slug>. Resume a parked feature.

Not for: feature-work prep on an already-Ready feature (prime-context), or editing a committed feature (feature-edit).

Workflow

  1. Resolve + load — resolve the methodology root + manifest via ${CLAUDE_PLUGIN_ROOT}/scripts/dae_resolve.py (see references/resolving.md). Load CHARTER.md and the last ~20 lines of .engineer/discussions.log. With a slug arg: also load that feature's feature.md + prior handoffs/*-discuss.md; reject if its status is ready/in-progress (→ feature-edit) or done.
  2. Open — if handed an intent.md (an originator-authored intent, see ${CLAUDE_PLUGIN_ROOT}/references/intent.md), read it as the opening context instead of a cold prompt, reflect the synthesis back, and continue from there — the async front door for originators who don't want an interactive session. Otherwise, fresh: "What are you thinking about?" After the first prompt, soft-match the topic against parked feature titles/areas and against roadmap items (driver per references/roadmap.md; local = ${CLAUDE_PLUGIN_ROOT}/scripts/dae_roadmap.py list); if it matches a planned roadmap item, say so and offer to promote that item (carry its id as roadmap_ref) rather than starting a disconnected idea. Continue mode: echo prior state in one line, then resume.
  3. Brainstorm (divergent) — explore intent, scope, alternatives; one question per turn. Surface charter signals (e.g. payment paths cap autonomy), ADR connections, and "too big — decompose?" flags as they arise.
  4. Surface the outcome — at a natural inflection, recommend an outcome (build / park / drop); the user confirms. Never auto-execute. If the user says "drop" but there's a concrete reason it's worth parking, ask once. Present it as a choice point (${CLAUDE_PLUGIN_ROOT}/references/choice-points.md): recommend one option marked "(Recommended)" with a one-line rationale, alternatives listed, autonomy_level-dialed default — not an open question. When the outcome is build, the recommendation carries the two funnel decisions, both projected from the conversation (size + clarity, per choice-points.md):
    • A — front half: shape known → spec-first; fuzzy / UX-heavy / "I'll know it when I see it" → prototype-first (${CLAUDE_PLUGIN_ROOT}/references/two-paths.md) — iterate a rough artifact, convert to spec later.
    • B — weight: projected ~1-PR / low-risk → express (XS) (${CLAUDE_PLUGIN_ROOT}/references/express-lane.md, one pass); non-trivial → full DAE. Charter-flagged path is never recommended express (safety wins). Prototype-first defers B to convergence (its prototype_disposition). Carry the projected size into the promote/prototype handoff so feature-init need not re-ask.
  5. Execute the outcome:
    • Drop — append one line to .engineer/discussions.log: <ISO-timestamp> | <slug> | dropped | <one-line why>. Draft the "why" from context; user confirms/edits.
    • Prototype — the idea is better built than specced: hand to the prototype skill (/engineer.prototype "<idea>") instead of feature-init. It iterates fast, then converts to spec (promote) into the pipeline later — the prototype-first entry (${CLAUDE_PLUGIN_ROOT}/references/two-paths.md). Do not create a feature here; prototype's promote does that on convergence.
    • Park — invoke feature-init with feature_intake { status: parked, autonomy_level: null, ... }.
    • Promote — first resolve autonomy_level (low/medium/high, charter caps surfaced); if the user can't decide, fall back to park. Then invoke feature-init with status: ready. If the idea came from a roadmap item, pass its roadmap_ref so feature-init back-links and marks it in-progress (see references/roadmap.md).
    • Keep the roadmap alive — when an idea is too big and decomposes into several future features, or you park something strategically worth tracking at the feature-list altitude, offer once to add it as a roadmap item (driver upsert, status: planned, a horizon) so the strategic layer stays current beyond onboard-time. The user's call — never auto-add. Skip silently if manifest.roadmap.type is none/unreachable.
  6. Handoff — for park/promote, write a <timestamp>-discuss.md handoff into the new feature folder. For drop, the log line is the record — no handoff.
Show full SKILL.md (71 more words)Show less

Continuing a parked feature: each session appends a new discuss handoff; feature.md is refined in place. Promoting a continued feature flips status to ready directly — feature-init is not re-invoked.

Handoff

For park/promote, emit per ${CLAUDE_PLUGIN_ROOT}/references/handoff-summary.md. checkpoint: null. Drop emits no handoff.

References

  • Discuss & Upstream Funnel — funnel, drop-log format, park/promote paths
  • Foundation Design — feature.md schema, autonomy levels
  • references/roadmap.md — the roadmap ↔ feature funnel (promote from / keep alive)
  • Sister skill: feature-init (invoked for park/promote).

© swingerman, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in engineer/skills/discuss of swingerman/engineer.

Open the folder on GitHubat commit 32947eb

Compare with similar skills

Discuss next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Discuss compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Discuss this skillswingerman/engineer154—~1.5kAutomated safety check: PassMIT
Commitsickn33/agentic-awesome-skills47k2 repos~1.3kAutomated safety check: PassMIT
Commitdavila7/claude-code-templates32k3 repos~730Automated safety check: PassMIT
Commitwindmill-labs/windmill18k—~447Automated safety check: PassCustom licence
Commitccusage/ccusage19k—~722Automated safety check: PassCustom licence
Commitantiwork/gumroad9.8k—~503Automated safety check: PassMIT

Similar skills

  • Commit

    sickn33/agentic-awesome-skills

    ALWAYS use this skill when committing code changes — never commit directly without it.

    47k GitHub starsUsed in 2 repos~1.3k tokens
    DevelopmentAuto-check passed
  • Commit

    davila7/claude-code-templates

    Create commit messages following Sentry conventions. An agent skill from davila7/claude-code-templates.

    32k GitHub starsUsed in 3 repos~730 tokens
    DevelopmentAuto-check passed
  • Commit

    windmill-labs/windmill

    Create a git commit with conventional commit format. An agent skill from windmill-labs/windmill.

    18k GitHub stars~447 tokensUpdated today
    DevelopmentAuto-check passed
  • Commit

    ccusage/ccusage

    Creates atomic Conventional Commits. An agent skill from ccusage/ccusage.

    19k GitHub stars~722 tokensUpdated today
    DevelopmentAuto-check passed
  • Commit

    antiwork/gumroad

    Stage and commit changes with a clear, concise commit message.

    9.8k GitHub stars~503 tokensUpdated today
    DevelopmentAuto-check passed
  • Commits

    redis/RedisInsight

    Official

    Generate commit messages following Conventional Commits format.

    8.9k GitHub stars~451 tokensUpdated 2 days ago
    DevelopmentAuto-check passed

More from swingerman/engineer

All 27 skills in this repo
  • Crap Analyzer

    swingerman/engineer

    A skill your agent uses to produce a risk-based refactor + test plan for recently-changed code on a diff/branch/PR by computing CRAP (complexity × untested) on changed methods.

    154 GitHub stars~1.2k tokensUpdated 14 days ago
    Auto-check passed
  • Atdd Mutate

    swingerman/engineer

    A skill your agent uses to add a third validation layer to the ATDD workflow — after acceptance tests verify WHAT and unit tests verify HOW, mutation testing verifies the tests actually catch bugs.

    154 GitHub stars~2.7k tokensUpdated 14 days ago
    Auto-check passed
  • Fix

    swingerman/engineer

    A skill your agent uses to drive a bug fix from first report through close, with a "why didn't we catch it?" loop at the end.

    154 GitHub stars~3k tokensUpdated 14 days ago
    Auto-check passed
  • Atdd

    swingerman/engineer

    A skill your agent uses to drive feature work through the Acceptance Test Driven Development workflow — Given/When/Then specs before code, a project-specific test pipeline, and two parallel test…

    154 GitHub stars~2.8k tokensUpdated 14 days ago
    Auto-check passed
  • Harden

    swingerman/engineer

    Use after a feature passes Light Verify (CP7), to prove the tests actually catch bugs and, where the code warrants it, to formally check its invariants — Checkpoint 8.

    154 GitHub stars~1.8k tokensUpdated 14 days ago
    Auto-check passed
  • Next

    swingerman/engineer

    Use at the start of a work session, or any time the question is "what should I pick up now" across the whole project.

    154 GitHub stars~3k tokensUpdated 14 days ago
    Auto-check passed

Questions about Discuss

What does Discuss do?

A skill your agent uses when exploring a feature idea before committing, or revisiting a parked one. Discuss is an agent skill from swingerman/engineer. Use when exploring a feature idea before committing, or revisiting a parked one.

When should I use Discuss?

Discuss fits situations like: exploring a feature idea before committing; revisiting a parked one; — /engineer.discuss; /engineer.discuss <slug.

How do I install Discuss in Claude Code?

Run `npx skills add swingerman/engineer --skill discuss -a claude-code`. Or copy the skill folder (engineer/skills/discuss in swingerman/engineer) into .claude/skills/discuss in your project. Claude Code loads it when a task matches its description.

How do I install Discuss in Codex?

Run `npx skills add swingerman/engineer --skill discuss -a codex`. Or copy the skill folder (engineer/skills/discuss in swingerman/engineer) into .agents/skills/discuss in your project. Codex loads it when a task matches its description.

Can I use Discuss in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add swingerman/engineer --skill discuss -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/discuss, .gemini/skills/discuss, .github/skills/discuss and .opencode/skills/discuss in your project.

What does Discuss need to run?

SKILL.md names no scripts, command-line tools or credentials: Discuss is instructions for the agent only.

Does Discuss access the network?

SKILL.md names 1 domain. As links in the text: notion.so. This is read from the text; nothing was executed.

Is Discuss safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Discuss use?

Discuss is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Discuss use?

About 1.5k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Discuss?

Skills that share tags, products or a category with Discuss: Commit (sickn33/agentic-awesome-skills, 47k stars), Commit (davila7/claude-code-templates, 32k stars), Commit (windmill-labs/windmill, 18k stars) and Commit (ccusage/ccusage, 19k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Discuss?

swingerman (a GitHub user) maintains it in swingerman/engineer, which has 154 GitHub stars. The repository holds 27 skills in this directory. The repository was last updated on September 23, 2026.

Source: swingerman/engineer on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.