CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

database-architect

Expert database architect specializing in data layer design from scratch, technology selection, schema modeling, and scalable database architectures.

Quality

52%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/database-architect/SKILL.md

The canonical home for this skill is database-architect in rmyndharis/antigravity-skills

SKILL.md
Quality
Evals
Security

Quality

Content

27%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.

The body establishes useful scope boundaries, behavioral traits, and distinctions from sibling skills, but drowns them in a long catalog of technologies and concepts Claude already knows, with no executable guidance, templates, or decision frameworks. It is a monolithic role profile rather than a lean, actionable skill document.

Suggestions

Cut the ~150-line Capabilities taxonomy and the Purpose/Core Philosophy/Knowledge Base sections, keeping only the decision frameworks and behavioral rules that are not common knowledge; move any needed catalog to a references/ file.

Replace the high-level step labels with concrete, executable guidance: a technology-selection decision table, a schema-design checklist, or a sample migration plan template with phases and rollback triggers.

Add explicit validation checkpoints to the workflow (e.g., 'validate migration plan in staging, verify data counts, only then recommend cutover') so the Safety section's intent becomes workflow steps.

DimensionReasoningScore

Conciseness

Heavily padded: ~150 of 257 lines are a Capabilities taxonomy enumerating technologies and concepts Claude already knows (B-tree/GIN/BRIN indexes, ACID, isolation levels, CAP theorem, product name lists), plus redundant 'Purpose', 'Core Philosophy', and 'Knowledge Base' sections that restate the description or list known concepts. The genuinely skill-specific signal (scope boundaries, behavioral traits, key distinctions) is a small fraction of the token budget.

1 / 5

Actionability

Guidance stays at the high level: 'Choose the database model and architecture pattern', 'Design schemas, indexes, and lifecycle policies' name concerns but give no concrete method, decision framework, command, or worked example to execute them. Not 3 because the Response Approach and Output Examples sections describe categories of output rather than any specific actionable content, and not 1 because the 4-step Instructions and Safety constraints do give minimal concrete direction.

2 / 5

Workflow Clarity

A sequence is present ('Instructions' 4 steps, 'Response Approach' 10 steps) and the Safety section includes validation ideas ('Validate migration plans in staging before production'), but checkpoints remain implicit — there is no validate/fix/retry loop anywhere in the workflow itself. Per the feedback-loops note for database operations, missing explicit validation loops cap this at 3.

3 / 5

Progressive Disclosure

The body has clear section headers and a 'Use/Do not use' split, so navigation is possible, but everything lives inline in one monolithic 257-line file with zero bundle references — the capability catalogs and example interactions clearly belong in separate reference files. This matches 'some structure but content that should be separate is inline'; not 2 because the sectioning is real, not minimal.

3 / 5

Total

9

/

20

Passed

Description

55%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 reasonably specific 'what' statement with relevant domain keywords, but it lacks any explicit 'when to use' trigger clause and does not distinguish itself from closely related database skills. Adding concrete trigger phrases and migration-related keywords would lift most dimensions.

Suggestions

Append an explicit trigger clause, e.g., 'Use when designing a new database schema, choosing between database technologies, or planning a data migration or re-architecture.'

Add natural trigger keywords users actually say: 'design a schema', 'choose a database', 'PostgreSQL vs MongoDB', 'sharding', 'zero-downtime migration'.

State the boundary with adjacent skills in the description itself, e.g., 'for tuning an existing database use database-optimizer instead'.

DimensionReasoningScore

Specificity

The description lists several concrete capability areas — 'data layer design from scratch, technology selection, schema modeling, and scalable database architectures' — naming the domain plus multiple specific actions. It falls short of 5 because the actions are framed as specializations rather than distinct verbs, and coverage gaps exist (e.g., migrations, a core capability in the body, are absent).

4 / 5

Completeness

The 'what' is clear (expert database architect doing design from scratch, technology selection, schema modeling), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It cannot score 2 because the 'what' is specific, not vague.

3 / 5

Trigger Term Quality

Terms like 'database', 'schema modeling', and 'technology selection' are relevant, but common natural phrases users would say — 'design a schema', 'choose a database', 'data migration', 'sharding', 'SQL vs NoSQL' — are missing. Not 4 because several high-frequency variations and synonyms are absent.

3 / 5

Distinctiveness Conflict Risk

The description is somewhat specific to data-layer design, but overlaps with adjacent skills the body itself acknowledges (database-admin, database-optimizer, backend-architect), so it could still trigger for the wrong skill. Not 4 because the description does nothing to differentiate itself from those near-neighbors.

3 / 5

Total

13

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/database-architect/SKILL.md

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.