Skill Add
Turn an external source or pasted content into a canonical local skill, then optionally expose it in enabled agent roots.
Debian/Linux variant: ../../platforms/linux/skills/skill-add/SKILL.md.
Required Context
Read before acting:
<user-home>\OneDrive\01 SKILLS\.agents\skills\skill-authoring\SKILL.md
<user-home>\OneDrive\01 SKILLS\.agents\machines.toml
<user-home>\OneDrive\01 SKILLS\.agents\default-profile.toml
If the source is a GitHub repository, URL, or external package, inspect only the
files needed to understand the skill. Do not copy large docs wholesale into
SKILL.md; summarize the agent-facing procedure and link or place conditional
detail in references/.
Accepted Sources
- GitHub repository or path
- webpage or documentation link
- pasted
SKILL.md - pasted instructions, README text, CLI usage, or workflow notes
- short natural-language description of a desired skill
Workflow
Determine the intended skill name, purpose, trigger phrases, and target agents.
Create or update:
<user-home>\OneDrive\01 SKILLS\.agents\skills\<kebab-name>\SKILL.mdPreserve useful upstream attribution in metadata or body when appropriate.
Keep local setup rules local: PowerShell, OneDrive canonical source, no
dotagents sync, no secrets.Validate the skill.
Update
INDEX.md.Update
skill-routerif the added skill creates a new common route.If it should be default-visible, add it to
default-profile.tomland propagate to every enabled machine root inmachines.toml.
Safety
Do not paste secrets, tokens, credentials, private env files, or raw sensitive logs into a skill. If a source contains sensitive values, omit them and note the redaction.
Do not overwrite an existing canonical skill without first understanding whether this is an update or a duplicate.
Output
Report the source, canonical path, validation status, propagation status, and any
manual follow-up such as adding an upstream agents.toml entry.
Machine-specific values in this document use privacy placeholders.