4.5 Packaging the Method as Skills

The method so far has been described as engineering practice: model the relevant knowledge, place authority around stable obligations, evaluate work with independent evidence, and convert recurring judgment into durable structure. Some of that recurring structure can itself be packaged for agents.

A skill is one way to package that structure for an agent. It can carry knowledge, examples, heuristics, decision procedures, triggers, and tools so that a fresh agent does not begin every session cold. A well-maintained skill can become engineering capital when later work benefits from inheriting the packaged judgment enough to justify its creation and upkeep.

Do not confuse packaging with authority. A skill made only of prose is reusable guidance. If it invokes a deterministic checker, restricts an action, or participates in a gate, the surrounding machinery may also carry authority. The distinction from Part III still applies after the procedure is packaged.

The companion repository demonstrates the architecture through three mastery skills: self-governance, self-operate, and self-communicate. Together they show one portable way to preserve recurring engineering judgment.

Tool skill. Teaches an agent how to operate one interface.

Mastery skill. Packages domain knowledge plus a repeatable decision procedure for doing a class of work well, independent of one particular tool.

A mastery-skill specializes commodity intelligence with domain-specific engineering judgment: it gives a fresh agent the abstractions, distinctions, and practices an experienced engineer would bring to the work.

Recent industry examples show related packaging moves.** Atlassian's Jira team reports a related move: it delegates keep-the-lights-on work — flaky tests, feature-flag cleanup, vulnerabilities, accessibility — by turning each into an explicit work item that carries context plus workflow instructions, so a maintenance class becomes delegable once the tacit repair procedure is encoded, not because the agent got clever 22. Atlassian, “AI Agents for Jira Engineering Maintenance,” Atlassian, 2026, https://www.atlassian.com/blog/development/ai-agents-jira-engineering-maintenance.. Twilio's public account is sharp: an unguided agent asked to "verify users" hand-rolls a six-digit one-time password, while its skill redirects to a dedicated verification product and inherits rate limiting, fraud controls, and routing the operator never thought to request 11. Twilio, “Why Connect Twilio AI Skills,” Twilio, 2026, https://www.twilio.com/en-us/blog/developers/best-practices/why-connect-twilio-ai-skills.. The encoded procedure is the capital; the class of work becomes inheritable.

4.5.1 The Skill Skeleton

The three examples share a construction pattern, drawn in Figure 4.5-1. A mastery-skill begins with a fundamental model: the abstraction through which the domain makes sense. Orthogonal facets capture independent concerns within that domain. A governing principle connects them and tells the agent how to reason across the whole: when to invoke each facet, what questions to ask, which tools to use, and what output must be returned.

The portable idea is the skeleton: tacit practice becomes a bounded reasoning environment that a new agent can enter repeatedly.

The skill skeleton, and the three skills that instantiate it A fundamental model of the domain sits at the left. Several orthogonal facets layer on top of it, each cutting the domain along an independent concern. All of them feed a SKILL.md governing principle that ties the facets together and tells the agent when to reach for which — and that, over its facets, is a working skill. The three shipped skills are three instances of this one skeleton: self-governance engineers the environment, self-operate runs its lifecycles, and self-communicate governs technical communication. fundamental model of the domain orthogonal facet orthogonal facet orthogonal facet SKILL.md the governing principle that ties them together a working skill Three instances of one skeleton: self-governance engineer the environment self-operate operate the lifecycles self-communicate govern technical communication
Figure 4.5-1. The Skill Skeleton. Every shipped skill shares one construction: a fundamental model of the domain, orthogonal facets that cut it along independent concerns, and a governing principle — a SKILL.md of principles — that ties them together and tells the agent when to reach for which. The three shipped skills, self-governance (engineer the environment), self-operate (operate the lifecycles), and self-communicate (govern technical communication), are three instances of this one skeleton.

4.5.2 Deliver the Right Context—and Measure It

A reusable procedure helps only if the actor reaches it when it matters. Packaging knowledge is not enough; it has to reach the reasoner when relevant, without drowning the reasoner in everything else.

The naive answer is to load everything: put every rule, architecture note, failure lesson, tool instruction, and procedure into the agent's standing context and trust attention to sort it out. That merely moves the navigation problem.

A better pattern separates what should remain continuously salient from what should appear only when the work makes it relevant. Dynamic context injection (DCI) is one realization: the environment observes properties of the task, work surface, or lifecycle state; selects the engineering knowledge relevant to those properties; and places that knowledge into the agent's working context. The trigger might be a file being changed, a component being entered, or a lifecycle transition being reached. The injected material might be a model slice, local constraint, procedure, example, or other guidance. The general pattern is shown in Figure 4.5-2.

