api-development

API Development Skill

Overview

This skill provides guidance for implementing backend API services with TypeScript and Node.js. It covers file system operations, process management, service architecture, error handling, and cross-platform compatibility. For US-4 (MCP Uninstaller), this skill is specifically tailored for:

• File validation and verification services
• Process detection and termination
• Directory removal with safety checks
• Rollback mechanism implementation

Core Capabilities

• Service Architecture: Create well-structured TypeScript services with clear separation of concerns
• File System Operations: Implement safe file/directory operations with proper error handling
• Process Management: Detect and terminate processes cross-platform (Windows, macOS, Linux)
• Error Handling: Implement comprehensive error handling with specific error types
• Cross-Platform Support: Handle platform differences in file paths and process management
• Async/Await Patterns: Use modern async patterns for non-blocking operations
• Type Safety: Leverage TypeScript for type-safe implementations

Input Requirements

Required:

• Task ID and description
• Files to create or modify
• Acceptance criteria
• Dependencies on other tasks

Optional:

• Existing service interfaces
• Project architecture patterns
• Testing requirements

Output Format

The skill returns:

• Service implementation with TypeScript
• Interface/type definitions
• Error handling patterns
• Usage examples
• Testing guidance

Dependencies

• TypeScript 5.x: For type-safe implementation
• Node.js 18+: For runtime environment
• fs-extra: Enhanced file system operations
• child_process: For process management
• rimraf or native fs.rm: For recursive directory deletion

Workflow

Step 1: Define Service Interface

Create TypeScript interfaces for the service:

// src/interfaces/service-name.interface.ts
export interface ServiceResult {
  success: boolean;
  data?: any;
  error?: string;
}

export interface ServiceOptions {
  // Service-specific options
}