Skill: karatla/opencode-controller (version 1.0.0)

--- name: opencode-controller description: Control and operate Opencode via slash commands. Use this skill to manage sessions, select models, switch agents (plan/build), and coordinate coding through Opencode. --- # Opencode Controller ## Core rule Clawdbot does not write code. All planning and coding happens inside Opencode. ## Pre-flight - Ask the user which AI provider to use. - Ask how the provider should be authenticated. - Do not proceed without confirmation. ## Session management - Start Opencode. - Open session selector using: /sessions - If the current project already exists: - Select the existing session. - Never create a new session without user approval. ## Agent (mode) control - Open agent selector using: /agents - Available agents: - Plan - Build - Always select Plan first. - Switch agents whenever required using `/agents`. ## Model selection - Open model selector using: /models - Select the user-requested provider. - If authentication is required: - Copy the login link provided by Opencode. - Send it to the user. - Wait for confirmation before continuing. ## Plan agent behavior - Ask Opencode to analyze the task. - Request a clear step-by-step plan. - Allow Opencode to ask clarification questions. - Review the plan carefully. - If the plan is incorrect or incomplete: - Ask Opencode to revise it. - Do not allow code generation in Plan. ## Build agent behavior - Switch to Build using `/agents`. - Ask Opencode to implement the approved plan. - If Opencode asks any question: - Immediately switch back to Plan. - Answer and confirm the plan. - Switch back to Build. ## Completion - Repeat the Plan → Build loop until all user requirements are satisfied. - Never skip Plan. - Never answer questions in Build. ## Output format - Show all slash commands explicitly. - State which option is selected. - Provide login links verbatim.

path: references/command-cheatsheet.md
content: ## Core Opencode commands

- Start Opencode:
  opencode

- Session selection:
  /sessions

- Agent (mode) selection:
  /agents

- Model selection:
  /models


path: references/failure-handling.md
content: ## Common failures and responses

### Login link does not work
- Ask the user to retry
- Do not proceed without confirmation

### Model not available
- Inform the user
- Ask for an alternative provider

### Plan is unclear or contradictory
- Ask Opencode to rewrite the plan
- Do not switch to Build mode


path: references/model-selection.md
content: ## Model selection procedure

- Open model selector with:
  /models

- Select the provider requested by the user

### Auth-based providers (e.g. OpenAI)

- Opencode will generate a login URL
- Copy the URL exactly
- Send it to the user
- Wait for confirmation before continuing

Never assume authentication is complete.


path: references/plan-vs-build.md
content: ## Plan mode

- Thinking only
- Planning
- Asking questions
- Revising approach
- No code generation

## Build mode

- Code implementation
- Execution of approved plan

### Mode switching

- Use the Tab key to toggle modes
- Always start in Plan mode


path: references/question-handling.md
content: ## Handling questions from Opencode

- If Opencode asks a question:
  - Switch to Plan mode immediately
  - Answer carefully
  - Confirm or revise the plan

Never answer questions in Build mode.


path: references/session-management.md
content: ## Session rules

- Opencode keeps a history of projects
- The same project must always use the same session
- Reusing sessions preserves context and decisions
- Starting a new session is allowed only if the user explicitly asks
- Open session selector using:
  /sessions

If unsure, ask the user before creating a new session.


path: references/workflow.md
content: ## Standard workflow

1. Confirm AI provider and auth method with the user
2. Start Opencode
3. Reuse existing project session if present
4. Select AI model using `/models`
5. Ensure Plan mode
6. Generate and validate plan
7. Switch to Build mode
8. Implement
9. Handle interruptions by returning to Plan mode
10. Repeat until finished


path: assets/operator-prompts.md
content: ### Ask for provider
Which AI provider do you want to use in Opencode?

### Ask for auth
How should Opencode authenticate (auth, key, local)?

### Plan request
Analyze the task and propose a step-by-step plan. Ask clarification questions if needed.

### Plan revision
The plan has issues. Please revise it.

### Build request
Proceed with implementation based on the approved plan.


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)