Deliver the right context in two layers — small standing context plus a retrieved task-relevant slice. A green engineering-knowledge box holds models, rules, and procedures. It splits into two layers: a solid green standing-context box (mission, compact method, compact policy) and a dashed green task-relevant-slice box (retrieved when needed). Both feed into a blue agent-context box, which flows down into a dark work box. A dashed rust lifecycle-event arrow loops from the work back up to the task-relevant slice, re-surfacing what matters now. The point: keep standing context small enough to genuinely remain standing, and retrieve richer slices per task rather than loading everything at once. ENGINEERING KNOWLEDGE models · rules · procedures STANDING CONTEXT mission · compact method compact policy TASK-RELEVANT SLICE richer models, procedures, examples — retrieved when needed AGENT CONTEXT WORK lifecycle event re-surfaces what matters now Keep standing context small enough to stay standing — retrieve the rest per task.
Figure 4.5-2. Delivering task-relevant context. Engineering knowledge — models, rules, procedures — splits into a small standing context (mission, compact method, the few policies whose salience must survive every task) and a task-relevant slice retrieved when the work calls for it. Both feed the agent's context; a lifecycle event can re-surface what matters now.

Standing context should contain the mission, compact method, and the few policies whose salience must survive every task. Retrieve richer model slices, procedures, examples, and local constraints according to the work. Where relevance can be determined mechanically, inject the appropriate slice rather than relying on the actor to discover and retrieve it.

But context has a cost. More guidance is not automatically better guidance. It consumes tokens, attention, and reasoning capacity, and stale guidance can actively misdirect work.

So treat context delivery as an engineering intervention and measure its effect. Compare performance with and without the added context. Measure task success first; then use diagnostic measures — tokens, navigation steps, tool calls, files opened, retries, or time — where they illuminate why performance changed. A context mechanism that consumes more reasoning budget without improving the engineering outcome has not earned its place.

The model-based software-engineering pilot is one example: run the same task against different model-and-context conditions and reasoner classes, and ask whether the supplied representation actually changes navigation cost or task success. What is portable is the discipline of testing whether engineered context does what we claim it does. Part V carries that pilot with its data and its limitations.

Context delivery changes what the reasoner can see; by itself, it does not change what the environment permits. A richer slice of the right rules makes a good action easier to find; only a constraint, validator, or gate makes a bad action unavailable.

4.5.3 Self-Governance: Engineering the Environment

Self-governance packages Modeling and Alignment as a procedure the agent can apply to its own engineering work. Recognize the situation, decide what to model and what to make authoritative, choose a move, act through the environment, weigh the evidence, and keep what should be inherited. Converting a recurring failure is one branch of that loop, not its definition. A recurrence is evidence the environment may be missing something durable — but the missing thing is not always a new control. It may be a model, an explicit obligation, better evidence, a validator, a constraint, a gate, or simply a decision procedure worth preserving.

The skill carries a model of the engineering method rather than a catalogue of preferred controls. Its fundamental model is the Modeling–Alignment loop; its facets organize the recurring questions the agent must answer to apply that loop: what to represent; how the representation corresponds to the system; what evidence exists; what authority is justified; how changes should be introduced; and when existing structure should be reconciled or retired. Where useful, the skill can query the environment's governance catalogue of existing mechanisms. Concrete system knowledge comes from the models and tools of the environment rather than being embedded in the skill. Its value is to give a fresh agent MAGE-specific judgment without embedding knowledge of the particular system in the skill itself.

The project's boot context can preserve mission, method, and concise rules, but treat those rules accurately. Mission orients. Method teaches judgment. Rules state project policy. They bind only where an environmental mechanism gives them consequence. A numbered sentence in an always-loaded file is still guidance unless something outside the producing agent enforces it.

Underneath the method sit the operating rules the skill applies on every touch, the same set the companion skill carries:

Self-governance — operating rules

A skill on its own is passive: it sits and waits to be invoked, and an agent heads-down in the work will not stop to invoke it. A hook brings the skill into the work while the evidence is still fresh enough to diagnose the episode; the skill applies the MAGE procedure to the episode and surfaces the relevant design forks — "we keep hitting this; here are two ideas, which should I try?" — then waits. It may recommend changing a model, an obligation, evidence, a mechanism, or nothing at all. The engineer retains the judgment about what matters enough to preserve.

Governance must earn its carrying cost

Governance mechanisms and other durable engineering assets can become capital when their continuing value exceeds their carrying cost; they can also depreciate. Over-investment turns governance maintenance into its own recurring cost. Three symptoms say the return has gone negative: upkeep crowds out product work; the checks cry wolf, flagging more than they catch; or the guarded failure is both cheap and rare. Each is a control whose upkeep outweighs its benefit. Size it the way Migrating to MAGE sizes any control — against the cost and the frequency of the failure it prevents — and retire the assets that no longer earn their cost.

