troubleshoot

Diagnose and resolve insight-wave plugin issues with remediation steps.

12|2|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/cogni-work/insight-wave --skill troubleshoot-cogni-work
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshoot
Source: https://github.com/cogni-work/insight-wave/tree/main/cogni-help/skills/troubleshoot
Command: npx skills add https://github.com/cogni-work/insight-wave --skill troubleshoot-cogni-work

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and resolve issues with insight-wave plugins, focusing on plugin-level and cross-plugin problems.

Core Features & Use Cases

  • Targeted plugin diagnostics: verify plugin availability, integrity of skill files, and correct SKILL.md frontmatter.
  • Cross-plugin health checks: validate dependencies and interplay between plugins, including environment readiness.
  • Structured remediation: present Problem → Cause → Fix guidance and actionable next steps.

Quick Start

Describe the plugin issue you’re seeing and I will run targeted diagnostics and provide fixes.

Frequently Asked Questions about troubleshoot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose broken insight-wave plugins and skill errors?

To diagnose broken insight-wave plugins, the system validates plugin availability, skill file integrity, and SKILL.md frontmatter. It checks environment readiness and stale state files, then provides actionable Problem, Cause, and Fix remediation steps.

What causes cross-plugin dependency issues and misconfigurations in workflows?

Cross-plugin dependency issues usually stem from failed interplay between plugins or environment unreadiness. Diagnostics validate these dependencies and check progress and state health to isolate the root cause of the workflow misconfiguration.

How do I fix stale state files and environment issues affecting my plugins?

Fix stale state files and environment issues by running targeted diagnostics that verify progress and state health alongside environment readiness. The system identifies stale state and provides structured remediation steps to restore plugin functionality.

Does plugin troubleshooting validate SKILL.md frontmatter and file integrity?

Yes, plugin troubleshooting validates SKILL.md frontmatter and checks skill file integrity. It confirms plugin availability and verifies that core skill files are not corrupted or misconfigured before attempting further dependency checks.

What is the best way to resolve insight-wave plugin errors fast?

The best way to resolve insight-wave plugin errors fast is to describe the issue and let the system run targeted diagnostics. It checks file integrity, dependencies, and environment readiness, returning structured Problem, Cause, and Fix guidance.