agents-v2-py
Build container-based Foundry Agents with Azure AI Projects SDK (ImageBasedHostedAgentDefinition). Use when creating hosted agents with custom container images in Azure AI Foundry.
Install with Tessl CLI
npx tessl i github:sickn33/antigravity-awesome-skills --skill agents-v2-py78
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
Discovery
75%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This description has good structure with explicit 'Use when' guidance and targets a clear technical niche, making it distinctive. However, it could benefit from listing more concrete actions beyond 'build' and including additional natural trigger terms that users might employ when seeking this functionality.
Suggestions
Expand the action list beyond 'Build' to include other concrete capabilities like 'deploy', 'configure', or 'manage' container-based agents.
Add common trigger term variations users might naturally say, such as 'Docker', 'containerized', 'image-based agents', or 'container deployment'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (container-based Foundry Agents) and mentions the SDK and specific class (ImageBasedHostedAgentDefinition), but doesn't list multiple concrete actions beyond 'build' - lacks details like deploy, configure, manage, or specific capabilities. | 2 / 3 |
Completeness | Clearly answers both what ('Build container-based Foundry Agents with Azure AI Projects SDK') and when ('Use when creating hosted agents with custom container images in Azure AI Foundry') with an explicit 'Use when' clause. | 3 / 3 |
Trigger Term Quality | Includes relevant technical terms like 'container', 'Foundry Agents', 'Azure AI Projects SDK', 'custom container images', and 'Azure AI Foundry', but these are fairly technical. Missing common variations users might say like 'Docker', 'containerized agents', or 'hosted agent deployment'. | 2 / 3 |
Distinctiveness Conflict Risk | Highly specific niche targeting ImageBasedHostedAgentDefinition and container-based agents in Azure AI Foundry. The combination of 'container images', 'hosted agents', and 'Azure AI Foundry' creates a distinct trigger profile unlikely to conflict with other skills. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid, actionable skill with excellent code examples and good organization. The main weaknesses are some redundancy in the complete example section and missing explicit validation/verification steps in the workflow for confirming agent creation success before proceeding.
Suggestions
Add explicit validation steps after agent creation (e.g., verify agent.state equals expected value, poll until deployment completes)
Remove or condense the 'Complete Example' section since it largely duplicates the Core Workflow code with minimal additions
Add error handling example showing try/except pattern mentioned in Best Practices
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient with good code examples, but includes some redundancy (e.g., the complete example largely duplicates earlier sections, and some explanations like 'Best Practice: Never hardcode secrets' state obvious security principles). | 2 / 3 |
Actionability | Provides fully executable, copy-paste ready Python code with complete imports, proper async patterns, and specific parameter tables. All code examples are concrete and runnable. | 3 / 3 |
Workflow Clarity | Steps are clearly numbered (1-4 in Core Workflow), but lacks validation checkpoints for the multi-step process. No explicit verification that the agent was created successfully or error recovery steps beyond a troubleshooting table. | 2 / 3 |
Progressive Disclosure | Well-organized with clear sections progressing from installation to prerequisites to core workflow to advanced topics. Reference links at the end point to external documentation without deep nesting. | 3 / 3 |
Total | 10 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
- Reviewed
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.