Skip to content

Agent skills for useful HTML artifacts, wireframes, interactive prototypes, plans, and diagrams.

Add big-pics-little-words skill and website guide

Michael Ramos975b047f6da6
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index dfb3dad..fa0d862 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -2,6 +2,7 @@
"name": "plannotator-effective-html",
"skills": [
"./skills/html",
+ "./skills/big-pics-little-words",
"./skills/design-artifact",
"./skills/html-wireframe",
"./skills/html-prototype",
diff --git a/README.md b/README.md
index e31d758..d8883e5 100644
--- a/README.md
+++ b/README.md
@@ -33,11 +33,12 @@ Render and annotate local HTML with <a href="https://github.com/backnotprop/plan
## Skill references
-The repo includes six optional skills for pragmatic visual artifacts.
+The repo includes seven optional skills for pragmatic visual artifacts.
| Skill | Use it for |
| --- | --- |
| [`html`](skills/html/SKILL.md) | Broad HTML requests, mixed artifacts, reports, explainers, presentations, landing pages, tools, and routing to a specialist |
+| [`big-pics-little-words`](skills/big-pics-little-words/SKILL.md) | Explain the current subject in HTML with large visuals and minimal text while preserving key details; copied from [bro](https://github.com/backnotprop/bro/blob/main/skills/big-pics-little-words/SKILL.md) |
| [`design-artifact`](skills/design-artifact/SKILL.md) | Subject-specific creative direction for any HTML artifact without imposing a reusable house style |
| [`html-wireframe`](skills/html-wireframe/SKILL.md) | Low-fidelity layout directions that test content, hierarchy, navigation, flows, and responsive structure |
| [`html-prototype`](skills/html-prototype/SKILL.md) | Working prototypes with realistic states, interaction, keyboard support, and responsive behavior |
@@ -59,6 +60,7 @@ List or install individual skills:
```bash
npx skills add plannotator/effective-html --list
+npx skills add plannotator/effective-html --skill big-pics-little-words
npx skills add plannotator/effective-html --skill design-artifact
npx skills add plannotator/effective-html --skill html-wireframe
npx skills add plannotator/effective-html --skill html-prototype
diff --git a/README.zh.md b/README.zh.md
index 166af92..01ad048 100644
--- a/README.zh.md
+++ b/README.zh.md
@@ -29,11 +29,12 @@ https://github.com/user-attachments/assets/24306977-7f30-44c9-9bff-55f901d557b0
## 技能参考
-本仓库包含六个可选技能,用于创建实用的视觉成果。
+本仓库包含七个可选技能,用于创建实用的视觉成果。
| 技能 | 适用场景 |
| --- | --- |
| [`html`](skills/html/SKILL.md) | 处理范围较广的 HTML 请求、混合型成果、报告、说明文档、演示文稿、落地页和工具,并在需要时转交给专用技能 |
+| [`big-pics-little-words`](skills/big-pics-little-words/SKILL.md) | 用大幅视觉元素和精简文字在 HTML 中解释当前主题,同时保留关键细节;复制自 [bro](https://github.com/backnotprop/bro/blob/main/skills/big-pics-little-words/SKILL.md) |
| [`design-artifact`](skills/design-artifact/SKILL.md) | 为任何 HTML 成果提供贴合主题的创意方向,同时避免套用固定的视觉风格 |
| [`html-wireframe`](skills/html-wireframe/SKILL.md) | 用低保真布局方案测试内容、层级、导航、流程和响应式结构 |
| [`html-prototype`](skills/html-prototype/SKILL.md) | 创建包含真实状态、交互、键盘支持和响应式行为的可用原型 |
@@ -54,6 +55,7 @@ npx skills add plannotator/effective-html
```bash
npx skills add plannotator/effective-html --list
+npx skills add plannotator/effective-html --skill big-pics-little-words
npx skills add plannotator/effective-html --skill design-artifact
npx skills add plannotator/effective-html --skill html-wireframe
npx skills add plannotator/effective-html --skill html-prototype
diff --git a/site/components/catalog-explorer.tsx b/site/components/catalog-explorer.tsx
index 05831c8..31c2ae1 100644
--- a/site/components/catalog-explorer.tsx
+++ b/site/components/catalog-explorer.tsx
@@ -557,7 +557,7 @@ export function CatalogExplorer() {
<header className={styles.sectionIntro}>
<h2>The methods behind the artifacts.</h2>
<p>
- Six focused skills turn a broad request into an artifact with
+ {catalogSkills.length} focused skills turn a broad request into an artifact with
the right fidelity, behavior, and verification boundary.
</p>
</header>
diff --git a/site/content/docs/big-pics-little-words.mdx b/site/content/docs/big-pics-little-words.mdx
new file mode 100644
index 0000000..e8f18b0
--- /dev/null
+++ b/site/content/docs/big-pics-little-words.mdx
@@ -0,0 +1,51 @@
+---
+title: Big pics, little words
+description: Explain the current subject in HTML with large visuals and minimal text while preserving key details.
+---
+
+[`big-pics-little-words`](https://github.com/plannotator/effective-html/blob/main/skills/big-pics-little-words/SKILL.md)
+asks your agent to explain what you are discussing through large visuals and
+short, plain explanations. Keep the key details; use real-world pictures, icons,
+and other visuals when they help explain the subject.
+
+The skill is an exact copy of
+[the original in bro](https://github.com/backnotprop/bro/blob/main/skills/big-pics-little-words/SKILL.md).
+Invoke it directly when you want to see an explanation of the current discussion.
+
+## Install and use
+
+```bash
+npx skills add plannotator/effective-html --skill big-pics-little-words
+```
+
+Once installed, ask your agent:
+
+```text
+Use big-pics-little-words to help me understand what we are discussing.
+```
+
+## Copy the canonical skill
+
+Save the block below as `skills/big-pics-little-words/SKILL.md` in a repository
+or agent skill directory. Its content matches the repository source exactly.
+
+````md title="skills/big-pics-little-words/SKILL.md"
+---
+name: big-pics-little-words
+description: >-
+ Explain the current subject in HTML with large visuals and minimal text
+ while preserving key details.
+disable-model-invocation: true
+---
+
+
+Use HTML to help me understand what we're discussing. Show me with big pictures and little words without witholding key details.
+Use your own taste, avoid lazy design, integrate real-world pictures/icons/visuals as needed but only selectively when it makes sense.
+When you do use prose/detail: Be clear, concise/terse, and avoid jargon. Explain things as if the viewer is new here.
+````
+
+<GuideNext
+ href="/docs/designing-artifacts"
+ title="Designing artifacts"
+ description="Choose a visual direction that fits the subject."
+/>
diff --git a/site/content/docs/index.mdx b/site/content/docs/index.mdx
index d3efcdb..10ae934 100644
--- a/site/content/docs/index.mdx
+++ b/site/content/docs/index.mdx
@@ -72,3 +72,6 @@ Browse the [catalog](/catalog) for live HTML artifacts, SVGs, examples, and
skills. The rest of this guide gives short overviews of [why HTML can help](/docs/why-html), [wireframes](/docs/wireframes),
[prototypes](/docs/prototypes), [diagrams](/docs/diagrams),
[decks](/docs/decks), and [plans](/docs/plans).
+
+For explanations with large visuals and minimal text, use
+[Big pics, little words](/docs/big-pics-little-words).
diff --git a/site/content/docs/meta.json b/site/content/docs/meta.json
index 3e254a4..7a40f68 100644
--- a/site/content/docs/meta.json
+++ b/site/content/docs/meta.json
@@ -3,6 +3,7 @@
"pages": [
"index",
"why-html",
+ "big-pics-little-words",
"designing-artifacts",
"choosing-fidelity",
"wireframes",
diff --git a/site/lib/catalog-data.ts b/site/lib/catalog-data.ts
index d86231d..f59319b 100644
--- a/site/lib/catalog-data.ts
+++ b/site/lib/catalog-data.ts
@@ -671,6 +671,15 @@ export const catalogSkills: CatalogSkill[] = [
sourceUrl: `${repoSource}/html/SKILL.md`,
color: "cobalt",
},
+ {
+ id: "big-pics-little-words",
+ title: "Big pics, little words",
+ description:
+ "Explain the current subject in HTML with large visuals and minimal text while preserving key details.",
+ guideUrl: "/docs/big-pics-little-words",
+ sourceUrl: `${repoSource}/big-pics-little-words/SKILL.md`,
+ color: "coral",
+ },
{
id: "design-artifact",
title: "Design artifact",
diff --git a/site/lib/llm-content.ts b/site/lib/llm-content.ts
index a8ab240..2aa63d2 100644
--- a/site/lib/llm-content.ts
+++ b/site/lib/llm-content.ts
@@ -11,6 +11,7 @@ const siteOrigin = "https://www.effectivehtml.com";
const guideOrder = [
"/docs",
"/docs/why-html",
+ "/docs/big-pics-little-words",
"/docs/designing-artifacts",
"/docs/choosing-fidelity",
"/docs/wireframes",
diff --git a/skills.sh.json b/skills.sh.json
index 96f91d7..24ea442 100644
--- a/skills.sh.json
+++ b/skills.sh.json
@@ -7,6 +7,7 @@
"description": "Creative direction and focused workflows for self-contained HTML artifacts, wireframes, prototypes, plans, and diagrams.",
"skills": [
"html",
+ "big-pics-little-words",
"design-artifact",
"html-wireframe",
"html-prototype",
diff --git a/skills/big-pics-little-words/SKILL.md b/skills/big-pics-little-words/SKILL.md
new file mode 100644
index 0000000..6eff657
--- /dev/null
+++ b/skills/big-pics-little-words/SKILL.md
@@ -0,0 +1,12 @@
+---
+name: big-pics-little-words
+description: >-
+ Explain the current subject in HTML with large visuals and minimal text
+ while preserving key details.
+disable-model-invocation: true
+---
+
+
+Use HTML to help me understand what we're discussing. Show me with big pictures and little words without witholding key details.
+Use your own taste, avoid lazy design, integrate real-world pictures/icons/visuals as needed but only selectively when it makes sense.
+When you do use prose/detail: Be clear, concise/terse, and avoid jargon. Explain things as if the viewer is new here.
diff --git a/skills/big-pics-little-words/agents/openai.yaml b/skills/big-pics-little-words/agents/openai.yaml
new file mode 100644
index 0000000..4a57394
--- /dev/null
+++ b/skills/big-pics-little-words/agents/openai.yaml
@@ -0,0 +1,7 @@
+interface:
+ display_name: "Big Pics, Little Words"
+ short_description: "Explain with large visuals and minimal text"
+ default_prompt: "Use $big-pics-little-words to explain the current subject in HTML with large visuals and minimal text while preserving key details."
+
+policy:
+ allow_implicit_invocation: false