Agent skill

Folio Template Documents

by awebai in awebai/aweb

Creates or appends a folio document from the built-in pitch, memo or metrics templates by sending schema-checked slots that folio renders to Markdown.

MITAuto-check passedDocuments & Office

Install Folio Template Documents

skills CLI
$ npx skills add awebai/aweb --skill create-from-template -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install awebai/aweb create-from-template --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/awebai/aweb.git skills-src && mkdir -p .claude/skills && cp -r skills-src/naapp/folio/skills/create-from-template .claude/skills/create-from-template && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
create-from-template
GitHub stars
115
Token cost
~1.1k tokens
SKILL.md length
182 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Creates or appends a folio document from the built-in pitch, memo or metrics templates by sending schema-checked slots that folio renders to Markdown.

  • Creating a pitch document from structured slots in folio
  • SKILL.md covers Prerequisites, Template schema, Pitch body shape and Memo body shape, plus 3 more sections
  • Reaches folio.aweb.ai
  • Writing a team memo with a cover and headed sections

What it does

Folio stores documents as append-only Markdown, and this skill gives agents a safer way to produce common layouts. Instead of writing Markdown directly, the agent sends a request that names a template (pitch, memo or metrics) and a set of slots. Folio validates the slots against a schema and renders them to ordinary Markdown before storage.

Pitch accepts cover, metrics, sections and an ask; memo accepts cover and sections; metrics accepts cover and metrics. A cover needs a title, a metric entry needs a label and a value, and a section needs a heading. Unsupported templates, slots or fields are rejected with a 422 error. The agent can also append a template-generated version to an existing document and request a time-limited presentation link. Work runs from a workspace with an active AWID team certificate, with the folio server address set in an environment variable.

When your agent uses it

  • Creating a pitch document from structured slots in folio
  • Writing a team memo with a cover and headed sections
  • Publishing a launch metrics page with labeled values
  • Appending a template-rendered revision to an existing folio document

Example prompts

  • “Create a folio pitch with a cover, three metrics and a closing ask.”
  • “Write a team memo in folio with sections for background, decision and next steps.”
  • “Append a new version to the launch-metrics document and give me a presentation link.”

Requirements

  • The `aw` CLI with an active AWID team certificate
  • Access to a folio server, set through FOLIO_ORIGIN

What it can do on your machine

Read from SKILL.md and the folder at commit 682c445. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • folio.aweb.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Folio Template Documents loads about 1.1k tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 182 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~49
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from awebai/aweb at commit 682c445, republished under its MIT licence (© awebai). 182 words, ~1,106 tokens.

