Installs just this skill. Get the whole plugin for auto-invocation.
⚡ How it fires
How this skill gets triggered: by you, by Claude, or both.
Fires itselfClaude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/octopus-quick
👁️ Context preview
The summary Claude sees to decide when to auto-load this skill.
Quick execution for ad-hoc tasks without full workflow overhead — use for small, self-contained requests
📊 Stats
Stars3,869
Forks362
LanguageShell
LicenseMIT
📦 Ships with octo
</> SKILL.md
octopus-quick.SKILL.md
---name: octopus-quick
description: "Quick execution for ad-hoc tasks without full workflow overhead — use for small, self-contained requests"
---> **Host: Codex CLI** — This skill was designed for Claude Code and adapted for Codex.
> Cross-reference commands use installed skill names in Codex rather than `/octo:*` slash commands.
> Use the active Codex shell and subagent tools. Do not claim a provider, model, or host subagent is available until the current session exposes it.
> For host tool equivalents, see `skills/blocks/codex-host-adapter.md`.
# Quick Mode - Lightweight Task Execution ⚡
Fast-track execution for small tasks that don't need full Double Diamond workflow overhead.
## When to Use Quick Mode
### ✅ Use Quick Mode For:
**Bug Fixes:**
- One-file bug fixes with known solution
- Typo corrections
- Logic error fixes
- Import/export corrections
**Configuration Changes:**
- Update environment variables
- Modify config files
- Adjust settings
- Update dependencies
**Small Refactorings:**
- Rename variables/functions
- Extract helper functions
If during execution you realize the task is more complex than expected:
**Stop and escalate to full workflow:**
```
This task is more complex than anticipated. I recommend using the full
workflow instead:
- For research: /octo:discover "research authentication patterns"
- For planning: /octo:define "define auth requirements"
- For building: /octo:develop "implement auth system"
- For validation: /octo:deliver "validate auth implementation"
Would you like me to switch to a full workflow?
```
**Indicators to escalate:**
- Multiple files need changes
- Requires architectural decisions
- Needs research or comparison
- Security implications
- Performance implications
- Breaking changes
## Directory Structure
Quick mode creates summaries in a dedicated directory:
```
.claude-octopus/
└── quick/
├── 20260129-143045-summary.md
├── 20260129-150122-summary.md
└── 20260129-161530-summary.md
```
Each summary includes:
- Task description
- Changes made
- Files modified
- Commit hash
- Timestamp
## Comparison: Quick Mode vs Full Workflow
| Aspect | Quick Mode ⚡ | Full Workflow 🐙 |
|--------|-------------|------------------|
| **Time** | 1-3 minutes | 5-15 minutes |
| **Cost** | Claude only | Claude plus available external providers |
| **Providers** | 1 (Claude) | Available provider fleet |
| **Research** | None | Comprehensive |
| **Planning** | None | Detailed |
| **Validation** | Basic | Multi-AI review |
| **Best For** | Simple fixes | Complex features |
| **When to Use** | Known solution | Unknown solution |
## Best Practices
### DO:
- ✅ Use quick mode for straightforward tasks
- ✅ Create descriptive commit messages
- ✅ Generate summaries for audit trail
- ✅ Update state even in quick mode
- ✅ Escalate to full workflow if complexity increases
### DON'T:
- ❌ Use quick mode for new features
- ❌ Skip commits (always commit atomically)
- ❌ Skip state updates (maintain consistency)
- ❌ Use quick mode for security-sensitive changes
- ❌ Force quick mode when full workflow is appropriate
## Troubleshooting
### "Quick mode is taking too long"
→ Task is probably too complex. Escalate to full workflow.
### "Change broke tests"
→ Quick mode assumes simple, safe changes. Use full workflow for risky changes.
### "Need to research best approach"
→ Quick mode is for known solutions only. Use /octo:discover for research.
### "Multiple files need changes"
→ Consider /octo:develop for coordinated multi-file changes.
## Summary
Quick mode is the right tool for simple, straightforward tasks with known solutions. It provides fast execution while maintaining essential tracking and documentation.
For everything else, use the full Double Diamond workflow to ensure quality through multi-AI orchestration.
**Remember: Fast is good, but correct is better. When in doubt, use the full workflow.**
