Communitygithub.com

docs-page-skill

生成三栏式文档页面(导航、正文、目录),适用于API参考、教程、指南等场景。

docs-page-skill 是什么?

该技能通过提供一个完整的SKILL.md流程,指导AI生成一个三栏式文档页面的单个HTML文件。它特别适用于创建真实的文档(如API参考、教程、指南),而非简单的线框图。技能要求页面布局包含内联开始侧边栏(固定,带链接组)、文章主体(带H1、H2、代码块、提示框、表格等)以及内联结束目录(随滚动高亮)。生成的HTML包含所有内联CSS,使用CSS Grid实现三栏布局,并遵循设计系统(DS)的排版和间距规则,确保在宽屏和窄屏(900px以下)下均有良好可读性,且支持RTL(从右到左)布局。输出是一个带`<artifact>`标签的单个HTML文档,用于严格的代码生成场景。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aurora-ember-bio-lab/splatstudio/tree/HEAD/design-templates/docs-page

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Docs Page Skill

生成一个单独的三栏文档页面,包含在一个 HTML 文件中。

工作流程

  1. 读取当前的 DESIGN.md(注入在页面之上)。对于正文使用 body 类型令牌;对于代码使用 mono 令牌;遵守行高和最大宽度规则。
  2. 从需求摘要中选取一个主题——页面应看起来像真实文档,而非通用线框图。使用具体的API名称、命令示例和合理的参数。
  3. 布局三个区域,以行内轴方向排列,以便在 dir="rtl" 下布局能正确翻转:
    • 行内开始导航(宽度240–280px,固定定位):分组链接列表,当前页面加粗显示,并在内联开始边缘添加强调色条纹。包含3–5个组,每组4–8个链接。
    • 文章主体(最大宽度 ~720px,中间列居中):包含 H1、引导段、H2 分区、代码块、提示框(注意/警告)、行内链接和列表。
    • 行内结束目录(宽度200–240px,固定定位):“本页内容”部分,包含 H2/H3 锚点,当前章节随滚动高亮。
  4. 编写单个 HTML 文档:
    • <!doctype html> 至 </html>,所有 CSS 内联。
    • 使用 CSS Grid 实现三列布局;侧边栏使用固定定位。
    • 代码块:使用等宽令牌、柔和背景填充、复制按钮占位(仅视觉效果 —— 无需 JS)。
    • 每个 H2/H3 添加锚点 ID,以便目录链接生效。
    • 在导航、文章主体和目录上添加 data-od-id 属性。
  5. 正文:撰写至少 350 词的可信文档。至少包含一个 shell 命令、一个代码片段(5–15行)、一个提示框、一个表格。
  6. 自检:
    • 正文文本在设计系统的行长度最佳点(60–75字符)处换行。
    • 代码使用设计系统的等宽令牌,而非通用的 monospace。
    • 强调色使用节制 —— 仅用于活动导航项、链接、一个提示框边框。不用于正文。
    • 页面在 1280px 宽度下可读,并在低于 900px 时优雅折叠(目录消失,导航变为顶部抽屉)。
    • 在侧边栏和强调色条纹上使用逻辑 CSS(margin-inline-start、border-inline-start、inset-inline-end、text-align: start),以便在 dir="rtl" 下布局正确翻转。

输出约定

在 <artifact> 标签之间输出:

<artifact identifier="docs-slug" type="text/html" title="Docs — Page Title">
<!doctype html>
<html>...</html>
</artifact>

在 artifact 之前写一句话,之后不再添加内容。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

aurora-ember-bio-lab/splatstudio

Audio generation skill — jingles, beds, voiceover, and sound effects. Routes music requests to Suno V5 / Udio / Lyria, speech to MiniMax TTS / FishAudio / ElevenLabs V3, and SFX to ElevenLabs SFX or AudioCraft. Output is one MP3/WAV file saved to the project folder.

aurora-ember-bio-lab/splatstudio

A long-form article / blog post — masthead, hero image placeholder, article body with figures and pull quotes, author byline, related posts. Use when the brief asks for "blog", "article", "post", "essay", or "case study".

aurora-ember-bio-lab/splatstudio

Structured medical case presentation for clinical rounds, conferences, and documentation. Generates SOAP-format or narrative case reports with physiologically accurate vitals, labs, and evidence-based plans. Use when the brief mentions "case report", "case presentation", "SOAP note", "clinical case", "ward rounds", "case summary", or "patient presentation".

aurora-ember-bio-lab/splatstudio

Self-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.

aurora-ember-bio-lab/splatstudio

Run a 5-dimension expert design review on any HTML artifact in the project — Philosophy / Visual hierarchy / Detail / Functionality / Innovation, each scored 0–10. Outputs a single self-contained HTML report with a radar chart, evidence-backed scores, and three lists: Keep / Fix / Quick-wins. Use when the brief asks for a "design review", "design critique", "5 维度评审", "design audit", or "what's wrong with my design".

