claudecode-omc 5.4.0 → 5.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.local/guidelines/CLAUDE.md +31 -0
- package/README.md +57 -1
- package/bundled/manifest.json +2 -2
- package/bundled/upstream/oh-my-claudecode/agents/analyst.md +1 -1
- package/bundled/upstream/oh-my-claudecode/agents/architect.md +1 -1
- package/bundled/upstream/oh-my-claudecode/agents/code-reviewer.md +1 -1
- package/bundled/upstream/oh-my-claudecode/agents/code-simplifier.md +1 -1
- package/bundled/upstream/oh-my-claudecode/agents/critic.md +1 -1
- package/bundled/upstream/oh-my-claudecode/agents/debugger.md +1 -1
- package/bundled/upstream/oh-my-claudecode/agents/designer.md +1 -1
- package/bundled/upstream/oh-my-claudecode/agents/document-specialist.md +1 -1
- package/bundled/upstream/oh-my-claudecode/agents/executor.md +1 -1
- package/bundled/upstream/oh-my-claudecode/agents/explore.md +1 -1
- package/bundled/upstream/oh-my-claudecode/agents/git-master.md +3 -3
- package/bundled/upstream/oh-my-claudecode/agents/planner.md +1 -1
- package/bundled/upstream/oh-my-claudecode/agents/qa-tester.md +1 -1
- package/bundled/upstream/oh-my-claudecode/agents/scientist.md +1 -1
- package/bundled/upstream/oh-my-claudecode/agents/security-reviewer.md +1 -1
- package/bundled/upstream/oh-my-claudecode/agents/test-engineer.md +1 -75
- package/bundled/upstream/oh-my-claudecode/agents/tracer.md +1 -1
- package/bundled/upstream/oh-my-claudecode/agents/verifier.md +1 -1
- package/bundled/upstream/oh-my-claudecode/agents/writer.md +1 -1
- package/bundled/upstream/oh-my-claudecode/hooks/hooks.json +21 -1
- package/bundled/upstream/oh-my-claudecode/skills/AGENTS.md +200 -0
- package/bundled/upstream/oh-my-claudecode/skills/autopilot/SKILL.md +17 -10
- package/bundled/upstream/oh-my-claudecode/skills/autoresearch/SKILL.md +90 -0
- package/bundled/upstream/oh-my-claudecode/skills/cancel/SKILL.md +15 -6
- package/bundled/upstream/oh-my-claudecode/skills/configure-notifications/SKILL.md +12 -12
- package/bundled/upstream/oh-my-claudecode/skills/debug/SKILL.md +35 -0
- package/bundled/upstream/oh-my-claudecode/skills/deep-dive/SKILL.md +4 -0
- package/bundled/upstream/oh-my-claudecode/skills/deep-interview/SKILL.md +23 -18
- package/bundled/upstream/oh-my-claudecode/skills/hud/SKILL.md +23 -101
- package/bundled/upstream/oh-my-claudecode/skills/learner/SKILL.md +27 -2
- package/bundled/upstream/oh-my-claudecode/skills/mcp-setup/SKILL.md +67 -8
- package/bundled/upstream/oh-my-claudecode/skills/omc-doctor/SKILL.md +32 -47
- package/bundled/upstream/oh-my-claudecode/skills/omc-setup/SKILL.md +4 -2
- package/bundled/upstream/oh-my-claudecode/skills/omc-setup/phases/01-install-claude-md.md +15 -4
- package/bundled/upstream/oh-my-claudecode/skills/omc-setup/phases/02-configure.md +9 -9
- package/bundled/upstream/oh-my-claudecode/skills/omc-setup/phases/03-integrations.md +13 -13
- package/bundled/upstream/oh-my-claudecode/skills/omc-setup/phases/04-welcome.md +3 -3
- package/bundled/upstream/oh-my-claudecode/skills/omc-teams/SKILL.md +28 -0
- package/bundled/upstream/oh-my-claudecode/skills/plan/SKILL.md +1 -0
- package/bundled/upstream/oh-my-claudecode/skills/project-session-manager/SKILL.md +25 -5
- package/bundled/upstream/oh-my-claudecode/skills/project-session-manager/lib/config.sh +2 -15
- package/bundled/upstream/oh-my-claudecode/skills/project-session-manager/lib/providers/github.sh +1 -1
- package/bundled/upstream/oh-my-claudecode/skills/project-session-manager/lib/session.sh +2 -2
- package/bundled/upstream/oh-my-claudecode/skills/project-session-manager/lib/tmux.sh +109 -4
- package/bundled/upstream/oh-my-claudecode/skills/project-session-manager/lib/worktree.sh +26 -0
- package/bundled/upstream/oh-my-claudecode/skills/project-session-manager/psm.sh +46 -5
- package/bundled/upstream/oh-my-claudecode/skills/project-session-manager/templates/pr-review.md +5 -2
- package/bundled/upstream/oh-my-claudecode/skills/project-session-manager/templates/projects.json +1 -1
- package/bundled/upstream/oh-my-claudecode/skills/project-session-manager/tests/test-psm-prompt-injection.sh +336 -0
- package/bundled/upstream/oh-my-claudecode/skills/ralph/SKILL.md +18 -9
- package/bundled/upstream/oh-my-claudecode/skills/ralplan/SKILL.md +2 -0
- package/bundled/upstream/oh-my-claudecode/skills/release/SKILL.md +167 -57
- package/bundled/upstream/oh-my-claudecode/skills/remember/SKILL.md +41 -0
- package/bundled/upstream/oh-my-claudecode/skills/self-improve/SKILL.md +391 -0
- package/bundled/upstream/oh-my-claudecode/skills/self-improve/data_contracts.md +274 -0
- package/bundled/upstream/oh-my-claudecode/skills/self-improve/scripts/plot_progress.py +128 -0
- package/bundled/upstream/oh-my-claudecode/skills/self-improve/scripts/resolve-paths.mjs +192 -0
- package/bundled/upstream/oh-my-claudecode/skills/self-improve/scripts/validate.sh +404 -0
- package/bundled/upstream/oh-my-claudecode/skills/self-improve/si-benchmark-builder.md +79 -0
- package/bundled/upstream/oh-my-claudecode/skills/self-improve/si-goal-clarifier.md +94 -0
- package/bundled/upstream/oh-my-claudecode/skills/self-improve/si-researcher.md +73 -0
- package/bundled/upstream/oh-my-claudecode/skills/self-improve/templates/agent-settings.json +14 -0
- package/bundled/upstream/oh-my-claudecode/skills/self-improve/templates/goal.md +22 -0
- package/bundled/upstream/oh-my-claudecode/skills/self-improve/templates/harness.md +18 -0
- package/bundled/upstream/oh-my-claudecode/skills/self-improve/templates/idea.md +5 -0
- package/bundled/upstream/oh-my-claudecode/skills/self-improve/templates/settings.json +23 -0
- package/bundled/upstream/oh-my-claudecode/skills/skill/SKILL.md +46 -77
- package/bundled/upstream/oh-my-claudecode/skills/skillify/SKILL.md +53 -0
- package/bundled/upstream/oh-my-claudecode/skills/team/SKILL.md +83 -11
- package/bundled/upstream/oh-my-claudecode/skills/trace/SKILL.md +1 -0
- package/bundled/upstream/oh-my-claudecode/skills/ultraqa/SKILL.md +1 -0
- package/bundled/upstream/oh-my-claudecode/skills/ultrawork/SKILL.md +1 -0
- package/bundled/upstream/oh-my-claudecode/skills/verify/SKILL.md +37 -0
- package/bundled/upstream/oh-my-claudecode/skills/wiki/SKILL.md +67 -0
- package/package.json +3 -1
- package/src/cli/artifact.js +47 -0
- package/src/cli/doctor.js +6 -1
- package/src/cli/guidelines.js +83 -0
- package/src/cli/index.js +13 -1
- package/src/cli/setup.js +68 -19
- package/src/cli/source.js +35 -1
- package/src/config/artifact-types.js +12 -2
- package/src/config/paths.js +95 -4
- package/src/config/sources.js +29 -5
- package/src/guidelines/apply.js +152 -0
- package/src/guidelines/optimizer.js +325 -0
- package/src/merge/claude-md-merger.js +35 -12
- package/bundled/upstream/oh-my-claudecode/skills/omc-doctor/skill-debugger.md +0 -101
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
# Coding Discipline
|
|
2
|
+
|
|
3
|
+
These are always-on guardrails for non-trivial coding work.
|
|
4
|
+
|
|
5
|
+
## Think Before Coding
|
|
6
|
+
|
|
7
|
+
- State assumptions that materially affect design, scope, or behavior.
|
|
8
|
+
- Surface ambiguity instead of silently choosing an interpretation.
|
|
9
|
+
- Ask for clarification when missing detail can change the implementation.
|
|
10
|
+
- Prefer the simpler path when it still satisfies the real goal.
|
|
11
|
+
|
|
12
|
+
## Simplicity First
|
|
13
|
+
|
|
14
|
+
- Make the smallest correct change that solves the task.
|
|
15
|
+
- Do not add speculative features, configuration, or extension points.
|
|
16
|
+
- Avoid new abstractions for one-off logic.
|
|
17
|
+
- If the solution expands quickly, step back and simplify it.
|
|
18
|
+
|
|
19
|
+
## Surgical Changes
|
|
20
|
+
|
|
21
|
+
- Change only the files and lines required for the task.
|
|
22
|
+
- Match existing patterns unless the task explicitly requires a new one.
|
|
23
|
+
- Do not refactor adjacent code, comments, or formatting as a drive-by edit.
|
|
24
|
+
- Clean up only unused code introduced by your own change unless asked.
|
|
25
|
+
|
|
26
|
+
## Goal-Driven Execution
|
|
27
|
+
|
|
28
|
+
- Turn vague requests into concrete success criteria.
|
|
29
|
+
- Verify behavior with tests or explicit checks whenever practical.
|
|
30
|
+
- Tie multi-step work to validation at each step.
|
|
31
|
+
- Do not claim completion without fresh evidence from the workspace.
|
package/README.md
CHANGED
|
@@ -19,9 +19,16 @@ omc-manage setup
|
|
|
19
19
|
| Agents | ~19 | oh-my-claudecode + superpowers |
|
|
20
20
|
| Hooks | ~8 | oh-my-claudecode (standalone) |
|
|
21
21
|
| Commands | ~3 | superpowers |
|
|
22
|
+
| Guidelines | 1 | local coding discipline prompt guidelines |
|
|
22
23
|
|
|
23
24
|
All artifacts are installed to `~/.claude/` where Claude Code discovers them automatically.
|
|
24
25
|
|
|
26
|
+
The bundled guidelines install into `~/.claude/CLAUDE.md` and add lightweight
|
|
27
|
+
coding discipline rules
|
|
28
|
+
adapted from [andrej-karpathy-skills](https://github.com/forrestchang/andrej-karpathy-skills):
|
|
29
|
+
think before coding, prefer simple solutions, make surgical changes, and verify
|
|
30
|
+
completion with concrete evidence.
|
|
31
|
+
|
|
25
32
|
## Commands
|
|
26
33
|
|
|
27
34
|
| Command | Description |
|
|
@@ -30,9 +37,11 @@ All artifacts are installed to `~/.claude/` where Claude Code discovers them aut
|
|
|
30
37
|
| `omc-manage doctor` | Health checks |
|
|
31
38
|
| `omc-manage source list` | Show configured sources |
|
|
32
39
|
| `omc-manage source sync` | Update upstream sources to latest |
|
|
33
|
-
| `omc-manage source add <name> <url>` | Add a new source |
|
|
40
|
+
| `omc-manage source add <name> <url>` | Add a new source, including `guidelines` sources |
|
|
34
41
|
| `omc-manage artifact list [--type <type>]` | List merged artifacts |
|
|
35
42
|
| `omc-manage artifact conflicts [--type <type>]` | Show conflict report |
|
|
43
|
+
| `omc-manage guidelines optimize [source...]` | Build maintainer-only guideline optimization artifacts |
|
|
44
|
+
| `omc-manage guidelines apply --result-file <path>` | Apply a maintainer-generated optimization result |
|
|
36
45
|
|
|
37
46
|
## Sources & Priority
|
|
38
47
|
|
|
@@ -50,6 +59,53 @@ mkdir -p ~/.omc-manage/local/skills/my-skill
|
|
|
50
59
|
omc-manage setup --force
|
|
51
60
|
```
|
|
52
61
|
|
|
62
|
+
Add a remote guidelines source:
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
omc-manage source add karpathy https://github.com/forrestchang/andrej-karpathy-skills.git \
|
|
66
|
+
--artifacts guidelines \
|
|
67
|
+
--mapping guidelines=CLAUDE.md \
|
|
68
|
+
--role guidelines
|
|
69
|
+
omc-manage source sync karpathy
|
|
70
|
+
omc-manage setup --type guidelines
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
## Maintainer Guideline Optimization
|
|
74
|
+
|
|
75
|
+
OMC now treats runtime prompt guidance as a first-class `guidelines` artifact,
|
|
76
|
+
but the semantic optimization workflow is maintainer-only. The optimizer does
|
|
77
|
+
not get installed into user Claude Code configs.
|
|
78
|
+
|
|
79
|
+
Build an optimization pack for model-assisted synthesis:
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
omc-manage guidelines optimize
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
This writes maintainer artifacts under `.omc/guidelines/`, including:
|
|
86
|
+
|
|
87
|
+
- `latest/next-steps.md`
|
|
88
|
+
- `latest/optimizer-input.md`
|
|
89
|
+
- `latest/sections.json`
|
|
90
|
+
- `latest/sources.json`
|
|
91
|
+
- `latest/current-local-guidelines.md`
|
|
92
|
+
|
|
93
|
+
If you are driving the repo with Claude Code CLI or Codex, read
|
|
94
|
+
`latest/next-steps.md` first. That file points the agent at the relevant
|
|
95
|
+
maintainer workflow and the runtime file to edit.
|
|
96
|
+
|
|
97
|
+
The repository-only maintainer prompt lives at
|
|
98
|
+
`.maintainer/skills/guideline-optimizer/SKILL.md`. It is intentionally not
|
|
99
|
+
installed into user runtime configs.
|
|
100
|
+
|
|
101
|
+
After the optimization pass updates `.local/guidelines/CLAUDE.md`, reinstall
|
|
102
|
+
with:
|
|
103
|
+
|
|
104
|
+
```bash
|
|
105
|
+
omc-manage guidelines apply --result-file /absolute/path/to/result.json
|
|
106
|
+
omc-manage setup --type guidelines
|
|
107
|
+
```
|
|
108
|
+
|
|
53
109
|
## Update Upstream
|
|
54
110
|
|
|
55
111
|
```bash
|
package/bundled/manifest.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
|
-
"bundledAt": "2026-04-
|
|
2
|
+
"bundledAt": "2026-04-23T09:40:23Z",
|
|
3
3
|
"sources": {
|
|
4
4
|
"anthropic-skills": { "artifacts": 2 },
|
|
5
|
-
"oh-my-claudecode": { "artifacts":
|
|
5
|
+
"oh-my-claudecode": { "artifacts": 21 },
|
|
6
6
|
"superpowers": { "artifacts": 8 }
|
|
7
7
|
}
|
|
8
8
|
}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: code-reviewer
|
|
3
3
|
description: Expert code review specialist with severity-rated feedback, logic defect detection, SOLID principle checks, style, performance, and quality strategy
|
|
4
|
-
model:
|
|
4
|
+
model: opus
|
|
5
5
|
level: 3
|
|
6
6
|
disallowedTools: Write, Edit
|
|
7
7
|
---
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: code-simplifier
|
|
3
3
|
description: Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Focuses on recently modified code unless instructed otherwise.
|
|
4
|
-
model:
|
|
4
|
+
model: opus
|
|
5
5
|
level: 3
|
|
6
6
|
---
|
|
7
7
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: git-master
|
|
3
3
|
description: Git expert for atomic commits, rebasing, and history management with style detection
|
|
4
|
-
model:
|
|
4
|
+
model: sonnet
|
|
5
5
|
level: 3
|
|
6
6
|
---
|
|
7
7
|
|
|
@@ -62,8 +62,8 @@ level: 3
|
|
|
62
62
|
- Format: [semantic (feat:, fix:) / plain / short]
|
|
63
63
|
|
|
64
64
|
### Commits Created
|
|
65
|
-
1.
|
|
66
|
-
2.
|
|
65
|
+
1. `<commit-sha-1>` - [commit message] - [N files]
|
|
66
|
+
2. `<commit-sha-2>` - [commit message] - [N files]
|
|
67
67
|
|
|
68
68
|
### Verification
|
|
69
69
|
```
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: test-engineer
|
|
3
3
|
description: Test strategy, integration/e2e coverage, flaky test hardening, TDD workflows
|
|
4
|
-
model:
|
|
4
|
+
model: sonnet
|
|
5
5
|
level: 3
|
|
6
6
|
---
|
|
7
7
|
|
|
@@ -12,23 +12,6 @@ level: 3
|
|
|
12
12
|
You are not responsible for feature implementation (executor), code quality review (quality-reviewer), or security testing (security-reviewer).
|
|
13
13
|
</Role>
|
|
14
14
|
|
|
15
|
-
<Integration_With_Test_Gen_Skill>
|
|
16
|
-
When user asks to "generate tests" or "add tests", prefer using the `/test-gen` skill:
|
|
17
|
-
|
|
18
|
-
- `/test-gen` handles tech stack detection and complexity analysis automatically
|
|
19
|
-
- For simple code, `/test-gen` generates tests directly using CLI commands
|
|
20
|
-
- For complex code, `/test-gen` will delegate to test-engineer with enriched context (detected stack, complexity metrics)
|
|
21
|
-
- For test strategy and planning, use test-engineer directly
|
|
22
|
-
- For test debugging and flaky test fixes, use test-engineer directly
|
|
23
|
-
|
|
24
|
-
When invoked by `/test-gen` for complex code, you will receive:
|
|
25
|
-
- Detected tech stack (frontend/backend frameworks, test frameworks, databases, APIs)
|
|
26
|
-
- Complexity analysis (function size, cyclomatic complexity, dependencies)
|
|
27
|
-
- Generated test framework (basic structure to build upon)
|
|
28
|
-
|
|
29
|
-
Use this context to generate comprehensive test cases that cover edge cases, error scenarios, and business logic validation.
|
|
30
|
-
</Integration_With_Test_Gen_Skill>
|
|
31
|
-
|
|
32
15
|
<Why_This_Matters>
|
|
33
16
|
Tests are executable documentation of expected behavior. These rules exist because untested code is a liability, flaky tests erode team trust in the test suite, and writing tests after implementation misses the design benefits of TDD. Good tests catch regressions before users do.
|
|
34
17
|
</Why_This_Matters>
|
|
@@ -140,60 +123,3 @@ level: 3
|
|
|
140
123
|
- For TDD: did I write the failing test first?
|
|
141
124
|
</Final_Checklist>
|
|
142
125
|
</Agent_Prompt>
|
|
143
|
-
|
|
144
|
-
## Enhanced Integration with Test Generation System
|
|
145
|
-
|
|
146
|
-
### Automatic Context Enrichment
|
|
147
|
-
|
|
148
|
-
When invoked for test generation, test-engineer receives enriched context:
|
|
149
|
-
|
|
150
|
-
- **Tech Stack**: Detected frameworks, languages, and test tools
|
|
151
|
-
- **Complexity Analysis**: Metrics including cyclomatic complexity, nesting levels, external dependencies
|
|
152
|
-
- **Suggested Approach**:
|
|
153
|
-
- `auto-generate`: Simple code, generate tests automatically
|
|
154
|
-
- `guided`: Complex code, ask user for clarification
|
|
155
|
-
- `manual`: Very complex, provide framework and guidance only
|
|
156
|
-
|
|
157
|
-
### Workflow for Complex Code
|
|
158
|
-
|
|
159
|
-
When complexity is `complex`:
|
|
160
|
-
|
|
161
|
-
1. **Review Context**: Examine complexity metrics and reasons
|
|
162
|
-
2. **Ask Questions**: Use pre-generated questions based on complexity reasons
|
|
163
|
-
3. **Generate Test Framework**: Create test structure with placeholders
|
|
164
|
-
4. **Fill in Details**: Based on user answers, complete test cases
|
|
165
|
-
5. **Verify Coverage**: Ensure all identified complexity factors are tested
|
|
166
|
-
|
|
167
|
-
### Example Invocation
|
|
168
|
-
|
|
169
|
-
```typescript
|
|
170
|
-
const context = await prepareTestEngineerContext({
|
|
171
|
-
filePath: 'src/services/payment.ts',
|
|
172
|
-
code: paymentServiceCode,
|
|
173
|
-
projectRoot: '/project/root',
|
|
174
|
-
});
|
|
175
|
-
|
|
176
|
-
// Context includes:
|
|
177
|
-
// - techStack: { backend: { language: 'nodejs', testFramework: 'vitest' } }
|
|
178
|
-
// - complexity: 'complex'
|
|
179
|
-
// - complexityMetrics: { lines: 75, cyclomaticComplexity: 15, ... }
|
|
180
|
-
// - suggestedApproach: 'guided'
|
|
181
|
-
// - questionsForUser: ['What payment flows...', 'Should I mock...']
|
|
182
|
-
```
|
|
183
|
-
|
|
184
|
-
### Integration with /test-gen Skill
|
|
185
|
-
|
|
186
|
-
The `/test-gen` skill automatically prepares this context before delegating to test-engineer:
|
|
187
|
-
|
|
188
|
-
1. User runs `/test-gen src/services/payment.ts`
|
|
189
|
-
2. System detects tech stack and analyzes complexity
|
|
190
|
-
3. If complex, prepares questions and delegates to test-engineer
|
|
191
|
-
4. Test-engineer asks questions and generates comprehensive tests
|
|
192
|
-
5. System verifies tests and commits
|
|
193
|
-
|
|
194
|
-
### Success Criteria
|
|
195
|
-
|
|
196
|
-
- [ ] Context preparation includes all necessary information
|
|
197
|
-
- [ ] Questions are relevant to complexity reasons
|
|
198
|
-
- [ ] Test-engineer can generate appropriate tests for both simple and complex code
|
|
199
|
-
- [ ] Integration with /test-gen skill is seamless
|
|
@@ -31,6 +31,11 @@
|
|
|
31
31
|
"type": "command",
|
|
32
32
|
"command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/project-memory-session.mjs",
|
|
33
33
|
"timeout": 5
|
|
34
|
+
},
|
|
35
|
+
{
|
|
36
|
+
"type": "command",
|
|
37
|
+
"command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/wiki-session-start.mjs",
|
|
38
|
+
"timeout": 5
|
|
34
39
|
}
|
|
35
40
|
]
|
|
36
41
|
},
|
|
@@ -92,6 +97,11 @@
|
|
|
92
97
|
"type": "command",
|
|
93
98
|
"command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/project-memory-posttool.mjs",
|
|
94
99
|
"timeout": 3
|
|
100
|
+
},
|
|
101
|
+
{
|
|
102
|
+
"type": "command",
|
|
103
|
+
"command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/post-tool-rules-injector.mjs",
|
|
104
|
+
"timeout": 3
|
|
95
105
|
}
|
|
96
106
|
]
|
|
97
107
|
}
|
|
@@ -150,6 +160,11 @@
|
|
|
150
160
|
"type": "command",
|
|
151
161
|
"command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/project-memory-precompact.mjs",
|
|
152
162
|
"timeout": 5
|
|
163
|
+
},
|
|
164
|
+
{
|
|
165
|
+
"type": "command",
|
|
166
|
+
"command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/wiki-pre-compact.mjs",
|
|
167
|
+
"timeout": 3
|
|
153
168
|
}
|
|
154
169
|
]
|
|
155
170
|
}
|
|
@@ -165,7 +180,7 @@
|
|
|
165
180
|
},
|
|
166
181
|
{
|
|
167
182
|
"type": "command",
|
|
168
|
-
"command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/persistent-mode.
|
|
183
|
+
"command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/persistent-mode.mjs",
|
|
169
184
|
"timeout": 10
|
|
170
185
|
},
|
|
171
186
|
{
|
|
@@ -184,6 +199,11 @@
|
|
|
184
199
|
"type": "command",
|
|
185
200
|
"command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/session-end.mjs",
|
|
186
201
|
"timeout": 30
|
|
202
|
+
},
|
|
203
|
+
{
|
|
204
|
+
"type": "command",
|
|
205
|
+
"command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/wiki-session-end.mjs",
|
|
206
|
+
"timeout": 30
|
|
187
207
|
}
|
|
188
208
|
]
|
|
189
209
|
}
|
|
@@ -0,0 +1,200 @@
|
|
|
1
|
+
<!-- Parent: ../AGENTS.md -->
|
|
2
|
+
<!-- Generated: 2026-01-28 | Updated: 2026-03-02 -->
|
|
3
|
+
|
|
4
|
+
# skills
|
|
5
|
+
|
|
6
|
+
30 skill directories for workflow automation and specialized behaviors.
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
|
|
10
|
+
Skills are reusable workflow templates that can be invoked via `/oh-my-claudecode:skill-name`. Each skill provides:
|
|
11
|
+
- Structured prompts for specific workflows
|
|
12
|
+
- Activation triggers (manual or automatic)
|
|
13
|
+
- Integration with execution modes
|
|
14
|
+
|
|
15
|
+
## Key Files
|
|
16
|
+
|
|
17
|
+
### Execution Mode Skills
|
|
18
|
+
|
|
19
|
+
| File | Skill | Purpose |
|
|
20
|
+
|-----------|-------|---------|
|
|
21
|
+
| `autopilot/SKILL.md` | autopilot | Full autonomous execution from idea to working code |
|
|
22
|
+
| `ultrawork/SKILL.md` | ultrawork | Maximum parallel agent execution |
|
|
23
|
+
| `ralph/SKILL.md` | ralph | Persistence until verified complete |
|
|
24
|
+
| `team/SKILL.md` | team | N coordinated agents with task claiming |
|
|
25
|
+
| `ultraqa/SKILL.md` | ultraqa | QA cycling until goal met |
|
|
26
|
+
|
|
27
|
+
### Planning Skills
|
|
28
|
+
|
|
29
|
+
| File | Skill | Purpose |
|
|
30
|
+
|-----------|-------|---------|
|
|
31
|
+
| `plan/SKILL.md` | omc-plan | Strategic planning with interview workflow |
|
|
32
|
+
| `ralplan/SKILL.md` | ralplan | Iterative planning (Planner+Architect+Critic) with RALPLAN-DR structured deliberation (`--deliberate` for high-risk) |
|
|
33
|
+
| `deep-interview/SKILL.md` | deep-interview | Socratic deep interview with mathematical ambiguity gating (Ouroboros-inspired) |
|
|
34
|
+
| `ralph-init/SKILL.md` | ralph-init | Initialize PRD for structured ralph |
|
|
35
|
+
|
|
36
|
+
### Exploration Skills
|
|
37
|
+
|
|
38
|
+
| File | Skill | Purpose |
|
|
39
|
+
|-----------|-------|---------|
|
|
40
|
+
| `deepinit/SKILL.md` | deepinit | Generate hierarchical AGENTS.md |
|
|
41
|
+
| `sciomc/SKILL.md` | sciomc | Parallel scientist orchestration |
|
|
42
|
+
|
|
43
|
+
### Visual Skills
|
|
44
|
+
|
|
45
|
+
| File | Skill | Purpose |
|
|
46
|
+
|-----------|-------|---------|
|
|
47
|
+
| `visual-verdict/SKILL.md` | visual-verdict | Structured visual QA verdict for screenshot/reference comparisons |
|
|
48
|
+
|
|
49
|
+
### Utility Skills
|
|
50
|
+
|
|
51
|
+
| File | Skill | Purpose |
|
|
52
|
+
|-----------|-------|---------|
|
|
53
|
+
| `ai-slop-cleaner/SKILL.md` | ai-slop-cleaner | Regression-safe cleanup workflow for AI-generated code slop |
|
|
54
|
+
| `learner/SKILL.md` | learner | Extract reusable skill from session |
|
|
55
|
+
| `ask/SKILL.md` | ask | Ask Claude, Codex, or Gemini via `omc ask` and capture an artifact |
|
|
56
|
+
| `note/SKILL.md` | note | Save notes for compaction resilience |
|
|
57
|
+
| `cancel/SKILL.md` | cancel | Cancel any active OMC mode |
|
|
58
|
+
| `hud/SKILL.md` | hud | Configure HUD display |
|
|
59
|
+
| `omc-doctor/SKILL.md` | omc-doctor | Diagnose installation issues |
|
|
60
|
+
| `setup/SKILL.md` | setup | Unified setup entrypoint for install, diagnostics, and MCP configuration |
|
|
61
|
+
| `omc-setup/SKILL.md` | omc-setup | One-time setup wizard |
|
|
62
|
+
| `omc-help/SKILL.md` | omc-help | Usage guide |
|
|
63
|
+
| `mcp-setup/SKILL.md` | mcp-setup | Configure MCP servers |
|
|
64
|
+
| `skill/SKILL.md` | skill | Manage local skills |
|
|
65
|
+
|
|
66
|
+
### Domain Skills
|
|
67
|
+
|
|
68
|
+
| File | Skill | Purpose |
|
|
69
|
+
|-----------|-------|---------|
|
|
70
|
+
| `project-session-manager/SKILL.md` | project-session-manager (+ `psm` alias) | Isolated dev environments |
|
|
71
|
+
| `writer-memory/SKILL.md` | writer-memory | Agentic memory for writers |
|
|
72
|
+
| `release/SKILL.md` | release | Generic release assistant — analyzes repo CI/rules, caches in `.omc/RELEASE_RULE.md`, guides the release |
|
|
73
|
+
|
|
74
|
+
## For AI Agents
|
|
75
|
+
|
|
76
|
+
### Working In This Directory
|
|
77
|
+
|
|
78
|
+
#### Skill Template Format
|
|
79
|
+
|
|
80
|
+
```markdown
|
|
81
|
+
---
|
|
82
|
+
name: skill-name
|
|
83
|
+
description: Brief description
|
|
84
|
+
triggers:
|
|
85
|
+
- "keyword1"
|
|
86
|
+
- "keyword2"
|
|
87
|
+
agent: executor # Optional: which agent to use
|
|
88
|
+
model: sonnet # Optional: model override
|
|
89
|
+
pipeline: [skill-name, follow-up-skill] # Optional: standardized multi-skill flow
|
|
90
|
+
next-skill: follow-up-skill # Optional: explicit handoff target
|
|
91
|
+
next-skill-args: --direct # Optional: arguments for the next skill
|
|
92
|
+
handoff: .omc/plans/example.md # Optional: artifact/context handed to next skill
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
# Skill Name
|
|
96
|
+
|
|
97
|
+
## Purpose
|
|
98
|
+
What this skill accomplishes.
|
|
99
|
+
|
|
100
|
+
## Workflow
|
|
101
|
+
1. Step one
|
|
102
|
+
2. Step two
|
|
103
|
+
3. Step three
|
|
104
|
+
|
|
105
|
+
## Usage
|
|
106
|
+
How to invoke this skill.
|
|
107
|
+
|
|
108
|
+
## Configuration
|
|
109
|
+
Any configurable options.
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
#### Skill Invocation
|
|
113
|
+
|
|
114
|
+
```bash
|
|
115
|
+
# Manual invocation
|
|
116
|
+
/oh-my-claudecode:skill-name
|
|
117
|
+
|
|
118
|
+
# With arguments
|
|
119
|
+
/oh-my-claudecode:skill-name arg1 arg2
|
|
120
|
+
|
|
121
|
+
# Auto-detected from keywords
|
|
122
|
+
"autopilot build me a REST API" # Triggers autopilot skill
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
#### Creating a New Skill
|
|
126
|
+
|
|
127
|
+
1. Create `new-skill/SKILL.md` directory and file with YAML frontmatter
|
|
128
|
+
2. Define purpose, workflow, and usage
|
|
129
|
+
3. Add to skill registry (auto-detected from frontmatter)
|
|
130
|
+
4. Optionally add activation triggers
|
|
131
|
+
5. Create corresponding `commands/new-skill.md` file (mirror)
|
|
132
|
+
6. Update `docs/REFERENCE.md` (Skills section, count)
|
|
133
|
+
7. If execution mode skill, also create `src/hooks/new-skill/` hook
|
|
134
|
+
|
|
135
|
+
### Common Patterns
|
|
136
|
+
|
|
137
|
+
**Skill chaining:**
|
|
138
|
+
```markdown
|
|
139
|
+
## Workflow
|
|
140
|
+
1. Invoke `explore` agent for context
|
|
141
|
+
2. Invoke `architect` for analysis
|
|
142
|
+
3. Invoke `executor` for implementation
|
|
143
|
+
4. Invoke `qa-tester` for verification
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
If `pipeline` / `next-skill` metadata is present, OMC appends a standardized **Skill Pipeline** handoff block to the rendered skill prompt so downstream steps are explicit.
|
|
147
|
+
|
|
148
|
+
**Conditional behavior:**
|
|
149
|
+
```markdown
|
|
150
|
+
## Workflow
|
|
151
|
+
1. Check if tests exist
|
|
152
|
+
- If yes: Run tests first
|
|
153
|
+
- If no: Create test plan
|
|
154
|
+
2. Proceed with implementation
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
### Testing Requirements
|
|
158
|
+
|
|
159
|
+
- Skills are verified via integration tests
|
|
160
|
+
- Test skill invocation with `/oh-my-claudecode:skill-name`
|
|
161
|
+
- Verify trigger keywords activate correct skill
|
|
162
|
+
- For git-related skills, follow `templates/rules/git-workflow.md`
|
|
163
|
+
|
|
164
|
+
## Dependencies
|
|
165
|
+
|
|
166
|
+
### Internal
|
|
167
|
+
- Loaded by skill bridge (`scripts/build-skill-bridge.mjs`)
|
|
168
|
+
- References agents from `agents/`
|
|
169
|
+
- Uses hooks from `src/hooks/`
|
|
170
|
+
|
|
171
|
+
### External
|
|
172
|
+
None - pure markdown files.
|
|
173
|
+
|
|
174
|
+
## Skill Categories
|
|
175
|
+
|
|
176
|
+
| Category | Skills | Trigger Keywords |
|
|
177
|
+
|----------|--------|------------------|
|
|
178
|
+
| Execution | autopilot, ultrawork, ralph, team, ultraqa | "autopilot", "ulw", "ralph", "team" |
|
|
179
|
+
| Cleanup | ai-slop-cleaner | "deslop", "anti-slop", cleanup/refactor + slop smells |
|
|
180
|
+
| Planning | omc-plan, ralplan, deep-interview, ralph-init | "plan this", "interview me", "ouroboros" |
|
|
181
|
+
| Exploration | deepinit, sciomc, external-context | "deepinit", "research" |
|
|
182
|
+
| Utility | learner, note, cancel, hud, setup, omc-doctor, omc-setup, omc-help, mcp-setup | "stop", "cancel" |
|
|
183
|
+
| Domain | psm, writer-memory, release | psm context |
|
|
184
|
+
|
|
185
|
+
## Auto-Activation
|
|
186
|
+
|
|
187
|
+
Some skills activate automatically based on context:
|
|
188
|
+
|
|
189
|
+
| Skill | Auto-Trigger Condition |
|
|
190
|
+
|-------|----------------------|
|
|
191
|
+
| autopilot | "autopilot", "build me", "I want a" |
|
|
192
|
+
| ultrawork | "ulw", "ultrawork" |
|
|
193
|
+
| ralph | "ralph", "don't stop until" |
|
|
194
|
+
| deep-interview | "deep interview", "interview me", "ouroboros", "don't assume" |
|
|
195
|
+
| cancel | "stop", "cancel", "abort" |
|
|
196
|
+
|
|
197
|
+
<!-- MANUAL:
|
|
198
|
+
- Team runtime wait semantics: `omc_run_team_wait.timeout_ms` only limits the wait call and does not stop workers.
|
|
199
|
+
- `timeoutSeconds` is removed from `omc_run_team_start`; use explicit `omc_run_team_cleanup` for intentional worker pane termination.
|
|
200
|
+
-->
|