You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs(agent-development): enhance content completeness and documentation
Add model selection guidance explaining when to choose haiku/sonnet/opus,
enrich Additional Resources with detailed file descriptions, provide full
copy-pasteable script path in Implementation Workflow, and document the
tools vs allowed-tools field naming difference between agents and skills.
Fixes#19
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
**Recommendation:** Use `inherit` unless agent needs specific model capabilities.
160
166
161
167
### color (required)
@@ -390,6 +396,8 @@ Output: [What to provide]
390
396
| color | Yes | Color name | blue |
391
397
| tools | No | Array of tool names |["Read", "Grep"]|
392
398
399
+
> **Note:** Agents use `tools` to restrict tool access. Skills use `allowed-tools` for the same purpose. The field names differ between component types.
400
+
393
401
### Best Practices
394
402
395
403
**DO:**
@@ -414,9 +422,9 @@ Output: [What to provide]
414
422
415
423
For detailed guidance, consult:
416
424
417
-
-**`references/system-prompt-design.md`** - Complete system prompt patterns
418
-
-**`references/triggering-examples.md`** - Example formats and best practices
419
-
-**`references/agent-creation-system-prompt.md`** - The exact prompt from Claude Code
425
+
-**`references/system-prompt-design.md`** - Four system prompt patterns (Analysis, Generation, Validation, Orchestration) with complete templates and common pitfalls
426
+
-**`references/triggering-examples.md`** - Example block anatomy, four example types, template library, and debugging guide
427
+
-**`references/agent-creation-system-prompt.md`** - The exact prompt used by Claude Code's agent generation feature with usage patterns
420
428
421
429
### Example Files
422
430
@@ -442,7 +450,7 @@ To create an agent for a plugin:
442
450
4. Write frontmatter with all required fields
443
451
5. Write system prompt following best practices
444
452
6. Include 2-4 triggering examples in description
445
-
7. Validate with `scripts/validate-agent.sh`
453
+
7. Validate with `./skills/agent-development/scripts/validate-agent.sh agents/your-agent.md`
0 commit comments