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.jsonindex 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.mdindex 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:```bashnpx skills add plannotator/effective-html --list+npx skills add plannotator/effective-html --skill big-pics-little-wordsnpx skills add plannotator/effective-html --skill design-artifactnpx skills add plannotator/effective-html --skill html-wireframenpx skills add plannotator/effective-html --skill html-prototypediff --git a/README.zh.md b/README.zh.mdindex 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```bashnpx skills add plannotator/effective-html --list+npx skills add plannotator/effective-html --skill big-pics-little-wordsnpx skills add plannotator/effective-html --skill design-artifactnpx skills add plannotator/effective-html --skill html-wireframenpx skills add plannotator/effective-html --skill html-prototypediff --git a/site/components/catalog-explorer.tsx b/site/components/catalog-explorer.tsxindex 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 withthe 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.mdxnew file mode 100644index 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.mdxindex 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, andskills. 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.jsonindex 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.tsindex 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.tsindex 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.jsonindex 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.mdnew file mode 100644index 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.yamlnew file mode 100644index 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