Przejdź do treści
Biblioteka skilli
Dokumenty i biuro · Pisanie

html-report

/html-report

Pisze raporty z prac, statusy, wyniki przeglądów i notatki ze spotkań, które renderują się jako dopracowany dokument w różnych hostach AI: markdown z frontmatterem lub samodzielna strona HTML.

Repozytorium
vskill ↗
Licencja
MIT
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Pisze raporty z prac, statusy, wyniki przeglądów i notatki ze spotkań, które renderują się jako dopracowany dokument w różnych hostach AI: markdown z frontmatterem lub samodzielna strona HTML.

Oryginalny opis (EN)

Write work reports, status updates, review results and meeting notes that render as a polished document (property table, serif title, lead, sections, chips) in any host and model: Claude, Codex, Copilot, Gemini, Cursor, OpenCode. Picks the form per host: structured markdown with flat frontmatter for document viewers (Claude desktop, SpecWithCode, Obsidian), or a self-contained HTML page from the bundled template when the report needs screenshots, comparisons or test matrices (SpecWithCode html_render, Claude artifacts, a file on disk). Use only when a result needs a report (several findings, e

Jak działa

  1. How the good-looking hosts do it
  2. 1. Structured markdown (default)
  3. Blockers are a question, or none
  4. 2. HTML page (visual evidence)
  5. Where to put it, by host
  6. Before you send
Sekcje z nagłówków SKILL.md, w oryginale · 101 linii, 1 026 słów
Podgląd SKILL.md
---
name: html-report
description: "Write work reports, status updates, review results and meeting notes that render as a polished document (property table, serif title, lead, sections, chips) in any host and model: Claude, Codex, Copilot, Gemini, Cursor, OpenCode. Picks the form per host: structured markdown with flat frontmatter for document viewers (Claude desktop, SpecWithCode, Obsidian), or a self-contained HTML page from the bundled template when the report needs screenshots, comparisons or test matrices (SpecWithCode html_render, Claude artifacts, a file on disk). Use only when a result needs a report (several findings, evidence links, screenshots, tables or comparisons) or the user asks for one; a short result, especially under a concise response style, stays a plain 1-3 line message. Fits final reports, summaries, handoffs and release notes, or when the user says 'make it look good', 'pretty report', 'HTML report', 'artifact', 'format this as a document', or complains a report is a wall of text."
version: 1.1.3
license: MIT
repository: anton-abyzov/vskill
metadata:
  tags: report, html, artifact, markdown, frontmatter, document, formatting, worker-report, status-update, cross-model
---

# html-report: reports that read as documents

A report is read, not parsed. A wall of prose with inline code chips is hard to scan; the same facts as a document (properties first, a title, one lead paragraph, short sections) read in seconds. This skill makes that the default for every model and host.

## How the good-looking hosts do it

Claude desktop's polished document look is not an HTML artifact. It is a **markdown file** that the app renders: flat YAML frontmatter becomes a property table (list values become chips), the `# H1` is a serif title, the first paragraph is the lead, `##` sections follow. HTML artifacts are kept for interactive or visual content. SpecWithCode renders worker reports the same way, and Obsidian shows the same frontmatter as properties.

So the optimal path is:

1. **Default: structured markdown.** Cheap, works in every model, every host renders it well, and it degrades to clean text anywhere else.
2. **Visual evidence: a self-contained HTML page** built from `template.html`, only when screenshots, a comparison, a results matrix or a chart say more than prose.

## 1. Structured markdown (default)

```markdown
---
title: Show harness on thread rows
status: done
branch: feat/thread-harness-label
tests: 262/262 pass
blockers: none
tags: [web, sidebar, models]
---

# Show harness on thread rows

Thread rows now show the harness first, then the model: "Claude Code · Opus 5.5", "Copilot · Claude Opus 5.5". Before, native threads showed just "Claude".

## Evidence

- Commit `d7c074f0b` on `feat/thread-harness-label`, not pushed.
- Headless screenshots: `threads-light.png`, `threads-dark.png`.
- The 5 full-suite failures also fail on clean `origin/main`.

## Next

- Push and open the PR once the release branch is cut.
```

Rules (these match what document viewers accept):

- Frontmatter is **flat**: `key: value` lines, and lists as `[a, b]` or `- a` lines. No nesting, no `|`/`>` block text, no duplicate keys; any of those makes viewers drop the whole table.
- Keys are lowercase words (`review_cycle` shows as "Review cycle"). Put short facts here: status, branch, version, test totals, blockers, owners, dates. Lists become chips, so use them for tags, people, files.
- One `# H1`, then **one lead paragraph** of one to three sentences: the outcome. Then `##` sections with bullets, one fact per bullet.
- Use `> [!NOTE]`, `> [!WARNING]` or `> [!CAUTION]` callouts for the one thing the reader must not miss.
- Tables only for real comparisons; numeric columns right-align on their own.
- No raw HTML in markdown; viewers strip it.
- Call the desktop app SpecWithCode on first mention and "the app" after that, never "Studio" or "SpecWeave Studio". Branch, repo, path and tool names stay literal (`feat/studio-plan-progress`, `studio_thread_list`).

**Short worker reports** (a 5-line "Outcome / Evidence / Blockers" result) skip frontmatter and the H1. Write each part as its own paragraph opening with a bold label:

```markdown
**Outcome:** Thread rows now show the harness first, then the model.

**Evidence:** commit `d7c074f0b` on `feat/thread-harness-label`, not pushed. Headless screenshots at `threads-light.png`. Unit tests: 262/262 pass.

**Blockers:** none.
```

SpecWithCode shows this as a document: the outcome as the lead, a long Evidence as a bulleted section, a short Blockers as a property.

## Blockers are a question, or none

`Blockers` is either `none` or **the one thing you need from the reader, asked as a question they can answer in one reply**: the decision, the options, and your recommendation.

- Good: `**Blockers:** Ship 1.0.20 now without the Windows build, or wait about 2 hours for the signer? I recommend shipping now and following up.`
- Bad: `**Blockers:** Windows signing is flaky.` (a status, not a question; the reader cannot act on it)
- Not a blocker: problems you already worked around. Put them in Evidence.

SpecWithCode reads this part: a thread whose last report names a blocker shows as **Blocked**, waits in "Waiting on you" with the question on hover and on its card, and never auto-resolves until someone writes back.

## 2. HTML page (visual evidence)

Start from `template.html` next to this file. `examples/worker-report.html` is a finished worker report (before/after screenshots, checks table) built from it. It is self-contained (inline CSS, no network), follows the host theme when one is injected (`--background`, `--foreground`, `--border`, `--accent`, ...) and falls back to its own light and dark palette, so the same file works in a host frame, as an artifact and opened from disk.

- Keep its structure: `dl.props` (facts), `h1`, `p.lead`, `h2` sections, `table` for results with `.pill.ok|bad|warn` status, `.shots` grid of `figure`s for screenshots, `details` for long logs.
- Inline images as `data:` URLs (resize first; keep the page under about 2 MB). Never hotlink.
- No outer card, banner or border, no `100vh`; let content set the height. Fluid width, max 680px text column.
- Charts: inline SVG, or Chart.js only where the host allows that library.
- Light and dark must both read well. Check contrast of pills and chips in both.

## Where to put it, by host

| Host | Markdown report | HTML report |
|---|---|---|
| SpecWithCode | Your final reply, as above | `html_preview`, then `html_render`, before the final reply; the reply adds only what the page doesn't say |
| Claude desktop (Cowork / Code) | Write a `.md` file, then `present_files` | Write the `.html` file, then `create_artifact` with its `html_path` |
| claude.ai chat | A `text/markdown` artifact | A `text/html` artifact |
| Codex, Copilot, Gemini, Cursor, OpenCode, any CLI | Your final reply, or a `.md` file whose path you print | Write the file to a scratch or reports folder, print the absolute path |

When a host has no way to show a page, still write the file and give its path; never paste HTML into the chat.

## Before you send

- The first two lines answer "what happened". A reader who stops there knows the result.
- Every claim of success has its evidence: a commit, a path, a command and its result.
- Failures, failing tests and security warnings are quoted exactly, never softened.
- Nothing invented to fill the template: drop a property or section you have no fact for.
Pliki w paczce (3)
  • SKILL.md 7 KB
  • template.html 6 KB
  • examples/worker-report.html 223 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · anton-abyzov/vskill100MIT
dataelement/bisheng100Apache-2.0
lingtai-ai/lingtai100Apache-2.0
Makkov-design/makkov-harness90MIT
costiash/eliviz87MIT

Migawka bazy z 13.11.2026 · wersja paczki 3501174bd3b9 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100ak-render
    Buduje dopracowany, offline raport HTML, dashboard lub stronę przeglądu architektury z krótkiej specyfikacji YAML, bez ręcznego pisania HTML i CSS.
  • 100md-document
    Zamienia markdown w dopracowany samodzielny dokument HTML ze spisem treści, numerowanymi rysunkami i tabelami, odsyłaczami, przypisami i CSS gotowym do druku.
  • 100html-brief-artifact
    Tworzy samodzielny brief HTML dla planów, statusów, podsumowań PR, notatek o incydentach i wyjaśnień badań, jako dopracowany dokument zamiast markdownu, slajdów czy pełnego frontendu.
  • 100html-output
    Zapisuje plany, specyfikacje, raporty i przeglądy kodu jako jeden samodzielny plik HTML zamiast długiego Markdownu.
  • 100docs
    Tworzy dokument HTML w kolorach i czcionkach organizacji, z logo i autorem, albo zamienia plik Markdown w taki dokument.
  • 100korean-report-doc
    Tworzy koreańskie dokumenty techniczne i biznesowe jako samodzielny HTML i opcjonalny PDF: raporty postępu, raporty techniczne, notatki badawcze, materiały na spotkania, benchmarki i propozycje.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.