CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

call-log-composition

Use this skill when working with call log composition, formatting call details, handling AI notes, transcripts, and understanding the call log flow in App Connect.

80

1.87x
Quality

78%

Does it follow best practices?

Impact

92%

1.87x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agent-skills/call-log-composition/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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, code-dense body that teaches the App Connect call log composer through executable examples and a clear flow map, with little wasted prose. The main improvements are trimming the redundant output-format listings and moving reference-grade material (format specs, upsert/parsing APIs) into separate reference files.

Suggestions

Consolidate the three output-format examples into one representative example plus a brief note on the differences, trimming ~30 lines of near-duplicate output.

Move the output-format specifications and the upsert/parsing API details into a references/ file (e.g. FORMATS.md), keeping SKILL.md as a lean overview with clearly signaled links.

Add a validation checkpoint in the Call Log Flow (e.g., verify the composed format matches getLogFormatType() and handle CRM API errors) and show the upsertCallRecordingLink example that is imported but never demonstrated.

DimensionReasoningScore

Conciseness

The body is almost entirely executable code with no padding or explanations of concepts Claude already knows — every section adds App-Connect-specific knowledge (format constants, composer API, upsert functions, handler flow). Minor trim opportunities exist: the three full output-format listings (HTML/Markdown/Plain Text) are largely redundant with each other, and the User Settings section repeats the userSettings pattern already shown in the connector example — 'efficient; minor instances that could be trimmed' (level 4), not level 5's every-token-earns-its-place.

4 / 5

Actionability

Nearly all guidance is copy-paste-ready: the require statements, the full composeCallLog invocation with realistic arguments, upsert function calls, and the parsing snippet are executable. The connector implementation retains placeholders ('// ... other fields', apiUrl, headers) and the upsertCallRecordingLink import is never demonstrated — 'mostly executable guidance with minor gaps' rather than fully covering the common cases.

4 / 5

Workflow Clarity

The 'Call Log Flow' section gives a clear 5-step sequence with specific file paths and functions (handlers/log.js → composeCallLog → connector.createCallLog → CallLogModel), and the flow is read coherently across sections. There are no explicit validation checkpoints (e.g., verifying format type or API response handling), but these are not destructive or batch operations, so the level-3 cap does not apply; this sits at 'clear sequence with most checkpoints present; minor validation gaps'.

4 / 5

Progressive Disclosure

The file has good section structure but everything is inlined in a single ~214-line SKILL.md with no bundle files and no references: the three output-format specifications, the upsert API, and the log-parsing example are reference material that could live in separate files. This matches level 3 ('some structure; content that should be separate is inline') — the under-50-lines exception does not apply, and it lacks level 4's mostly-appropriate placement or clearly signaled references.

3 / 5

Total

15

/

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 solid description: it names the domain, several concrete capabilities, and an explicit 'Use when...' trigger clause scoped to App Connect. The main weaknesses are mildly generic verbs ('handling', 'understanding the call log flow') and missing natural trigger variations like 'log a call' or 'call logging'.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "call log composition, formatting call details, handling AI notes, transcripts" — grounded in a specific domain (App Connect), with minor gaps ("handling" is somewhat generic and no mention of parsing/updating logs). It matches the anchor 'Lists several specific actions; minor gaps in coverage' and is not level 5, since coverage is not comprehensive, nor level 3, since more than 1-2 concrete actions are named.

4 / 5

Completeness

Both parts are present: the 'what' ("composition, formatting call details, handling AI notes, transcripts") and an explicit 'when' clause ("Use this skill when working with... in App Connect"). The 'when' could be more concrete (e.g., 'when creating a connector that logs calls to a CRM'), which is exactly the level-4 anchor 'both what and when; when could be more explicit or specific' — not level 5's fully concrete triggers, and the explicit 'Use when...' clause rules out the level-3 cap.

4 / 5

Trigger Term Quality

Natural phrases like "call log", "formatting call details", "AI notes", "transcripts", and "call log flow" would plausibly appear in user requests. It falls short of level 5 because common variations such as "log a call", "call logging", or "call notes" are missing, but it clearly exceeds level 3's 'missing common variations' threshold only partially — good coverage with a few natural terms missing.

4 / 5

Distinctiveness Conflict Risk

The niche is fairly distinct — "call log composition" with AI notes/transcripts in "App Connect" is unlikely to capture generic logging or note-taking skills. Minor overlap risk remains with general call-logging or transcript-related skills, matching the level-4 anchor rather than level 5's 'clear niche with minimal conflict risk'.

4 / 5

Total

16

/

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.

Repository

ringcentral/rc-unified-crm-extension

Path

.agent-skills/call-log-composition/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.