Skill58 estrellas del repoactualizado 4d ago

openskills-runtime-debug

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.

Ver fuente Repositorio: openskills

Instalar en Claude Code

Copiar

git clone --depth 1 https://github.com/Geeksfino/openskills /tmp/openskills-runtime-debug && cp -r /tmp/openskills-runtime-debug/.cursor/skills/openskills-runtime-debug ~/.claude/skills/openskills-runtime-debug

Después abre una sesión nueva de Claude Code; el skill carga automáticamente.

Definición

SKILL.md

# OpenSkills Runtime Debug

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

```bash
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

Del mismo repositorio

openskills-bindings-maintainerSkill

Maintain compatibility between openskills-runtime and language bindings (TypeScript, Python), including feature flags, build configuration, and smoke verification.

openskills-dev-orchestratorSkill

Route OpenSkills development tasks to the right project skill or subagent, including sequencing rules for debugging, feature work, regression checks, and release readiness.

openskills-e2e-test-runbookSkill

Run deterministic OpenSkills end-to-end validation across runtime tests and example agents, then report tool calls, activation behavior, and regressions.

openskills-plugin-separationSkill

Enforce clean separation between core openskills-runtime and optional WASM build plugins so plugin compilation does not break runtime consumers or language bindings.

openskills-release-opsSkill

Prepare and validate OpenSkills release readiness across runtime, bindings, examples, and regression gates with a deterministic checklist and go/no-go outcome.

openskills-skill-authoringSkill

Create and refine OpenSkills-compatible skills (SKILL.md + optional resources) with strong metadata, clear activation triggers, and reliable execution guidance.

code-reviewSkill

Reviews code for quality, best practices, and potential issues. Use when asked to review, audit, or check code for problems.

explaining-codeSkill

Explains code clearly and thoroughly. Use when asked to explain, clarify, or teach about code snippets, functions, or concepts.