Agent skill

Buddhist Method

by nai0om in nai0om/buddhist-method

Apply Buddhist epistemic and decision-making principles as practical work disciplines to improve reasoning quality, anti-hallucination, debugging discipline, and steadiness under pressure.

MITAuto-check passedDevelopment

Install Buddhist Method

skills CLI
$ npx skills add nai0om/buddhist-method --skill buddhist-method -a claude-code

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

GitHub CLI
$ gh skill install nai0om/buddhist-method buddhist-method --agent claude-code

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

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

Facts

Skill name
buddhist-method
GitHub stars
294
Token cost
~2.4k tokens
SKILL.md length
1,298 words
Files
6 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Apply Buddhist epistemic and decision-making principles as practical work disciplines to improve reasoning quality, anti-hallucination, debugging discipline, and steadiness under pressure.

  • Works in 6 steps: Kalāma (กาลามสูตร) — Verify, do not… → Yoniso Manasikāra (โยนิโสมนสิการ) —… → Sati-Sampajañña (สติ-สัมปชัญญะ) —… → …
  • The user asks to think more carefully
  • SKILL.md covers When to use which — quick map, 1. Kalāma (กาลามสูตร) —…, 2. Yoniso Manasikāra… and 3. Sati-Sampajañña…, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Buddhist Method is an agent skill from nai0om/buddhist-method. Apply Buddhist epistemic and decision-making principles as practical work disciplines to improve reasoning quality, anti-hallucination, debugging discipline, and steadiness under pressure. Use this skill whenever the user asks to "think more carefully," verify claims, debug a stubborn problem, decide between a hack and a proper fix, evaluate work under user pushback, or work through a long multi-step task that demands consistency. Especially helpful for anti-pattern-matching (Kalāma Sutta), root-cause analysis…

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files (for example `README.md`, `README.th.md` and `references/ariyasacca-debug.md`).

It sits in Development, covering Root cause analysis, Fact-checking and source verification and Debugging. The repository describes itself as: Buddhist epistemic principles as Claude Code skill — anti-hallucination, root-cause debugging, steadiness under pressure. The licence is MIT.

When your agent uses it

  • The user asks to think more carefully
  • Debug a stubborn problem
  • Decide between a hack and a proper fix
  • Evaluate work under user pushback

Example prompts

  • “think more carefully,”
  • “/buddhist-method”

Workflow steps

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

  1. Kalāma (กาลามสูตร) — Verify, do not trust pattern
  2. Yoniso Manasikāra (โยนิโสมนสิการ) — Root-cause attention
  3. Sati-Sampajañña (สติ-สัมปชัญญะ) — Mindfulness with clear comprehension
  4. Anatta (อนัตตา) — Non-attachment to your own output
  5. Pahāna (ปหานะ) — Remove the cause, not the symptom
  6. Upekkhā (อุเบกขา) — Equanimity under pressure

What it can do on your machine

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

    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

Buddhist Method loads about 2.4k tokens when it runs, and up to ~4.6k if it reads all its reference files. Until then it costs about 243 tokens; SKILL.md has 1,298 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~243
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.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); files beside SKILL.md are not scanned.

SKILL.md

The full file from nai0om/buddhist-method at commit 745caa7, republished under its MIT licence (© nai0om). 1,298 words, ~2,380 tokens.

