Skip to content

Security: protocol/perun

Security

SECURITY.md

Security policy

This repository ships markdown skills and local install scripts. There is no networked service and no runtime sandbox.

How to install a pinned copy (AST02 / AST07)

Do not curl | bash unsigned HEAD. Do not treat npx skills add owner/repo without a tag as a pin — that follows whatever the default branch is today.

Verified path:

git clone --branch vX.Y.Z --depth 1 \
  https://github.com/protocol/perun.git
cd perun
# optional: sha256sum -c SHA256SUMS
./install.sh /path/to/your/project

Replace vX.Y.Z with a published release tag (see GitHub Releases). The AGENTS.md stamp records Installed: **x.y.z** (@ sha) after copy.

SHA256SUMS covers the three skill trees under .claude/skills/. Regenerate with bash scripts/write-checksums.sh. Lane PRs do not commit it; the land commit (the one that bumps VERSION) does, and CI checks the file against the tree there. This is a content hash, not OpenSSF Model Signing — do not claim a signed skill.

Optional marketplace path, still pinned:

npx skills add protocol/perun#vX.Y.Z --skill deep-code-review

Prefer --copy over a symlink that auto-updates. npx skills update without a re-review is AST07.

Reporting a vulnerability

Open a private GitHub security advisory on this repository, or an issue if the finding is already public. Do not file a proof-of-concept exploit against systems you do not own.

Honest gaps

  • install.sh is local cp -R. It does not sign the payload.
  • Required-review branch protection is off so a same-owner merge is not trapped. Status check gates is required.
  • Secret-scanning validity checks and non-provider patterns are GitHub product settings; they may need GitHub Secret Protection. Do not claim they are on unless the live security_and_analysis payload says so.

There aren't any published security advisories