skills.rest
awebai
awebaiOFFICIAL
Explore all skills by this author →
GitHub

present-to-human

Mint capability URLs to present folio documents to humans via POST /v1/present.

82|9|Updated Feb 2, 2026
Search Tags:#revocation#present#document sharing#folio#aweb#aw cli#capability link
One-click install
npx skills add https://github.com/awebai/aweb --skill present-to-human-awebai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: present-to-human
Source: https://github.com/awebai/aweb/tree/main/naapp/folio/skills/present-to-human
Command: npx skills add https://github.com/awebai/aweb --skill present-to-human-awebai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agents working in the aweb ecosystem need a way to show folio documents to humans who have no account, team certificate, or agent runtime. This Skill mints a document-bound capability link so a human can open a server-rendered HTML page of one pinned document version. ## Core Features & Use Cases - Capability Link Minting: Calls POST /v1/present with a document slug, optional pinned version, and optional TTL to receive an opaque token and public URL. - Human-Friendly Delivery: Opens the URL with the system opener (open or xdg-open) and prints it as a fallback for headless environments. - Revocation and Privacy: Supports revoking tokens via POST /v1/present/<token>/revoke; the public page hides team id, document id, version metadata, and certificate fields. - Use Case: After an agent finishes drafting a team document in folio, it mints a 24-hour present link and hands the URL to a reviewer who reads it in a browser without any credentials. ## Quick Start Ask the agent to present the folio document with a given slug to a human by minting a present link and opening the returned URL.

Frequently Asked Questions about present-to-human

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I share a folio document with a human who has no account?▼

Mint a capability link by sending POST /v1/present with the document slug, an optional version, and an optional ttl_seconds. The response contains a public URL the human can open in a browser without any login or team certificate.

How to pin a specific document version in a present link?▼

Include the version field in the POST /v1/present JSON body to pin that version. Omitting version pins the current latest version of the document at mint time.

What prerequisites are needed to mint a folio present link?▼

You need a workspace with an active AWID team certificate, verified with aw workspace status and aw id cert show, plus the FOLIO_ORIGIN environment variable pointing at the folio server. Requests authenticate with the --team-auth flag of aw id request.

Can I revoke a folio present link after sharing it?▼

Yes, send POST /v1/present/<token>/revoke with team authentication using the token from the original response. Revoked, expired, or unknown tokens return 404 for public viewers.

What information does the public present page expose?▼

The public page does not expose the team id, document id, version metadata, creator identity, or certificate fields. It only renders the pinned document content behind the opaque token.

Related Skills

Explore More Software Engineering Skills→
DalomeveDalomeve
3

clawhub-web-only-publish

Publish ClawHub skills through the web dashboard without CLI login.

Community
Intermediate
ivanyeorsivanyeors

feedback-channels-plan

Plan and document product feedback channels with routing and handover artifacts.

Community
Intermediate
evolution-foundationevolution-foundation
520

workspace-share

Create, list, and revoke public share links for workspace files.

Official
Intermediate
LinnanliLinnanli
1

web-clone

Clone live websites by extracting visual layout and basic interactivity with Playwright MCP.

Community
Advanced