technical-specification

Creates detailed technical specifications for software projects covering requirements, architecture, APIs, and testing strategies. Use when planning features, documenting system design, or creating architecture decision records.

Install with Tessl CLI

npx tessl i github:secondsky/claude-skills --skill technical-specification

What are skills?

1.21x

Quality

89%

Does it follow best practices?

Impact

100%

1.21x

Average score across 3 eval scenarios

SKILL.md

Review

Evals

Evaluation results

100%

18%

Technical Specification: User Authentication Service

API spec structure and requirements

Criteria

Without context

With context

Metadata table

60%

100%

Executive Summary length

33%

100%

Non-Goals section

100%

FR table format

100%

Measurable NFRs

100%

NFR table format

100%

Architecture diagram

100%

API contract detail

100%

Data model SQL

100%

Testing strategy table

87%

100%

Security threat analysis

100%

Security checklist

57%

100%

Risk assessment table

100%

Rollout stages

100%

Rollback plan

71%

100%

Without context: $0.4342 · 3m 1s · 9 turns · 10 in / 10,215 out tokens

With context: $0.5217 · 3m 19s · 14 turns · 63 in / 10,517 out tokens

100%

Technical Specification: Real-Time Notification Service

Monitoring, dependencies, and alternatives

Criteria

Without context

With context

Monitoring metrics

100%

Alerts table

100%

External dependencies

100%

Team dependencies

100%

Alternatives explored

100%

Open questions

100%

Quantified NFRs

100%

Success metrics table

50%

100%

Non-Goals section

100%

Implementation phases

100%

Background context

85%

100%

Reviewers in metadata

100%

Without context: $0.3489 · 2m 36s · 9 turns · 9 in / 8,029 out tokens

With context: $0.5345 · 3m 48s · 14 turns · 142 in / 10,992 out tokens

100%

26%

Technical Specification: Search Index Rebuild Pipeline

Component design, glossary, and rollout

Criteria

Without context

With context

Component purpose docs

100%

Component dependencies docs

62%

100%

Component interfaces docs

100%

Glossary present

100%

Progressive rollout stages

100%

Rollback plan

87%

100%

Testing strategy table

100%

FR IDs and priority

100%

Acceptance criteria in FRs

100%

Architecture diagram

100%

Success metrics

100%

References section

100%

Risk assessment

62%

100%

Without context: $0.3348 · 2m 23s · 8 turns · 9 in / 7,615 out tokens

With context: $0.6409 · 4m 10s · 16 turns · 17 in / 13,046 out tokens

Evaluated: 5 days ago
Agent: Claude Code
Model: Claude Sonnet 4.6

Table of Contents

Technical Specification: User Authentication Service Technical Specification: Real-Time Notification Service Technical Specification: Search Index Rebuild Pipeline

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.