# Client Status Report

> Use when asked to build, generate, or produce a client status report — a period update for a client covering progress, risks, decisions, and next actions — to share or publish, especially via agentpub. This skill is a reusable on-brand blueprint so every report comes out consistent instead of being rebuilt from scratch.

- **Type:** Skill
- **Install:** `agentstack add skill-agentpub-io-skill-client-status-report`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [agentpub-io](https://agentstack.voostack.com/s/agentpub-io)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [agentpub-io](https://github.com/agentpub-io)
- **Source:** https://github.com/agentpub-io/skill/tree/main/skills/client-status-report

## Install

```sh
agentstack add skill-agentpub-io-skill-client-status-report
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Client Status Report (blueprint)

This skill is a **blueprint**: a reusable, on-brand artifact design. Build a report by copying `assets/template.html` and filling it in — do NOT hand-write HTML from scratch each time, which drifts (random colors, inconsistent layout). The template and the tokens below ARE the design contract.

## Locked design tokens (anti-drift)

**Do not improvise colors.** Use these tokens exactly. They live as CSS custom properties at the top of `assets/template.html`; never replace a token value with a one-off hex inline. The palette is a restrained agency deliverable — warm-neutral paper, near-black ink, one slate-teal accent. High-contrast, WCAG AA. No purple/violet AI gradients.

### Palette

| Token           | Value     | Use                            |
| --------------- | --------- | ------------------------------ |
| `--ink`         | `#1a1d1f` | Primary text, top rule         |
| `--ink-soft`    | `#4a5054` | Secondary / body copy          |
| `--ink-faint`   | `#8b9296` | Meta, captions                 |
| `--paper`       | `#f7f5f1` | Page background                |
| `--surface`     | `#ffffff` | Cards                          |
| `--line`        | `#e3ded6` | Hairlines / borders            |
| `--accent`      | `#0f6b6b` | The one accent (slate-teal)    |
| `--accent-deep` | `#0a4f4f` | Accent strong                  |
| `--accent-wash` | `#e7f0ef` | Accent tint fills              |
| `--sev-high`    | `#a8341f` | Risk severity: high (+ wash)   |
| `--sev-med`     | `#9a6b14` | Risk severity: medium (+ wash) |
| `--sev-low`     | `#0f6b6b` | Risk severity: low (+ wash)    |

### Typography (system / web-safe only — no external fonts)

- `--font-display`: Iowan Old Style / Palatino / Georgia serif stack — masthead, section titles.
- `--font-body`: -apple-system / Segoe UI / Roboto sans stack — body copy.
- `--font-mono`: SF Mono / Menlo / Consolas — eyebrows, labels, severity pills.

### Spacing & shape

4px scale: `--s-1` (4) → `--s-9` (96). Radius `--radius` 10px, `--radius-sm` 6px. One elevation `--shadow`.

## Report structure (the contract)

Fill every required section. Optional sections may be dropped if there is genuinely nothing to report.

| Section              | Required? | Notes                                                                                              |
| -------------------- | --------- | -------------------------------------------------------------------------------------------------- |
| Header               | Required  | Report title + client name + reporting period + prepared-by + date issued. (Status chip optional.) |
| Executive summary    | Required  | 2–4 sentences: overall state, headline wins, what you need.                                        |
| Progress this period | Required  | 2–5 concrete items shipped/advanced this period.                                                   |
| Risks                | Required  | Each risk MUST have an **owner** and a **severity** (High / Medium / Low).                         |
| Decisions needed     | Required  | Decisions the client must make; include a by-when if known. Use "None this period" if empty.       |
| Next actions         | Required  | Owner + due date per action.                                                                       |

## How to build a new report

1. **Copy** `assets/template.html` to your working file (do not edit the asset in place for a one-off report).
2. **Fill each section** from the user's inputs, replacing the sample "Acme Co" content. Keep the section order and structure.
3. **Keep the design tokens unchanged.** Do not add new colors or swap fonts. If a risk is Low severity, reuse the `.severity.low` class — don't invent a style.
4. **Stay self-contained:** inline `` only, the system/web-safe font stacks already in the template, and **no external resources** (no ``, no CDN scripts, no remote images/fonts). This keeps it CSP-safe when published and makes it render anywhere.
5. **Print-friendly:** the template ships a print stylesheet for clean PDF export (white background, page margins, break-inside avoid). Leave it intact.

## Publish step

Publish via the `agentpub-publish` skill (create → upload → finalize):

- **Review draft → anonymous (24h).** Publish with no auth; you get a one-time `claimUrl`. **Surface that claim URL to the user immediately** — it is the only way to keep the site past 24h. Optionally enable review mode so the client leaves inline comments/approval, then apply feedback per the publish skill.
- **Permanent deliverable → owned.** Publish with `Authorization: Bearer $AGENTPUB_API_KEY` for an account-owned, permanent site.

Either way, surface the live `https://{slug}.agentpub.io/` URL (and the claim/review URL when anonymous) back to the user. See `skills/agentpub-publish/SKILL.md` for the exact calls.

## Compounding note

This skill IS the reusable blueprint. To improve every future report at once, edit the tokens and `assets/template.html` here — all reports built from it inherit the change. Don't fork the design per report.

## Save-as-template note

When a user likes a one-off report's design, fold it back in: lift its palette/type/spacing into the tokens above and reconcile `assets/template.html` to match. That way a good one-off compounds into the blueprint instead of being lost.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [agentpub-io](https://github.com/agentpub-io)
- **Source:** [agentpub-io/skill](https://github.com/agentpub-io/skill)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-agentpub-io-skill-client-status-report
- Seller: https://agentstack.voostack.com/s/agentpub-io
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.