Agent skill

The Goal Automation Diagnostic

by glebis in glebis/claude-skills

Walks through Goldratt's Five Focusing Steps to find the real bottleneck in your work, then recommends one automation aimed at it and a list of what not to automate.

MITAuto-check passedProductivity & Automation

Install The Goal Automation Diagnostic

skills CLI
$ npx skills add glebis/claude-skills --skill the-goal -a claude-code

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

GitHub CLI
$ gh skill install glebis/claude-skills the-goal --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/glebis/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/the-goal .claude/skills/the-goal && 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
the-goal
GitHub stars
391
Token cost
~2k tokens
SKILL.md length
939 words
Files
7 (incl. scripts, references, assets)
Skills in repo
92
Repo updated
First seen
Licence
MIT

At a glance

Walks through Goldratt's Five Focusing Steps to find the real bottleneck in your work, then recommends one automation aimed at it and a list of what not to automate.

  • Works in 3 steps: It targets a non-constraint. The worst… → It optimizes a local metric. Feels… → "Felt busy" is not "moved the needle."…
  • Deciding what to automate with agents when several ideas compete
  • SKILL.md covers When to use, The core distinction (state…, Workflow — the Five Focusing… and Guardrails (non-negotiable), plus 2 more sections
  • Runs Python scripts from its folder; calls python3

What it does

Before you build a skill, loop or schedule, this skill runs an interactive diagnostic of your work system, asking one focused question at a time. The agent turns your answers into structured inputs, and two bundled Python scripts then rank the candidate constraints and choose an autonomy rung, so those calls come from scoring rather than free-form judgment.

The output is a single recommended automation aimed at the constraint, plus a list of things not to automate. It guards against three failures: targeting something that is not the constraint, optimizing a local metric, and mistaking feeling busy for added throughput. References cover the five focusing steps and an autonomy ladder, and an assets file provides a constraint-analysis template. If you already know your constraint, it skips to the elevate step and the recommendation.

When your agent uses it

  • Deciding what to automate with agents when several ideas compete
  • Reviewing a pile of half-useful automations that leave you busy but stuck
  • Checking whether a planned skill, loop or schedule is worth building
  • Running a periodic review of where agent effort is going

Example prompts

  • “What should I automate first? My week is full of reports, client emails and invoicing.”
  • “Find my bottleneck before I build another Claude Code skill.”
  • “Prioritize my automation backlog using the Theory of Constraints.”
  • “Is a nightly schedule for inbox triage worth building, or is that busywork?”

Requirements

  • Python for the bundled scoring scripts

Workflow steps

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

  1. It targets a non-constraint. The worst kind. Even a flawless automation here adds zero throughput; the bottleneck still caps the system…
  2. It optimizes a local metric. Feels productive (inbox zero, faster research) but the global goal does not move.
  3. "Felt busy" is not "moved the needle." Activity is not throughput. Require a measurable throughput before recommending anything.

What it can do on your machine

Read from SKILL.md and the folder at commit 3b88261. 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

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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

The Goal Automation Diagnostic loads about 2k tokens when it runs, and up to ~5.6k if it reads all its reference files. Until then it costs about 210 tokens; SKILL.md has 939 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~210
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.6k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from glebis/claude-skills at commit 3b88261, republished under its MIT licence (© glebis). 939 words, ~1,989 tokens.

Download SKILL.mdSave it as .claude/skills/the-goal/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
the-goal
description
A Theory-of-Constraints diagnostic for deciding what to automate with AI agents. Before building any automation, skill, Goal, loop, or schedule, it walks Goldratt's Five Focusing Steps over the user's work system to find the real bottleneck, then recommends the single highest-leverage automation aimed at the constraint plus a what-NOT-to-automate list. Use when the user asks "what should I automate", "where do I point my agents", "prioritize my automation backlog", "which workflow should I agentify", "is this worth building", "find my bottleneck", "what's the highest-leverage thing", when they are about to build a Claude Code skill/Goal/loop/schedule and aren't sure it matters, or during a review of their automations. Guards against the common failure of automating busywork (a local optimum) instead of the constraint.

The Goal — constraint-first automation

Named after Eliyahu Goldratt's The Goal. The lesson this skill encodes: a local optimum is not a global one. Automating something that feels productive but is not the system's constraint produces no throughput gain. Most wasted automation effort dies here. This skill finds the constraint first, then points exactly one automation at it.

When to use

Use before building anything, and during reviews:

  • "What should I automate?" / "Where do I point my agents?" / "What's the highest-leverage thing right now?"
  • The user is about to build a Claude Code skill, Goal, loop, schedule, or workflow and isn't sure it matters.
  • The user has a pile of half-useful automations and feels busy but stuck.
  • A periodic review of where agent effort is going.

If the user already knows their constraint with confidence and just wants to build, skip the diagnosis and go straight to Step 4 (elevate) and the Recommendation.

The core distinction (state this early)

Three ways an automation idea fails, worst first:

  1. It targets a non-constraint. The worst kind. Even a flawless automation here adds zero throughput; the bottleneck still caps the system. Cut it.
  2. It optimizes a local metric. Feels productive (inbox zero, faster research) but the global goal does not move.
  3. "Felt busy" is not "moved the needle." Activity is not throughput. Require a measurable throughput before recommending anything.

Workflow — the Five Focusing Steps

Run as an interactive diagnostic, one focused question at a time. The LLM's job is to elicit the picture and map it to structured inputs; two scripts then do the ranking and the rung selection deterministically, so the core calls aren't free-form vibes. Load references/five-focusing-steps.md for the full method, definitions (throughput / inventory / operating expense in knowledge-work terms, drum-buffer-rope, Herbie) and example walkthroughs.

Optional — cenno mode. If cenno is available and the user prefers panels (or asks to "ask me in panels"), collect the inputs through cenno instead of chat: choice 0–3 (or a custom a2ui 0–3 slider) for the ordinal scores, confirm for necessary_condition/policy_gate and the seven rung facts, text for the goal/throughput. The answers feed the same two scripts unchanged. Load references/cenno-mode.md for the control mapping, ask_sequence batching, and how to persist the analysis. Fall back to chat if cenno isn't running — never block.

Step 0 — Define the goal + throughput measure (gate). What is this system for, and what single rate rises when it succeeds (revenue/quarter, products shipped/month, clients served, qualified leads)? No measurable throughput → stop and define one first. Validate it: "reclaimed hours" and "inbox zero" are usually operating-expense reduction or local efficiency, not throughput, unless free capacity is the system's explicit goal. Reject local-efficiency measures here.

  1. Identify the constraint. Walk the flow from intent to result; list the candidate steps. For each, elicit ordinal evidence (0–3): throughput-sensitivity (would T rise if this step were 2× faster — the decisive one), wait-before, downstream-starvation, capacity-gap, whether it's a policy/approval gate, and how annoying it feels. Also flag necessary_condition: true for steps that must be adequate to function but already are (e.g. a sales page that converts) — the scorer then labels them "prerequisite: finish, don't over-invest" instead of lumping them with non-binding traps. Then rank deterministically:
    bash
    echo '[{"name":"...","throughput_sensitivity":3,"wait_before":2,"downstream_starvation":3,"capacity_gap":2,"annoyance":1}, ...]' | python3 scripts/score_constraints.py
    Honor the verdict: insufficient_data → gather more before deciding; ambiguous → re-scope or shorten the time window; constraint_found → proceed. The script flags the annoying-but-non-binding trap automatically.
  2. Exploit it. Before building anything, get the most from the constraint as it is. Often a non-automation fix (stop interrupting it, batch it, remove a hand-off) beats new tooling. Recommend exploitation first.
  3. Subordinate. Point everything else — including existing automations — at serving the constraint, not at optimizing non-constraints. This often means slowing or ignoring non-constraints (drum-buffer-rope).
  4. Elevate. Only now add capacity at the constraint with one automation. Pick the rung deterministically (the LLM supplies the yes/no facts; the tree decides):
    bash
    python3 scripts/recommend_rung.py --recurring --fixed-steps      # or --bounded-outcome, --streaming-input, etc.
    See references/autonomy-ladder.md for what each rung means. Elevation costs operating expense, so it comes after exploit + subordinate, never before.
  5. Repeat (POOGI). The constraint moves once relieved. Name the likely next constraint and queue it. Warn against inertia: do not keep polishing the old, now-non-binding step.
Show full SKILL.md (258 more words)Show less

Guardrails (non-negotiable)

  • Never recommend automating a non-constraint. If the user's proposed automation targets a non-constraint, say so plainly and redirect to the constraint.
  • Require a measurable throughput before any recommendation. "Make things better" is not a goal.
  • Name local optima out loud when seen.
  • Exploit and subordinate before elevate. Do not build new tooling prematurely when a cheaper exploitation fix exists.
  • One constraint-targeting automation at a time, not a backlog of five.

Output

Produce a short constraint analysis using assets/constraint-analysis-template.md with these sections:

  • Goal + throughput measure — the system's purpose and the one number.
  • The constraint — where the line stalls, with the evidence that identifies it.
  • Exploit — the cheapest non-build fix to try first.
  • The one automation — the single recommendation, the autonomy-ladder rung it sits on (Goal/loop/schedule/...), and why it serves the constraint.
  • Do NOT automate — the tempting non-constraints to leave alone, named explicitly.
  • Next constraint — where the bottleneck will likely move, queued for the repeat step.

Before delivering, run this validity checklist (not just shape):

  • throughput is a rate tied to the system goal (not a local-efficiency proxy)
  • constraint backed by the scorer's constraint_found verdict (or unknowns named)
  • an exploit fix is offered before the build
  • exactly one automation, with its autonomy-ladder rung
  • the do-NOT-automate list names the rejected non-constraints
  • a next-constraint is queued

End with the call to action: pick the single constraint-targeting automation and define it as a Goal (verifiable end-state + conditions), then build it.

Referenced skills

  • name-audition — sibling diagnostic; same "a local optimum is not safe" discipline, applied to names. (Cross-reference only; not a handoff.)

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

Files

SKILL.md and 6 other files (scripts, references, assets) in the-goal of glebis/claude-skills.

  • SKILL.md
  • assets/constraint-analysis-template.md
  • references/autonomy-ladder.md
  • references/cenno-mode.md
  • references/five-focusing-steps.md
  • scripts/recommend_rung.py
  • scripts/score_constraints.py

Open the folder on GitHubat commit 3b88261

Compare with similar skills

The Goal Automation Diagnostic 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.

The Goal Automation Diagnostic compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
The Goal Automation Diagnostic this skillglebis/claude-skills391—~2kAutomated safety check: PassMIT
CEO Plan Reviewgarrytan/gstack136k—~20kAutomated safety check: NotesMIT
Cc Best Practicesaiskillstore/marketplace433—~2.6kAutomated safety check: PassNone
Tandem Workflow Plan Modehashgraph-online/awesome-codex-plugins1.3k—~5kAutomated safety check: PassApache-2.0
Gdpr Remediation Roadmapmukul975/Privacy-Data-Protection-Skills301—~452Automated safety check: PassApache-2.0
Refly Skill Runnerrefly-ai/refly7.5k—~1.7kAutomated safety check: PassCustom licence

Similar skills

  • CEO Plan Review

    garrytan/gstack

    Reviews a plan from a founder's point of view, questioning premises and scope in one of four modes that run from expansion to reduction.

    136k GitHub stars~20k tokensUpdated today
    Product & Project ManagementAuto-check: notes
  • Cc Best Practices

    aiskillstore/marketplace

    Guidance on how to use Claude Code effectively — covering context management, verification strategies, the explore-plan-implement workflow, prompting techniques, session management, parallel…

    433 GitHub stars~2.6k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Tandem Workflow Plan Mode

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when the user wants to design, revise, or validate a Tandem workflow (V2 automation, workflow plan, or mission).

    1.3k GitHub stars~5k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Gdpr Remediation Roadmap

    mukul975/Privacy-Data-Protection-Skills

    Guides conversion of gap analysis findings into phased implementation plans with milestones and risk-based prioritisation.

    301 GitHub stars~452 tokensUpdated 6 mo ago
    Legal & ComplianceAuto-check passed
  • Refly Skill Runner

    refly-ai/refly

    Base skill for the Refly ecosystem: finds, runs and monitors workflow-backed skills through the refly command line, with the actual work done on the Refly backend.

    7.5k GitHub stars~1.7k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Piece Builder

    activepieces/activepieces

    Build and edit Activepieces pieces (integrations) — creating new pieces, adding actions or triggers, or fixing bugs in existing ones.

    25k GitHub stars~3.1k tokensUpdated today
    Productivity & AutomationAuto-check: notes

More from glebis/claude-skills

All 92 skills in this repo
  • Runs a human-first workflow for labeling PII spans in a transcript, then scores inter-annotator agreement and drafts an adjudicated gold set.

    391 GitHub stars~1.3k tokensUpdated 3 days ago
    Auto-check passed
  • Automates a dedicated, logged-in Chrome instance per profile without ever closing the user's own open tabs or browser windows.

    391 GitHub stars~973 tokensUpdated 3 days ago
    Auto-check passed
  • Deep Research

    glebis/claude-skills

    This skill should be used when conducting comprehensive research on any topic using the OpenAI Deep Research API.

    391 GitHub stars~2.6k tokensUpdated 3 days ago
    Auto-check: notes
  • Elimination Research

    glebis/claude-skills

    This skill should be used for elimination-style research where the user wants to choose from a shortlist of products, tools, services, vendors, or other options using explicit criteria, numeric…

    391 GitHub stars~1.6k tokensUpdated 3 days ago
    Auto-check passed
  • Narrated HTML Presentations

    glebis/claude-skills

    Generates a self-contained HTML presentation with article and slides modes, ElevenLabs voiceover narration and optional GPT Image 2 illustrations.

    391 GitHub stars~2.3k tokensUpdated 3 days ago
    Auto-check: notes
  • Writes fictional but realistic coaching or therapy session transcripts for evals, demos and few-shot examples, in several modalities and export formats.

    391 GitHub stars~2.9k tokensUpdated 3 days ago
    Auto-check passed

Questions about The Goal Automation Diagnostic

What does The Goal Automation Diagnostic do?

Walks through Goldratt's Five Focusing Steps to find the real bottleneck in your work, then recommends one automation aimed at it and a list of what not to automate. Before you build a skill, loop or schedule, this skill runs an interactive diagnostic of your work system, asking one focused question at a time. The agent turns your answers into structured inputs, and two bundled Python scripts then rank the candidate constraints and choose an autonomy rung, so those calls come from scoring rather than free-form judgment.

When should I use The Goal Automation Diagnostic?

The Goal Automation Diagnostic fits situations like: deciding what to automate with agents when several ideas compete; reviewing a pile of half-useful automations that leave you busy but stuck; checking whether a planned skill, loop or schedule is worth building; running a periodic review of where agent effort is going.

How do I install The Goal Automation Diagnostic in Claude Code?

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

How do I install The Goal Automation Diagnostic in Codex?

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

Can I use The Goal Automation Diagnostic 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 glebis/claude-skills --skill the-goal -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/the-goal, .gemini/skills/the-goal, .github/skills/the-goal and .opencode/skills/the-goal in your project.

What does The Goal Automation Diagnostic need to run?

Going by SKILL.md and its folder, The Goal Automation Diagnostic needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python for the bundled scoring scripts.

Does The Goal Automation Diagnostic 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 The Goal Automation Diagnostic 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does The Goal Automation Diagnostic use?

The Goal Automation Diagnostic 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 The Goal Automation Diagnostic use?

About 2k tokens (SKILL.md is roughly 8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.6k tokens, read only when the agent opens those files.

What are the alternatives to The Goal Automation Diagnostic?

Skills that share tags, products or a category with The Goal Automation Diagnostic: CEO Plan Review (garrytan/gstack, 136k stars), Cc Best Practices (aiskillstore/marketplace, 433 stars), Tandem Workflow Plan Mode (hashgraph-online/awesome-codex-plugins, 1.3k stars) and Gdpr Remediation Roadmap (mukul975/Privacy-Data-Protection-Skills, 301 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains The Goal Automation Diagnostic?

glebis (a GitHub user) maintains it in glebis/claude-skills, which has 391 GitHub stars. The repository holds 92 skills in this directory. The repository was last updated on October 8, 2026.

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