MCPInstall

thinking-circle-of-competence

Use when a specific claim may lack grounding. Check evidence boundary, size wrongness cost, then answer, fetch, or abstain — never confabulate.

Installs
577
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/tjboudreaux/cc-thinking-skills --skill thinking-circle-of-competence
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads thinking-circle-of-competence automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Circle of Competence

Treat competence as an evidence boundary, not self-image. Answer only when grounded; otherwise fetch, mark uncertainty, or abstain. The failure mode is a fluent fabrication treated as fact.

When to Use

  • About to assert a specific fact (API, path, number, config, version behavior) without a citable source from this session.
  • The claim is about this codebase or system and you have not read or run the relevant artifact.
  • Pattern reconstruction would sound complete but is unconfirmed.
  • Cost of a wrong confident answer is material (security, data, irreversible action, trust).

When NOT to Use

  • Claim is grounded in something you read, ran, or can cite this session, or is stable universal knowledge — answer without false humility.
  • Error cost is trivial and reversible and you will flag the claim as unverified.
  • Grounding is one cheap fetch away — fetch first; abstention is not an excuse to skip a check.
  • User explicitly wants labeled brainstorming or hypotheticals.

Procedure

  1. Name the claim. Isolate the assertion that would be treated as fact.
  2. Classify the zone.
    • Grounded: citeable session source (read/run) or stable non-version-specific knowledge.
    • Partial: general shape known; version/repo/config detail unconfirmed.
    • Ungrounded: would invent a concrete value with no source.
  3. Size wrongness cost. If high-stakes (security, data loss, irreversible ops), treat Partial as Ungrounded until verified.
  4. Act by zone.
    • Grounded → answer; cite when useful; do not hedge verified facts.
    • Partial → cheap fetch then answer; else answer only with explicit uncertainty and a check path.
    • Ungrounded → fetch if possible; else ask or abstain with what would enable an answer. Never invent.
  5. Refuse competence creep. Adjacent code, prior versions, or general capability do not ground the unread target.
  6. Stop. Emit answer, fetch request, or abstention. Do not round "probably" to a flat assertion.

Stop condition: Claim answered with grounding, marked partial with a check path, or refused with missing-evidence note.

Output

Claim: <assertion>
Zone: grounded | partial | ungrounded
Evidence: <source or none>
Wrongness cost: low | medium | high
Action: answer | fetch-then-answer | answer-with-uncertainty | abstain/ask
Response: <wording or missing artifact>

Verification

  • Falsify if a specific value was asserted with no session source and no uncertainty marker.
  • Falsify if Partial/high-stakes was treated as Grounded, or a cheap fetch was skipped for abstention theater.
  • Over-application guard: do not hedge or refuse claims verified this session.

FAQ

What does the thinking-circle-of-competence skill do?

Use when a specific claim may lack grounding. Check evidence boundary, size wrongness cost, then answer, fetch, or abstain — never confabulate.

How do I install thinking-circle-of-competence?

Run npx skills add https://github.com/tjboudreaux/cc-thinking-skills --skill thinking-circle-of-competence in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/thinking-circle-of-competence/ (personal) or .claude/skills/thinking-circle-of-competence/ (project).

Which AI agents can use thinking-circle-of-competence?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is thinking-circle-of-competence safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains thinking-circle-of-competence?

It is published by tjboudreaux in tjboudreaux/cc-thinking-skills. It has 577 recorded installs.

More from tjboudreaux/cc-thinking-skills

View all →

thinking-first-principles

tjboudreaux/cc-thinking-skills

When a constraint is treated as fixed, separate physics from convention, keep only independently supported primitives, and rebuild the simplest solution that satisfies real constraints.

thinking-red-team

tjboudreaux/cc-thinking-skills

For authorized security review of code, auth, or APIs you control, model the attacker, map the attack surface, and report only findings with a reproducible exploit path and verified mitigation.

Backend & APIs674 installs

thinking-pre-mortem

tjboudreaux/cc-thinking-skills

Before committing to a plan or launch, assume it already failed and reason backward through concrete causes — convert failure paths into mitigations, gates, and stop checks.

thinking-theory-of-constraints

tjboudreaux/cc-thinking-skills

When throughput or latency is pipeline-limited, identify the single binding constraint and exploit, subordinate, elevate, then recheck—ignore non-constraints.

649 installs

thinking-socratic

tjboudreaux/cc-thinking-skills

When a request is vague, assumption-laden, or "obvious," ask the few load-bearing questions that expose hidden requirements before building or committing.

631 installs

thinking-opportunity-cost

tjboudreaux/cc-thinking-skills

Before committing scarce time, people, or money, name the best forgone use of those resources and the value delta of the chosen path versus that alternative.

616 installs

Popular other skills

View category →

hyperframes-cli

heygen-com/hyperframes

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

1.3M installs

triage

mattpocock/skills

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs