CtrlK
BlogDocsLog inGet started
Tessl Logo

architecture

Use when navigating the codebase for the first time, adding a new client method, adding a new container handler/service, or understanding how a request flows from Worker through the Sandbox DO into the container. Covers the three-layer architecture, client pattern, container runtime structure, and monorepo layout. (project)

85

1.33x
Quality

77%

Does it follow best practices?

Impact

100%

1.33x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.agents/skills/architecture/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a well-structured skill description with an explicit 'Use when' clause covering multiple trigger scenarios and project-specific terminology that makes it highly distinctive. Its main weakness is that it describes what it 'covers' (reference material) rather than listing concrete actions it performs, making the specificity slightly weaker. Overall, it would serve well for skill selection among many skills.

Suggestions

Rephrase 'Covers the three-layer architecture...' to use more active, concrete verbs like 'Explains the three-layer architecture, guides adding new client methods and container handlers, traces request flow from Worker through Sandbox DO into the container.'

DimensionReasoningScore

Specificity

Names the domain (codebase navigation, client methods, container handlers) and some actions (adding a new client method, adding a new container handler/service), but the actions are more about use cases than concrete capabilities the skill provides. It describes what it 'covers' (architecture, client pattern, runtime structure, monorepo layout) rather than specific actions it performs.

2 / 3

Completeness

Explicitly answers both 'what' (covers three-layer architecture, client pattern, container runtime structure, monorepo layout) and 'when' (navigating codebase for first time, adding a new client method, adding a new container handler/service, understanding request flow). The 'Use when' clause is present and detailed.

3 / 3

Trigger Term Quality

Includes strong natural trigger terms users would say: 'navigating the codebase', 'new client method', 'container handler/service', 'request flows', 'Worker', 'Sandbox DO', 'container', 'three-layer architecture', 'monorepo layout'. These are specific terms a developer would naturally use when onboarding or trying to understand the project structure.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with project-specific terminology (Worker, Sandbox DO, three-layer architecture, container runtime). The combination of these specific architectural concepts and the '(project)' tag makes it very unlikely to conflict with other skills.

3 / 3

Total

11

/

12

Passed

Implementation

64%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a solid architectural overview skill that provides genuinely useful, project-specific information with concrete file paths and clear patterns. Its main strengths are actionability (precise paths, explicit rules about which path to use) and good structural organization. Weaknesses include missing validation checkpoints in the workflow for adding new operations and some unnecessary general knowledge padding that could be trimmed.

Suggestions

Add explicit validation/verification steps to the 'When adding a new container control operation' workflow — e.g., 'Run unit tests after step 2 before proceeding to step 3' or 'Verify the RPC contract matches on both sides'.

Trim general knowledge that Claude already knows: remove explanations of what DI containers are, what npm workspaces do, and generic Docker advice like 'keep images lean'. Focus only on project-specific constraints.

Consider splitting the container base image details and the full specialized client listing into separate referenced files to improve progressive disclosure.

DimensionReasoningScore

Conciseness

The content is mostly efficient and well-structured, but includes some information Claude would already know (e.g., explaining what npm workspaces are, what DI containers do, what Ubuntu is). Some sections like 'Container Base Image' include general advice ('keep images lean') that is common knowledge. However, the architecture-specific details are genuinely useful and not padded excessively.

2 / 3

Actionability

The skill provides concrete, specific guidance: exact file paths for every component, clear step-by-step instructions for adding new container control operations (4-step process with specific directories), and explicit rules about when to use which path. The directory references are precise and actionable.

3 / 3

Workflow Clarity

The 'When adding a new container control operation' section provides a clear 4-step sequence, but lacks validation checkpoints — there's no explicit verification step between adding the service and adding tests, no mention of how to validate the control-plane method works before mirroring it on the SDK side. For a multi-step process touching multiple packages, a feedback loop would be valuable.

2 / 3

Progressive Disclosure

The content is well-organized with clear headers and logical sections, but it's a monolithic document with no references to supporting files. Given the breadth of topics covered (architecture, request flow, container runtime, monorepo structure, base image), some content like the container base image details or the full client listing could be split into referenced files. However, no bundle files exist, so this is evaluated in isolation.

2 / 3

Total

9

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
cloudflare/sandbox-sdk
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.