Teammates and skills

Skill text or a complete skill folder?

Choose based on whether the instructions reference external resources.

OfficeCubs · · 2 min read

Skill text or a complete skill folder?

Choose based on whether the instructions reference external resources. Copying prose is enough only when that prose is self-contained; it cannot make scripts and templates appear in the environment.

Compare the practical differences

DecisionSkill textLocal skill folder
Best fitSelf-contained guidanceGuidance with scripts, templates or assets
Useful propertyEasy to inspect inside a roleKeeps resources available at their original location
What to checkDoes not automatically fetch referenced filesRequires checking resource paths and dependencies

A concrete choice

A writing tone rule may work as plain text. A presentation workflow that calls a rendering script needs the script and its dependencies as well.

Verify the choice

Read every resource reference and run a limited fixture before using the skill on important inputs.

Write the reason for your choice into the task brief or setup notes. Then run a small representative task and compare the actual result with the requirement that drove the decision. Keep any unmet requirement visible rather than declaring the whole workflow ready from a single successful step.

Continue with the setup

The related desktop guide explains the relevant controls and limits. Use the current application state when applying this comparison; the presence of an option in a document does not mean every dependency on your computer is ready.

Keep exploring

Setup and troubleshooting in Help