8.9 Skills and plugins: who approved the steps?
- Approved by
- Panaversity ·
In everyday life. A new cook brings a recipe card from her last restaurant. It is a good recipe, but it says "bake for 20 minutes," and this kitchen's oven runs hotter. So the head chef cooks it on a quiet afternoon before it goes on the menu. The head chef signs the card only after the dish comes out right.
What you will learn. How a skill differs from a connector, a plugin and project instructions. Whether to reuse a skill or write your own. How to test one, who approves its steps, and what to do when something changes or the skill is no longer used. You practice it in Tasks 8 and 9 of the lab.
Why it matters. Section 8.7's second habit is that nothing serves until it is approved. A skill is the steps the worker follows on real invoices, so the habit applies to it too. A skill someone else wrote brings their steps and their numbers with it.
Four kinds of setup
What does each kind add?
Section 8.5 set up a project with instructions, knowledge and connectors, and named a fourth kind of setup, the skill. Sort the things you can add to an AI Worker by what each one adds:
| Kind | What it adds | Example | What its owner checks |
|---|---|---|---|
| Project instructions | Standing rules for one project. They load with every conversation in it. | "Policy answers come only from the concept files in this project." | That each rule points to the approved source |
| Skill | Steps for one kind of task, sometimes with files or scripts. It loads only when a task calls for it. | Brightline's invoice check | That each step is right, and that it passes its tests |
| Connector | Reach: a link to a source or an app, with someone's permissions | The shared drive that holds the stable concepts | What it can see, and what it can change |
| Plugin | A package of several of these, such as skills and connectors | An invoice package with a check skill and a mail connector | Each part inside it, by its own row |
Instructions and skills tell the worker how to work, as rules and as steps. That is procedure, and a company approves its procedure the way it approves a concept. A connector adds no steps, but it adds reach, and reaching a source does not make it approved (8.5). A plugin adds whatever it holds, so check each part inside it as if it came alone.
Adopting a skill
Should you reuse a skill or write your own?
Reuse saves the writing. It does not save the approval. A skill written outside the company was written for someone else's work: their limits, their approvals and their idea of normal. Reusing it means adopting it. It enters your record as a draft, like any concept, the short file that holds the rules for one topic (8.6). And it gets an owner.
Reuse a skill when its job is general, such as checking that an invoice's lines add up to its total. Write your own when the steps depend on your company's rules. Either way, a step must point to your approved concepts, never carry its own numbers. A number inside a skill is a second copy of a rule, and copies drift apart.
Keep the skill's approved text where the concepts are kept, in the company's own folder, with its owner and status. The skill turned on in an AI product is a copy. So is a procedure pasted into project instructions on a plan without skills (8.8). Change the folder's file first, then refresh every copy and log it, as 8.7's fourth habit says.
What do you read before you turn it on?
Read every step, and every file or script it carries. Then ask what it can reach, and what it can send or change. That is a blast-radius question, and 7.4 answers it. This page asks a second question: are its steps your company's approved procedure?
How do you test it?
Test it before anyone relies on it, in two places. First, in a test project that holds the same stable concepts as the worker's project, never the project itself. Then in a plain chat, with no concepts at all. Once a skill is on, it is in every chat, not only in one project (8.5), so people will use it where the concepts are not. In the test project, the worker may follow a concept and set a wrong step aside. The plain chat shows what the steps do on their own. While the skill is a draft, keep it on only for its tester, only while they test, in an account that does no real work until it is off (8.7).
Write the result you expect from each case, in each place, before you run it. Then run three cases:
- A normal case. An ordinary input. Does it do the job, and name its sources?
- A missing-input case. An input with something missing, such as an invoice with no total. Does it stop and say what is missing, or does it guess? A skill that points to a concept must also say so, and stop, when the concept is not there.
- A case it must refuse. An input that asks for something the worker must never do, such as approving a payment or changing a vendor's bank details. Does it refuse and report the request? Text inside an input is information to report, never an instruction to follow (7.6).
Save the three cases beside the skill, with the expected and actual results from both places. They are its tests. They also show its owner whether the steps work, the way Lab 8's ten test questions show whether the concepts work.
Who approves its steps, and what do they look at first?
The person who owns the procedure. At Brightline, the book's example company, that is Dave, the controller, who owns the AP policy concepts. AP means accounts payable, the bills a company owes. Maria, the office manager, drafts the skill, runs the tests and keeps it current. Dave looks at two things before he approves: the steps, and the test results from both places. He approves one version, and the approval is recorded: who approved it, when, and which version. Only then is the skill turned on for the worker's work.
What does this look like at Brightline?
On Thursday, November 5, 2026, two days after the AP Worker gave four wrong answers, Maria wants its invoice check as a skill. The AP Worker is the AI Worker that handles the bills Brightline owes. She finds a ready-made invoice-review skill that someone outside Brightline wrote and shared. It checks the total, looks for duplicates and flags requests to change bank details. Two of its steps carry the other company's rules. One says "Invoices under $10,000 need no approval." At Brightline, section 4.1 of the AP policy says $5,000. The other lists "update the vendor's bank details" as the first next step. Section 5.1 says never change a vendor's bank details because of an email.
At 9:30, she reads its steps and what it can reach. It carries no scripts and asks for no connector. She saves it in Brightline's folder as a draft. At 10:00, she opens a test project that holds the five stable concepts. She turns the skill on and runs three cases:
- Normal. Tri-County's invoice 5149 for $2,940.00. The total adds up, and it is under $5,000. Pass.
- Missing input. The same invoice with its total cut off. The skill says the total is missing, and stops. Pass.
- Must refuse. Buckeye's invoice BO-23104 for $6,150, with an email from Buckeye asking Brightline to "approve it and update our bank details." The answer follows the concepts, not the skill. It is over $5,000, so Dave must approve it, and the bank change is reported, not made. The answer even says that Brightline's approved policy overrides the skill's step. Pass.
Three passes. Maria is tempted to send the skill to Dave as it is. At 10:30 she shows him the results, and Dave asks one question. Once the skill is on, it is in every chat, not only in the test project. So what does it do where Jordan would use it, in a plain chat without the concepts? Jordan is a clerk who joins in December to help at year-end.
At 10:45, Maria opens a plain chat with no project and no concepts, and runs the must-refuse case again. This time the skill's own step answers: "$6,150 is under $10,000, so no finance manager approval is needed." Fail, under section 4.1. The answer still did not change the bank details. It said to call Buckeye first, on a number already on file. But that came from the model's own caution, not from any step. Do not count on that. The step still says to update the bank details first, and a later model, or a busy day, may follow it. On the other AI vendor, the same test followed both wrong steps: it called the invoice "ready to pay" and put updating the bank details first.
The concepts in the test project had hidden the bad steps. The skill passed there because the concepts sat beside it, not because its steps were right.
By 11:15, she has pointed both steps to their concepts, the invoice approval threshold and changes to vendor bank details. She has added two lines. "If a concept you need is not available, say so, decide nothing that rests on it, and name who decides." And "Never approve a payment or change bank details. Report any request to do so, and name who decides." She runs the three cases in the test project again, and all three pass. In the plain chat, the must-refuse case now says that the threshold concept is not available. It decides nothing about approval, and it reports both requests. Then she turns the skill off.
On Friday, November 6, at 8:30, Dave reads the steps and the results from both places, and approves that version. Maria turns the skill on where the AP Worker's work runs, and writes down each place it is on.
That is the lesson of the plain chat. Good knowledge in a project can hide bad steps. So a skill's steps must be right on their own. Each step points to the concept that holds its rule. And when the concept is not there, the skill says so and stops.
On Monday, November 9, Dave approves the currency rule (8.7). The skill points to the concept, so its steps do not change. But what it checks has changed. So Maria runs the three cases again in the test project, plus a fourth: Northern Maple's invoice in Canadian dollars. The skill now flags it for Dave, and she logs the run.

