cgf optimize
- Repo stars 0
- Author repo skills-registry
- Domain
- Other
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @tomevault-io · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- Python
- Detected file/system behavior
-
- Read-only
- Write / modify
- Shell exec
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# CGF Optimize Skill
This skill launches the CGF (Claude Gradient Feedback) optimization pipeline for a specified resource or creates a new resource from description.
## Usage
### Optimization Mode (Existing Resource)
```
/cgf-optimize <resource> <optimization_goal> [--review]
```
### Creation Mode (New Resource)
```
/cgf-create <description> [--review]
```
### Arguments
**For optimization mode:**
- **resource**: Resource identifier - can be:
- Agent name: `python-expert`, `refactor-agent`
- Namespaced agent: `research-team:research-specialist`
- Full path: `.claude/agents/dev-python-expert.md`
- **optimization_goal**: What to optimize for:
- `async programming`
- `better error handling`
- `code quality improvements`
- `Context7 usage patterns`
**For creation mode:**
- **description**: Natural language description of the desired resource:
- `Python async expert that helps with asyncio patterns`
- `Kubernetes deployment agent for managing k8s resources`
- `Code review skill for security-focused reviews`
- **--review** (optional): Enable checkpoint mode for human review at each phase
## Examples
### Basic Optimization
```
/cgf-optimize python-expert async programming
```
Runs full optimization pipeline automatically.
### With Review Checkpoints
```
/cgf-optimize typescript-expert --review
```
Pauses after research, test generation, and evaluation for your review.
### Plugin Agent
```
/cgf-optimize research-team:research-specialist Context7 integration
```
Optimizes a plugin agent.
### Create New Agent
```
/cgf-create Python async expert that helps with asyncio patterns
```
Creates initial agent draft using context-engineer, then optimizes.
### Create With Review
```
/cgf-create Kubernetes deployment agent --review
```
Creates and optimizes with human review at each phase.
## Workflow
### Optimization Mode
1. **INIT**: Creates workspace, detects resource type
2. **RESEARCH**: Investigates domain best practices (via research-team)
3. **RESEARCH_ITERATE**: Agentic optimization using research findings and LLM self-critique
4. **EVALUATE**: Assesses results, recommends accept/refine/reject
5. **FINALIZE**: Applies recommendation
### Creation Mode
1. **INIT**: Creates workspace, detects creation mode
2. **CREATE**: Spawns context-engineer to create initial resource draft
3. **RESEARCH**: Investigates domain best practices
4. **RESEARCH_ITERATE**: Agentic optimization using research findings and LLM self-critique
5. **EVALUATE**: Assesses results, recommends accept/refine/reject
6. **FINALIZE**: Applies recommendation
## Output
Results saved to `workspace/{resource_id}/`:
- `run_state.json` - Current state (supports resume)
- `{resource_id}-v{N}.md` - Optimized version
- `reviews/v{N}_review.md` - Evaluation report
## Resume
If optimization was interrupted, simply re-run the same command - it will resume from the last checkpoint.
---
> Source: [andisab/casdk-harness](https://github.com/andisab/casdk-harness) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-22 -->
Sections and files
Listed in source order.
sections -> Usage → Optimization Mode (Existing Resource) → Creation Mode (New Resource) → Arguments → Examples → Basic Optimization
terms -> For optimization mode · resource · optimizationgoal · For creation mode · description · --review · INIT · RESEARCH
files/cmd -> python-expert · refactor-agent · research-team:research-specialist · .claude/agents/dev-python-expert.md · async programming · better error handling · code quality improvements · Context7 usage patterns
body sha256 -> 7a304ee015f9
Arguments
For optimization mode: resource: Resource identifier - can be: Agent name:
python-expert,refactor-agentNamespaced agent:research-team:research-specialistFull path:.claude/agents/dev-python-expert.mdBasic Optimization
Runs full optimization pipeline automatically.
With Review Checkpoints
Pauses after research, test generation, and evaluation for your review.
Plugin Agent
Optimizes a plugin agent.
Create New Agent
Creates initial agent draft using context-engineer, then optimizes.