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 'when' trigger is overly broad ('add text, image, or video to the app') and could easily conflict with non-AI-related skills. The capability description lists architectural concerns rather than concrete user-facing actions, and the trigger terms miss common AI/LLM-related vocabulary users would naturally use.
Suggestions
Narrow the 'Use quando...' clause to be more AI-specific, e.g., 'Use quando o usuario quiser integrar APIs de IA como OpenAI, Claude, ou modelos de geracao de texto, imagem ou video no app'.
Replace architectural jargon (provider, adapter, hooks) with concrete actions like 'configurar chamadas a APIs de LLM, implementar streaming de respostas, gerenciar tokens e custos de API'.
Add more natural trigger terms users would say, such as 'API de IA', 'LLM', 'OpenAI', 'Claude API', 'geracao de conteudo', 'inteligencia artificial'.
| 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 quando...' 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', 'generative AI', 'machine learning integration'. The terms 'provider', 'adapter', 'hooks' are more developer-architecture jargon than user-facing trigger terms. | 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 skills for media handling, content management, file uploads, or general app feature development. The scope of 'text, image, or video' is very wide and not uniquely tied to AI integrations. | 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/routing document than an actionable skill. It tells Claude which files to read and what outputs to produce but provides zero concrete guidance on how to actually architect an AI integration. The complete absence of examples, code, decision frameworks, or step-by-step workflows makes it nearly unusable as a standalone skill.
Suggestions
Add a concrete workflow with numbered steps: e.g., 1. Identify use case type (text/image/video), 2. Select provider using criteria from providers.md, 3. Design adapter layer, 4. Define hooks, 5. Validate cost/security constraints—with explicit validation checkpoints.
Include at least one concrete example showing a typical AI integration architecture (e.g., a text generation adapter with hook pattern, even in pseudocode with specific interface shapes).
Add a brief decision framework or table inline (e.g., 'text generation → use streaming adapter pattern; image generation → use async queue pattern') so the skill has actionable content without requiring all external files.
Remove or consolidate the 'Entradas Esperadas' and 'Saidas Esperadas' sections into a more compact format—these read as process documentation rather than skill instructions.
| 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 definitions. Everything is delegated to external files without any inline substance. | 1 / 3 |
Workflow Clarity | There is no clear sequenced workflow. The skill lists files to consult and outputs to produce but doesn't define a step-by-step process with validation checkpoints. For a multi-step architectural task involving provider selection, adapter design, cost analysis, and security review, the absence of any sequenced workflow with feedback loops is a significant gap. | 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 quick-start or 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.
d87ad31
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.