define-purpose

define-purpose is a skill for Claude Code from clomia/claude-automata. It costs 16 tokens per session (572 once invoked), scanned A, original, Apache-2.0.

A guided writing tool for creating a purpose file: a document that states the ongoing direction of an autonomous coding-agent loop. Unlike a mission, a purpose has no finish condition and continues until explicitly stopped.

In plain words
What is it for?
Use it to question the user, define the agent’s role and direction, and save the result as an anchor document for a ploop launch.
Why use it?
It helps an agent decide what work to pursue over time when there is no single final deliverable. The file also records the allowed boundaries and decision criteria.

Skill for Claude Code

Written for Claude Code: disable-model-invocation in frontmatter. Also seen: mentions CLAUDE.md.

Part of the ploop plugin — 6 skills, 2 agents, 5 hooks shipped together

Good fit Use it to question the user, define the agent’s role and direction, and save the result as an anchor document for a ploop launch.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/clomia/claude-automata/define-purpose
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add clomia/claude-automata --skill define-purpose
Clone the repo
git clone --depth 1 https://github.com/clomia/claude-automata

Made for: Claude Code.

Or install ploop, the plugin that ships this one along with the rest of its 6 skills, 2 agents, 5 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for define-purpose

README.md
[![agentmods](https://agentmods.dev/badge/skills/clomia/claude-automata/define-purpose/github.svg)](https://agentmods.dev/skills/clomia/claude-automata/define-purpose)
Your own site
<a href="https://agentmods.dev/skills/clomia/claude-automata/define-purpose"><img src="https://agentmods.dev/badge/skills/clomia/claude-automata/define-purpose/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for define-purpose

Your own site · 80×15
<a href="https://agentmods.dev/skills/clomia/claude-automata/define-purpose"><img src="https://agentmods.dev/badge/skills/clomia/claude-automata/define-purpose.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 16 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 572 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00016 $0.00572
Opus 5 $0.00008 $0.00286
Sonnet 5 $0.00003 $0.00114
Haiku 4.5 $0.00002 $0.00057

Measured 9d ago against content hash 0ef8d2c9a2ac, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

define-purpose scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/ploop/skills/define-purpose/SKILL.md · 34 lines

What it actually says

Anchor file save path: $ARGUMENTS or ANCHOR.md

ploop(advisor loop)은 agent가 오랜 시간 자율적으로 작업하는 loop다. anchor는 그 loop를 붙들어 매는 기준 파일로, context가 유실되어도 항상 원문 그대로 보존된다.

Purpose는 완료 조건 없이 방향만 가진다. agent는 Purpose로부터 스스로 요구사항을 만들며 나아가야 한다. advisor를 소집하면 방향·Constraint 대비 상태를 감사받는다. purpose loop는 스스로 멈추지 않는다 — /ploop:off가 끝이다.

Instructions

  1. 사용자를 추궁해 생각과 의도를 최대한 수집하라 — 열린 질문으로 시작해 여러 번의 질의응답을 거쳐라.
    • [CRITICAL] 사용자의 주장을 사실로 수용하지 마라. False assumption이 가장 위험하다. 사용자의 말은 생각이나 의도로 해석하라.
  2. 수집한 정보를 판단 기준으로 쓸 수 있는 축으로 종합하고, Anchor file save path에 markdown 형식으로 purpose를 작성하라.
  3. 사용자가 anchor를 최종 검수하게 하라 — 내용을 모두 출력하지 말고 파일 확인을 요청하라.
  4. 완료 후 anchor text를 복사해 별도 session에 /ploop:launch [anchor text] 하라고 안내하라.
    • /ploop:launch는 파일 경로가 아닌 내용을 copy & paste해야 한다.

Purpose 규칙

  • [IMPORTANT] Acceptable boundaries나아갈 방향이 명확히 정의되어야 한다.
    • agent의 역할, 존재 이유를 정의하라.
    • agent가 스스로 할 일을 찾고 판단할 수 있는 기준을 서술하라.
  • harness(CLAUDE.md, rules 등)가 제공하는 내용은 중복이니 anchor에 넣지 마라.
  • ROI(분량 대비 정보)가 높은 문서를 작성하라 — 중요한 단어만 남기고, 작성 후 더 irreducible하게 줄일 수 있는지 재검토하라.
  • 구조는 Background → Purpose → Constraint → Reference 순이다. # Purpose(나아갈 방향)와 # Constraint(허용 범위)는 필수, # Background(방향의 배경)와 # Reference(관련 link — URL·파일 경로)는 선택이며, section은 자유롭게 추가할 수 있다.
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 34 lines · 16 tokens per session scan A 0ef8d2c9a2ac

Subscribe to this mod's changes

define-purpose is a skill published in the GitHub repository clomia/claude-automata (13 stars, last pushed 6d ago), licensed Apache-2.0. It adds 16 tokens to every session and 572 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories