Skill para desenhar e implementar integracoes de IA em aplicacoes, separando provider, adapter, hooks, observabilidade, custo e seguranca. Use quando o usuario quiser adicionar texto, imagem ou video ao app.
55
44%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/25-ai-integration-architect/SKILL.mdQuality
Discovery
67%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description has a clear structure with both 'what' and 'when' clauses, which is good for completeness. However, the capabilities listed are more architectural concepts than concrete actions, and the trigger condition ('add text, image, or video to the app') is overly broad and could conflict with many other skills. The description would benefit from more specific actions and more precise trigger terms tied to AI/LLM integration scenarios.
Suggestions
Add more specific concrete actions like 'configure LLM API clients', 'implement streaming responses', 'set up token usage tracking', 'manage API key rotation' instead of just listing architectural layers.
Narrow and enrich trigger terms to include natural phrases users would say: 'AI API', 'LLM integration', 'OpenAI', 'Claude API', 'chat completion', 'embeddings', 'generative AI features'.
Make the 'Use when' clause more distinctive — 'adicionar texto, imagem ou video ao app' is too generic; specify it's about integrating AI-powered generation (e.g., 'Use when the user wants to integrate AI-powered text generation, image generation, or video analysis into their application').
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (AI integrations) and mentions some architectural concepts (provider, adapter, hooks, observability, cost, security), but these are more structural concerns than concrete actions. It doesn't list specific actions like 'configure API endpoints', 'implement retry logic', or 'set up streaming responses'. | 2 / 3 |
Completeness | It explicitly answers both 'what' (design and implement AI integrations with separation of provider, adapter, hooks, observability, cost, and security) and 'when' ('Use quando o usuario quiser adicionar texto, imagem ou video ao app'). The 'Use when' clause is present and explicit. | 3 / 3 |
Trigger Term Quality | Includes some relevant terms like 'IA', 'texto', 'imagem', 'video', 'integracoes', but misses common natural language triggers users might say such as 'AI API', 'LLM', 'OpenAI', 'Claude API', 'chat completion', 'embeddings', 'generative AI'. The trigger terms are somewhat generic. | 2 / 3 |
Distinctiveness Conflict Risk | The AI integration focus provides some distinctiveness, but the trigger 'adicionar texto, imagem ou video ao app' is quite broad and could easily overlap with general UI/frontend skills, media handling skills, or content management skills. The architectural terms (provider, adapter, hooks) help somewhat but aren't typical user trigger terms. | 2 / 3 |
Total | 9 / 12 Passed |
Implementation
22%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill reads more like a metadata card or routing document than an actionable skill. It tells Claude when to use the skill and what files to consult, but provides zero concrete guidance on how to actually architect an AI integration — no code examples, no decision frameworks, no workflow steps. The entire value is deferred to external files, making the skill body itself nearly empty of teachable content.
Suggestions
Add a concrete step-by-step workflow for designing an AI integration (e.g., 1. Identify modality, 2. Select provider using criteria X, 3. Define adapter interface, 4. Implement hooks, 5. Add observability, 6. Validate cost constraints).
Include at least one concrete code example showing an adapter pattern or hook implementation so Claude has an executable reference rather than only abstract descriptions.
Add a brief decision framework or table for provider selection (e.g., text→OpenAI/Anthropic, image→DALL-E/Midjourney, video→Runway) to make the skill immediately actionable without requiring file lookups.
Add validation checkpoints in the workflow, such as verifying cost estimates before proceeding or testing adapter connectivity before handoff.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is relatively brief but includes several sections that are more organizational boilerplate than actionable content (e.g., 'Quando Usar', 'Quando Nao Usar', 'Entradas Esperadas', 'Saidas Esperadas'). These sections describe the skill's purpose rather than teaching Claude how to do anything, adding tokens without much value. | 2 / 3 |
Actionability | The skill provides no concrete code, commands, examples, or executable guidance. It describes what to consult and what outputs to produce but never shows how to actually implement an AI integration — no code snippets, no adapter patterns, no hook examples, no schema examples. Everything is delegated to external files without any inline actionable content. | 1 / 3 |
Workflow Clarity | There is no clear sequenced workflow. The skill lists inputs, outputs, and references but never defines a step-by-step process for designing an AI integration. There are no validation checkpoints, no decision points, and no feedback loops for what is inherently a multi-step architectural process. | 1 / 3 |
Progressive Disclosure | The skill does reference multiple external files (patterns/ai-integration/*.md, policies/*.md, templates/*.md) which is good progressive disclosure structure. However, the references are not clearly signaled with descriptions of what each file contains, and the main file itself has almost no substantive content — it's essentially just a pointer file with no useful overview content to stand on its own. | 2 / 3 |
Total | 6 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
e9f6648
Table of Contents
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.