mbrucedogs/ai-docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: clarify agents vs skills

Browse Source
This commit is contained in:
Matt Bruce 2026-02-11 09:54:35 -06:00
parent 860948697b
commit 51e2fae97f
1 changed files with 9 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
docs/ai/overview.md
View File

@ -51,6 +51,15 @@ Copilot is an AI coding assistant that integrates with editors and chats to help
- Skills: Reusable knowledge or workflows the assistant can apply. - Skills: Reusable knowledge or workflows the assistant can apply.
- Tokens: The usage units that track AI consumption. - Tokens: The usage units that track AI consumption.
## Agents vs Skills (Where They Live)
Agents are full personas or modes (for example, Task Researcher) that control how the assistant behaves end-to-end. Skills are focused, reusable workflows (for example, webapp-testing) that the assistant can load for a specific task.
Where they live:
- Agents can be stored in a repo (project-specific) or in a user-level folder for global reuse.
- Skills are typically installed globally via the approved skills directory and synced with a manifest.
If you need the official agent assets repo, ask your team lead or check your internal setup docs.
## Key Repo Files (Why They Exist) ## Key Repo Files (Why They Exist)
These files explain how the AI docs are organized and how contributors should work. Each one has a different job. These files explain how the AI docs are organized and how contributors should work. Each one has a different job.