ACE Analysis Skill
Analyzes AI agent sessions using ACE (Agentic Context Engineering) framework.
Purpose
Evaluate session quality and generate improvement suggestions for prompts, skills, and commands.
Triggers
/ace-reflectcommand- Session analysis requests
- Prompt optimization tasks
Workflow
1. Collect Session Data
Preferred: om-session plugin tools
session-list → get recent sessions
session-read → get messages from session
Fallback: OpenCode CLI
opencode session list -n 10 --format json
Last resort: Direct context analysis (current conversation)
2. Determine Analysis Mode
| Mode | Flag | Scope |
|---|---|---|
| Default | (none) | Text analysis, 2-3 findings |
| Verbose | --verbose |
Deeper analysis, more findings |
| Technical | --technical |
Include IDs, timestamps, tool stats |
| Full | --full |
Complete analysis with all metadata |
3. Analyze Session Content
Focus on patterns, not individual mistakes:
- Response quality (clarity, accuracy, completeness)
- Tool usage efficiency (redundant calls, missing tools)
- Context management (pruning, distillation)
- Workflow adherence (approval gates, context loading)
4. Score Session
Use scoring rubric from references/scoring-rubric.md:
| Criterium | Weight | Focus |
|---|---|---|
| Completeness | 5 | All requested tasks completed |
| Accuracy | 5 | Correct solutions, no hallucinations |
| Efficiency | 5 | Minimal iterations, good tool usage |
| Clarity | 5 | Clear communication, good structure |
| Relevance | 5 | On-topic, no unnecessary tangents |
Max Score: 25
5. Generate Report
Use template from references/report-template.md:
- Summary (1-2 sentences)
- Scores table
- Findings (patterns, not individual mistakes)
- Suggestions (specific, actionable)
- Decision (no changes / review / changes recommended)
6. Return to Orchestrator
Return formal report for presentation to user.
References
references/report-template.md- Report structurereferences/scoring-rubric.md- Detailed scoring criteria
Error Handling
| Situation | Action |
|---|---|
| No session data | Analyze current context directly |
| Plugin unavailable | Use CLI fallback |
| Subagent spawn fails | Analyze in current context |
Configuration
features:
ace:
enabled: true
max_subagent_depth: 2
auto_apply_suggestions: false