hoist-the-elephant

Name: hoist-the-elephant
Author: jinhanbuilds

Pending

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

50stars

0forks

JavaScript

Installation

# Add to your Claude Code skills
git clone https://github.com/jinhanbuilds/hoist-the-elephant

Getting Started

Guides for using ai agents skills like hoist-the-elephant.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

README.md

Frequently Asked Questions

What is hoist-the-elephant?

hoist-the-elephant is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by jinhanbuilds. Re-anchor long conversations that drift through repeated local corrections. It has 50 GitHub stars.

Is hoist-the-elephant safe to use?

hoist-the-elephant's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.

How do I install hoist-the-elephant?

Clone the repository with "git clone https://github.com/jinhanbuilds/hoist-the-elephant" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is hoist-the-elephant written in?

hoist-the-elephant is primarily written in JavaScript. It is open-source under jinhanbuilds on GitHub, so you can review or fork the full source.

Are there alternatives to hoist-the-elephant?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh hoist-the-elephant against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

244,886

general-readme-skill imark

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.

Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.

Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.

Read the Terms of Service

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:

Stop extending the current solution.
Reread the relevant conversation rather than trusting a short recap.
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.
Explain how local correction drift occurred only when doing so would help prevent another drift.
Restate the governing mainline with enough signal to guide the next response.
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.