⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

v0.1.0

hoist-the-elephant

jinhanbuilds@jinhanbuilds⭐ 102 stars· last commit 2mo ago· 0 open issues

仅在用户明确调用 `$hoist-the-elephant` 时使用。把因连续纠正和局部过拟合而偏离主线的长对话拉回正轨:暂停当前推进,回溯对话中真正支配任务的目标和已经形成的认识,重新建立后续工作的依据。

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐⭐⭐ 102 on GitHubGitHub ↗

Popular

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

Hoist the Elephant

简体中文

An explicit-only Agent Skill for re-anchoring a long conversation that has drifted through repeated local corrections.

When the elephant starts wobbling, stop pushing it. Hoist it.

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.

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.

Read the full product story in Chinese.

When to use it

Invoke it when:

  • every recent correction sounds right, but the result feels increasingly wrong;
  • the Agent oscillates between two extremes;
  • one bad example is turning into a growing set of permanent rules;
  • accepted and rejected ideas have accumulated until the mainline is unclear;
  • execution remains competent, but you suspect it is competently heading in the wrong direction.

One-line install

npx skills add jinhanbuilds/hoist-the-elephant --skill hoist-the-elephant -y

This package follows the Agent Skills 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.

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.

Reopen the Agent host after installation, then invoke it explicitly:

$hoist-the-elephant

The Skill intentionally disables implicit invocation. Re-anchoring changes the basis of the active conversation, so the user should decide when to call it.

What happens next

The Agent should:

  1. Stop extending the current solution.
  2. Reread the relevant conversation rather than trusting a short recap.
  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.
  4. Explain how local correction drift occurred only when doing so would help prevent another drift.
  5. Restate the governing mainline with enough signal to guide the next response.
  6. Pause and ask the user to confirm or correct the recovered anchor.

It does not automatically resume implementation after the reset.

Boundaries

  • It is not a generic summary or a request to return to the earliest message.
  • It does not assume the oldest or newest instruction is automatically correct.
  • It does not create a persistent memory, mission file, task database, or new project plan.
  • It does not erase earlier work or modify source files.
  • It does not silently choose a new direction; the user confirms the recovered mainline.

Package contents

  • skills/hoist-the-elephant/ — the complete runtime Skill.
  • docs/product-story.zh-CN.md — the original independent product story and mechanism.
  • .codex-plugin/plugin.json — optional OpenAI/ChatGPT/Codex Plugin metadata.
  • scripts/ and tests/ — package validation, reproducible release building, and maintainer-only local installation sync.

Status and validation

Latest release: v0.1.0.

npm run validate
npm test
npm run build

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.

License

MIT © 2026 Jinhan

// HOW IT'S BUILT

// FILES

2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • skills/hoist-the-elephant/SKILL.md1.7 KBupstream ↗
    ---
    name: hoist-the-elephant
    description: "仅在用户明确调用 `$hoist-the-elephant` 时使用。把因连续纠正和局部过拟合而偏离主线的长对话拉回正轨:暂停当前推进,回溯对话中真正支配任务的目标和已经形成的认识,重新建立后续工作的依据。"
    ---
    
    # Hoist the Elephant
    
    长对话会让再强的模型也像一头踩着球的大象:每次纠正都会改变重心,最后可能从一个极端倒向另一个极端。
    
    调用本 Skill 时:
    
    1. **停止**
    
       不要继续修改、补充或执行当前方案,先摆脱最近局部思路的惯性。
    
    2. **回溯**
    
       从整体目的向下重新阅读相关对话。依据用户实际表达,恢复这件事真正要实现什么、此前已经认可和否决了什么,并区分必须保持的目标与原则和可以改变的实现选择。
    
       如果相关历史不可见、互相冲突或不足以确定主线,明确指出真正影响定锚的未知或冲突,并请用户纠正;不要用推断填满缺口。
    
    3. **重新定锚**
    
       重新陈述找到的主线,使它足以成为后续工作的当前依据。只在有助于避免再次偏离时说明局部纠正怎样带偏了方向;不要机械总结历史,也不要套用固定栏目。
    
       不以简短或完整为目标;以正确的主线能否重新支配后续对话为目标。
    
    4. **确认**
    
       陈述完成后停止,等待用户确认或纠正。确认之前不要继续原任务。
    
    这里的“第一性原理”是用户真正要解决的问题及其成功标准,不是模型重新发明的一套理论。最早和最新的表达都不自动拥有最高权重;以完整对话中能够确认的用户意图为依据。
    
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/jinhanbuilds-hoist-the-elephant-skills-hoist-the-elephant.md

// REPO STATS

102 stars
0 open issues
Last commit: 2mo ago