Syncause: Fix the Real Problem with Evidence

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:

1. Reproduce the issue: Turn a reported failure into a reproducible fact. No more guessing what triggered the bug.
2. 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.
3. 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.

Manual Installation

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.

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>" }
    }
  }
}

Note: Environment variables are optional. If not provided, the server will run in anonymous mode.

Step 1: Skill installation

⚠️ IMPORTANT
Ensure that:

1. The GitHub Copilot Chat extension is installed.
2. chat.useAgentSkills is enabled in settings.

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>" }
    }
  }
}

Note: Environment variables are optional. If not provided, the server will run in anonymous mode.

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>" }
    }
  }
}

Note: Environment variables are optional. If not provided, the server will run in anonymous mode.

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>"

Note: Environment variables are optional. If not provided, the server will run in anonymous mode.

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>" }
    }
  }
}

Note: Environment variables are optional. If not provided, the server will run in anonymous mode.

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

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

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

Note: Environment variables are optional. If not provided, the server will run in anonymous mode.

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

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>" }
    }
  }
}

Note: Environment variables are optional. If not provided, the server will run in anonymous mode.

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

TIP
OpenCode is also compatible with Claude's skill directories: .claude/skills/ and ~/.claude/skills/

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
    }
  }
}

Note: Environment variables are optional. If not provided, the server will run in anonymous mode.

Appendix

Skill directory summary