Build and Manage Skills

#Open Skills in a Workspace

⤢Expand

Screenshot previewChoose the Skills book icon in the workspace toolbar to browse personal and shared collections without leaving the work.

×

1. 01

   Open the Workspace

   Enter the workspace where you want to use, create, or improve a Skill.

2. 02

   Choose Skills

   Select the Skills (book) icon in the workspace toolbar. The Skills panel opens on the right.

3. 03

   Expand a collection

   Open my-skills or an available shared collection such as Acme Sales Playbooks.

4. 04

   Choose a Skill

   Select the Skill you want the agent to use or update. Choose Change Requests when you need to review a proposed shared change.

#Know which collection you are changing

#Use or improve a Skill in the Workspace

1. 01

   Open the Skill

   Read its purpose and visible instructions before asking the agent to use or change it.

2. 02

   Give the agent a concrete task

   Name the Skill and the result you need so the agent can apply it to the current workspace context.

3. 03

   Ask for a focused improvement

   When the method needs work, describe the problem and ask the agent to show the proposed Skill change.

4. 04

   Review the result and the change

   Confirm both the completed work and the updated instructions or source before submitting a shared change.

#Include a Workflow Script when instructions are not enough

A Skill can contain instructions, examples, reference material, and a Workflow Script. Use the documentation to explain when the process applies, the inputs and expected result, and the judgment the agent still needs to provide. Use the Workflow Script for the known steps that should run consistently.

Because the documentation and source remain available together, the agent can inspect both when a run fails. Ask it to identify the failed step, compare the behavior with the Skill, repair the source, and prove the change with a new Workflow Run.

#Example: update a shared skill from a workspace

Suppose the renewal-account-brief skill needs a clearer renewal confidence rule. Ask the agent to open that skill, add a concise definition backed by visible evidence, and show the proposed change before publishing.

#Submit a change request

1. 01

   Review the diff

   Confirm the proposal changes only the intended skill files.

2. 02

   Describe the reason

   Explain the user problem and how the revision improves the method.

3. 03

   Submit for review

   Publish the proposed workspace change through the collection’s review flow.

4. 04

   Follow status

   Return to the request to see whether it is pending, approved, or needs revision.

#Review and approve a change

⤢Expand

Screenshot previewReviewers can inspect the proposed Skill diff in the Workspace, choose Approve, and confirm with Approve Changes.

×

1. 01

   Open Change Requests

   In the Workspace Skills panel, expand the shared collection and choose Change Requests.

2. 02

   Open a ready request

   Select a request marked Ready for review and read its reason, affected files, and complete diff.

3. 03

   Choose the review outcome

   Choose Request Change when the proposal needs revision. Choose Approve only when the change is correct and appropriately scoped.

4. 04

   Confirm approval

   In the confirmation dialog, choose Approve Changes to add the reviewed change to the shared collection.

#After approval

New workspace use should follow the approved version. Verify a representative request after approval so the intended behavior is confirmed from results, not only from the request status.

⤢Expand

Screenshot previewAfter approval, the shared collection’s approved version includes the reviewed change.

×