CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

twenty-record-presentation

Retrieve and present Twenty CRM records as readable summaries or tables, using the connected Twenty MCP server to discover fields, fetch relevant data, format dates and values, build record links, and avoid raw API output.

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

—

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

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

A strong instruction-only skill body: concrete tool names, path patterns, worked date examples, and copy-paste Markdown templates, organized into well-labeled sections with fallbacks for missing data. The only meaningful gaps are minor redundancy around ID-display rules and the absence of an explicit verification step in the retrieval workflow.

DimensionReasoningScore

Conciseness

The body is dense, directive, and assumes competence — no space is spent explaining what a CRM, timestamp, or Markdown table is, and every bullet is a distinct rule. It is 4 rather than 5 because of minor tightening opportunities, e.g. raw-ID guidance is repeated across "Record Links" ("Prefer linking the record display name... instead of adding a raw ID column") and "Table Alignment" ("Avoid raw ID columns... destroy alignment").

4 / 5

Actionability

Guidance is fully concrete and executable: exact tool chain "learn_tools → execute_tool", the link path pattern "/object/:objectNameSingular/:objectRecordId", worked timestamp conversions ("2026-05-05T09:43:18.123Z → May 5, 2026, 11:43 AM"), explicit field-label mappings, and copy-paste-ready compact-table and labeled-block templates. As an instruction-only skill with concrete, specific guidance throughout, it meets the top anchor.

5 / 5

Workflow Clarity

The retrieval workflow is clearly sequenced (select MCP server → learn_tools → discover fields → retrieve → format → present) with fallback checkpoints for missing context, missing recordReferences, unknown workspace origin, and no available MCP server. It is 4 rather than 5 because there is no explicit verification step (e.g. confirming the fetched record count matches what was requested) before presenting.

4 / 5

Progressive Disclosure

The body is well-organized into clearly headed sections with no bundle files and no nested or dead references — appropriate for a presentation-formatting skill whose rules are all needed at answer time. It is 4 rather than 5 because at ~159 lines, detail-heavy catalogs such as the field-label mapping table and the fine-grained Table Alignment rules could be split into a one-level-deep reference file, slightly trimming the always-loaded surface.

4 / 5

Total

17

/

20

Passed

Description

75%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 specific, well-scoped description with concrete actions and strong distinctiveness, written in third person without fluff. Its main weakness is the absence of any 'Use when...' trigger clause and of the natural object-level vocabulary (contacts, companies, opportunities, deals) users would use when asking for records.

Suggestions

Append a 'Use when...' clause, e.g. 'Use when the user asks about Twenty CRM records — contacts, companies, opportunities, deals, or notes — or wants them shown as readable summaries or tables.'

Add natural trigger synonyms for common Twenty objects (people/companies, deals/opportunities, tasks/notes) so the description matches how users actually phrase record requests.

Optionally include a trigger phrase tied to the MCP context, such as 'Use when a Twenty MCP server is connected and the user wants CRM data instead of raw API output.'

DimensionReasoningScore

Specificity

"Retrieve and present Twenty CRM records", "discover fields, fetch relevant data, format dates and values, build record links, and avoid raw API output" lists six concrete, distinct actions covering the skill's full capability surface. This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' rather than 4, where coverage would show gaps.

5 / 5

Completeness

The 'what' is explicit and detailed ("Retrieve and present Twenty CRM records as readable summaries or tables..."), but there is no 'Use when...' clause or equivalent explicit trigger guidance anywhere in the description. Per the judging guideline, a missing 'Use when...' clause caps completeness at 3; it is not 2 because the 'what' is clear and specific.

3 / 5

Trigger Term Quality

Natural terms are present — "Twenty CRM records", "records", "summaries or tables", "record links" — which a user asking about CRM data would plausibly say. It falls short of 5 because common synonyms users actually say ("show my contacts", "companies", "deals", "opportunities", "list my pipeline") are absent, and above 3 because the core natural phrasing is there rather than only technical jargon.

4 / 5

Distinctiveness Conflict Risk

"Twenty CRM" and "connected Twenty MCP server" name a specific product with distinct triggers, giving a clear niche with minimal conflict risk against generic data-presentation or other CRM skills. It is not 4, since the vendor/product qualifier leaves essentially no overlap ambiguity.

5 / 5

Total

17

/

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

relative_links

Relative link issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

twentyhq/twenty

Path

packages/twenty-claude-skills/skills/twenty-record-presentation/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.