OpenSkills Runtime Debug

SkillDev tools

Diagnose openskills-runtime execution failures in sandboxed paths (Landlock, seatbelt, native script execution, wasm execution) and produce root-cause-first findings with minimal-risk remediation steps.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the OpenSkills Runtime Debug skill

What this skill tells your AI

The instructions your AI receives, as published by geeksfino/openskills in .cursor/skills/openskills-runtime-debug/SKILL.md and read by ahel’s review.

Use this skill when debugging runtime failures in runtime/ and execution paths used by run_skill_target, native scripts, or sandbox enforcement.

Primary Targets

  • runtime/src/executor.rs
  • runtime/src/native_runner.rs
  • runtime/src/wasm_runner.rs
  • runtime/src/permissions.rs
  • runtime/tests/*sandbox*
  • runtime/tests/seatbelt_tests.rs

Workflow

  1. Reproduce with the smallest command that fails.
  2. Classify failure bucket:
    • sandbox policy issue
    • feature/config mismatch
    • script/tool resolution issue
    • wasm runtime issue
  3. Confirm behavior against tests and existing fallback logic.
  4. Propose the smallest safe fix that preserves security boundaries.
  5. Re-run focused tests, then broader runtime tests.

Recommended Commands

cargo check -p openskills-runtime
cargo test -p openskills-runtime
cargo test -p openskills-runtime seatbelt_tests -- --nocapture

Debug Heuristics

  • Treat silent degradation in sandbox setup as high risk.
  • Prefer explicit error propagation over ignored Result.
  • If fallback behavior is intentional, confirm it is visible in logs and tests.
  • Keep macOS and Linux behavior differences explicit in findings.

Output Format

Return:

  1. Root cause
  2. Impact surface
  3. Fix proposal
  4. Verification evidence
  5. Residual risks

Signals

GitHub stars
71
Forks
13
Last commit
Aug 2026
Advanced
Catalog kind
skill
Gateway key
openskills-runtime-debug
Source
github.com/geeksfino/openskills