Agent skill

Conducty Shape

by robertbarclayy in robertbarclayy/conducty

Defines appetite, scope, no-go zones, and design before any prompts are written.

MITAuto-check passedAgent Workflows

Install Conducty Shape

skills CLI
$ npx skills add robertbarclayy/conducty --skill conducty-shape -a claude-code

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

GitHub CLI
$ gh skill install robertbarclayy/conducty conducty-shape --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/robertbarclayy/conducty.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/conducty-shape .claude/skills/conducty-shape && 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
conducty-shape
GitHub stars
176
Token cost
~2.2k tokens
SKILL.md length
1,131 words
Files
1
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

Defines appetite, scope, no-go zones, and design before any prompts are written.

  • Works in 9 steps: Set the Appetite → Understand the Goal → Scope Check and Decomposition → …
  • A goal is Medium
  • SKILL.md covers When to Use, The Shaping Process and Core Principles
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Conducty Shape is an agent skill from robertbarclayy/conducty. Defines appetite, scope, no-go zones, and design before any prompts are written. Use when a goal is Medium or High complexity, requirements are unclear, scope needs bounding, or the user says "shape", "design", "brainstorm", "think through".

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

It sits in Agent Workflows, covering Brainstorming. The repository describes itself as: Stop context-switching. Start batch-planning. Conducty replaces the fragmented cycle of plan → prompt → wait → get distracted → review → fix → repeat with advanced batch planning. The licence is MIT.

When your agent uses it

  • A goal is Medium
  • High complexity
  • Requirements are unclear
  • Scope needs bounding

Example prompts

  • “design”
  • “brainstorm”
  • “think through”
  • “/conducty-shape”

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Set the Appetite
  2. Understand the Goal
  3. Scope Check and Decomposition
  4. Breadboard the Solution
  5. Identify Rabbit Holes and No-Go Zones
  6. Propose Approaches
  7. Present the Design
  8. Save the Design Note
  9. Return to Planning

What it can do on your machine

Read from SKILL.md and the folder at commit 64aefd5. 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 (its code samples are markdown).

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

  • Network

    No URLs in SKILL.md.

    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

Conducty Shape loads about 2.2k tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 1,131 words of instructions outside code blocks.

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

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 robertbarclayy/conducty at commit 64aefd5, republished under its MIT licence (© robertbarclayy). 1,131 words, ~2,222 tokens.

