菜单
Digital asset storefront management bot for the Vouch platform. USE WHEN processing orders, listing items, answering customer questions, or generating sales analytics. Supports STL, SVG, digital art, ebooks, and any downloadable digital asset.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Audit and compliance workflows for enterprise governance. USE WHEN audit OR compliance OR export OR soc2 OR eu ai act OR nist OR governance report OR audit trail.
Team and agent management workflows. USE WHEN manage team OR add member OR create agent OR team settings OR agent autonomy OR team permissions.
Queue-based task management with capture and autonomous execution. USE WHEN do work OR capture request OR work queue OR start working OR queue status OR process requests. Manages a persistent task queue.
Tutorial skill demonstrating the skill system. USE WHEN learning skills OR creating first skill OR testing skill activation. Shows the minimum viable skill structure.
Session review and learning capture system. USE WHEN reflect OR review learnings OR what did I learn OR extract lessons OR session insights OR improve skills. Extracts actionable learnings from work sessions.
General-purpose web research with configurable depth. USE WHEN research OR look up OR find out OR what is OR deep dive OR compare options OR investigate. Supports quick lookups, deep dives, and comparative analysis.
| name | Shopkeep |
| description | Digital asset storefront management bot for the Vouch platform. USE WHEN processing orders, listing items, answering customer questions, or generating sales analytics. Supports STL, SVG, digital art, ebooks, and any downloadable digital asset. |
| version | 0.1.0 |
| author | Percival Labs |
| tags | ["commerce","storefront","digital-assets","vouch","lightning"] |
Manages all storefront operations: listing digital assets, processing Lightning-paid purchases, answering buyer questions, and reporting sales analytics. Operates autonomously within owner-defined constraints.
| Workflow | Trigger | File |
|---|---|---|
| ListItem | "list a new item", "add a product", "sell this file" | Workflows/ListItem.md |
| ProcessOrder | Purchase confirmation, payment webhook, "new order" | Workflows/ProcessOrder.md |
| CustomerSupport | Customer question, "help with purchase", product inquiry | Workflows/CustomerSupport.md |
| Analytics | "how are sales?", "show me stats", "analytics", "report" | Workflows/Analytics.md |
All endpoints require NIP-98 authentication signed with the bot's Nostr keypair.
POST /v1/storefronts/{id}/listings -- Create new listingGET /v1/storefronts/{id}/listings -- List all listingsGET /v1/storefronts/{id}/listings/{lid} -- Get listing detailsPATCH /v1/storefronts/{id}/listings/{lid} -- Update listing (owner approval required for price)DELETE /v1/storefronts/{id}/listings/{lid} -- Remove listing (owner approval required)POST /v1/storefronts/{id}/listings/{lid}/purchase -- Initiate purchase (returns Lightning invoice)POST /v1/storefronts/{id}/listings/{lid}/confirm -- Confirm payment and get download tokenGET /v1/storefronts/{id}/orders -- List orders for storefrontGET /v1/storefronts/{id}/analytics?period=daily|weekly|monthly -- Sales analyticsExample 1: Owner lists a new STL file
Owner: "List my new articulated dragon STL for 500 sats"
-> Invokes ListItem workflow
-> Collects: title, description, category (stl), price (500), file URL, preview images
-> Computes SHA-256 hash of the file
-> Creates listing via API, publishes NIP-99 event to relays
-> Reports listing URL and Nostr event ID to owner
Example 2: Buyer purchases a listing
System: Payment confirmed for listing lid_abc123
-> Invokes ProcessOrder workflow
-> Verifies payment via /confirm endpoint
-> Receives download token
-> Sends buyer: confirmation, download link, file hash, download limits
-> Logs sale, notifies owner with daily totals
Example 3: Buyer asks about a product
Buyer: "What material should I use for this STL?"
-> Invokes CustomerSupport workflow
-> Looks up listing metadata (recommended materials, dimensions, print settings)
-> Answers from listing data
-> Escalates to owner if answer not in metadata
Example 4: Owner checks sales
Owner: "How did we do this week?"
-> Invokes Analytics workflow
-> Fetches sales data for the week
-> Generates markdown report: revenue, transactions, top sellers, trends
-> Includes trend indicators and category breakdown