CtrlK
BlogDocsLog inGet started
Tessl Logo

prompt-architect

Create and enhance prompts, system instructions, and principle files. Capabilities: transform verbose prompts, add patterns/heuristics, optimize token usage, structure CLAUDE.md principles, improve agent/persona definitions, apply prompt engineering techniques (CoT, few-shot, ReAct). Actions: create, enhance, optimize, refactor, compress prompts. Keywords: prompt engineering, system prompt, CLAUDE.md, principle files, instruction optimization, agent prompt, persona prompt, token efficiency, prompt structure, workflow prompts, rules, constraints, few-shot, chain-of-thought, soul, tensions, dialectic. Use when: creating new prompts, enhancing principle files, improving system instructions, optimizing CLAUDE.md, restructuring verbose prompts, adding patterns to workflows, defining agent behaviors.

91

1.28x
Quality

88%

Does it follow best practices?

Impact

95%

1.28x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

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 strong, well-structured skill description that excels across all dimensions. It provides comprehensive specificity with concrete actions and techniques, includes extensive natural trigger terms, explicitly addresses both what and when, and carves out a distinct niche around prompt engineering. The description is thorough without being padded, and uses appropriate third-person voice throughout.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: transform verbose prompts, add patterns/heuristics, optimize token usage, structure CLAUDE.md principles, improve agent/persona definitions, and names specific techniques (CoT, few-shot, ReAct). Also lists explicit action verbs: create, enhance, optimize, refactor, compress.

3 / 3

Completeness

Clearly answers both 'what' (create and enhance prompts, system instructions, principle files with specific techniques) and 'when' with an explicit 'Use when:' clause listing seven distinct trigger scenarios including creating new prompts, enhancing principle files, improving system instructions, and optimizing CLAUDE.md.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'prompt engineering', 'system prompt', 'CLAUDE.md', 'principle files', 'agent prompt', 'persona prompt', 'token efficiency', 'few-shot', 'chain-of-thought', 'rules', 'constraints'. These are terms users would naturally use when seeking prompt optimization help.

3 / 3

Distinctiveness Conflict Risk

Occupies a clear niche around prompt engineering and system instruction optimization. The specific references to CLAUDE.md, principle files, prompt compression, CoT, few-shot, and ReAct make it highly distinguishable from general writing or coding skills. Unlikely to conflict with other skills.

3 / 3

Total

12

/

12

Passed

Implementation

77%

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

This is a strong, highly actionable skill that provides Claude with concrete patterns, decision tables, and worked examples for prompt engineering. Its main weakness is length—some sections are redundant (expertise_transfer and key_transformations overlap significantly), and the entire content lives in one file rather than using progressive disclosure. The soul/tensions framework is a genuinely novel and useful contribution that goes beyond generic prompt engineering advice.

Suggestions

Extract building_blocks and key_transformations into separate referenced files (e.g., BUILDING_BLOCKS.md, TRANSFORMATIONS.md) to reduce the main skill's token footprint and improve progressive disclosure.

Consolidate the expertise_transfer and key_transformations sections—the compression rules and before/after examples appear in both, creating redundancy that could be eliminated.

DimensionReasoningScore

Conciseness

The skill is fairly long (~300+ lines) and includes some redundancy—the key_transformations section repeats concepts already covered in expertise_transfer and building_blocks. The example section and taxonomy examples are useful but verbose. However, most content is genuinely instructional rather than explaining things Claude already knows, and the domain-specific vocabulary (tensions, dialectic, soul) earns its place.

2 / 3

Actionability

The skill provides highly concrete, executable guidance: specific XML/YAML templates for building blocks, clear before/after transformation examples, decision tables for mode detection and technique selection, and a complete worked example (startup strategist). Claude can directly apply these patterns to produce prompts.

3 / 3

Workflow Clarity

The workflow is clearly sequenced through the detect_mode table → diagnosis → technique_selection → output_format → building_blocks → validation pipeline. Each step has explicit decision criteria (e.g., 'When to Apply' vs 'Skip When' columns). The validation section provides clear checkpoints (Structure, Content, Soul, Preservation tests). For a creative/generative skill like prompt engineering, this level of workflow clarity is excellent.

3 / 3

Progressive Disclosure

The content is entirely self-contained in one file with no references to external documents. While the sections are well-organized with clear headers, the building_blocks and key_transformations sections are quite long and could benefit from being split into referenced files. The monolithic structure means Claude must process ~300+ lines even for simple prompt creation tasks.

2 / 3

Total

10

/

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
majiayu000/claude-skill-registry-data
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.