https://github.com/grittygrease/safe-encryption-skill
SAFE encryption skill for AI coding assistants
https://github.com/grittygrease/safe-encryption-skill
agent-skills claude-code copilot cryptography cursor encryption safe skill windsurf
Last synced: 4 months ago
JSON representation
SAFE encryption skill for AI coding assistants
- Host: GitHub
- URL: https://github.com/grittygrease/safe-encryption-skill
- Owner: grittygrease
- License: apache-2.0
- Created: 2026-02-01T13:51:22.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-02-15T02:20:17.000Z (4 months ago)
- Last Synced: 2026-02-15T09:34:48.293Z (4 months ago)
- Topics: agent-skills, claude-code, copilot, cryptography, cursor, encryption, safe, skill, windsurf
- Size: 57.6 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# safe-encryption
[](https://skills.sh/grittygrease/safe-encryption-skill)
[](https://www.npmjs.com/package/@grittygrease/safe-encryption-skill)
[](https://github.com/grittygrease/safe-encryption-skill/stargazers)
[](LICENSE)
A skill for encrypting and decrypting files using [SAFE](https://github.com/grittygrease/safe).
> **Modern encryption alternative to GPG/PGP** with post-quantum support, composable authentication paths, and random-access editing. Includes agent-to-agent encrypted communication capabilities.
## What This Skill Does
When installed, your AI coding assistant will know how to:
- Encrypt/decrypt files with passwords or public keys
- Generate encryption keypairs (x25519, p-256, ml-kem-768)
- Set up two-factor encryption (password + key)
- Configure multi-party encryption (separation of duties)
- Use post-quantum encryption for future-proof security
- Edit encrypted files without full re-encryption
- Manage recipients (add/remove/rotate keys)
- **Exchange encrypted messages with other agents**
- **Auto-generate AGENTS.md for projects**
## Installation
### Using the Skills CLI (recommended)
```bash
npx skills add grittygrease/safe-encryption-skill
```
This works with Cursor, Claude Desktop, Windsurf, and other AI coding assistants that support the [skills ecosystem](https://skills.sh).
### Using npm
```bash
npm install @grittygrease/safe-encryption-skill
```
Then add the skill to your AI assistant's configuration.
### Manual Installation
#### Global (all projects)
```bash
mkdir -p ~/.claude/skills/safe-encryption
curl -o ~/.claude/skills/safe-encryption/SKILL.md \
https://raw.githubusercontent.com/grittygrease/safe-encryption-skill/main/SKILL.md
```
Or clone the repo:
```bash
git clone https://github.com/grittygrease/safe-encryption-skill.git /tmp/skill
cp -r /tmp/skill ~/.claude/skills/safe-encryption
rm -rf /tmp/skill
```
#### Project-specific
```bash
mkdir -p .claude/skills/safe-encryption
curl -o .claude/skills/safe-encryption/SKILL.md \
https://raw.githubusercontent.com/grittygrease/safe-encryption-skill/main/SKILL.md
```
## Also Required: SAFE CLI or Browser
This skill teaches your assistant how to use the `safe` command.
```bash
curl -sSfL https://thesafe.dev/install.sh | sh
```
Or via package managers:
```bash
pip install safe-encryption # Python
npm install -g safe-encryption # Node.js
cargo install safe-encryption # Rust
```
Verify: `safe --help`
**No CLI? No problem.** If you can't install the CLI (restricted environment, no build tools, sandboxed IDE), the skill will automatically fall back to the web interface at [thesafe.dev](https://thesafe.dev). All operations work in the browser — no installation required.
### MCP Server (AI-native)
For AI assistants with MCP support, the `safe-mcp` server exposes encrypt/decrypt/keygen as native tool calls:
```json
{
"mcpServers": {
"safe": {
"command": "safe-mcp"
}
}
}
```
Build from source: `cd /path/to/safe/go && go build -o safe-mcp ./cmd/safe-mcp`
## Usage
Once installed, just ask naturally:
- "Encrypt this file with a password"
- "Generate an encryption keypair"
- "Set up two-factor encryption for secrets.txt"
- "Encrypt this for Alice and Bob"
- "Decrypt credentials.safe"
### Agent-to-Agent Communication
Agents can exchange encrypted messages across any text channel:
- "Set up my agent identity"
- "Create an AGENTS.md for this project"
- "Send an encrypted message to this public key"
- "Check if this encrypted message is for me"
- "Post an encrypted message to pastebin"
The skill includes conventions for reply-to keys, Key ID matching, and multi-identity management.
## Also Available On
This skill is distributed on multiple platforms for maximum discoverability:
- **GitHub**: [grittygrease/safe-encryption-skill](https://github.com/grittygrease/safe-encryption-skill)
- **npm**: [@grittygrease/safe-encryption-skill](https://www.npmjs.com/package/@grittygrease/safe-encryption-skill)
- **Skills.sh**: [skills.sh/grittygrease/safe-encryption-skill](https://skills.sh/grittygrease/safe-encryption-skill) *(indexed after first installs)*
- **SkillsMP**: Auto-indexed from GitHub *(requires 2+ stars)*
Want to see this skill on more platforms? Star the repo on GitHub!
## License
Apache-2.0