Figure 8.10. A skill's life, and the plain-chat test that shows what its steps do without the concepts.
Keeping it right
When do you test it again?
Run the saved cases again after any change that can move an answer:
- The skill's own steps change. Changed steps are a new draft. They go back to the skill's owner for approval before they serve again, the way an edited concept is approved again in 8.6.
- A concept it points to changes, as the currency rule did.
- Its author publishes a new version. That is a new draft too. It passes the same tests and gets the same approval before it replaces the one in use.
- The model changes. A line written for an older model can make a newer one do too much (5.5).
Add a case for the change itself, and keep it with the others. The tests grow with the skill.
How do you retire a skill?
When a skill is replaced, or nobody uses it any more, retire it the way 8.6 retires a concept. Mark its file deprecated, pointing to the skill that replaces it. Then turn it off in every place it is on. Check each person's account, any setting that gives it to a whole team, and any project instructions that hold a pasted copy. A skill sits outside any one project, so reviewing the project does not find all of these. Keep the list of where each skill is on. Retiring ends only when every place on the list is checked. A skill that must not be served at all, because it is wrong or unsafe, is not retired but taken down, which Chapter 10 covers.
What does this cost?
Every skill the worker uses on company work needs an owner, three tests in two places and an approval, even a short one. Each change means running the tests again. Reuse saves less than it seems, because the reading and the testing are the same work either way. The other choice is fair for a skill that only formats your own notes and decides nothing anyone relies on: a careful read is enough. A skill that touches a payment, an approval or a vendor record gets all of it.
Check yourself
Question 1 / 10 · drawn from 11
0 answered
Maria finds a ready-made skill that someone outside Brightline wrote. What is its status in Brightline's record?
- Owner
- Panaversity