Kognitos debugging
Debug Kognitos applications and workflows by isolating failure boundaries, capturing evidence, and narrowing the issue quickly.From its SKILL.md
npx -y skills add kognitos/kognitos-plugin --skill kognitos-debuggingAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its file declares
Copied from the file, not written here
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
2.6 KB, as published. Nobody here has run it
Kognitos Debugging
Use this skill when a Kognitos-backed application or workflow is failing and you need a reliable triage path.
Default Flow
- Use references/triage-flow.md to identify whether the issue is UI, integration, workflow, or environment related.
- Use references/evidence-capture.md to collect logs, payloads, and repro notes before changing code.
- Run scripts/collect_debug_bundle.py when you need a quick local evidence summary.
API-Driven Debugging
When debugging run failures or exceptions, use the API endpoints from the kognitos-api-client skill:
- List recent runs to find the failing run — see runs-api.md.
- List run events for the step-by-step execution log — the primary debugging view.
- Inspect exceptions to see error details, group, and resolution status — see exceptions-api.md.
- Read the resolution thread (
list_eventson the exception) to see what the agent tried. - Reply to the exception agent to guide resolution, or assign to an operator.
- Check troubleshooting guides for known resolutions before escalating.
- Generate a run report from run-report-template.md to capture the full audit trail.
When To Load More
- For narrowing the fault domain: references/triage-flow.md
- For reproducible evidence collection: references/evidence-capture.md
- For a quick local debug bundle: scripts/collect_debug_bundle.py
- For run event logs and run control: kognitos-api-client/references/runs-api.md
- For exception inspection and resolution: kognitos-api-client/references/exceptions-api.md
- For structured run audit trails: kognitos-api-client/assets/run-report-template.md
Notes
- Capture evidence before “fixing” anything that is not yet explained.
- Prefer narrowing one boundary at a time over shotgun instrumentation.
- Use the run report template to document findings — it converts cleanly to HTML, PDF, or Confluence.