Follow Discord
Sweep 22 Oct 2026 · 04:32Z Build v2.1.308 527 read Stable v2.1.308 Latest v2.1.308 Next v2.1.308 Feeds RSS JSON llms.txt llms-full.txt Unofficial
HomeDocsClaude Developer Platform 22 Oct 2026
One change · api

PDF Processing changedagents-and-tools/agent-skills/best-practices

Nearest release: v2.1.308, published 2 hours after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.

Recorded here
Lines+8added
Lines−8removed
From line 254 where the diff opens
First seen 14 Aug 2026 this site's first read of the page
Recorded edits6to this page, all time

The whole hunk

from line 254, old and new numbered
/
lines
from line 254
254254 
255255**Practical guidance:**
256256 
257* Keep `SKILL.md` body under 500 lines for optimal performance
258* Split content into separate files when approaching this limit
259* Use the following patterns to organize instructions, code, and resources effectively
257* Keep the `SKILL.md` body under 500 lines for optimal performance.
258* Split content into separate files when approaching this limit.
259* Use the following patterns to organize instructions, code, and resources effectively.
260260 
261261#### Visual overview: From simple to complex
262262 
from line 812
812812* **Testing with Claude B** (the agent using the Skill to perform real work)
813813* **Observing Claude B's behavior** and bringing insights back to Claude A
814814 
8151. **Use the Skill in real workflows:** Give Claude B (with the Skill loaded) actual tasks, not test scenarios
8151. **Use the Skill in real workflows:** Give Claude B (with the Skill loaded) actual tasks, not test scenarios.
816816 
8172. **Observe Claude B's behavior:** Note where it struggles, succeeds, or makes unexpected choices
8172. **Observe Claude B's behavior:** Note where it struggles, succeeds, or makes unexpected choices.
818818 
819819 **Example observation:** "When I asked Claude B for a regional sales report, it wrote the query but forgot to filter out test accounts, even though the Skill mentions this rule."
820820 
from line 822
822822 
8238234. **Review Claude A's recommendations:** Claude A might recommend reorganizing to make rules more prominent, using stronger language such as "MUST filter" instead of "always filter," or restructuring the workflow section.
824824 
8255. **Apply and test changes:** Update the Skill with Claude A's refinements, then test again with Claude B on similar requests
8255. **Apply and test changes:** Update the Skill with Claude A's refinements, then test again with Claude B on similar requests.
826826 
8278276. **Repeat based on usage:** Continue this observe-refine-test cycle as you encounter new scenarios. Each iteration improves the Skill based on real agent behavior, not assumptions.
828828 
from line 1137
11371137 
11381138### Token budgets
11391139 
1140Keep `SKILL.md` body under 500 lines for optimal performance. If your content exceeds this, split it into separate files using the progressive disclosure patterns described earlier. For architectural details, see [How Skills work](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview#how-skills-work).
1140Keep the `SKILL.md` body under 500 lines for optimal performance. If your content exceeds this, split it into separate files using the progressive disclosure patterns described earlier. For architectural details, see [How Skills work](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview#how-skills-work).
11411141 
11421142## Checklist for effective Skills
11431143 
Feedback