CtrlK
BlogDocsLog inGet started
Tessl Logo

prompt-engineer

Skill para desenhar prompts reutilizaveis de texto, imagem e video com foco em clareza, controle, custo e reprodutibilidade. Use quando a qualidade do prompt for parte central da feature ou do fluxo. Trigger em: "prompt engineer", "prompt engineering", "melhorar prompt", "otimizar prompt", "template de prompt", "system prompt", "few-shot", "chain of thought", "reduzir custo de prompt", "iterar prompt", "prompt reutilizavel".

60

Quality

70%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/26-prompt-engineer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

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 is a well-structured skill description with strong trigger term coverage and clear completeness (both what and when are addressed). The main weakness is that the capability description could be more specific about concrete actions beyond 'desenhar prompts reutilizaveis' — listing specific techniques or outputs would strengthen specificity. The explicit trigger list is a notable strength that aids skill selection.

Suggestions

Expand the 'what' portion with more concrete actions, e.g., 'cria system prompts, estrutura few-shot examples, otimiza token usage, constrói templates de chain-of-thought' to increase specificity.

DimensionReasoningScore

Specificity

The description names the domain (prompt engineering) and mentions some actions like designing reusable prompts for text, image, and video with focus on clarity, control, cost, and reproducibility. However, it doesn't list multiple concrete specific actions (e.g., 'create system prompts, optimize token usage, build few-shot templates, structure chain-of-thought reasoning').

2 / 3

Completeness

Clearly answers both 'what' (designing reusable prompts for text, image, and video with focus on clarity, control, cost, and reproducibility) and 'when' (when prompt quality is central to the feature or flow), plus includes an explicit trigger list. The 'Use quando' clause provides clear guidance on when to select this skill.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say, including both Portuguese and English variations: 'prompt engineer', 'prompt engineering', 'melhorar prompt', 'otimizar prompt', 'template de prompt', 'system prompt', 'few-shot', 'chain of thought', 'reduzir custo de prompt', 'iterar prompt', 'prompt reutilizavel'. These are terms users would naturally use when needing this skill.

3 / 3

Distinctiveness Conflict Risk

The skill occupies a clear niche — prompt engineering and optimization — with highly specific trigger terms like 'few-shot', 'chain of thought', 'system prompt', and 'prompt reutilizavel' that are unlikely to conflict with other skills. The domain is well-defined and distinct.

3 / 3

Total

11

/

12

Passed

Implementation

50%

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

This skill provides a reasonable framework for prompt engineering with the 3-layer incremental construction approach, but falls short on actionability — it describes what to do at each layer without showing concrete examples of prompts at each stage. The workflow has checkpoints but lacks specificity on validation criteria. The content could be significantly tightened by removing boilerplate sections and adding one concrete example.

Suggestions

Add a concrete example showing a prompt evolving through Camada A → B → C with actual prompt text at each stage, so Claude can see the pattern in action.

Define specific validation criteria for each 'Testar aqui' checkpoint — what does passing look like? What are common failure modes and how to fix them?

Remove or consolidate boilerplate sections (Governança Global, Quando Não Usar, Entradas/Saídas Esperadas) that don't add actionable guidance beyond what the Layering section already provides.

Add a concrete prompt template or schema showing the expected output format (e.g., a sample system prompt with placeholders) rather than just describing what it should contain.

DimensionReasoningScore

Conciseness

The skill is moderately efficient but includes some unnecessary sections like 'Quando Não Usar' and 'Entradas Esperadas' that add little value for Claude. The governance references at the top consume tokens without adding actionable guidance. However, the Layering section is reasonably tight.

2 / 3

Actionability

The Layering section provides a useful incremental framework with clear steps, but lacks concrete examples of actual prompts at each layer. There are no executable code snippets, no sample prompt templates, and no input→output examples showing what a good prompt looks like at each camada.

2 / 3

Workflow Clarity

The 3-layer progressive construction is a clear multi-step workflow with explicit 'test before advancing' checkpoints at each layer. However, the validation steps are vague — 'Testar aqui antes de avançar' doesn't specify how to test or what constitutes passing. There's no feedback loop for what to do when a test fails.

2 / 3

Progressive Disclosure

References to external files like 'patterns/ai-integration/prompt-patterns.md', 'templates/agent-spec.md', and 'templates/prompt-spec.md' are present and one-level deep, which is good. However, no bundle files are provided to verify these exist, and the references are scattered throughout rather than organized in a clear navigation section. The governance references at the top add clutter.

2 / 3

Total

8

/

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
felvieira/claude-skills-fv
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.