framework_eng/skills/framework-meta/agent-development/SKILL.md
Create or configure custom subagents with specialized prompts (reviewers, debuggers, domain-specific assistants). Helps determine the location, structure, and system context of a new agent.
npx skillsauth add steelmorgan/1c-agent-based-dev-framework agent-developmentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Subagents are specialized AI assistants running in isolated contexts with custom system prompts. If previous conversation context exists, infer the subagent's purpose from what was discussed.
| Location | Scope | Priority |
|----------|-------|----------|
| .cursor/agents/ | Current project | Higher |
| ~/.cursor/agents/ | All your projects | Lower |
When multiple subagents share the same name, the higher-priority location wins.
Project subagents (.cursor/agents/): Ideal for codebase-specific agents. Check into version control to share with your team.
User subagents (~/.cursor/agents/): Personal agents available across all your projects.
Create a .md file with YAML frontmatter and a markdown body (the system prompt):
---
name: code-reviewer
description: Reviews code for quality and best practices
---
You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.
| Field | Description |
|-------|-------------|
| name | Unique identifier (lowercase letters and hyphens only) |
| description | When to delegate to this subagent (be specific!) |
The description is critical - the AI uses it to decide when to delegate. Include "use proactively" to encourage automatic delegation.
# Bad — too vague
description: Helps with code
# Good — specific trigger conditions
description: Expert code review specialist. Proactively reviews code for quality, security, and maintainability. Use immediately after writing or modifying code.
---
name: code-reviewer
description: Expert code review specialist. Proactively reviews code for quality, security, and maintainability. Use immediately after writing or modifying code.
---
You are a senior code reviewer ensuring high standards of code quality and security.
When invoked:
1. Run git diff to see recent changes
2. Focus on modified files
3. Begin review immediately
Review checklist:
- Code is clear and readable
- Functions and variables are well-named
- No duplicated code
- Proper error handling
- No exposed secrets or API keys
- Input validation implemented
- Good test coverage
- Performance considerations addressed
Provide feedback organized by priority:
- Critical issues (must fix)
- Warnings (should fix)
- Suggestions (consider improving)
Include specific examples of how to fix issues.
.cursor/agents/) or user (~/.cursor/agents/)mkdir -p .cursor/agents && touch .cursor/agents/my-agent.mdname and description (required).cursor/agents/ or ~/.cursor/agents/.md extensiontesting
MUST use BEFORE making a judgment about the cause of a conflict, a test failure, or an artifact dispute. Defines the end-to-end verification method L1→L6 and the classification of the first broken link.
development
MUST use AFTER a work cycle with ≥2 iterations (wrote → error → fixed → success). Provides the retrospective procedure and the format for recording practice/anti-patterns in references/learned-patterns.md or {project}/.context/learned-patterns.md.
tools
MUST use WHEN you are writing reusable knowledge into RLM (pattern / architectural decision / stable domain fact) OR reading it before a non-trivial task/solution in the domain. Provides the breakdown of native-push vs RLM-pull, tools for writing and reading RLM, H-MEM levels, and hygiene.
testing
MUST use WHEN the task is classified as simple (< 20 lines, 1 file, no new metadata objects, no architectural decisions). Provides a short cycle of 3 steps with a guard on the self path and mandatory verify.