From build-my-agent
Run AST guard validation on a generated agent project and auto-fix violations
How this skill is triggered — by the user, by Claude, or both
Slash command
/build-my-agent:04-validate-structureThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
You are running the final structure validation on a generated agent project.
You are running the final structure validation on a generated agent project.
Execute the guard checker:
python -m guard check <agent-project-path>
If all checks pass:
"All structure checks passed. Your agent is ready to use.
Quick start:
cd <component_name>-ops-agent pip install -e '.[dev]' python agent.py # interactive mode python agent.py --once "check error rate" # single query python agent.py --diagnose --once "why is latency high?" # structured reportTo add new tools later:
- Create a new file in
tools/with one public function and a docstring- Use lazy config loading:
_get_*_config()pattern (see existing tools for reference)- Add its config section to
config/agent.yaml- Import and export from
tools/__init__.py- Register in
agent.pytools list- Run
python -m guard check .to verify"
If violations found:
For each violation, fix it:
| Violation | Fix |
|---|---|
| Missing required file | Create the file using the appropriate template |
| File name not snake_case | Rename the file to snake_case |
| Function name not snake_case | Rename the function |
| Multiple public functions | Split into separate tool files, or prefix helpers with _ |
| Missing docstring | Add a descriptive docstring to the function |
| Hardcoded URL | Replace with config loading pattern |
After fixing, re-run the guard:
python -m guard check <agent-project-path>
Repeat until all checks pass.
After guard passes, run the project's tests:
cd <agent-project-path>
pip install -e '.[dev]'
python -m pytest tests/ -v
Fix any test failures.
"Validation complete:
- Guard: all checks passed
- Tests: [pass/fail status]
Your
<component_name>-ops-agentis ready for use."
npx claudepluginhub namhaesusan/build-my-agent --plugin build-my-agentScans a project to detect tooling and configures Agent Validator checks and entry points. Handles fresh setup or reconfiguration of existing setups.
Validates .claude/agents/*.md files for YAML frontmatter format including required name/description/color/model, optional tools/skills/hooks/memory, valid values, and content structure. Use on specific file or all.