auto-context
Automatically read relevant context before major actions. Loads TODO.md, roadmap.md, handoffs, task plans, and other project context files so the AI operates with full situational awareness. Use when starting a task, implementing a feature, refactoring, debugging, planning, or resuming a session.
Why use this skill?
Enhance your AI agent's situational awareness with the auto-context skill. Automatically read TODOs, roadmaps, and project plans to ensure alignment.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/wpank/auto-contextWhat This Skill Does
Auto-context is a foundational meta-skill for the OpenClaw agent designed to maintain peak situational awareness. It functions as an automated intelligence gathering phase that executes before major actions, ensuring the agent is fully informed about the current project state. By scanning standardized project files like TODO.md and roadmap.md, the agent avoids common pitfalls such as redundant work, conflicting implementations, or ignoring active constraints. It bridges the gap between disconnected tasks by synthesizing project history, recent handoffs, and documented findings into a coherent mental model.
Installation
To integrate this skill into your environment, run the following command in your terminal:
npx clawhub@latest install auto-context
This will pull the latest version from the OpenClaw registry and configure the necessary file watchers for your project root.
Use Cases
- Feature Development: Automatically pull the current task plan and project roadmap before writing new code to ensure alignment with architectural goals.
- Refactoring: Gather insights from
CHANGELOG.mdandfindings.mdto avoid breaking recent fixes or ignoring established technical debt. - Debugging: Load recent session notes and handoffs to immediately grasp the context of an issue without starting research from scratch.
- Task Transitions: Seamlessly switch between different development tasks by refreshing the context window with the latest project metadata.
Example Prompts
- "Auto-context: Prepare the workspace to implement the new OAuth authentication flow based on the existing task plan."
- "Update my situational awareness using auto-context, then summarize the top three blockers listed in the roadmap."
- "Refactor the user profile controller, but first run auto-context to see if there are any specific findings or warnings regarding the database schema."
Tips & Limitations
- Proactive Usage: Do not wait for prompts; configure your agent to trigger this whenever it enters a new command cycle.
- File Maintenance: This skill relies on the quality of your project documentation. Ensure your
TODO.mdandroadmap.mdare kept up to date for maximum efficiency. - Fallback Awareness: If your project structure deviates from standard conventions, ensure you define the secondary file paths in your agent config so the skill can locate your documentation across nested directories.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-wpank-auto-context": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-read
Related Skills
mermaid-diagrams
Create software diagrams using Mermaid syntax. Use when users need to create, visualize, or document software through diagrams including class diagrams, sequence diagrams, flowcharts, ERDs, C4 architecture diagrams, state diagrams, git graphs, and other diagram types. Triggers include requests to diagram, visualize, model, map out, or show the flow of a system.
api-design-principles
Skill by wpank
clear-writing
Write clear, concise prose for humans — documentation, READMEs, API docs, commit messages, error messages, UI text, reports, and explanations. Combines Strunk's rules for clearer prose with technical documentation patterns, structure templates, and review checklists.
compare-pools
Compare all Uniswap pools for a token pair across fee tiers and versions. Use when the user asks which pool is best, wants to compare V3 vs V4, or wants to find the optimal fee tier.
track-performance
Track the performance of Uniswap LP positions over time — check which positions need attention, are out of range, or have uncollected fees. Use when the user asks how their positions are doing.