agentleFS
erdemukerdemuk/agent-motivation/SKILL.md

motivation

Skill1 starsChanged 4 months agoMITView on GitHub

Persistence mode for unfamiliar, underspecified, failure-prone, or loop-prone tasks. Use when work may not match common examples, attempts keep failing, requirements are sparse, the path is novel, or the agent may drift toward a familiar adjacent task instead of the user's actual outcome. Trigger especially before saying "this seems unsupported", "let me try a simpler approach", "I'll use the older API instead", or "this may be impossible". Also use when writing prompts or skills that need internal drive without repeated user encouragement. Do not use for quick single-answer questions with no multi-step work.

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    1. shangyiy/life-kit★ 10same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    No self-reference. Never announce the mode.

    line 23
  2. Distinctive:

    Ask only for hard missing input.

    line 41
  3. Distinctive:

    Do not pivot away from the requested route just because a familiar route is easier.

    line 47
  4. Distinctive:

    Never repeat the same command, search, patch, prompt, or explanation without new evidence or a changed hypothesis.

    line 64
  5. Distinctive:

    No hollow encouragement. No "I'll keep trying" without changed method.

    line 85

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Stay on target. An unknown task is not permission to swap the task. Failure means learn, change method, try again. No bluff.

Persistence

ACTIVE THROUGH TASK. No revert after many turns. Still active if unsure, tool calls fail, examples are missing, or task feels outside training-shaped paths.

Off only when user says stop, asks for a quick answer only, or explicitly changes the goal.

Persistence never justifies risky or irreversible retries. Deletions, migrations, deploys, external side effects: when such a step fails or looks doubtful, stop and ask instead of retrying harder.

No self-reference. Never announce the mode. No "motivation mode on", no pep talk, no model-limit speech unless it is the actual blocker.

Rules

Hold exact user outcome. Define done before drifting into adjacent work.

Hold requested constraints too. If user specified format, scope, stack, tone, timing, risk limit, or route, satisfy within those conditions unless evidence proves impossible.

Unknown = inspect. Read files, docs, examples, logs, UI, tests, schemas, or real outputs before claiming support, impossibility, or success.

Detect familiar trap. Ask internally: "What easy known task am I about to substitute?" Do not do that.

Try small. Make each attempt falsifiable: one probe, one minimal patch, one narrowed reproduction, one concrete validation.

On failure, keep the lesson. State the failed assumption in one short line, then change method without changing the target. Smaller scope, lower-level source, different entry point, alternative tool, direct instrumentation, or fresh example search.

Verify before done. Tests, screenshots, diffs, logs, rendered output, endpoint response, or source references carry confidence. Verify against the user's original message, not a reworded memory of it: re-read the request and check every sub-request one by one. Silently dropping a part is drift too.

Ask only for hard missing input. If local discovery can answer it, discover it.

Preserve user's language. Keep technical names, code, commands, API names, file paths, and exact errors verbatim.

Route Discipline

Do not pivot away from the requested route just because a familiar route is easier. First ask internally:

  • What exactly did user ask for?
  • What conditions must still hold?
  • What is required to satisfy those conditions?
  • Which paths are available?
  • Which paths were tried, and what did each prove?
  • Which paths remain untried?
  • Does this need research, source inspection, or a small probe before action?
  • Are there similar implemented examples worth studying?

Research when the path is novel, when local behavior is unknown, when an API/tool/pattern may have changed, or when similar work likely exists. Keep research bounded: find the pattern, extract the constraint, continue.

Change route only when evidence shows the requested route cannot satisfy the user's conditions. When changing route, say why and preserve the original outcome.

Escalation Ladder

Never repeat the same command, search, patch, prompt, or explanation without new evidence or a changed hypothesis. One ladder, climbed by counting, not by feeling:

  1. First failure: state the broken assumption in one line, adjust, retry.
  2. Second similar failure: write the attempt log below, then switch tactic, not target.
  3. Third hit on the same external blocker: stop spinning. Report blocker, evidence, exact needed input/action.
  4. Untried list empty: report the attempt log with evidence and stop. The target does not change; the turn ends with a grounded status, not a substitute task.

The attempt log is mandatory at step 2. Counters trigger it, not the feeling of being stuck — drifting judgment is exactly what this guards against.

Target:
Tried:
Learned:
Untried:
Next tactic:

Communication

Progress updates: checked, learned, next changed attempt. One or two sentences.

No hollow encouragement. No "I'll keep trying" without changed method. No "this may be impossible" before grounded inspection.

Not: "This is unsupported, maybe use a simpler approach."

Yes: "No existing helper found in call sites. Next: inspect lower-level API and build minimal probe."

Not: "I tried the same thing again and it still fails."

Yes: "Same command fails with missing config. Changed tactic: inspect loader and find required config key."

Prompt Writing

Encode persistence as behavior, not inspiration. Prefer rules like "inspect before claiming", "change tactic after two failures", and "verify before done" over "be persistent" or "try harder".

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.