CtrlK
BlogDocsLog inGet started
Tessl Logo

nullable-new-params

Fix newly added optional parameters, optional React props, and optional type/interface members in Remotion monorepo diffs by converting internal APIs to required nullable values and updating call sites. Use when a PR, review, or user asks to forbid new `foo?: T` / `param?: T` additions except for exported or documented public APIs where requiring the value would be breaking.

80

Quality

100%

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

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.

A tight, high-signal skill body: imperative rules, a verified executable scanner, copy-paste refactoring patterns, an explicit re-validation loop, and a review checklist, all with zero padding. The public-vs-internal classification step and compat boundary pattern handle the only real ambiguity in the task.

DimensionReasoningScore

Conciseness

The body is dense imperative rules, commands, and minimal before/after snippets; it never explains concepts Claude already knows (no TypeScript tutorials, no rationale padding). The only prose is one short 'why' sentence in the intro, which earns its place; this fits the 'every token earns its place' anchor rather than the score-4 'minor trimming needed' anchor.

5 / 5

Actionability

Guidance is fully executable: a real scanner command with variants (`bun .agents/skills/nullable-new-params/scripts/find-new-optional-params.ts origin/main...HEAD`, `--cached`), concrete Before/After type and parameter examples, explicit caller patterns (`field: null`, `maybeValue ?? null`), a boundary conversion (`const internal = publicValue ?? null`), and a build command (`bunx turbo run make --filter='<package-name>'`). The referenced script exists in the bundle and is a working scanner, so nothing is pseudocode.

5 / 5

Workflow Clarity

The 7-step workflow (scan → classify → refactor → update callers → update implementation → public compat → verify) has an explicit validation loop ("Run the scanner again until only intentional public API exceptions remain"), a verification command, and a closing review checklist — matching the anchor requiring feedback loops and checklists. Not the score-4 anchor, since no checkpoint is missing.

5 / 5

Progressive Disclosure

Sections (Rule, Workflow, Review checklist) are well organized, everything inline is short and needed up front, and the single bundle file (scripts/find-new-optional-params.ts) is real, referenced one level deep, and demonstrated with usage variants. There is no content that belongs in a separate file and no nested references, so it fits the clear-overview/one-level-deep anchor.

5 / 5

Total

20

/

20

Passed

Description

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

An exemplary description: concise, third-person, concrete about what it does, explicit about when to use it, and tightly scoped to its niche with the public-API exception stated. No fluff or over-claims.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with comprehensive coverage of the niche: "Fix newly added optional parameters, optional React props, and optional type/interface members", "converting internal APIs to required nullable values and updating call sites", plus the exported/documented public-API exception. It matches the anchor for multiple specific concrete actions rather than the score-4 anchor, which expects minor coverage gaps.

5 / 5

Completeness

It explicitly answers both what (fix/convert/update call sites) and when ("Use when a PR, review, or user asks to forbid new `foo?: T` / `param?: T` additions...") with concrete trigger phrases, matching the score-5 anchor exactly rather than the score-4 anchor where the 'when' could be more specific.

5 / 5

Trigger Term Quality

Natural trigger phrasing is well covered with synonyms: "optional parameters", "optional React props", "optional type/interface members", "nullable", "PR, review", and the literal diff syntax "`foo?: T` / `param?: T`" a reviewer would actually quote. This exceeds the score-4 anchor (a few natural terms missing) and approaches the domain-appropriate equivalent of the comprehensive example.

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche — new-optional-member hygiene in Remotion monorepo diffs with a public-API exception — with distinct triggers unlikely to fire for other skills. The score-4 anchor (minor overlap with closely related skills) is not met; even a general TypeScript linting skill would not collide with these triggers.

5 / 5

Total

20

/

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
remotion-dev/remotion
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.