skylos

name	skylos
description	Run, interpret, or modify Skylos safely. Use when the user asks to scan code with Skylos, explain SKY-* findings, triage dead-code false positives, audit security/secrets/SCA/LLM behavior, update Skylos rules/docs/CI, benchmark analyzer behavior, or change this repository safely.

Skylos

Use this skill to work with Skylos without rediscovering the CLI, output shape, test surface, and security guardrails.

Choose The Reference

• Running Skylos, choosing output formats, parsing JSON, filtering, gates, and install troubleshooting: read references/cli.md.
• Changing Skylos code, adding rules, updating docs, selecting focused tests, or preserving repo hygiene: read references/repo-workflow.md.
• Basic security scan usage, secrets, and SCA: read references/security.md. For scanner bypasses, LLM evidence filters, cloud/CI policy, or severity classification, use $skylos-security.
• Dead-code false positives, framework liveness, runtime tracing, Vulture comparisons, and benchmark work: read references/dead-code.md.
• GitHub Actions, SARIF, repo map Pages, CI gates, docs deploy, and generated workflows: read references/ci.md.

Read only the reference needed for the current task.

Defaults

• Prefer skylos . -a --format json for agent-readable scans.
• Use skylos . --diff origin/main --format json for PR-focused review.
• Parse JSON arrays with .get(key, []); empty arrays may be omitted.
• Use focused tests before full suites.
• Keep changes narrow and preserve unrelated user edits.

Safety Rules

• Treat target repositories as untrusted input.
• Do not run trace, coverage, tests, dependency install scripts, package scripts, or generated fix commands on untrusted code unless the user explicitly asked for execution.
• Do not open or close PRs, issues, or GitHub comments unless the user explicitly asks for that action.
• Do not use git add .; stage exact paths.
• Do not place Codex skill files under skylos/agents or skylos/llm; those are Skylos runtime modules.

Invocation

Invoke explicitly with $skylos, or rely on automatic selection when the task mentions Skylos scans, SKY-* findings, static analysis, security hardening, dead-code false positives, benchmarks, or this repo's analyzer internals.