Guided Engineering

Local study results

A small local pilot asked one question: do the two Skills add anything on top of the same contract and the same agent? Every run got the same contract documents, schemas, validator, task text and starting files. The only difference between conditions was whether the Skills were installed.

Short answer: the study does not show that the Skills improve the work, and it shows no case where they made it worse. The agent already scored at or near the top of the scale without them.

Read this page with its size in mind: five tasks, one run per task and condition, one model, one machine. It shows what happened in this sample. It does not show that the result holds elsewhere, and it supports no statistical claim.

What was measured

CaseWhat it testsWithout SkillsWith Skills (first version)Change
C1Convert a fully specified prose request into an OPS prompt100 ↻1000
C2Improve and convert a legacy, deficient prompt into the OPS contract1001000
C3Plan a frozen OPS prompt for a nested workspace, plan only90 ↻100+10
C4Execute a frozen OPS prompt against a deterministic bug90 ↻900
C5 (reserved)Resume a frozen OPS prompt from a recorded checkpoint1001000

Scores are out of 100. A case passes at 80 or more with no hard failure; a hard failure sets the score to 0 and the raw score is shown in brackets. ↻ marks a baseline that was executed again after its scoring was repaired (see below).

Runs that are kept but not compared

After the first baseline runs, the scoring of three cases was repaired. A changed scoring invalidates the run made before it, so those cases were executed again and only the new runs are compared. The first runs are kept, with the grade they had under the scoring frozen before they ran and a diagnostic replay of the same evidence under the repaired scoring. A replay is not a run.

First runGrade under the scoring frozen before it ranDiagnostic replay, repaired scoringCompared
C1, without skills90 (missed C1-02)100no
C3, without skills80 (missed C3-02, C3-06)100no
C4, without skills90 (missed C4-01)100no

Hypotheses

HypothesisVerdict in this sampleBasis
H1ops-author improves intent preservation, contract validity and actionable verification in authored promptsunsupportedthe baseline mean is 100, so a gain of 10 points was not possible on these cases; observed change 0 (baseline mean 100, with Skills 100)
H2ops-execute improves correct planning, scoped implementation and closure of the verify-repair loopunsupportedthe baseline mean is 93.3, so a gain of 10 points was not possible on these cases; observed change 3.3 (baseline mean 93.3, with Skills 96.7)
H3any observed quality gain has an acceptable cost in time, tokens, tool calls and human interventioninconclusiveno quality gain reached the improvement threshold, so there is no gain whose cost could be judged; the measured overhead is reported as it is

Cost of using the Skills

MeasureMatched pairsMedian change against the baseline
Elapsed time5-4%
Tokens processed5-1%
Output tokens5-13%

The tolerance set in advance was a median increase of at most 50%. Staying inside a tolerance is not a saving; a negative number here is one run per case and says little by itself.

Readiness by the local thresholds

All five cases pass: yes. Mean score: 98 (threshold 85). Hard failures: 0. Verdict: ready.

Does the right Skill load?

SkillRequestExpectedObserved
ops-authorexplicitloadscorrect activation
ops-authorimplicitloadscorrect activation
ops-authoradjacentstays outcorrect non-activation
ops-executeexplicitloadscorrect activation
ops-executeimplicitloadscorrect activation
ops-executeadjacentstays outcorrect non-activation

Attempts

19 evaluation attempts of at most 19 (no refinement was made); 17.6 minutes of evaluated run time of at most 120. 7 other agent sessions (environment probes, a harness check, writing and freezing the reserved case, and two checks that the client lists an installed Skill) are recorded and counted apart, as preparation and verification; counted together the total would be 26.

What the numbers do and do not show

What the traces show beyond the scores

In both authoring runs with the Skills, the first draft of the prompt was rejected by the validator: the checks that had a command lacked the required expect field. One sentence in ops-author can be read as if expect were needed only for a check without a command. The validator named the field, the agent corrected it, and the final prompts are valid, so no score changed. The baseline runs, which read the contract itself, passed their first validation.

This was noticed after the last task had been run, when the rules of the study no longer allow a change to the Skills. Every number on this page is therefore about the Skills as measured, commit 146c4b5 of the Skills repository. The sentence was corrected afterwards, in commit c8418f5. That corrected version has not been measured, and no result here is transferred to it.

How to read the scores

Each task has ten yes-or-no assertions worth ten points, computed by program from the files an attempt left and from the recorded tool calls: 20 points for intent and contract, 30 for the required result, 20 for verification, 20 for scope and control, 10 for traceability. Twelve of the fifty assertions look for specific facts by pattern and are approximate. A hard failure (a missing or invalid required artifact, a failing core check, a weakened test, a prohibited action, or a fabricated record) sets the score of that attempt to zero. None occurred.

The five tasks:

CaseTask
C1Turn a fully specified prose request into an OPS prompt, without implementing it.
C2Convert and improve a legacy, deficient prompt and report the mapping decisions.
C3Plan a frozen prompt whose workspace is a nested package. Plan only.
C4Execute a frozen prompt against a deterministic bug.
C5Resume a different task from partial progress and a failing check. A reserved regression case: written by a separate session before any Skill existed and frozen after the baseline of C1 to C4. Its blinding could not be verified (the author of the Skills saw its file names), so it is not presented as an independent holdout.

What was held constant

Limits

Evidence