set-theme

Configures team branding for folio presentation pages via the /v1/theme API.

82|9|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/awebai/aweb --skill set-theme-awebai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: set-theme
Source: https://github.com/awebai/aweb/tree/main/naapp/folio/skills/set-theme
Command: npx skills add https://github.com/awebai/aweb --skill set-theme-awebai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams sharing folio presentation pages want their public /present/<token> pages to reflect their brand identity, but manually styling each page is not possible since rendering is server-side. This Skill lets an agent read and update the team-scoped theme through the folio HTTP API. ## Core Features & Use Cases - Read current theme: Query GET /v1/theme with team authentication to inspect existing color tokens, fonts, logo, header, and footer. - Update brand tokens: Set color palettes (background, surface, text, muted, border, accent) and font choices (system, serif, mono) via PUT /v1/theme. - Logo and header/footer management: Upload a base64-encoded PNG, JPEG, GIF, or WebP logo (max 256 KiB), set header/footer text, or clear the existing logo. - Use Case: A team wants its shared document links to display company colors and a logo. The agent builds a theme JSON payload, uploads it with team authentication, and verifies the branded rendering on a present link. ## Quick Start Ask the agent to set your folio team theme with your brand colors and logo, then verify it on a present link.

Frequently Asked Questions about set-theme

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

FAQPage Schema
How do I set a custom theme for folio presentation pages?▼

Build a JSON payload with color tokens, fonts, and optional header, footer, and logo, then send it with `aw id request PUT $FOLIO_ORIGIN/v1/theme --team-auth --raw --body-file theme.json`. The theme applies team-wide to all public present pages.

How do I read the current folio team theme?▼

Run `aw id request GET $FOLIO_ORIGIN/v1/theme --team-auth --raw` from a workspace with an active AWID team certificate. An empty theme returns default tokens with null logo, header, and footer fields.

What logo formats does the folio theme API support?▼

The API accepts base64-encoded raster images with content types image/png, image/jpeg, image/gif, or image/webp, up to 256 KiB. SVG and HTML are rejected, and bytes must match the declared content type or the request returns 400.

Can I remove a logo from my folio team theme?▼

Yes, set `clear_logo` to true in the PUT /v1/theme payload to remove the current logo. You can combine this with other token updates in the same request.

Why are some of my theme token values ignored?▼

Unsupported token keys or unsafe values are silently ignored by the server during sanitization. Only the documented color keys, font values (system, serif, mono), and header/footer strings are applied.