debug

Troubleshoots Outfitter Dev Kit issues including Result handling, MCP problems, CLI output, exit codes, and logging. Use when debugging stack-specific issues, unexpected errors, wrong output modes, or when "debug Result", "MCP not working", "wrong exit code", or "logging issue" are mentioned.

Ir a la instalación

Repositorio: outfitter-dev/outfitter
Última actividad en el origen: 17 de marzo de 2026 a las 17:22
Idioma detectado de SKILL.md: inglés
Estrellas: 6
Forks: 1

Opciones de instalación

De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.

npx skills add https://github.com/outfitter-dev/outfitter --skill debug

El comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.

¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.

Revisa los archivos de origen

Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.

SKILL.md

Instrucciones de origen · Vista previa de solo lectura

Volver a la búsqueda Volver a la instalación

outfitter-daemon

Patterns for @outfitter/daemon including lifecycle management, IPC communication, health checks, and PID files. Use when building background services, daemons, or when "daemon", "IPC", "health check", "background service", or "@outfitter/daemon" are mentioned.

2026-03-24

scaffold

Creates handlers, CLI commands, MCP tools, and daemon services following Outfitter Dev Kit conventions. Use when adding new components to a project, scaffolding code, or when "create handler", "new command", "add tool", or "daemon service" are mentioned.

2026-03-24

outfitter-mcp

Deep patterns for @outfitter/mcp including tool registration, Zod schemas, resources, and server configuration. Use when building MCP servers, registering tools, defining resources, or when "MCP server", "MCP tool", "registerTool", or "@outfitter/mcp" are mentioned.

2026-03-18

Ver todos los de este repositorio

// BAD: Reassigning breaks narrowing
let result = await getUser(id);
if (result.isOk()) {
  result = await updateUser(result.value); // Breaks!
}

// GOOD: Separate variables
const getResult = await getUser(id);
if (getResult.isErr()) return getResult;
const updateResult = await updateUser(getResult.value);

if (result.isErr()) {
  switch (result.error._tag) {
    case "ValidationError":
      console.log(result.error.context);
      break;
    case "NotFoundError":
      console.log(result.error.resourceId);
      break;
  }
}

server.registerTool(myTool);
server.start(); // After registration!

Check schema is valid Zod with .describe():

const schema = z.object({
  query: z.string().describe("Required for AI"),
});

Verify handler is async:

handler: async (input) => {
  // Not sync!
  return Result.ok(data);
};

Return Result, not raw value:

// BAD
return { data: "value" };

// GOOD
return Result.ok({ data: "value" });

Force mode:
```
await output(data, { mode: "json" });
```

Check environment:

OUTFITTER_JSON=1 myapp list
OUTFITTER_JSON=0 myapp list --json  # Forces human!

Await output:

// BAD
output(data);
process.exit(0); // May exit before output!

// GOOD
await output(data);

Use exitWithError:

// BAD
process.exit(1);

// GOOD
exitWithError(result.error);

Exit code table:

Category Exit
validation 1
not_found 2
conflict 3
permission 4
timeout 5
rate_limit 6
network 7
internal 8
auth 9
cancelled 130

const logger = createLogger({
  redaction: { enabled: true }, // Must be true!
});

// Custom patterns
const logger = createLogger({
  redaction: {
    enabled: true,
    patterns: ["password", "apiKey", "myCustomSecret"],
  },
});

import { createChildLogger } from "@outfitter/logging";

const requestLogger = createChildLogger(ctx.logger, {
  requestId: ctx.requestId,
  handler: "myHandler",
});

requestLogger.info("Processing", { data }); // Includes requestId

const logger = createLogger({
  level: process.env.LOG_LEVEL || "info",
});

// Hierarchy: trace < debug < info < warn < error < fatal
// "info" hides trace and debug

function traceResult<T, E>(name: string, result: Result<T, E>): Result<T, E> {
  console.log(
    `[${name}]`,
    result.isOk() ? "OK:" : "ERR:",
    result.isOk() ? result.value : result.error
  );
  return result;
}

const result = traceResult("getUser", await getUser(id));

console.log("Context:", {
  requestId: ctx.requestId,
  hasLogger: !!ctx.logger,
  hasConfig: !!ctx.config,
  hasSignal: !!ctx.signal,
  cwd: ctx.cwd,
});

const parseResult = schema.safeParse(rawInput);
if (!parseResult.success) {
  console.log("Zod errors:", parseResult.error.issues);
}

name	debug
version	0.1.0
description	Troubleshoots Outfitter Dev Kit issues including Result handling, MCP problems, CLI output, exit codes, and logging. Use when debugging stack-specific issues, unexpected errors, wrong output modes, or when "debug Result", "MCP not working", "wrong exit code", or "logging issue" are mentioned.
allowed-tools	Read Grep Glob Bash(rg ) Bash(bun )

name	debug
version	0.1.0
description	Troubleshoots Outfitter Dev Kit issues including Result handling, MCP problems, CLI output, exit codes, and logging. Use when debugging stack-specific issues, unexpected errors, wrong output modes, or when "debug Result", "MCP not working", "wrong exit code", or "logging issue" are mentioned.
allowed-tools	Read Grep Glob Bash(rg ) Bash(bun )

debug

Opciones de instalación

Revisa los archivos de origen

Stack Debugging

Result Issues

Always Getting Error

Stack Debugging

Result Issues

Always Getting Error

Type Narrowing Broken

Error Type Lost

MCP Issues

Tool Not Appearing

Tool Invocation Failing

CLI Output Issues

JSON Not Printing

Wrong Exit Code

Logging Issues

Redaction Not Working

Missing Context

Wrong Level

Debugging Tools

Trace Result Chain

Inspect Context

Validate Zod Schema

Related Skills

Category	Exit
validation	1
not_found	2
conflict	3
permission	4
timeout	5
rate_limit	6
network	7
internal	8
auth	9
cancelled	130

debug

Datos de origen

Opciones de instalación

Revisa los archivos de origen

Más de este repositorio

Más de este repositorio

Stack Debugging

Result Issues

Always Getting Error

Stack Debugging

Result Issues

Always Getting Error

Type Narrowing Broken

Error Type Lost

MCP Issues

Tool Not Appearing

Tool Invocation Failing

CLI Output Issues

JSON Not Printing

Wrong Exit Code

Logging Issues

Redaction Not Working

Missing Context

Wrong Level

Debugging Tools

Trace Result Chain

Inspect Context

Validate Zod Schema

Related Skills