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

docs: clarify instructions agents skills

Browse Source
This commit is contained in:
Matt Bruce 2026-02-11 10:01:38 -06:00
parent b39ce9cb65
commit eb83c2177c
3 changed files with 17 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
docs/ai/cross-platform.md
View File

@ -1,5 +1,12 @@
# Cross-Platform AI Usage # Cross-Platform AI Usage
## Instructions (Always-On Rules)
Instructions are repo-scoped rules that auto-apply based on file patterns. They are always on and do not need to be invoked.
Where they live:
- Repo instructions directory (for example, [instructions/](../../instructions/))
- Editor or org-level instruction files when configured by your team
## Agents.md ## Agents.md
### What It Is ### What It Is
Agents define a structured workflow so tasks are broken into clear steps, with explicit inputs and outputs. Agents define a structured workflow so tasks are broken into clear steps, with explicit inputs and outputs.
@ -23,6 +30,10 @@ Verification: No tests needed
- Use agents for multi-step tasks like refactors, doc audits, or migrations. - Use agents for multi-step tasks like refactors, doc audits, or migrations.
- Use chat for quick questions or one-off explanations. - Use chat for quick questions or one-off explanations.
## Agents vs Skills (Quick Compare)
- Agents are full modes/personas that control behavior end-to-end. They can be stored in a repo or a user-level folder.
- Skills are focused workflows you load for specific tasks. They are typically installed globally via the approved skills directory.
## Chat Modes In Copilot ## Chat Modes In Copilot
Ask: Quick Q and A or summaries. Ask: Quick Q and A or summaries.
Edit: Targeted file edits with constraints. Edit: Targeted file edits with constraints.

2
docs/ai/index.md
View File

@ -29,7 +29,7 @@ If you will edit these docs, start with the "Key Repo Files" section in the over
- [Android Setup](android.md) - [Android Setup](android.md)
## Usage Guides ## Usage Guides
- [Cross-Platform AI Usage](cross-platform.md) - Agents, prompting patterns, MCP overview, and workflow tips - [Cross-Platform AI Usage](cross-platform.md) - Agents, instructions, prompting patterns, MCP overview, and workflow tips
- [Skills Library](skills.md) - [Skills Library](skills.md)
- [Usage and Token Budgeting](usage-tokens.md) - [Usage and Token Budgeting](usage-tokens.md)
- [Troubleshooting and FAQ](troubleshooting.md) - [Troubleshooting and FAQ](troubleshooting.md)

5
docs/ai/skills.md
View File

@ -1,5 +1,10 @@
# Skills Library # Skills Library
## Skills vs Agents vs Instructions
- Skills are reusable workflows you load for specific tasks.
- Agents are full modes/personas that control behavior end-to-end.
- Instructions are always-on repo rules that auto-apply by file pattern.
## What Skills Are ## What Skills Are
Skills are reusable instructions and workflows that guide the assistant through specialized tasks. Skills are reusable instructions and workflows that guide the assistant through specialized tasks.