CtrlK
BlogDocsLog inGet started
Tessl Logo

g14wxz/lenguaje-ubicuo

Lenguaje ubicuo para agentes de código: explicaciones cortas, directas y sin jerga, y un glosario compartido (docs/lenguaje-ubicuo.md) cuyas palabras se usan igual en la conversación, el código, los tests y la base de datos.

76

Quality

95%

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

Overview
Quality
Evals
Security
Files

Quality

Content

100%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 is an exemplary short-form skill: lean, project-specific, with real grep/git/migration commands, explicit pre-commit validation and feedback loops for rename/migration operations, and a single verified external reference holding the table template. Nothing is padded and nothing important is missing.

DimensionReasoningScore

Conciseness

The ~53-line body is lean and every section carries project-specific guidance; no padding or explanations of concepts Claude already knows. The brief opening definition is anchored to project conventions ('El glosario vive en docs/lenguaje-ubicuo.md y sigue la plantilla de…'), so every token earns its place.

5 / 5

Actionability

Fully executable commands throughout: `grep -rniE "sale|order|transaction" src/`, `git grep -n -i "<término viejo>" -- . ':!docs/lenguaje-ubicuo.md' ':!**/migrations/**'`, and concrete project commands ('npx sequelize-cli db:migrate', 'npm test'). Includes a concrete report format with file:line and an example clarifying question.

5 / 5

Workflow Clarity

Four clearly numbered workflows with explicit validation checkpoints for destructive/batch operations: pre-commit checks ('Que no quede el término viejo…', 'Que la migración nueva se aplica sin errores y que los tests pasan… Si algo falla, arréglalo antes del commit') and a repeat-until-clean feedback loop ('Después de cada cambio de nombre aprobado, repite la búsqueda: no debe quedar ninguna coincidencia').

5 / 5

Progressive Disclosure

Well-organized sections with a single, clearly signaled one-level-deep reference: 'sigue la plantilla de [references/plantilla-glosario.md](references/plantilla-glosario.md)' — the file exists (43 lines) and contains the table template appropriately kept out of SKILL.md. Content split is appropriate for a short skill.

5 / 5

Total

20

/

20

Passed

Description

87%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 description: third-person voice, concrete artifact and actions, and multiple explicit 'Use when…' triggers covering project start, naming decisions, new/ambiguous terms, synonyms, and code-language review. Only minor gaps in synonym coverage keep trigger quality and specificity at 4.

DimensionReasoningScore

Specificity

Names the artifact ('glosario de lenguaje ubicuo del proyecto (docs/lenguaje-ubicuo.md)') and three concrete actions ('Crea, actualiza y revisa'), plus where the vocabulary applies ('la conversación, el código, los tests y la base de datos'). Falls just short of the 5 anchor's comprehensive multi-action coverage since sub-capabilities (rename propagation, migration handling) are only implied.

4 / 5

Completeness

Explicitly answers both questions: what ('Crea, actualiza y revisa el glosario… el vocabulario compartido…') and when ('Úsala al empezar un proyecto…, al nombrar…, cuando aparece un término nuevo o ambiguo…'). Multiple concrete trigger phrases, matching the anchor-5 example structure.

5 / 5

Trigger Term Quality

Natural triggers are well covered: 'al empezar un proyecto desde un documento de requisitos', 'al nombrar tablas, modelos, funciones o rutas', 'cuando aparece un término nuevo o ambiguo', 'cuando hay dos palabras para lo mismo', 'cuando piden revisar si el código habla igual que el negocio'. A few natural phrasings (e.g. 'glosario', 'DDD', 'speak the same language') are absent, so it sits between anchors 4 and 5, closer to 4.

4 / 5

Distinctiveness Conflict Risk

Clear niche (ubiquitous-language glossary management at a fixed path) with distinct triggers; minimal overlap risk with other skills. The 'Úsala…' triggers are specific to glossary/naming situations, not generic code work.

5 / 5

Total

18

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Reviewed

Table of Contents