widen-return-type v2A

Immutable. This exact content is served forever at /api/v1/blob/fc8bbfa734acf4cb.

---
name: widen-return-type
description: widen return type
triggers:
  - widen return type
  - opt-in tool map
  - feature flag gating
  - tool registration
generated_from_knowledge: []
source_knowledge_ids: []
generated_at: 2026-07-02T02:11:00.606Z
confidence: 0.60
status: active
version: 2
skill_origin: generated
---

<!-- generated by opencode-swarm skill-generator. Do not edit by hand; edits will be preserved on regeneration only with controlled update mode. -->

# widen return type

## Trigger

- widen return type
- opt-in tool map
- feature flag gating
- tool registration

## Required Procedure

- use TypeScript overloads to preserve narrow return types when widening a function's return type for extensibility
- mirror existing opt-in pattern: separate tool map constant, conditional merge in agents/index.ts, gating tests verifying disabled and enabled states

## Forbidden Shortcuts

- invent new tool-gating mechanisms for opt-in feature flags

## Delegation Template

When delegating a task affected by this skill, include:

```
SKILLS: file:.opencode/skills/generated/widen-return-type/SKILL.md
```

## Reviewer Checks

- Verify each required action above appears in the diff.</item>