Syncause: Fix the Real Problem with Evidence

April 14, 2026 · View on GitHub

From reported bug to reviewable fix.

AI can write code fast, but it still debugs like it’s blind. Without evidence, agents often guess and only fix symptoms, leading to "still broken" loops that burn time and tokens.

Syncause empowers your AI agent with a professional, evidence-based debugging workflow:

Reproduce the issue: Turn a reported failure into a reproducible fact. No more guessing what triggered the bug.
Fix from evidence: Access stack traces, request params, and variable snapshots from the moment the bug occurred. Fixes are based on what actually happened, not guesswork.
Review the repair report: Every fix is backed by cited evidence. See exactly why the code changed and the data that proves the fix is correct.

Mandatory Instruction Set

Syncause is a mandatory skill that constrains the Agent's behavior to ensure high-quality, professional repairs:

Mandatory Evidence Gathering: Before offering a fix, the Agent MUST fetch Runtime Facts to understand the failure context.
Evidence-Based Repair: When analyzing the issue, the Agent is required to explicitly cite specific data points (e.g., "The stack trace shows user_id was null at line 42...").
Reviewable Results: Moves the agent from "just patching" to "explaining and proving" the fix.

How it works

Syncause uses advanced Tracing technology to track all function calls and their arguments across your application, which are called Runtime Facts.

Full Traceability: We record the execution path in the background, capturing how data flows through your system.
Deep Visibility: When an error occurs, Syncause provides a "flight recorder" view of the exact sequence of calls leading up to the failure.
Zero Configuration: Instrumentation is handled automatically, so your agent gets deep insights without you manually adding logs or breakpoints.

Installation

Automatic Installation

Install the skill for your AI agents with a single command:

npx skills add Syncause/debug-skill

This skill depends on the Syncause MCP server, which will be automatically installed when your agents use this skill. If the installation fails, you will be prompted to install it manually.

If your agent isn't automatically detected in the automatic installation process, follow the manual setup guides below. For detailed configuration (including Login Mode), see the Anonymous Guide or Login Guide.

Cursor

Step 1: Skill installation

Prompt-guided installation

Help me install the Agent Skill: syncause-debugger
GitHub: https://github.com/Syncause/debug-skill/tree/main/skills/syncause-debugger

Please confirm the installation scope:
- Project-level: Install to the .cursor/skills/ directory
- Global: Install to the ~/.cursor/skills/ directory

Step 2: MCP installation

One-Click Deeplink Installation

Or, manually edit .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "debug-mcp-server": {
      "command": "npx",
      "args": ["-y", "@syncause/debug-mcp@latest"],
      "env": { "API_KEY": "<your-api-key>" }
    }
  }
}

VS Code (GitHub Copilot Chat)

Step 1: Skill installation

Prompt-guided installation

Help me install the Agent Skill: syncause-debugger
GitHub: https://github.com/Syncause/debug-skill/tree/main/skills/syncause-debugger

Please confirm the installation scope:
- Project-level: Install to the .github/skills/ directory
- Global: Install to the ~/.copilot/skills/ directory

Step 2: MCP installation

One-Click Deeplink Installation

Or, manually edit .vscode/settings.json:

{
  "servers": {
    "debug-mcp-server": {
      "command": "npx",
      "args": ["-y", "@syncause/debug-mcp@latest"],
      "env": { "API_KEY": "<your-api-key>" }
    }
  }
}

Claude Code

Step 1: Skill installation

Prompt-guided installation

Help me install the Agent Skill: syncause-debugger
GitHub: https://github.com/Syncause/debug-skill/tree/main/skills/syncause-debugger

Please confirm the installation scope:
- Project-level: Install to the .claude/skills/ directory
- Global: Install to the ~/.claude/skills/ directory

Step 2: MCP installation

CLI command (recommended)

# Project-level
claude mcp add --scope project debug-mcp-server -- npx -y @syncause/debug-mcp@latest

# User-level
claude mcp add --scope user debug-mcp-server -- npx -y @syncause/debug-mcp@latest

Or, manually edit .mcp.json (project-level) or ~/.claude/settings.json (user-level):

{
  "mcpServers": {
    "debug-mcp-server": {
      "command": "npx",
      "args": ["-y", "@syncause/debug-mcp@latest"],
      "env": { "API_KEY": "<your-api-key>" }
    }
  }
}

Codex

Step 1: Skill installation

Prompt-guided installation

Help me install the Agent Skill: syncause-debugger
GitHub: https://github.com/Syncause/debug-skill/tree/main/skills/syncause-debugger