Even a soft mechanism can be governed like a hard one. NVIDIA's public account describes treating a skill as a deployable capability rather than a static prompt, run through an eight-stage supply chain — source, review, scan, evaluate, skill card, sign, catalog, sync — where scanning looks for agent-specific threats (hidden instructions, trigger abuse, excessive agency, tool poisoning, purpose/access mismatch), not only conventional software risk 33. NVIDIA, “NVIDIA Verified Agent Skills Provide Capability Governance for AI Agents,” NVIDIA, 2026, https://developer.nvidia.com/blog/nvidia-verified-agent-skills-provide-capability-governance-for-ai-agents/.. The prose is a reusable knowledge asset; the signing and gating around it add authority to its distribution and use.

4.5.4 Self-Operate: Running the Environment

Self-operate packages the previous chapter's lifecycles, recovery paths, runbook step types, and operating heuristics. Its fundamental model is the operational lifecycle; supporting facets distinguish the lifecycle class a symptom belongs to, the typed runbook action, and the trigger that fires it. Its procedure tells an agent how to orient against the healthy path, run deterministic steps through tools, dispatch delegable judgment with a prepared brief, and surface irreducible judgment to the operator.

The skill is useful because operating procedure otherwise has to be reconstructed at every fresh session. It does not replace the underlying tools, state machines, validators, or gates. It makes their use repeatable.

Its boundary with self-governance is explicit. Self-operate routes an operating condition to a typed runbook and runs it; when a condition instead exposes a deficiency in the models, mechanisms, skills, or lifecycle itself, self-operate returns the engineering problem — with evidence, not a redesign — up to self-governance. It runs the environment; it does not re-engineer it.

The two mastery skills divide the work by the question each answers. Table 4.5-1 sets the split side by side.

Table 4.5-1. The two mastery skills, by facet. Self-governance asks how the environment should be engineered and produces or revises durable engineering structure; self-operate asks how to run a lifecycle and produces a completed operation or returned evidence. Each hands the other exactly one thing: design flows down to be run, and engineering deficiencies flow back up to be fixed.
FacetSelf-governanceSelf-operate
The question it answersHow should this be engineered?How do I operate this lifecycle?
Acts onthe environment — models, mechanisms, skillsthe running lifecycles — dispatch, land, deploy, recover
Producesdurable engineering structurea completed operation, or returned evidence
Hands offdesign down to self-operate to runengineering deficiencies up to self-governance to fix

The interface is two-way and explicit: self-governance delegates execution downward; self-operate returns engineering problems upward. Neither absorbs the other: self-governance decides how a mechanism should exist; self-operate uses it at runtime.

4.5.5 Self-Communicate: a Boundary Test

Self-communicate packages a different craft: engineer-facing prose and technical drawing. Its value here is as a boundary test for the architecture. Governance and operations sit close to the method's core; technical communication is farther away, yet the same skeleton still works — a domain model, orthogonal representations of the craft, and a decision procedure that tells the agent how to apply them.

Self-communicate is not a third pillar of MAGE; it shows that the same skill architecture can extend beyond governance and operations. The appendix and companion repository carry the procedure itself.

Reusable agent procedures can become engineering capital when later work inherits them, and the industry is finding the pattern in parallel. Part V's MAGE in the Wild sets six such systems side by side.

Worked Examples

Shopify. Shopify's public account describes agent sessions made visible and searchable, together with mechanisms for turning reusable lessons into shared skills and defaults. The important move is that private reasoning can become organizationally reusable rather than disappearing with the session: make the work visible, then mine the repeated judgment into a skill, so the environment gets incrementally smarter with each pass instead of every session starting cold.

Zenseact. Zenseact's public account describes a centrally owned runtime and safety envelope combined with domain-owned agents, tools, instructions, and reusable expertise. Each domain team contributes an agent as little more than a directory holding a config and a skill, and a router surfaces domain expertise on demand — the organization centralizes the mechanism and decentralizes the judgment.

Takeaway. Reusable agent procedures can become engineering capital when later work inherits them. Shopify's account describes judgment mined from prior sessions into defaults later work inherits; Zenseact's describes the organizational variant, where domain teams contribute reusable expertise to a centrally governed runtime. The portable move is to preserve recurring procedure without pretending that packaging alone grants authority.

Works Cited

  1. Twilio. “Why Connect Twilio AI Skills.” Twilio, 2026. https://www.twilio.com/en-us/blog/developers/best-practices/why-connect-twilio-ai-skills.
  2. Atlassian. “AI Agents for Jira Engineering Maintenance.” Atlassian, 2026. https://www.atlassian.com/blog/development/ai-agents-jira-engineering-maintenance.
  3. NVIDIA. “NVIDIA Verified Agent Skills Provide Capability Governance for AI Agents.” NVIDIA, 2026. https://developer.nvidia.com/blog/nvidia-verified-agent-skills-provide-capability-governance-for-ai-agents/.
© James C. Davis, 2026–present