diegosouzapw/awesome-omni-skill / skills/ai-agents/agent-ops-impl-details
agent-ops-impl-details
VerifiedExtract, plan, or propose implementation details at configurable depth levels (low/normal/extensive). Outputs to reference files for team discussion and handoff.
Implementation Details
Generate detailed implementation specifications at varying depths.
Reference: See REFERENCE.md for templates, examples, and output formats.
Depth Levels
| Level | Name | Includes | Use Case |
|---|---|---|---|
| 1 | low | Files, approach, dependencies, risks | Quick alignment |
| 2 | normal | + Signatures, pseudo-code, data structures | Technical review |
| 3 | extensive | + Actual executable code, edge cases, tests | Formal spec |
Auto-Selection by Confidence
| Confidence | Level | Override |
|---|---|---|
| LOW | extensive (mandatory) | No |
| NORMAL | normal | Yes |
| HIGH | low | Yes |
LOW confidence requires extensive details with actual executable code.
Modes
Extract Mode
Document existing code to understand how it works.
Input: File path or symbol name
Procedure:
- Identify target (file or symbol)
- Analyze at requested level
- Generate reference file:
.agent/issues/references/{context}-impl-extract.md
Plan Mode
Generate implementation details for planned changes.
Input: Issue ID (e.g., FEAT-0083@c5f3e7)
Procedure:
- Read issue requirements and acceptance criteria
- Analyze affected code
- Generate details at requested level
- Create reference file:
.agent/issues/references/{ISSUE-ID}-impl-plan.md - Link from issue's
spec_filefield
Propose Mode
Suggest implementation approach for a conceptual change.
Input: Description of desired change
Procedure:
- Identify affected areas
- Generate approach options
- Create proposal file:
.agent/issues/references/{context}-impl-proposal.md
Output Sections
All levels include:
- Summary: One-paragraph overview
- Files Affected: Table of files and actions
- Approach: Technical rationale
Normal adds:
- Detailed Changes: Function signatures, code locations
- Dependencies: What this requires/enables
- Risks: Potential issues with mitigations
Extensive adds:
- Complete Implementation: Full executable code
- Edge Cases: Table of cases and handling
- Test Cases: Complete test functions
Invocation
# Extract existing code
/agent-impl-details extract src/services/auth.ts --level normal
# Plan for issue
/agent-impl-details plan FEAT-0083@c5f3e7 --level extensive
# Propose approach
/agent-impl-details propose "Add rate limiting to API" --level low
Confidence Indicators
Output should include:
## Confidence Indicators
### ✅ High Confidence
- All files identified
- Clear API contracts
### ⚠️ Uncertainty
- {Area}: {Why}
### ❓ Blockers
- {Question needing answer}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 468k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |