ai-integration-architect

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. Trigger em: "integrar IA no app", "AI integration", "provider adapter de IA", "feature de IA", "chamar OpenAI", "chamar Anthropic", "Claude API", "LLM no app", "arquitetura de IA", "custo de IA", "fallback de provider", "rate limit de IA".

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

67%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Well-structured architectural skill body with a strong validation checkpoint and feedback loop. The main weakness is conciseness — the Beautiful UI section is verbose, duplicates the Fontes section, and embeds time-sensitive dates inline.

Suggestions

Move the 20-component Beautiful UI catalog into a separate reference file and keep only a one-line pointer plus the adoption caveat, eliminating the duplication with the Fontes section.

Relocate time-sensitive details (confirmation date 2026-08-23, version v2.12.2+) into a dated changelog/deprecated note rather than inline prose to reduce date-rot noise.

Consider numbering the core workflow steps (Entradas -> Base -> Checkpoint -> Evidencia -> Handoff) as an explicit checklist to lift workflow clarity from good to fully sequenced.

Dimension	Reasoning	Score
Conciseness	Mostly efficient but the Beautiful UI section inlines a verbose 20-component / 6-category listing plus license and confirmation details that repeat in the Fontes section, and time-sensitive dates (2026-08-23, v2.12.2+) sit inline rather than in a deprecated section; not a 4 because the redundant component listing and inline dates are trimmable padding.	3 / 5
Actionability	Concrete executable guidance — specific files to consult, a real-call checkpoint ('forçar timeout ou erro 429'), and copy-paste bash for the submodule; not a 5 because much of the guidance is navigational ('consultar' pattern files) rather than fully self-contained code.	4 / 5
Workflow Clarity	Clear logical sequence (Entradas -> Base Obrigatoria -> Checkpoint -> Evidencia -> Handoff) with an explicit validation checkpoint and a validate-fix-retry feedback loop ('Se o fallback não disparar, corrigir o adapter e forçar o erro de novo'); not a 5 because steps are section-based rather than an explicit numbered checklist.	4 / 5
Progressive Disclosure	Good structure with one-level-deep references clearly signaled (patterns/ai-integration/.md, policies/.md, templates/ai-integration-plan.md); not a 5 because the inlined Beautiful UI component catalog arguably belongs in a separate reference file, and no bundle files exist to verify the cited paths.	4 / 5
	Total	15 / 20 Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, specific description that clearly states both the skill's purpose and concrete trigger phrases in third-person voice. Minor overlap risk from the broad 'imagem ou video ao app' framing is the only weakness.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'desenhar e implementar integracoes de IA', 'separando provider, adapter, hooks, observabilidade, custo e seguranca' — giving comprehensive coverage of the skill's scope; not a 4 because the enumerated concerns are concrete and specific rather than a minor gap.	5 / 5
Completeness	Explicitly answers both what ('desenhar e implementar integracoes de IA... separando provider, adapter, hooks, observabilidade, custo e seguranca') and when ('Use quando o usuario quiser adicionar texto, imagem ou video ao app. Trigger em: ...') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Comprehensive natural trigger phrases including synonyms and brand names — 'integrar IA no app', 'AI integration', 'chamar OpenAI', 'chamar Anthropic', 'Claude API', 'LLM no app', 'fallback de provider', 'rate limit de IA'; covers what users would actually say.	5 / 5
Distinctiveness Conflict Risk	Clear niche around AI integration architecture with distinct triggers (provider, fallback, rate limit), but 'adicionar texto, imagem ou video ao app' creates minor overlap risk with image/video-generation skills; not a 5 because that breadth invites some conflict.	4 / 5
	Total	19 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
relative_links	Relative link issues: 1 suspicious	Warning

	Total	15 / 16 Passed

Repository: felvieira/claude-skills-fv
Path: skills/25-ai-integration-architect/SKILL.md
Commit: 74aa7c1

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.