plugins/cache/nyldn-plugins/octo/9.30.0/skills/skill-knowledge-work/SKILL.md
Switch to Knowledge Work mode for research and writing — use when task is non-code focused
npx skillsauth add moliboy5000/.claude skill-knowledge-workInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Claude Octopus now auto-detects work context! The system analyzes your prompt and project to determine whether you're in a Dev Context (code-focused) or Knowledge Context (research/strategy-focused).
You typically don't need this skill - context is detected automatically when you use:
octo research X - Auto-detects dev vs knowledge researchocto build X - Auto-detects code vs document buildingocto review X - Auto-detects code vs document reviewUse ONLY when auto-detection is wrong:
/octo:km on
All subsequent workflows will use Knowledge Context until reset.
/octo:km off
All subsequent workflows will use Dev Context until reset.
/octo:km auto
Context detection returns to automatic mode.
/octo:km
Shows current mode (auto, knowledge, or dev).
When you use any octo workflow, context is detected by analyzing:
Prompt Content (strongest signal):
Project Type (secondary signal):
package.json, Cargo.toml, go.mod → Dev Context.md, .docx, .pdf files → Knowledge ContextExplicit Override (if set via /octo:km):
When workflows run, you'll see the detected context in the banner:
Dev Context:
🐙 **CLAUDE OCTOPUS ACTIVATED** - Multi-provider research mode
🔍 [Dev] Discover Phase: Technical research on caching patterns
Knowledge Context:
🐙 **CLAUDE OCTOPUS ACTIVATED** - Multi-provider research mode
🔍 [Knowledge] Discover Phase: Market analysis for APAC expansion
User: "octo research caching strategies for our Node.js API"
Claude: (auto-detects Dev Context from "Node.js API")
🐙 **CLAUDE OCTOPUS ACTIVATED** - Multi-provider research mode
🔍 [Dev] Discover Phase: Technical research on caching strategies
[Researches with technical/implementation focus]
User: "octo research market opportunities in healthcare AI"
Claude: (auto-detects Knowledge Context from "market opportunities")
🐙 **CLAUDE OCTOPUS ACTIVATED** - Multi-provider research mode
🔍 [Knowledge] Discover Phase: Strategic research on healthcare AI market
[Researches with business/strategic focus]
User: "octo research React patterns"
Claude: (auto-detects Dev) 🔍 [Dev] Discover Phase...
User: "Actually, this is for a presentation. Force knowledge mode."
Claude: "Setting context override to Knowledge Mode."
/octo:km on
User: "octo research React patterns"
Claude: (uses override) 🔍 [Knowledge] Discover Phase... (focuses on trends, adoption, strategic implications)
User: "What context mode am I in?"
Claude:
Current mode: Auto-detection (no override set)
Last detected context: Dev (based on project having package.json)
To override: /octo:km on (force Knowledge) or /octo:km off (force Dev)
To return to auto: /octo:km auto
| Workflow | Focus |
|----------|-------|
| octo research X | Technical implementation, libraries, code patterns |
| octo build X | Code generation, architecture, tests |
| octo review X | Code quality, security, performance |
| Agents | codex, backend-architect, code-reviewer, security-auditor |
| Workflow | Focus |
|----------|-------|
| octo research X | Market analysis, competitive research, literature synthesis |
| octo build X | PRDs, strategy docs, presentations, reports |
| octo review X | Document quality, argument strength, completeness |
| Agents | strategy-analyst, ux-researcher, exec-communicator, product-writer |
After running knowledge workflows, export to professional formats:
Just say: "Export this to Word" or "Create a PowerPoint presentation"
| Command | Description |
|---------|-------------|
| /octo:km | Show current status (auto, on, or off) |
| /octo:km on | Force Knowledge Context for all workflows |
| /octo:km off | Force Dev Context for all workflows |
| /octo:km auto | Return to auto-detection (default) |
Don't override if:
Override is for:
At the end of significant work sessions, extract learnings:
Store learnings in .claude-octopus/learnings/<date>-<summary>.json:
{
"date": "2026-03-21",
"task_type": "debugging",
"approach": "Traced the error from the test failure back to the API handler",
"outcome": "success",
"lesson": "Always check middleware ordering before investigating handler logic"
}
Each learning file captures: task_type, approach, outcome, and lesson.
At session start, check for relevant learnings:
.claude-octopus/learnings/ directory/octo:discover - Research workflow (auto-detects context)/octo:develop - Build workflow (auto-detects context)/octo:deliver - Review workflow (auto-detects context)/octo:docs - Document export (works in both contexts)tools
MANDATORY prerequisite — load this skill BEFORE every `generate_diagram` tool call. NEVER call `generate_diagram` directly without loading this skill first. Trigger whenever the user asks to create, generate, draw, render, sketch, or build a diagram — flowchart, architecture diagram, sequence diagram, ERD or entity-relationship diagram, state diagram or state machine, gantt chart, or timeline. Also trigger when the user mentions Mermaid syntax or wants a system architecture, decision tree, dependency graph, API call flow, auth handshake, schema, or pipeline visualized in FigJam. Routes to type-specific guidance, sets universal Mermaid constraints, and tells you when to use a different diagram type or skip the tool entirely (mindmaps, pie charts, class diagrams, etc.).
development
DEFAULT PIPELINE for all tasks requiring execution. You (Claude) are the strategic orchestrator. Codex agents are your implementation army - hyper-focused coding specialists. Trigger on ANY task involving code, file modifications, codebase research, multi-step work, or implementation. This is NOT optional - Codex agents are the default for all execution work. Only skip if the user explicitly asks you to do something yourself.
development
This skill should be used when the user asks to analyze a UI screen recording and map interaction states into Figma. Trigger for requests such as "put video frames in Figma", "extract states from my recording", "map interactions from video to Figma", "analyze this screen recording", "create a storyboard from my video", "deconstruct this interaction in Figma", "annotate the UI states in my recording", or "pull the key moments from this video into Figma". Also trigger when the user references a video file (.mp4, .mov, .webm, .avi) together with Figma, design review, interaction analysis, prototypes, or UI states. The skill extracts key visual moments from a video, infers interaction triggers, and builds an annotated Figma Design storyboard using native Figma annotations and uploaded screenshot assets.
development
Generate a FigJam project plan board from a PRD plus codebase context. Interactive flow: research → propose sections → per-section deep research → per-section content + block-shape proposal → create FigJam → skeleton → fill → diagrams → wrap. Each content block (section, nested section, intro callout, table, multi-column text, sticky column, diagram section, metadata strip) has its own subskill reference file. Use when the user asks for 'project plan in FigJam', 'interactive project plan', '/generate-project-plan', or provides a PRD and wants per-section confirmation on content + rendering.