ancoder-skill-cli 0.13.38-beta.1 → 0.13.38-beta.12

package/README.md

@@ -174,11 +174,24 @@ go build -o bin/skill-cli .
 | `skill-cli create <name> [--path <dir>]` | Create a skill scaffold with contract and smoke eval templates |
 | `skill-cli test <path>` | Check that a skill has trigger docs, contract, and eval coverage |
 | `skill-cli verify <path> [--suite smoke]` | Run a machine-readable verification suite end-to-end |
-| `skill-cli generate <name> --desc "..."` | Generate with OMC, then run isolated generator/evaluator contract negotiation and review (default) |
-| `skill-cli generate <name> --desc "..." --no-adversarial` | Generate with OMC only, skipping the default adversarial review |
+| `skill-cli generate <name> --desc "..."` | Generate with the default OMC pipeline, real-task feedback, and skill self-loop scaffolding |
+| `skill-cli improve <path-or-name> --logs <dir>` | Improve an existing skill through the default self-iteration loop |
+| `skill-cli loop skill run <path-or-name> --logs <dir>` | Run explicit skill self-iteration cycles with state, budget, and run logs |
+| `skill-cli generate <name> --desc "..." --adversarial` | Also run isolated generator/evaluator contract negotiation and review |
 | `skill-cli install [--no-omc]` | Install ECC components into `~/.claude/` (includes OMC by default) |
 | `skill-cli install --component omc` | Install only the bundled OMC multi-agent orchestration layer |
 
+## Skill Self-Iteration Loops
+
+Generated and improved skills now use a loop-engineering operating layer by default. Each skill can carry:
+
+- `LOOP.md` for cadence, gates, and escalation rules
+- `STATE.md` for durable memory across runs
+- `loop-budget.md` for token budget and kill switch
+- `loop-run-log.md` for append-only cycle history
+
+Use `skill-cli loop skill audit <skill>` to inspect readiness, `skill-cli loop skill init <skill>` to add the files to an older skill, and `skill-cli loop skill run <skill> --logs ./logs` to run evidence-backed self-improvement cycles.
+
 ## Machine-Readable Skill Layout
 
 Task-oriented skills can now include a deterministic verification harness:
@@ -201,10 +214,10 @@ my-skill/
 
 ## Adversarial Skill Generation
 
-`skill-cli generate` runs an independent adversarial evaluator pass after the OMC generation pipeline by default:
+`skill-cli generate` uses the OMC pipeline by default. For stricter experimental review, add `--adversarial` to run an independent evaluator pass after the OMC generation pipeline:
 
 ```bash
-skill-cli generate pdf-to-md --desc "Convert PDF files to Markdown"
+skill-cli generate pdf-to-md --desc "Convert PDF files to Markdown" --adversarial
 ```
 
 This mode uses two isolated Claude CLI contexts:
@@ -214,7 +227,7 @@ This mode uses two isolated Claude CLI contexts:
 
 The evaluator fails the run when critical issues are found or the score is below `0.80`. Deterministic gate failures are always converted into critical diff items and cap the score below `0.60`.
 
-Use `--no-adversarial` if you want the older OMC-only generation behavior.
+Use the default command without `--adversarial` for the OMC-only generation path.
 
 ### Generation failure logs
 
@@ -224,7 +237,7 @@ Every `skill-cli generate` run writes a local JSONL session log under:
 <skills-dir>/.skill-cli/logs/generate/<skill-name>-<timestamp>.jsonl
 ```
 
-When generation fails, the CLI prints the exact log path. The log records major stages such as Claude binary resolution, scaffold creation, brainstorm probe, loop start/ticks, deterministic gates, repair attempts, and adversarial review failures, including captured command output and error tails for troubleshooting.
+Every generation run prints the exact log path. The log records major stages such as Claude binary resolution, scaffold creation, brainstorm probe, loop start/ticks, deterministic gates, repair attempts, real-task feedback artifacts, and optional adversarial review failures, including captured command output and error tails for troubleshooting.
 
 ## Publish to npm
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ancoder-skill-cli",
-  "version": "0.13.38-beta.1",
+  "version": "0.13.38-beta.12",
   "description": "CLI for managing everything-claude-code (ECC) components — agents, skills, commands, rules, hooks, MCP configs. Single binary, all assets embedded.",
   "bin": {
     "skill-cli": "bin/skill-cli.js"