Please confirm the installation scope:
- Project-level: Install to the .codex/skills/ directory
- Global: Install to the ~/.codex/skills/ directory

Step 2: MCP installation

CLI command (recommended)

codex mcp add debug-mcp-server --command "npx -y @syncause/debug-mcp@latest"

Or, manually edit ~/.codex/config.toml:

[mcp_servers.debug-mcp-server]
command = "npx"
args = ["-y", "@syncause/debug-mcp@latest"]

[mcp_servers.debug-mcp-server.env]
API_KEY = "<your-api-key>"

Gemini CLI

Step 1: Skill installation

CLI command (recommended)

# Project-level
gemini skills install https://github.com/Syncause/debug-skill.git --path skills/syncause-debugger --scope workspace

# Global
gemini skills install https://github.com/Syncause/debug-skill.git --path skills/syncause-debugger

Or, run the following in the Agent chat window within your terminal:

Help me install the Agent Skill: syncause-debugger
GitHub: https://github.com/Syncause/debug-skill/tree/main/skills/syncause-debugger

Please confirm the installation scope:
- Project-level: Install to the .gemini/skills/ directory
- Global: Install to the ~/.gemini/skills/ directory

Step 2: MCP installation

CLI command (recommended)

gemini mcp add debug-mcp-server npx -y @syncause/debug-mcp@latest

**Or,** manually edit `.gemini/settings.json` (project-level) or `~/.gemini/settings.json` (global):
```json
{
  "mcpServers": {
    "debug-mcp-server": {
      "command": "npx",
      "args": ["-y", "@syncause/debug-mcp@latest"],
      "env": { "API_KEY": "<your-api-key>" }
    }
  }
}

Antigravity

Step 1: Skill installation

Prompt-guided installation

Help me install the Agent Skill: syncause-debugger
GitHub: https://github.com/Syncause/debug-skill/tree/main/skills/syncause-debugger

Please confirm the installation scope:
- Project-level: Install to the .agent/skills/ directory
- Global: Install to the ~/.gemini/antigravity/skills/ directory

Step 2: MCP installation

Manually edit configuration

Open the Agent sidebar in the Editor or the Agent Manager view
Click the “…” (More Actions) menu and select MCP Servers
Select View raw config to open mcp_config.json file
Add the following configuration:

{
  "mcpServers": {
    "debug-mcp-server": {
      "command": "npx",
      "args": ["-y", "@syncause/debug-mcp@latest"],
      "env": { "API_KEY": "<your-api-key>" }
    }
  }
}

Save the file and click Refresh in the MCP panel to see the new tools

Windsurf

Step 1: Skill installation

Prompt-guided installation

Help me install the Agent Skill: syncause-debugger
GitHub: https://github.com/Syncause/debug-skill/tree/main/skills/syncause-debugger

Please confirm the installation scope:
- Project-level: Install to the .windsurf/skills/ directory
- Global: Install to the ~/.codeium/windsurf/skills/ directory

Step 2: MCP installation

Manually edit configuration Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "debug-mcp-server": {
      "command": "npx",
      "args": ["-y", "@syncause/debug-mcp@latest"],
      "env": { "API_KEY": "<your-api-key>" }
    }
  }
}

OpenCode

Step 1: Skill installation

Prompt-guided installation

Help me install the Agent Skill: syncause-debugger
GitHub: https://github.com/Syncause/debug-skill/tree/main/skills/syncause-debugger

Please confirm the installation scope:
- Project-level: Install to the .opencode/skills/ directory
- Global: Install to the ~/.config/opencode/skills/ directory

Step 2: MCP installation

Manually edit configuration Edit ~/.config/opencode/opencode.json:

{
  "$schema": "http://opencode.ai/config.json",
  "mcp": {
    "debug-mcp-server": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@syncause/debug-mcp@latest"],
      "environment": { "API_KEY": "<your-api-key>" },
      "enabled": true
    }
  }
}

Appendix

Skill directory summary

IDE	Project-level Path	Global Path
Cursor	`.cursor/skills/`	`~/.cursor/skills/`
VSCode	`.github/skills/`	`~/.copilot/skills/`
Claude Code	`.claude/skills/`	`~/.claude/skills/`
Codex	`.codex/skills/`	`~/.codex/skills/`
Gemini CLI	`.gemini/skills/`	`~/.gemini/skills/`
Antigravity	`.agent/skills/`	`~/.gemini/antigravity/skills/`
Windsurf	`.windsurf/skills/`	`~/.codeium/windsurf/skills/`
OpenCode	`.opencode/skills/`	`~/.config/opencode/skills/`