Download SKILL.mdSave it as .claude/skills/conducty-shape/SKILL.md (or your agent's skills folder).
name
conducty-shape
description
Defines appetite, scope, no-go zones, and design before any prompts are written. Use when a goal is Medium or High complexity, requirements are unclear, scope needs bounding, or the user says "shape", "design", "brainstorm", "think through".
aliases
conducty-shape, shape
tags
conducty/skill, conducty/shape

Conducty Shape — Appetite, Boundaries, Design

Turn unclear or complex goals into bounded, executable designs. Shaping answers three questions before any prompt is written: How much is this worth? What's in scope? What's explicitly out?

This is not brainstorming in the open-ended sense. Shaping is opinionated — you propose boundaries, cut rabbit holes, and produce a design that fits the declared appetite. The output is a design doc that [[conducty-plan]] can decompose into prompts.

[!warning] Hard gate Do NOT generate prompts for a non-trivial goal until you have presented a design with appetite, scope, and no-go zones, and the user has approved it.

When to Use

Mandatory (invoked by [[conducty-plan]]):

  • Goal is Medium or High complexity
  • Goal spans multiple subsystems or projects
  • Goal requirements are ambiguous or underspecified

Optional (user-triggered):

  • User says "shape", "design", "brainstorm", "think through"
  • User wants to explore approaches before committing

Skip when:

  • Goal is Low complexity with clear requirements and obvious implementation
  • Goal is a straightforward bugfix with known root cause
  • Goal is a mechanical refactor with a clear before/after

The Shaping Process

Step 1: Set the Appetite

Before asking what to build, ask what it's worth.

"How much time should we spend on this? An hour? Half a day? A full day?"

The appetite is a hard constraint, not an estimate. If the design can't fit the appetite, cut scope — don't extend time. This prevents unbounded exploration and forces prioritization decisions early.

If the user hasn't thought about appetite, help them: "This feels like a half-day effort based on what you've described. Does that match your expectation?"

Step 2: Understand the Goal

Ask questions one at a time to understand what the user wants:

  • Prefer multiple-choice questions — faster to answer, forces you to have a hypothesis
  • One question per message — don't overwhelm
  • Check the project context note first ([[Context {Project}]] in the vault — see [[conducty-obsidian]]) before asking questions the context already answers
  • Focus on: purpose, constraints, what "done" looks like, who benefits

Keep it tight. You have the appetite as a constraint — don't spend 30 minutes of questions on a 2-hour task.

Step 3: Scope Check and Decomposition

Before designing, assess scale:

  • If the goal describes multiple independent subsystems, flag this immediately
  • Help decompose into sub-goals: what are the independent pieces, what order should they be built?
  • Each sub-goal gets its own shaping cycle
  • A goal that can't be decomposed to fit the appetite is too big
Step 4: Breadboard the Solution

Define the key components and how they connect — not wireframes, not full specs, just the essential shape:

  • What are the main pieces?
  • How do they connect?
  • What are the critical interactions?
  • What existing code is involved?

Think of this as a fat marker sketch — detailed enough to execute, abstract enough to leave room for the implementer to make tactical decisions.

Step 5: Identify Rabbit Holes and No-Go Zones

This is what separates shaping from open-ended brainstorming.

Rabbit holes — areas that could consume disproportionate time:

  • Identify them explicitly
  • For each: time-box it ("spend max 30 min on this") or cut it ("use the simple approach, don't optimize")
  • If a rabbit hole is essential and can't be time-boxed, the appetite is wrong — renegotiate

No-go zones — what is explicitly OUT of scope:

  • Write these down as carefully as what's IN scope
  • "We are NOT building X" / "We will NOT handle Y in this round"
  • No-go zones prevent scope creep during execution
Step 6: Propose Approaches

Present 2-3 approaches with trade-offs:

  • Lead with your recommendation and explain why
  • Frame trade-offs in terms of the appetite: "Approach A fits the appetite. Approach B is better but needs another half-day."
  • Keep it conversational — this is a planning discussion, not a formal document
Show full SKILL.md (520 more words)Show less
Step 7: Present the Design

Once the approach is chosen, present the design:

  • Scale each section to its complexity — a paragraph for simple parts, more detail for complex parts
  • Ask after each section: "Does this look right so far?"
  • Be ready to revise

Design for isolation and clarity:

  • Break into units with one clear purpose each
  • Well-defined interfaces between units
  • Each unit should be testable and understandable independently
  • Smaller units are easier for agents to implement reliably — a file that can be held in context produces better results than one that can't

Working in existing codebases:

  • Explore the current structure (use Glob/Grep) before proposing changes. Follow existing patterns.
  • Where existing code has problems that affect the work, include targeted improvements as part of the design
  • Don't propose unrelated refactoring. Stay focused on what serves the current goal.
  • Identify characterization needs: which existing behavior must be verified before changes begin?
Step 8: Save the Design Note

Write the approved design to the vault as Designs/Design YYYY-MM-DD HHmm {Topic Title Case}.md (see [[conducty-obsidian]] for full conventions). The timestamp matches the plan that will consume the design.

markdown
---
type: design
date: YYYY-MM-DD
time: HHmm
topic: {Topic Title Case}
project: {project-name}
appetite: {time budget}
tags: [conducty, conducty/design]
---

# Design: {Topic}

**Goal**: {one-sentence goal}

## Approach
{chosen approach and why}

## Components
{what gets built/changed, with file paths where known}

## Acceptance Criteria
- {criterion 1 — concrete and verifiable}
- {criterion 2}

## No-Go Zones
- {what is explicitly out of scope}
- {what we are deferring}

## Rabbit Holes
- {area of risk} — {mitigation: time-box or cut}

## Characterization Needs
- {existing behavior to verify before changing}

## Trade-offs
- Chose: {what we chose}
- Traded away: {what we gave up and why that's acceptable}

## Testing Strategy
{how to verify the whole thing works}

## Related

- Index: [[Designs Index]]
- Project: [[Context {Project}]]
- Consumed by: [[Plan YYYY-MM-DD HHmm {Topic}]]

Then prepend the new design's wikilink to [[Designs Index]] (Edit, not Write).

Step 9: Return to Planning

Hand control back to [[conducty-plan]] with:

  • The design note wikilink (e.g. [[Design 2026-04-27 0930 Auth Cleanup]])
  • The acceptance criteria (become prompt verification steps)
  • The components list (become individual prompts)
  • Suggested decomposition: which components are parallel vs. sequential
  • The appetite (constrains prompt count and time budgets)
  • The no-go zones (included in each prompt to prevent scope creep)

Core Principles

Fixed time, variable scope

Shape Up (Singer) — The appetite is a circuit breaker. When the design doesn't fit, cut scope — never extend time. Half-finished prompts all need rework.

The boundaries ARE the design

Shape Up (Singer) — What you exclude determines the shape more than what you include. Write no-go zones first, then scope what remains.

One bet per question

The Pragmatic Programmer (Hunt & Thomas) — Every question should carry a hypothesis. Prefer multiple choice. One per message. Exhaust what you know before asking what you don't.

Rabbit holes are budget items, not risks

Shape Up (Singer) — Time-box it or cut it. A rabbit hole without one of those is an unbounded liability in the plan.

Fat marker over fine tip

Shape Up (Singer) — Design at components, interfaces, and data flow. Finer than that and the agent fights you when reality diverges. Vaguer and the agent invents scope.

Separate what changes from what doesn't

Working Effectively with Legacy Code (Feathers) — Find the seam before you cut. Characterization needs go into the design doc before components do.

Decompose until each piece fits one prompt

A Philosophy of Software Design (Ousterhout) — If a component can't be one prompt with clear criteria, file paths, and a verification command, it's too big. Split it.

Trade-offs are named, not buried

Designing Data-Intensive Applications (Kleppmann) — "We chose X over Y because Z." A design that claims no trade-offs hasn't been examined.

Kill your darlings early

The Mythical Man-Month (Brooks) — The most valuable shaping output is often the feature you decided NOT to build. Shaping is cheap. Execution is expensive.

© robertbarclayy, 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 skills/conducty-shape of robertbarclayy/conducty.

Open the folder on GitHubat commit 64aefd5

Compare with similar skills

Conducty Shape 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.

Conducty Shape compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Conducty Shape this skillrobertbarclayy/conducty176—~2.2kAutomated safety check: PassMIT
Brainstormingxpinjection/test-driven-spring-boot11254 repos~2.6kAutomated safety check: PassMIT
Typesafe AIOpenAgentsInc/openagents4559 repos~2.5kAutomated safety check: PassMIT
Yao Meta Skillyaojingang/yao-meta-skill2.7k—~768Automated safety check: PassMIT
Trellis StartROYIANS/foliq-print-template-designer1356 repos~646Automated safety check: PassMIT
Brainstorming Before BuildingjnMetaCode/superpowers-zh8.3k—~1.8kAutomated safety check: PassMIT

Similar skills

  • Brainstorming

    xpinjection/test-driven-spring-boot

    You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior.

    112 GitHub starsUsed in 54 repos~2.6k tokens
    Agent WorkflowsAuto-check passed
  • Typesafe AI

    OpenAgentsInc/openagents

    Build AI-powered software with TypeSafe: small units of AI intelligence you can use like programming primitives.

    455 GitHub starsUsed in 9 repos~2.5k tokens
    Agent WorkflowsAuto-check passed
  • Yao Meta Skill

    yaojingang/yao-meta-skill

    Create, improve, or evaluate an existing skill from workflows, prompts, SOPs, scripts.

    2.7k GitHub stars~768 tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Trellis Start

    ROYIANS/foliq-print-template-designer

    Initializes an AI development session by reading workflow guides, developer identity, git status, active tasks, and project guidelines from .trellis/.

    135 GitHub starsUsed in 6 repos~646 tokens
    Agent WorkflowsAuto-check passed
  • Brainstorming Before Building

    jnMetaCode/superpowers-zh

    Turns a rough idea into an approved design before any code is written, sorting the request into spike, bounded or architectural and enforcing an approval gate.

    8.3k GitHub stars~1.8k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Om Brainstorm

    go-musicfox/go-musicfox

    Divergent conversation before any artifact exists — open questions one at a time, alternatives including building nothing, converging on a routing decision and a handoff brief for the next skill.

    2.6k GitHub starsUsed in 1 repo~1.6k tokens
    Agent WorkflowsAuto-check passed

More from robertbarclayy/conducty

All 20 skills in this repo
  • Conducty Checkpoint

    robertbarclayy/conducty

    Quality gate between parallelization groups. An agent skill from robertbarclayy/conducty.

    176 GitHub stars~1.5k tokensUpdated 3 mo ago
    Auto-check passed
  • Conducty Code Review

    robertbarclayy/conducty

    Standalone post-implementation code review across a whole branch or PR.

    176 GitHub stars~2k tokensUpdated 3 mo ago
    Auto-check passed
  • Conducty Context

    robertbarclayy/conducty

    Ingest a project directory into the Obsidian vault as a linked context sub-graph — Architecture, Conventions, Invariants, Hotspots, Tests, Glossary, plus per-bounded-context module notes.

    176 GitHub stars~3.7k tokensUpdated 3 mo ago
    Auto-check passed
  • Conducty Debug

    robertbarclayy/conducty

    Leverage-point analysis for failed prompts. An agent skill from robertbarclayy/conducty.

    176 GitHub stars~1.9k tokensUpdated 3 mo ago
    Auto-check passed
  • Conducty Execute

    robertbarclayy/conducty

    Dispatches Claude Code Task subagents to run prompts from a vault plan note.

    176 GitHub stars~2.5k tokensUpdated 3 mo ago
    Auto-check passed
  • Conducty Improve

    robertbarclayy/conducty

    End-of-plan improvement kata. An agent skill from robertbarclayy/conducty.

    176 GitHub stars~1.5k tokensUpdated 3 mo ago
    Auto-check passed

Categories

Questions about Conducty Shape

What does Conducty Shape do?

Defines appetite, scope, no-go zones, and design before any prompts are written. Conducty Shape is an agent skill from robertbarclayy/conducty. Defines appetite, scope, no-go zones, and design before any prompts are written.

When should I use Conducty Shape?

Conducty Shape fits situations like: A goal is Medium; high complexity; requirements are unclear; scope needs bounding.

How do I install Conducty Shape in Claude Code?

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

How do I install Conducty Shape in Codex?

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

Can I use Conducty Shape 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 robertbarclayy/conducty --skill conducty-shape -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/conducty-shape, .gemini/skills/conducty-shape, .github/skills/conducty-shape and .opencode/skills/conducty-shape in your project.

What does Conducty Shape need to run?

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

Does Conducty Shape access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Conducty Shape 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 Conducty Shape use?

Conducty Shape 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 Conducty Shape use?

About 2.2k tokens (SKILL.md is roughly 8.9k 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 Conducty Shape?

Skills that share tags, products or a category with Conducty Shape: Brainstorming (xpinjection/test-driven-spring-boot, 112 stars), Typesafe AI (OpenAgentsInc/openagents, 455 stars), Yao Meta Skill (yaojingang/yao-meta-skill, 2.7k stars) and Trellis Start (ROYIANS/foliq-print-template-designer, 135 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Conducty Shape?

robertbarclayy (a GitHub user) maintains it in robertbarclayy/conducty, which has 176 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on June 19, 2026.

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