# affirmations

A skill for an agent stuck in a loop: it reads a short set of affirmations, re-checks what it actually knows, and takes one small step.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 242 installs · ★ 31 repo stars
- Author: 101-skills
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/101-skills/superpowers/tree/HEAD/guides/agent/affirmations/SKILL.md
- Updated: 2026-08-31
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/affirmations

## What it does

The skill is a markdown file the agent opens on itself once the signs show up: the same patch attempted again, a refactor whose end state it can no longer describe, or more apologies than code edits. The lines inside are written in the second person and meant to be read in order, before the next tool call rather than after it.

A three-step reset follows. List only what has been observed: file contents, command output, error text. Then name the assumption nobody tested and run the smallest possible check of it. The rules section says to drop the abandoned theory in one clause and stop discussing it, and to give the user one sentence of acknowledgement at most.

The skill addresses the agent's state, not the problem's subject. The bug will still be there. A reset only counts when the next action differs from the previous one, so repeating the last attempt just lengthens the loop by a turn. Reaching for it on the first obstacle wastes it the other way.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add 101-skills/superpowers --skill affirmations -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/affirmations/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/affirmations/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add 101-skills/superpowers --skill affirmations -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/affirmations/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add 101-skills/superpowers --skill affirmations -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/affirmations/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install 101-skills/superpowers guides/agent/affirmations
```

2. **Manually: put the files in place**
- File: `.github/skills/affirmations/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add 101-skills/superpowers --skill affirmations -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/101-skills/superpowers --path guides/agent/affirmations
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/affirmations/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add 101-skills/superpowers --skill affirmations -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/101-skills/superpowers/tree/HEAD/guides/agent/affirmations/SKILL.md

## When to use it
- break out of a loop where the same fix keeps returning
- surface the assumption the agent never tested
- regain the thread halfway through a refactor
- trade repeated apologies for actual code changes
- drop an approach the agent has been defending

## Example prompts
- You've patched this file three times now. Read the affirmations and restart from what the output actually says.
- We're going in circles — re-ground: what's verified, and which assumption is untested?
- Skip the apology. Name what the command output proves and test that assumption with one small step.

## Similar
- [claude-code-guide](https://affpapa.org/en/nevibecode/skills/claude-code-guide.md) — skill · 905 installs
- [gpt-5-4-prompting](https://affpapa.org/en/nevibecode/skills/gpt-5-4-prompting.md) — skill · 742 installs
- [steno-mode](https://affpapa.org/en/nevibecode/skills/steno-mode.md) — skill · 32 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [ketchup](https://affpapa.org/en/nevibecode/skills/ketchup.md) — skill · 7900 installs
- [gravitas](https://affpapa.org/en/nevibecode/skills/gravitas.md) — skill · 6800 installs

From the same set: [101-skills/superpowers](https://affpapa.org/en/nevibecode/by/101-skills/superpowers.md) — 81 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