aurora-ember-bio-lab/splatstudio

Admin / analytics dashboard in a single HTML file. Fixed left sidebar, top bar with user/search, main grid of KPI cards and one or two charts. Use when the brief asks for a "dashboard", "admin", "analytics", or "control panel" screen.

aurora-ember-bio-lab/splatstudio

A consumer-feeling dating / matchmaking dashboard — left rail navigation, ticker bar of community signals, headline KPIs, a 30-day mutual-matches bar chart, and a match-rate trend block. Editorial typography, restrained accent. Use when the brief asks for a "dating site", "matchmaking", "community dashboard", "social network dashboard", or any consumer product where the data is the story.

aurora-ember-bio-lab/splatstudio

Discounted cash flow valuation and intrinsic value analysis for public companies. Use when the brief asks for DCF, fair value, intrinsic value, price target, undervalued or overvalued analysis, or "what is this company worth?"

aurora-ember-bio-lab/splatstudio

A two-spread digital e-guide preview — page 1 is a cover (display title, author, "What's inside" stats, table of contents teaser); page 2 is a spread (lesson body with pull-quote and a step list). Lifestyle / creator brand tone. Use when the brief asks for an "e-guide", "digital guide", "lookbook", "lead magnet", "creator guide", "playbook", "PDF guide", or "电子指南".

aurora-ember-bio-lab/splatstudio

A brand product-launch email — masthead with wordmark, hero image block, headline lockup with skewed-italic accent, body copy, primary CTA, and a specifications grid. Pure HTML email layout (centered single column, table fallback). Use when the brief asks for an "email", "newsletter blast", "MJML", "product launch email", or "email template".

aurora-ember-bio-lab/splatstudio

An engineering runbook — service overview, alerts table, dashboards links, common procedures with copy-pasteable commands, on-call rotation, and an incident-response checklist. Use when the brief mentions "runbook", "ops doc", "on-call guide", "SRE doc", or "运维手册".

aurora-ember-bio-lab/splatstudio

Quarterly / monthly financial report — masthead with KPIs, revenue and burn charts, P&L summary table, top-line highlights, and an outlook paragraph. Use when the brief mentions "financial report", "Q3 report", "MRR review", "P&L", or "财报".

aurora-ember-bio-lab/splatstudio

Team-management dashboard skill in the FlowAI aesthetic — three tabs (Team Members, Team Details, Activity Log), KPI stat row, member table, role distribution bar chart, online presence and activity sparklines, and a top-contributors panel, all in a single self-contained HTML file with light/dark theming, hoverable chart tooltips, click-to-zoom panels, and CSV export. Use when the brief asks for a team / workspace admin dashboard, an interactive admin dashboard with charts, or names FlowAI.

aurora-ember-bio-lab/splatstudio

A multi-frame gamified mobile-app prototype — three phone frames on a dark showcase stage. Frame 1: cover / poster, Frame 2: today's quests with XP ribbons and a level bar, Frame 3: quest detail. Vivid quest tiles, level ribbon, bottom tab bar. Use when the brief asks for a "gamified app", "habit tracker", "RPG-style life app", "level-up app", "daily quests", "XP / streak app", or "ELI5-style explainer app".

aurora-ember-bio-lab/splatstudio

GitHub repository analytics dashboard — stars, forks, contributors, issues, pull requests, recent activity, and top contributors. Use when the brief asks for a GitHub repo dashboard, open-source growth report, repository health page, or GitHub analytics view.

aurora-ember-bio-lab/splatstudio

For marketing and gtm work: bind launches, campaigns, events, and brand plans to growth and pipeline outcomes. Built around the core query "annual-marketing-plan", with GTM strategy lead judgment, buyer-ready proof, and this outcome: approve launch plan, campaign budget, or GTM motion.

aurora-ember-bio-lab/splatstudio

A new-hire onboarding plan as a single page — first week schedule, buddy + manager intro, learning track, equipment checklist, and "you're set when…" outcomes. Use when the brief mentions "onboarding", "new hire", "first week plan", or "入职".

aurora-ember-bio-lab/splatstudio

A first-30-days onboarding module for new hospitality hires — the behaviors, the practice, the checks, and the manager follow-up. Built as a decision-grade professional training deck for new hires, managers.

aurora-ember-bio-lab/splatstudio

Produce a print-grade single-page kami (紙 / 纸) document — warm parchment canvas, ink-blue accent, serif at one weight, no italic, no cool grays. The output reads like a professional white paper or studio one-pager, not an app UI. Multilingual by design (EN · zh-CN · ja). One self-contained HTML file, zero dependencies.

aurora-ember-bio-lab/splatstudio

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

相关技能