Skip to content

Commit bf322c7

Browse files
committed
Update docs landing page: elevate skill signing, broaden tagline
1 parent 2a3f25a commit bf322c7

1 file changed

Lines changed: 23 additions & 6 deletions

File tree

docs/index.md

Lines changed: 23 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,24 @@
11
# SchemaPin
22

3-
**Cryptographic tool schema verification to prevent MCP Rug Pull attacks.**
3+
**Cryptographic integrity for AI tool schemas and skill directories — signing, verification, TOFU pinning, and trust bundles.**
44

55
SchemaPin is the tool integrity layer of the [ThirdKey](https://thirdkey.ai) trust stack: **SchemaPin** (tool integrity) → [AgentPin](https://agentpin.org) (agent identity) → [Symbiont](https://symbiont.dev) (runtime).
66

77
---
88

99
## What SchemaPin Does
1010

11-
SchemaPin enables developers to cryptographically sign tool schemas (ECDSA P-256 + SHA-256) and clients to verify schemas haven't been tampered with. It uses Trust-On-First-Use (TOFU) key pinning and `.well-known` endpoints for public key discovery.
11+
SchemaPin enables developers to cryptographically sign tool schemas and skill directories (ECDSA P-256 + SHA-256) and clients to verify they haven't been tampered with. It uses Trust-On-First-Use (TOFU) key pinning and `.well-known` endpoints for public key discovery.
1212

13-
- **Schema Signing** — ECDSA P-256 signatures over canonicalized JSON schemas
13+
- **Schema Signing** — ECDSA P-256 signatures over canonicalized JSON tool schemas
14+
- **Skill Directory Signing** — Sign entire skill directories, producing a `.schemapin.sig` manifest that covers every file
1415
- **Verification** — Signature verification with public key discovery and TOFU pinning
15-
- **Skill Signing** — Sign entire skill directories with `.schemapin.sig` manifests (v1.3)
16-
- **Trust Bundles** — Offline verification with pluggable discovery resolvers (v1.2)
16+
- **Trust Bundles** — Offline verification with pluggable discovery resolvers
1717
- **Revocation** — Key and schema revocation with standalone documents
1818

19-
## Quick Example
19+
## Quick Examples
20+
21+
### Sign a Tool Schema
2022

2123
```python
2224
from schemapin.crypto import KeyManager, SignatureManager
@@ -40,6 +42,21 @@ is_valid = SignatureManager.verify_signature(public_key, canonical, signature)
4042
print(f"Valid: {is_valid}")
4143
```
4244

45+
### Sign a Skill Directory
46+
47+
```python
48+
from schemapin.skill import sign_skill, verify_skill_offline
49+
from schemapin.verification import KeyPinStore
50+
51+
# Sign all files in a skill directory (writes .schemapin.sig)
52+
sig = sign_skill("./my-skill/", private_key_pem, "example.com")
53+
print(f"Signed {len(sig.file_manifest)} files, root hash: {sig.skill_hash}")
54+
55+
# Verify the skill hasn't been tampered with
56+
result = verify_skill_offline("./my-skill/", discovery_doc, sig, None, KeyPinStore())
57+
print(f"Verified: {result.valid}")
58+
```
59+
4360
## Implementations
4461

4562
| Language | Package | Install |

0 commit comments

Comments
 (0)