Engineering practice · Coding agents

Develop coding-agent skills that hold across unfamiliar tasks.

Turn engineering judgment into rubrics and coverage for developing coding-agent skills. Test when a skill should apply, whether it improves the work, and what it causes the agent to overlook.

For teams developing coding-agent skills, harnesses, and repository workflows

A Teammately cockatiel working on a laptop
Development focusSkill applicability and generalization

A successful patch can hide a weak skill.

An agent may solve the task because the repository is familiar, the request repeats an example, or a narrow test misses the effect on adjacent code. A reusable skill must help the agent recognize the right situation, make appropriate changes, and verify them across variations the author did not anticipate.

Engineering practice · These are development and assessment methods, not reported customer results.

01

The skill helps in one context and interferes in another

The context

A procedure written for a migration may be invoked during a small bug fix. The instructions can be internally correct while prescribing more work than the task requires.

Judgment to capture

Which evidence should trigger the skill? When should the agent adapt it, defer it, or leave it unused?

02

The visible tests pass, but the change breaks a requirement

The context

A patch can satisfy a test while altering a public contract, masking an error, or depending on an assumption about repository state.

Judgment to capture

What behavior must be preserved? Which checks establish that the requested change is complete rather than merely plausible?

03

The agent follows the steps without understanding their purpose

The context

A changed build tool, incomplete context, or failing dependency makes the recorded procedure inapplicable. Repeating it can conceal the real blocker.

Judgment to capture

What may the agent infer, what should it inspect, and what evidence should make it change its approach?

Capture the engineering judgment behind a good change.

Teammately’s agents prepare patch and trajectory reviews, comparisons, and follow-up conversations. Maintainers explain the distinction between a technically plausible edit and one they would accept. Agents develop those findings into proposed rubrics, applicability conditions, and coverage for further skill development.

Repository maintainers

Task boundaries, architectural intent, compatibility requirements, and acceptable verification.

Experienced agent users

When a skill helps, when instructions overconstrain the task, and where the agent needs to investigate.

Develop the skill against a deliberate range of tasks.

Treat the skill as part of the harness being evaluated. Establish the tasks it should improve and the behavior it must preserve, then vary the conditions that made the original example easy to solve.

Ontology dimensions
Task intent, repository structure, available context, dependencies, permitted scope, and verification requirements.
Combinations to exercise
The skill should remain unused; the repository contradicts its expected procedure; a plausible patch passes a narrow test but changes an adjacent contract.
Interpreting the case mix
Separate tasks used to develop the skill from those used to assess transfer. Include missed invocation and unnecessary invocation in the evaluation.

Give the skill an applicability and acceptance standard

Teammately’s contribution

Turn maintainer findings into rubrics for when to invoke the skill, the scope of an acceptable change, and the verification needed. Preserve the reasons a procedure should adapt when repository evidence differs.

What this makes possible

The benchmark can distinguish successful skill use, a missed opportunity, and an unnecessary intervention.

Construct tasks that test the purpose of the skill

Teammately’s contribution

Coverage varies task intent, repository conditions, and available evidence. Weave constructs scoped codebase cases and supporting material. Include tasks where the skill’s underlying judgment remains relevant but the familiar procedure does not.

What this makes possible

The candidate must use the engineering principle across meaningful changes in context, rather than recall a filename or imitate a known patch.

Compare the skill-bearing harness against a baseline

Teammately’s contribution

Use Trialground to run candidates in the agreed task environment and apply the rubrics. Keep model and evaluation conditions comparable when assessing the contribution of a skill or revision.

What this makes possible

Inspect task completion, invocation, scope control, and recorded verification together, including regressions on tasks the skill should leave alone.

Pursue a general improvement to the prototype

Teammately’s contribution

Coevolve can investigate failures and test skill-bearing harness prototypes in a sandbox against the benchmark goal. Your engineers and coding agents use the retained candidates and evidence in subsequent implementation.

What this makes possible

A tested direction for further development, with the protected behavior and remaining applicability limits visible.

This practice focuses on harness development. When failures instead expose a distinction the model needs to learn, the same rubrics and coverage can direct Weave’s training-data augmentation.

Establish where the skill helps and where it gets in the way.

  • Appropriate use of the skill and recognition of its limits.
  • Completion of the requested change without unnecessary scope expansion.
  • Preservation of applicable contracts and existing behavior.
  • Verification appropriate to the change and its consequences.
  • Adaptation when repository evidence contradicts the expected procedure.

Compare a baseline and skill-bearing candidate under the same task and model conditions. Use separate assessment tasks and vary meaningful repository and task conditions. Report completion alongside unnecessary invocation, missed applicability, and changes outside the requested scope.

Review the resulting patch and recorded trajectory together. A passing test can leave a requirement unexamined; a successful patch can also result from behavior that would fail in a different repository. Assess verification against what the change requires, rather than the number of checks performed.

Apply the practice to related work.

Repository migrations

Test preservation of behavior across dependency and structural changes.

Investigation and debugging

Assess whether evidence gathering distinguishes plausible causes before an edit.

Code review assistance

Elicit what makes a finding actionable, correctly scoped, and worth raising.

Bring a skill whose usefulness is hard to establish.

A skill, a few task examples, and the people who review the resulting work can be enough to define the first benchmark question.

Talk to our team