Skip to content
Back to search

hoist-the-elephant

Re-anchor long conversations that drift through repeated local corrections.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jinhanbuilds--hoist-the-elephant/badge.svg)](/listings/jinhanbuilds--hoist-the-elephant)

HTML

<a href="/listings/jinhanbuilds--hoist-the-elephant"><img src="/api/listings/jinhanbuilds--hoist-the-elephant/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 85 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Hoist the Elephant
  2. [简体中文](README.zh-CN.md)
  3. An explicit-only Agent Skill for re-anchoring a long conversation that has drifted through repeated local corrections.
  4. > **When the elephant starts wobbling, stop pushing it. Hoist it.**
  5. In a long conversation, each correction can be reasonable on its own while the overall direction moves farther from the real goal. The Agent responds to the latest feedback, overcorrects, gets corrected again, and gradually lets a local problem replace the higher-level mission.
  6. Hoist the Elephant interrupts that momentum. It rereads the relevant conversation, restores the user-owned mission and accumulated understanding, separates governing principles from adjustable implementation choices, then pauses for confirmation before the original task continues.
  7. [Read the full product story in Chinese](docs/product-story.zh-CN.md).
  8. ## When to use it
  9. Invoke it when:
  10. - every recent correction sounds right, but the result feels increasingly wrong;
  11. - the Agent oscillates between two extremes;
  12. - one bad example is turning into a growing set of permanent rules;
  13. - accepted and rejected ideas have accumulated until the mainline is unclear;
  14. - execution remains competent, but you suspect it is competently heading in the wrong direction.
  15. ## One-line install
  16. ```bash
  17. npx skills add jinhanbuilds/hoist-the-elephant --skill hoist-the-elephant -y
  18. ```
  19. This package follows the [Agent Skills specification](https://agentskills.io/specification). The command above uses the cross-host `skills` CLI; add `--agent <host>` when you need to select a supported host explicitly. For a manual install, copy `skills/hoist-the-elephant/` into a directory your host scans, such as `~/.agents/skills/hoist-the-elephant/` where the shared convention is supported.
  20. The core `SKILL.md` is host-neutral. `skills/hoist-the-elephant/agents/openai.yaml` and `.codex-plugin/plugin.json` are optional OpenAI/ChatGPT/Codex metadata; compatible non-OpenAI hosts may ignore them. Re-anchoring requires access to the relevant conversation history; when that history is unavailable or conflicting, the Skill reports the gap instead of reconstructing it.
  21. Reopen the Agent host after installation, then invoke it explicitly:
  22. ```text
  23. $hoist-the-elephant
  24. ```
  25. The Skill intentionally disables implicit invocation. Re-anchoring changes the basis of the active conversation, so the user should decide when to call it.
  26. ## What happens next
  27. The Agent should:
  28. 1. Stop extending the current solution.
  29. 2. Reread the relevant conversation rather than trusting a short recap.
  30. 3. Recover the real mission, accumulated understanding, hard constraints, preferences, and rejected directions; if the visible history is insufficient or conflicting, state the gap and ask the user to correct it rather than pretending the mainline is complete.
  31. 4. Explain how local correction drift occurred only when doing so would help prevent another drift.
  32. 5. Restate the governing mainline with enough signal to guide the next response.
  33. 6. Pause and ask the user to confirm or correct the recovered anchor.
  34. It does not automatically resume implementation after the reset.
  35. ## Boundaries
  36. - It is not a generic summary or a request to return to the earliest message.
  37. - It does not assume the oldest or newest instruction is automatically correct.
  38. - It does not create a persistent memory, mission file, task database, or new project plan.
  39. - It does not erase earlier work or modify source files.
  40. - It does not silently choose a new direction; the user confirms the recovered mainline.
  41. ## Package contents
  42. - `skills/hoist-the-elephant/` — the complete runtime Skill.
  43. - `docs/product-story.zh-CN.md` — the original independent product story and mechanism.
  44. - `.codex-plugin/plugin.json` — optional OpenAI/ChatGPT/Codex Plugin metadata.
  45. - `scripts/` and `tests/` — package validation, reproducible release building, and maintainer-only local installation sync.
  46. ## Status and validation
  47. Latest release: **[v0.1.0](https://github.com/jinhanbuilds/hoist-the-elephant/releases/tag/v0.1.0)**.
  48. ```bash
  49. npm run validate
  50. npm test
  51. npm run build
  52. ```
  53. Package checks establish structural integrity. Real value should be evaluated on long conversations where local corrections have actually created drift, using the user's confirmation of the recovered mainline as the central acceptance signal.
  54. ## License
  55. [MIT](LICENSE) © 2026 Jinhan

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.