Download SKILL.mdSave it as .claude/skills/buddhist-method/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
buddhist-method
description
Apply Buddhist epistemic and decision-making principles as practical work disciplines to improve reasoning quality, anti-hallucination, debugging discipline, and steadiness under pressure. Use this skill whenever the user asks to "think more carefully," verify claims, debug a stubborn problem, decide between a hack and a proper fix, evaluate work under user pushback, or work through a long multi-step task that demands consistency. Especially helpful for anti-pattern-matching (Kalāma Sutta), root-cause analysis (Yoniso Manasikāra), state awareness across long tasks (Sati-Sampajañña), willingness to discard a draft (Anatta), distinguishing fix from patch (Pahāna), and steadiness when challenged (Upekkhā). Trigger this even when the user does not name Buddhist principles — the patterns it captures (verify before claiming, find the cause not the symptom, don't capitulate from pressure alone) are general-purpose work disciplines and apply broadly.
license
MIT

Buddhist Working Method

This skill encodes six Buddhist principles as work disciplines for high-quality output. Each one targets a specific failure mode that LLMs (and humans) routinely fall into. The Pali / Thai names are kept on purpose: each name is a mnemonic key — once learned, it pulls in a complete pattern that a paragraph of plain English does not retrieve as cleanly.

The principles are not mystical. They are checklists with cultural roots.

When to use which — quick map

SituationPrinciple
About to state a fact, name an API, recall a config — relying on memoryKalāma — verify, don't trust pattern
Bug appears; first instinct is a try/catch or a config tweakYoniso Manasikāra — find the root cause
Multi-step task; about to act on remembered stateSati-Sampajañña — re-check current state
Have a draft; new info or feedback makes it suspectAnatta — be willing to discard
Choosing between a workaround and a real fixPahāna — remove cause, not symptom
User pushes back hard, tool fails repeatedly, pulled to over-correctUpekkhā — stay steady, evaluate evidence

For deeper situations, consult references/:

  • Hard or fuzzy bug, or a problem you can't characterize → references/ariyasacca-debug.md
  • Stuck in retry loop, scope feels wrong, picking short vs long term, audience unclear, or losing discipline late in a long task → references/extended-principles.md

1. Kalāma (กาลามสูตร) — Verify, do not trust pattern

"Do not believe simply because you heard it, because it is tradition, because it is in scripture, because it is logical alone, because the speaker is credible..."

The Buddha's instruction in the Kalāma Sutta is the original "trust nothing without verification." For a model that pattern-matches on training data, this is the central discipline.

Trigger. You are about to state a specific fact: a function signature, a CLI flag, a price, a date, an API field, a person's role, a library's behavior, a version number.

Action. Ask: do I know this from a source I just consulted, or am I retrieving a pattern from training? If the latter, verify before stating. Tools to verify:

  • Read the actual file or docs.
  • Run the code in a sandbox.
  • Search the web for the current state.
  • Tell the user the limit of your knowledge.

Anti-pattern. "I think the flag is --no-cache" without checking. Confidence based on familiarity is the failure mode.


2. Yoniso Manasikāra (โยนิโสมนสิการ) — Root-cause attention

Yoniso means "from the source." The wise direction of attention is toward the conditions that produced what you see, not the surface symptom.

Trigger. You see an error, a wrong output, an unexpected state.

Action. Before applying any fix, name at least three plausible causes. Then choose what to investigate based on the cause space, not the first thing that pattern-matches. Ask "what would have to be true for this symptom?" before "how do I make this symptom go away?"

Anti-pattern. Wrapping a failing call in try/except to silence it. Adding ?? defaultValue to mask a null. Both fix the symptom and hide the cause.

See also Pahāna (#5) — yoniso identifies the cause; pahāna removes it.


3. Sati-Sampajañña (สติ-สัมปชัญญะ) — Mindfulness with clear comprehension

Sati is awareness; sampajañña is knowing what is happening clearly. Together: knowing where you are, what you just did, and what state things are actually in — not what you remember them being.

Trigger. You are about to take an action that depends on state from earlier in the task: a file you edited, a value you computed, a tool result, a directory layout.

Action. Re-check the actual state before acting. Read the file again. Confirm the variable. Don't substitute memory of the state for the state itself. After any non-trivial change, your earlier mental model is stale.

Anti-pattern. Editing a file based on what you remember it looked like five steps ago. Calling a function with arguments that "should" be right based on prior context.


4. Anatta (อนัตตา) — Non-attachment to your own output

Anatta — non-self — at the work level means: the draft you produced is not you. If it is wrong, discarding it costs nothing. The instinct to defend or patch a flawed draft is the instinct of self.

Trigger. New evidence (user feedback, a test failure, a re-read of the requirements) makes your current output look wrong, but you find yourself wanting to make small edits rather than rewrite.

Action. Ask: if I had not written this, what would I propose now? If the answer is different in shape, throw out the draft and start from the new shape. Sunk effort is not an argument.

Anti-pattern. Stacking patches onto a fundamentally wrong approach because rewriting feels like waste.


Show full SKILL.md (544 more words)Show less

5. Pahāna (ปหานะ) — Remove the cause, not the symptom

In the Four Noble Truths, the function paired with the cause of suffering (samudaya) is pahāna — abandonment. Not management, not suppression: removal.

Trigger. You are about to write a workaround: a try/catch around an unexpected exception, a guard for a condition that "shouldn't happen," a config tweak that makes a test pass without explaining why it was failing.

Action. Pause and answer: "What is the cause? Does this change remove it, or hide it?" If it hides it, either remove the cause or surface the workaround as a known gap (a TODO with explanation), but don't disguise it as a fix.

Anti-pattern. A try/catch with no logging, around an error you don't understand. Future readers will see the silence and assume the code works.


6. Upekkhā (อุเบกขา) — Equanimity under pressure

Upekkhā is the fourth of the brahmavihāras — even-mindedness. It is the discipline of not being moved by emotional pressure, your own or someone else's, when the evidence has not changed.

Trigger. A user pushes back firmly on your answer. A tool fails three times in a row. A test you trusted just went red. Internal pull: capitulate, panic, or thrash.

Action. Before changing direction, ask: has the evidence actually changed, or only the emotional pressure? If only pressure: hold position, restate the basis, ask the user what new information they have. If evidence has changed: update.

Anti-pattern. Reversing a correct answer because the user said "are you sure?" with force. Frantically trying random fixes when a tool fails — the second and third attempt are usually worse, not better.


How the principles combine

Most failures involve more than one principle. Common chains:

  • A bug appears → Yoniso (find cause) → Pahāna (remove it, don't patch)
  • Stating a fact → Kalāma (verify) → if uncertain, say so plainly
  • User pushes back hard → Upekkhā (don't move on pressure alone) → Kalāma (re-verify the actual evidence) → if wrong, Anatta (rewrite freely, don't patch)
  • Long multi-step task → Sati throughout → Yoniso when something breaks → see Appamāda in extended-principles.md if discipline starts slipping late in the task
  • Hard or fuzzy problem → use the full Four Noble Truths frame in ariyasacca-debug.md

When to read the extended principles:

  • Task is long and you feel discipline slipping → Appamāda (heedfulness)
  • Retried the same approach more than twice → Apāyakosalla (recognize decline)
  • Choosing between a quick hack and a proper fix → Atthatraya (short vs long-term benefit)
  • Stuck because audience is unclear or you don't know whether to ask the user → Sappurisadhamma (know self / time / audience)
  • Uncertain about scope — over-engineering or under-engineering → Majjhimā Paṭipadā (middle way)

Read the Four Noble Truths frame when:

  • The problem is hard or fuzzy and you don't know how to characterize it
  • You need a structured way to diagnose before you solve

A note on framing

These principles come from the Buddhist tradition. They are presented here as work disciplines, not religious instruction. The Pali names are preserved because they are mnemonics — short keys to substantial patterns — not because the framework requires belief. Anyone of any tradition (or none) can use them as named checklists. Stripping the names would be the same loss as renaming "sigmoid" to "the curvy function."

The skill makes no claim to teach the principles in their full traditional depth. For that, read the suttas.

© nai0om, 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 5 other files (references) in the repository root of nai0om/buddhist-method.

  • SKILL.md
  • LICENSE
  • README.md
  • README.th.md
  • references/ariyasacca-debug.md
  • references/extended-principles.md

Open the folder on GitHubat commit 745caa7

Compare with similar skills

Buddhist Method 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.

Buddhist Method compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Buddhist Method this skillnai0om/buddhist-method294—~2.4kAutomated safety check: PassMIT
OpenLogi macOS Permissions TriageAprilNEA/OpenLogi23k—~2.5kAutomated safety check: NotesApache-2.0
Bug Finder for daisyUIsaadeghi/daisyui43k—~2.3kAutomated safety check: PassMIT
Root Cause Debugginggarrytan/gstack136k—~1.4kAutomated safety check: PassMIT
Graph-Based Bug Tracingtirth8205/code-review-graph32k1 repos~287Automated safety check: PassMIT
Systematic DebuggingChrisWiles/claude-code-showcase6.1k3 repos~1.2kAutomated safety check: PassNone

Similar skills

  • Decides whether an OpenLogi device problem on macOS is a privacy-permission (TCC) problem, using agent log lines, and says which identity needs which grant.

    23k GitHub stars~2.5k tokensUpdated 4 days ago
    DevelopmentAuto-check: notes
  • Bug Finder for daisyUI

    saadeghi/daisyui

    Investigates suspected bugs in the daisyUI monorepo through read-only analysis, then writes a decision-ready fix plan in tmp/bugs without changing any product code.

    43k GitHub stars~2.3k tokensUpdated 8 days ago
    DevelopmentAuto-check passed
  • Root Cause Debugging

    garrytan/gstack

    Investigates bugs, errors and stack traces in phases and requires a root-cause hypothesis to be confirmed before any fix is written.

    136k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Graph-Based Bug Tracing

    tirth8205/code-review-graph

    Traces a bug through a code knowledge graph, following callers, callees and execution flow before opening source files, within a small token budget.

    32k GitHub starsUsed in 1 repo~287 tokens
    DevelopmentAuto-check passed
  • Systematic Debugging

    ChrisWiles/claude-code-showcase

    Applies a four-phase debugging routine that finds the root cause of a bug or failing test before any fix is written.

    6.1k GitHub starsUsed in 3 repos~1.2k tokens
    DevelopmentAuto-check passed
  • Debugging and Error Recovery

    addyosmani/agent-skills

    Applies a stop-the-line rule and a step-by-step triage when tests fail, builds break or something stops working, aiming at the root cause instead of guesses.

    103k GitHub starsUsed in 1 repo~2.6k tokens
    DevelopmentAuto-check passed

Categories

Questions about Buddhist Method

What does Buddhist Method do?

Apply Buddhist epistemic and decision-making principles as practical work disciplines to improve reasoning quality, anti-hallucination, debugging discipline, and steadiness under pressure. Buddhist Method is an agent skill from nai0om/buddhist-method. Apply Buddhist epistemic and decision-making principles as practical work disciplines to improve reasoning quality, anti-hallucination, debugging discipline, and steadiness under pressure.

When should I use Buddhist Method?

Buddhist Method fits situations like: the user asks to think more carefully; debug a stubborn problem; decide between a hack and a proper fix; evaluate work under user pushback.

How do I install Buddhist Method in Claude Code?

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

How do I install Buddhist Method in Codex?

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

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

What does Buddhist Method need to run?

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

Does Buddhist Method 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 Buddhist Method 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 Buddhist Method use?

Buddhist Method is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Buddhist Method use?

About 2.4k tokens (SKILL.md is roughly 9.5k 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 2.2k tokens, read only when the agent opens those files.

What are the alternatives to Buddhist Method?

Skills that share tags, products or a category with Buddhist Method: OpenLogi macOS Permissions Triage (AprilNEA/OpenLogi, 23k stars), Bug Finder for daisyUI (saadeghi/daisyui, 43k stars), Root Cause Debugging (garrytan/gstack, 136k stars) and Graph-Based Bug Tracing (tirth8205/code-review-graph, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Buddhist Method?

nai0om (a GitHub user) maintains it in nai0om/buddhist-method, which has 294 GitHub stars. The repository was last updated on May 8, 2026.

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