Download SKILL.mdSave it as .claude/skills/create-from-template/SKILL.md (or your agent's skills folder).
name
create-from-template
description
Use when an agent needs to create or append a folio document from a built-in declarative template: pitch, memo, or metrics. This is for USING folio, not changing server code.

Create a folio document from a built-in template

Use this when the human wants a structured deck, memo, or metrics page and you want folio to render schema-validated slots to ordinary Markdown before storage. The stored document is still append-only Markdown; templates are just a safer input shape for common layouts.

Prerequisites

Run from a workspace with an active AWID team certificate:

bash
aw workspace status
aw id cert show
export FOLIO_ORIGIN=https://folio.aweb.ai

For local development, use http://127.0.0.1:8765 instead.

Template schema

All template requests use:

json
{"name":"<pitch|memo|metrics>","slots":{}}

Minimal pitch selector shape: {"name":"pitch","slots":{"cover":{"title":"Deck"},"sections":[]}}.

Built-ins:

  • pitch: cover/metrics/sections/ask
  • memo: cover/sections
  • metrics: cover/metrics

Slot fields:

  • cover: title required; optional subtitle, eyebrow.
  • metrics: array of objects with label required, value required, optional caption.
  • sections: array of objects with heading required, optional body Markdown.
  • ask: object with optional headline, body Markdown, items array of strings.

Unsupported templates, slots, fields, or bad shapes fail closed with 422.

Pitch body shape

bash
cat > pitch-template.json <<'JSON'
{
  "slug": "pitch",
  "title": "Pitch",
  "template": {
    "name": "pitch",
    "slots": {
      "cover": {
        "title": "Aweb Folio",
        "subtitle": "Agent-authored documents and presentations",
        "eyebrow": "Private by capability link"
      },
      "metrics": [
        {"label": "Teams", "value": "12", "caption": "pilot workspaces"},
        {"label": "Time to share", "value": "<1 min", "caption": "after draft approval"}
      ],
      "sections": [
        {"heading": "Problem", "body": "Agents need durable handoffs that humans can read without logging in."},
        {"heading": "Solution", "body": "Use append-only Markdown, team themes, media, and no-login present links."}
      ],
      "ask": {
        "headline": "Ask",
        "body": "Approve launch and send the presentation link.",
        "items": ["Ship folio", "Watch deploy", "Follow up with feedback"]
      }
    }
  }
}
JSON
aw id request POST "$FOLIO_ORIGIN/v1/documents" --team-auth --raw \
  --body-file pitch-template.json

Memo body shape

bash
cat > memo-template.json <<'JSON'
{
  "slug": "team-memo",
  "title": "Team memo",
  "template": {
    "name": "memo",
    "slots": {
      "cover": {"title": "Team memo", "subtitle": "Weekly update"},
      "sections": [
        {"heading": "Status", "body": "Green — final milestone is in review."},
        {"heading": "Risks", "body": "Keep present links private and noindex."}
      ]
    }
  }
}
JSON
aw id request POST "$FOLIO_ORIGIN/v1/documents" --team-auth --raw \
  --body-file memo-template.json

Metrics body shape

bash
cat > metrics-template.json <<'JSON'
{
  "slug": "launch-metrics",
  "title": "Launch metrics",
  "template": {
    "name": "metrics",
    "slots": {
      "cover": {"title": "Launch metrics"},
      "metrics": [
        {"label": "Documents", "value": "3", "caption": "free-tier cap"},
        {"label": "Versions", "value": "50", "caption": "per document"}
      ]
    }
  }
}
JSON
aw id request POST "$FOLIO_ORIGIN/v1/documents" --team-auth --raw \
  --body-file metrics-template.json

Append a template-generated version

Use the template body without slug/title against the append endpoint:

bash
cat > pitch-v2-template.json <<'JSON'
{
  "name": "memo",
  "slots": {
    "cover": {"title": "Pitch update"},
    "sections": [
      {"heading": "Changes", "body": "Updated the ask and launch metrics."}
    ]
  }
}
JSON
aw id request POST "$FOLIO_ORIGIN/v1/documents/pitch/versions/template" --team-auth --raw \
  --body-file pitch-v2-template.json

Present the generated document

bash
aw id request POST "$FOLIO_ORIGIN/v1/present" --team-auth --raw \
  --body '{"slug":"pitch","ttl_seconds":86400}'

The returned /present/<token> page uses the same theme, layout, sanitizer, and noindex protections as any other folio document.

© awebai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in naapp/folio/skills/create-from-template of awebai/aweb.

Open the folder on GitHubat commit 682c445

Compare with similar skills

Folio Template Documents next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Folio Template Documents compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Folio Template Documents this skillawebai/aweb115—~1.1kAutomated safety check: PassMIT
Ky Markdown RebuilderKyrieCheungYep/ky-markdown-rebuilder117—~5.7kAutomated safety check: PassNone
Bookforge Korean Ebook PDF Makergongnyang/bookforge3141 repos~1.7kAutomated safety check: PassMIT
Marp Slide Creatorjjmartres/opencode1333 repos~2.2kAutomated safety check: PassMIT
Markdown to HTML ReportMegaSuperKitty/WeClaw370—~456Automated safety check: PassMIT
Human Reviewpetergyang/human-review1.4k—~2.1kAutomated safety check: PassMIT

Similar skills

  • Ky Markdown Rebuilder

    KyrieCheungYep/ky-markdown-rebuilder

    Rebuild visual documents into reliable Markdown by combining text extraction with page or screenshot alignment.

    117 GitHub stars~5.7k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Produces book-style Korean ebook PDFs from a topic or finished manuscript, with six design styles, real book parts and quality-check gates before output.

    314 GitHub starsUsed in 1 repo~1.7k tokens
    Documents & OfficeAuto-check passed
  • Marp Slide Creator

    jjmartres/opencode

    Builds Marp slide decks in one of seven ready-made themes, using bundled templates plus syntax, image and style references to keep slides short and readable.

    133 GitHub starsUsed in 3 repos~2.2k tokens
    Documents & OfficeAuto-check passed
  • Markdown to HTML Report

    MegaSuperKitty/WeClaw

    Drafts a report in Markdown with numbered inline citations and a references section, then renders it to a styled HTML file through a Jinja2 template on Windows.

    370 GitHub stars~456 tokensUpdated 5 mo ago
    Documents & OfficeAuto-check passed
  • Human Review

    petergyang/human-review

    Open an HTML file, Markdown file, or localhost page in the browser so the user can edit text directly and leave comments on specific parts, then send all edits and comments back to you.

    1.4k GitHub stars~2.1k tokensUpdated 19 days ago
    Documents & OfficeAuto-check passed
  • Suiko

    nwiizo/suiko

    日本語文書のAI由来の均一さ、翻訳調、不自然さ、論旨、読解負荷を、決定的なRust CLIと目視で診断し、依頼に応じて書く・直す。日本語の学術論文・研究報告では、中心命題、用語、論証、DOCX/PDF納品を監査契約で確認する。Use when the user explicitly mentions suiko, asks whether Japanese text looks…

    114 GitHub stars~1.8k tokensUpdated today
    Documents & OfficeAuto-check passed

More from awebai/aweb

All 18 skills in this repo
  • Recognizes old aweb bootstrap-era `agents/` directories and migrates them to current team and identity primitives, since the old command family is retired.

    115 GitHub stars~701 tokensUpdated today
    Auto-check passed
  • Guides decisions for agents working in an aweb team: when to check shared state, claim tasks, take locks, read team roles and instructions, and open separate worktrees.

    115 GitHub stars~4k tokensUpdated today
    Auto-check passed
  • aweb Messaging

    awebai/aweb

    Guides how an agent reads and responds to aweb mail and chat events, choosing between asynchronous mail and synchronous chat and respecting sender verification and encryption boundaries.

    115 GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • This skill should be used when joining or being added to an aweb team, picking the correct invite/add-member path for the team's authority model (hosted vs BYOT), accepting invites, fetching team…

    115 GitHub stars~5.4k tokensUpdated today
    Auto-check passed
  • Present To Human

    awebai/aweb

    A skill your agent uses when an agent needs to show a human an folio document: mint a document-bound capability link with POST /v1/present, open the returned URL for the human, print it as fallback…

    115 GitHub stars~590 tokensUpdated today
    Auto-check passed
  • Set Theme

    awebai/aweb

    A skill your agent uses when an agent needs to brand folio presentation pages for its team: read or update GET/PUT /v1/theme with colors, fonts, header/footer, and an optional base64 raster logo.

    115 GitHub stars~669 tokensUpdated today
    Auto-check passed

Questions about Folio Template Documents

What does Folio Template Documents do?

Creates or appends a folio document from the built-in pitch, memo or metrics templates by sending schema-checked slots that folio renders to Markdown. Folio stores documents as append-only Markdown, and this skill gives agents a safer way to produce common layouts. Instead of writing Markdown directly, the agent sends a request that names a template (pitch, memo or metrics) and a set of slots.

When should I use Folio Template Documents?

Folio Template Documents fits situations like: creating a pitch document from structured slots in folio; writing a team memo with a cover and headed sections; publishing a launch metrics page with labeled values; appending a template-rendered revision to an existing folio document.

How do I install Folio Template Documents in Claude Code?

Run `npx skills add awebai/aweb --skill create-from-template -a claude-code`. Or copy the skill folder (naapp/folio/skills/create-from-template in awebai/aweb) into .claude/skills/create-from-template in your project. Claude Code loads it when a task matches its description.

How do I install Folio Template Documents in Codex?

Run `npx skills add awebai/aweb --skill create-from-template -a codex`. Or copy the skill folder (naapp/folio/skills/create-from-template in awebai/aweb) into .agents/skills/create-from-template in your project. Codex loads it when a task matches its description.

Can I use Folio Template Documents in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add awebai/aweb --skill create-from-template -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/create-from-template, .gemini/skills/create-from-template, .github/skills/create-from-template and .opencode/skills/create-from-template in your project.

What does Folio Template Documents need to run?

SKILL.md names no scripts, command-line tools or credentials: Folio Template Documents is instructions for the agent only. Our summary lists: The `aw` CLI with an active AWID team certificate; Access to a folio server, set through FOLIO_ORIGIN.

Does Folio Template Documents access the network?

SKILL.md names 1 domain. In commands or code: folio.aweb.ai; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Folio Template Documents safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Folio Template Documents use?

Folio Template Documents is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Folio Template Documents use?

About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Folio Template Documents?

Skills that share tags, products or a category with Folio Template Documents: Ky Markdown Rebuilder (KyrieCheungYep/ky-markdown-rebuilder, 117 stars), Bookforge Korean Ebook PDF Maker (gongnyang/bookforge, 314 stars), Marp Slide Creator (jjmartres/opencode, 133 stars) and Markdown to HTML Report (MegaSuperKitty/WeClaw, 370 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Folio Template Documents?

awebai (a GitHub organization) maintains it in awebai/aweb, which has 115 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 7, 2026.

Source: awebai/aweb on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.