orpc-contract-first

Guide for implementing oRPC contract-first API patterns in Dify frontend. Triggers when creating new API contracts, adding service endpoints, integrating TanStack Query with typed contracts, or migrating legacy service calls to oRPC. Use for all API layer work in web/contract and web/service directories.

Install with Tessl CLI

npx tessl i github:langgenius/dify --skill orpc-contract-first

What are skills?

Overall
score

81%

Review — 83%

Does it follow best practices?

If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:

npx tessl skill review --optimize ./path/to/skill

Learn more

Evaluation — 100%

↑ 2.00x

Agent success when using this skill

Validation — 13 / 16 Passed

Validation for skill structure

SKILL.md

Review

Evals

Evaluation results

99%

57%

Add In-App Notifications API Contract

Contract definition and structure

Criteria

Without context

With context

Contract file location

100%

base import

100%

type import from @orpc/contract

100%

path field defined

100%

method field defined

100%

input field defined

100%

output field defined

100%

Detailed input structure

100%

Path param syntax

100%

Path param in params object

100%

Type import source

88%

type<T>() helper

100%

Without context: $1.2166 · 10m 13s · 30 turns · 31 in / 9,405 out tokens

With context: $0.6622 · 2m 31s · 34 turns · 61 in / 8,243 out tokens

100%

30%

Wire Up Subscription Management API for Frontend Consumption

Router registration and no-barrel-file rule

Criteria

Without context

With context

Router file updated

100%

Direct domain import in router

100%

No barrel file created

100%

API prefix nesting

100%

Hook file location

63%

100%

Multiple hooks created

100%

consoleQuery queryKey called

100%

Correct group.contract in queryKey

100%

consoleClient called as fetcher

44%

100%

Correct group.contract in client call

56%

100%

ConsoleInputs type export preserved

100%

Without context: $0.4437 · 1m 46s · 22 turns · 71 in / 5,383 out tokens

With context: $0.7325 · 2m 41s · 30 turns · 31 in / 8,974 out tokens

100%

63%

Implement Audit Log API Integration

TanStack Query hooks and type exports

Criteria

Without context

With context

Contract file in console/

100%

base import used

100%

Detailed input structure

100%

Path param in path string

100%

Path param in params schema

100%

Hook file naming

100%

consoleQuery.queryKey usage

100%

consoleClient call usage

100%

ConsoleInputs reflects new contracts

100%

No barrel files

100%

Without context: $0.4964 · 2m 6s · 24 turns · 135 in / 6,214 out tokens

With context: $0.6285 · 2m 24s · 27 turns · 323 in / 8,647 out tokens

Evaluated: about 12 hours ago
Agent: Claude Code

Table of Contents

Add In-App Notifications API Contract Wire Up Subscription Management API for Frontend Consumption Implement Audit Log API Integration

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.