Fix Interface
Developmentfix-interfaceFix Interface is an Agent Skill for development published in the wrtnlabs/autobe repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Fix Interface and Controller compilation errors
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/wrtnlabs/autobe/blob/HEAD/internals/template/realize/.claude/skills/fix-interface/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/fix-interface, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Fix Interface Errors
Fix interface and controller compilation errors according to code conventions.
FORBIDDEN
NEVER use:
askeyword (type assertion)anytype
Fix type issues by properly defining interfaces.
DO NOT MODIFY
Leave as-is:
console.login Controller catch blocksconsole.errorin Controller catch blocks
These are intentional and should not be changed to NestJS Logger.
Purpose
Fix compilation errors in interface and controller files to ensure npm run build:main passes.
Workflow
┌─────────────────────────────────────┐
│ Step 1: Run Build │
│ npm run build:main │
└───────────────┬─────────────────────┘
│
▼
┌─────────────────────────────────────┐
│ Step 2: Parse Interface Errors │
│ - Empty interfaces {} │
│ - Type mismatches │
│ - Missing properties │
└───────────────┬─────────────────────┘
│
▼
┌─────────────────────────────────────┐
│ Step 3: Fix by Convention │
│ - Fill empty interfaces │
│ - Add typia tags │
│ - Fix nullable types │
└───────────────┬─────────────────────┘
│
▼
┌─────────────────────────────────────┐
│ Step 4: Re-run Build │
│ Loop until 0 errors │
└─────────────────────────────────────┘
Step 1: Run Build
npm run build:main 2>&1 | head -100
Capture interface-related errors.
Step 2: Parse Errors
Common error patterns:
Type '{}' is not assignable→ Empty interfaceProperty 'X' does not exist on type '{}'→ Empty interfaceType 'string' is not assignable to type 'string & Format<"uuid">'→ Missing typia tag
Step 3: Fix by Convention
Empty Interface Fix
Read Prisma schema and fill interface:
// Before
export type IEntity = {};
// After
import { tags } from "typia";
export type IEntity = {
id: string & tags.Format<"uuid">;
name: string;
status: "active" | "inactive";
created_at: string & tags.Format<"date-time">;
updated_at: string & tags.Format<"date-time">;
deleted_at: (string & tags.Format<"date-time">) | null;
};
ICreate Convention
export namespace IEntity {
export type ICreate = {
name: string;
status?: "active" | "inactive"; // optional with default
};
}
IUpdate Convention
export namespace IEntity {
export type IUpdate = {
name?: string;
status?: "active" | "inactive";
};
}
ISummary Convention
export namespace IEntity {
export type ISummary = {
id: string & tags.Format<"uuid">;
name: string;
status: "active" | "inactive";
created_at: string & tags.Format<"date-time">;
};
}
IRequest Convention
export namespace IEntity {
export type IRequest = {
page?: number & tags.Minimum<1>;
limit?: number & tags.Minimum<1> & tags.Maximum<100>;
search?: string;
status?: "active" | "inactive";
};
}
Typia Tags
// UUID
id: string & tags.Format<"uuid">;
// Email
email: string & tags.Format<"email">;
// URL
url: string & tags.Format<"uri">;
// DateTime
created_at: string & tags.Format<"date-time">;
// Numeric constraints
page: number & tags.Minimum<1>;
limit: number & tags.Minimum<1> & tags.Maximum<100>;
Nullable Types
// Nullable field
deleted_at: (string & tags.Format<"date-time">) | null;
// Optional nullable field
description?: string | null;
Path Naming Fix
Fix redundant path segments where the same word repeats:
// Before - redundant word in path: /{word}/{word}s
@Controller("{prefix}/{word}/{word}s")
export class {Word}{Word}sController { ... }
// After - remove redundant segment
@Controller("{prefix}/{word}s")
export class {Word}sController { ... }
Pattern to fix:
/{word}/{word}s→/{word}s/{word}/{word}-*→/{word}-*or/{word}/*
When fixing paths, also update:
- Controller
@Controller()decorator - Controller class name
- Controller file name and directory
- Related provider function names
- Test file paths and API calls
Step 4: Verify
npm run build:main
Repeat Steps 2-4 until no interface errors.
Common Fixes
| Error Pattern | Fix |
|---|---|
Empty interface {} | Read Prisma schema, define all fields |
| Missing typia tag | Add appropriate tags.Format<> |
| Nullable mismatch | Add | null for nullable fields |
| Missing namespace | Add namespace with ICreate, IUpdate, etc. |
Redundant path /{word}/{word}s | Remove duplication: /{word}s |
Exit Condition
npm run build:maincompletes with no interface errors- All interfaces properly defined
- All typia tags applied
- No redundant path segments (
/{word}/{word}spattern)