Report security issues privately through the GitHub Security Advisory rather than opening a public issue. Do not include exploit details, credentials, or other sensitive values in public reports.
Use private reporting for any credible security vulnerability, including:
- workflow steps or scripts that could expose secrets, encourage unsafe configurations, or cause destructive repository changes;
- compromised or misleading shipped skill payloads;
- credentials or unsafe sensitive examples in evidence manifests; and
- supply-chain or privilege risks in repository scripts, dependencies, or CI workflows.
Ordinary documentation defects, feature requests, and behavior bugs without a credible security impact may be opened as public GitHub issues. When uncertain, report privately.
Repository security covers maintainer infrastructure outside the shipped payload: GitHub Actions workflows, validation and monitoring scripts, evidence manifests, and URL contract checks. These components must preserve the declared shipping boundary, avoid exposing credentials, and prevent unreviewed content from entering the runtime payload.
CI validates skill structure, portability, documentation integrity, and external contract reachability. A passing validator is evidence for these defined checks, not a claim that the repository or its recommendations are free of vulnerabilities.
The shipped payload is a single SKILL.md and five reference files with no
runtime scripts, no config files, and no dependencies. Shipped instructions
are checked for agent-specific references by CI portability gate.
The workflow teaches agents to inspect candidate skills for provenance, dependencies, permissions, and maintenance activity. Suspected sensitive values are reported by existence and location only. Credible exposure is prioritized ahead of lower-value review, and the agent recommends revocation or rotation without reproducing the value.
Always-on safety rules live in
skills/skill-discovery/SKILL.md.
Detailed trust evaluation guidance is in
references/trust-review.md.
SECURITY.md summarizes the trust boundary; it does not replace those
runtime instructions.
- All shipped files redact sensitive values and report existence or location only.
- Credible credential exposure stops lower-priority review and prompts rotation guidance.
- Filename and pattern checks are described as heuristic, not proof of a clean repository.
- Reports and recommendations exclude sensitive values.
- CI checks the payload for common live-token and private-key patterns.
- The shipped payload contains no destructive reset, forced-push, or secret-dumping commands.
- External evidence manifests verify reachability without storing credentials.
Last reviewed: 2026-07-25.