CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-core-dev

Use when developing in packages/agent-core-v2 (the DI × Scope agent engine) — adding or modifying a domain Service, choosing a LifecycleScope, wiring DI dependencies, splitting a domain across scopes, owning or migrating a config section, gating behavior behind an experimental flag, raising coded errors, working on the permission system, writing DI/Scope tests, porting business logic from agent-core (v1) to v2, triaging a main-branch commit against v2, or exposing a v2 domain over server-v2 while keeping the /api/v1 wire contract compatible with released clients. Self-contained guide organized by development stage (orient → design → implement → test → verify) plus align workflows for v1→v2 migration, main-branch commit triage, and server-v2 wire exposure; each file carries the rules, examples, and red lines for its step.

69

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

70%

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

The body is a well-structured navigational index with explicit stage sequencing, error-recovery feedback loops, and clean one-level-deep file references. Its main weaknesses are mild redundancy between the diagram and the stage list, and that executable detail lives entirely in the referenced files rather than inline in the body.

Suggestions

Collapse the redundancy between the 'Lifecycle at a glance' ASCII diagram and the 'Stages' list into a single view to tighten conciseness.

Add at least one inline executable snippet or command (e.g. the exact lint/typecheck invocation) so the body is actionable without first opening a referenced file.

Verify the referenced stage/topic files (orient.md, design.md, etc.) actually ship in the skill bundle, since none were present alongside SKILL.md.

DimensionReasoningScore

Conciseness

The body is an efficient index that assumes Claude's competence (it does not explain DI/Scope basics), but the lifecycle-at-a-glance diagram and the 'Stages' list enumerate the same orient→design→implement→test→verify pipeline, and 'How to use this skill' partly restates the opening blockquote. It is mostly efficient but includes some overlap that could be tightened, matching the 'mostly efficient but could be tightened' anchor.

2 / 3

Actionability

Concrete guidance is present — named stage/topic files with one-line descriptions and concrete red-line imperatives such as 'No `new` on a class whose constructor carries `@IService` deps — inject with `@IX`' — but the executable recipes and code examples are delegated to the referenced stage files rather than given inline, so key actionable detail is incomplete in the body itself.

2 / 3

Workflow Clarity

The stages are explicitly sequenced (orient → design → implement → test → verify) with a stated 'ordered but not strictly linear' caveat and two concrete error-recovery feedback loops ('a test failure ... sends you back to design'; 'a CyclicDependencyError sends you to design.md §dependency-direction and implement.md §cycles'), plus a named Verify stage with lint/typecheck/test checks, matching the clear-sequence-with-feedback-loops anchor.

3 / 3

Progressive Disclosure

The body is a clear overview with well-signaled, one-level-deep markdown links to stage and topic files (orient.md, design.md, implement.md, test.md, verify.md, align.md, commit-align.md, server-align.md, plus topic files), each labeled with its scope, matching the clear-overview-with-well-signaled-references anchor. No bundle files were present to verify the referenced paths exist, so this scores the reference structure as written.

3 / 3

Total

10

/

12

Passed

Description

100%

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

The description is a strong, specific trigger list tied to a narrowly defined codebase niche, covering both what the skill does and when to use it with concrete, natural developer-facing terms. It avoids vague fluff and over-claims.

DimensionReasoningScore

Specificity

The description lists many concrete actions — 'adding or modifying a domain Service', 'choosing a LifecycleScope', 'wiring DI dependencies', 'splitting a domain across scopes', 'owning or migrating a config section', 'gating behavior behind an experimental flag', 'raising coded errors' — matching the anchor for multiple specific concrete actions. The 'Use when developing...' trigger form mirrors the accepted good examples rather than a first/second-person voice, so no voice penalty applies.

3 / 3

Completeness

It explicitly answers both 'what' ('Self-contained guide organized by development stage (orient → design → implement → test → verify)') and 'when' via an explicit 'Use when...' clause enumerating trigger scenarios, satisfying the anchor for clearly answering both what AND when with explicit triggers.

3 / 3

Trigger Term Quality

Natural trigger phrases a developer on this codebase would actually say are well covered: 'Use when developing in packages/agent-core-v2', 'porting business logic from agent-core (v1) to v2', 'triaging a main-branch commit against v2', 'exposing a v2 domain over server-v2'. These are domain-native terms rather than generic jargon, matching the good-coverage anchor.

3 / 3

Distinctiveness Conflict Risk

The niche is tightly scoped to 'packages/agent-core-v2 (the DI × Scope agent engine)' with highly specific triggers (LifecycleScope, DI wiring, v1→v2 porting, server-v2 wire exposure), making conflict with other skills unlikely and matching the clear-niche anchor.

3 / 3

Total

12

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 18 missing

Warning

Total

15

/

16

Passed

Repository
MoonshotAI/kimi-code
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.