Kxiandaoyan · rohan-tessl · Mar 24, 2026
diff --git a/internal/skills/defaults/agent-reach/SKILL.md b/internal/skills/defaults/agent-reach/SKILL.md
@@ -1,7 +1,6 @@
 ---
 name: agent-reach
-description: "Give your AI Agent eyes to see the entire internet. Search + read 10+ platforms with one install."
-install: pip install git+https://github.com/Panniantong/agent-reach.git
+description: "Searches and reads content from GitHub, YouTube, Bilibili, Reddit, Twitter, WeChat, Xiaohongshu, RSS feeds, and arbitrary web URLs. Use when the agent needs to fetch, search, or scrape web content across multiple platforms via CLI, Python API, or MCP server."
 ---
 
 # Agent Reach — 给 Agent 装上眼睛 👁️
@@ -14,6 +13,14 @@ install: pip install git+https://github.com/Panniantong/agent-reach.git
 pip install git+https://github.com/Panniantong/agent-reach.git
 ```
 
+安装完成后，运行以下命令验证安装是否成功：
+
+```bash
+agent-reach doctor
+```
+
+如果输出显示各平台状态，则安装成功。如果遇到 `ModuleNotFoundError` 或 `command not found`，请确认 Python 版本 >= 3.8 且 pip 安装路径已加入 `PATH` 环境变量。
+
 ## 装完直接能用的（零配置）
 
 - `agent-reach read <URL>` — 读取任意网页、GitHub、B站、YouTube、RSS

diff --git a/internal/skills/defaults/canvas-design/SKILL.md b/internal/skills/defaults/canvas-design/SKILL.md
diff --git a/internal/skills/defaults/create-plan/SKILL.md b/internal/skills/defaults/create-plan/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: create-plan
-description: Create a concise plan. Use when a user explicitly asks for a plan related to a coding task.
+description: "Creates step-by-step implementation plans with scope definition, file structure, dependencies, task breakdown, and validation steps for coding tasks. Produces actionable checklists with concrete actions, test strategies, and risk assessment. Use when the user asks for a plan, roadmap, approach, strategy, implementation plan, action items, or step-by-step breakdown for a development task."
 ---
 
 # Create Plan

diff --git a/internal/skills/defaults/develop-web-game/SKILL.md b/internal/skills/defaults/develop-web-game/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: "develop-web-game"
-description: "Use when Codex is building or iterating on a web game (HTML/JS) and needs a reliable development + testing loop: implement small changes, run a Playwright-based test script with short input bursts and intentional pauses, inspect screenshots/text, and review console errors with render_game_to_text."
+description: "Use when building, iterating, or testing a browser game or JavaScript game (HTML/JS) via a reliable development and game testing loop: implement small changes, run a Playwright-based test script with short input bursts and intentional pauses, inspect screenshots and text state, and review console errors with render_game_to_text."
 ---
 
 
@@ -122,10 +122,7 @@ window.advanceTime = (ms) => {
 
 ## Progress Tracking
 
-Create a `progress.md` file if it doesn't exist, and append TODOs, notes, gotchas, and loose ends as you go so another agent can pick up seamlessly.
-If a `progress.md` file already exists, read it first, including the original user prompt at the top (you may be continuing another agent's work). Do not overwrite the original prompt; preserve it.
-Update `progress.md` after each meaningful chunk of work (feature added, bug found, test run, or decision made).
-At the end of your work, leave TODOs and suggestions for the next agent in `progress.md`.
+See step 5 of the Workflow for the full `progress.md` initialization rules. After setup, update `progress.md` after each meaningful chunk of work (feature added, bug found, test run, or decision made) and leave TODOs and suggestions for the next agent at the end of your work.
 
 ## Playwright Prerequisites
 

diff --git a/internal/skills/defaults/docx/SKILL.md b/internal/skills/defaults/docx/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: docx
-description: "Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks"
+description: "Comprehensive Word document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. Use when working with Word files, Microsoft Word documents, .docx or .doc files for: creating new documents, modifying or editing content, working with tracked changes, adding comments, or any other document tasks."
 license: Proprietary. LICENSE.txt has complete terms
 ---
 
@@ -10,7 +10,7 @@ license: Proprietary. LICENSE.txt has complete terms
 
 ## Overview
 
-A user may ask you to create, edit, or analyze the contents of a .docx file. A .docx file is essentially a ZIP archive containing XML files and other resources that you can read or edit. You have different tools and workflows available for different tasks.
+A user may ask you to create, edit, or analyze the contents of a .docx file. You have different tools and workflows available for different tasks.
 
 ## Workflow Decision Tree
 

diff --git a/internal/skills/defaults/frontend-design/SKILL.md b/internal/skills/defaults/frontend-design/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: frontend-design
-description: Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.
+description: "Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics."
 license: Complete terms in LICENSE.txt
 ---
 
@@ -37,6 +37,64 @@ NEVER use generic AI-generated aesthetics like overused font families (Inter, Ro
 
 Interpret creatively and make unexpected choices that feel genuinely designed for the context. No design should be the same. Vary between light and dark themes, different fonts, different aesthetics. NEVER converge on common choices (Space Grotesk, for example) across generations.
 
-**IMPORTANT**: Match implementation complexity to the aesthetic vision. Maximalist designs need elaborate code with extensive animations and effects. Minimalist or refined designs need restraint, precision, and careful attention to spacing, typography, and subtle details. Elegance comes from executing the vision well.
+**IMPORTANT**: Match implementation complexity to the aesthetic vision. Maximalist designs need elaborate code with extensive animations and effects. Minimalist or refined designs need restraint, precision, and careful attention to spacing, typography, and subtle details.
 
-Remember: Claude is capable of extraordinary creative work. Don't hold back, show what can truly be created when thinking outside the box and committing fully to a distinctive vision.
+## Code Examples
+
+### CSS Animation: Staggered Reveal on Scroll
+
+```css
+.reveal {
+  opacity: 0;
+  transform: translateY(24px);
+  transition: opacity 0.6s cubic-bezier(0.16, 1, 0.3, 1),
+              transform 0.6s cubic-bezier(0.16, 1, 0.3, 1);
+}
+.reveal.visible { opacity: 1; transform: translateY(0); }
+.reveal:nth-child(2) { transition-delay: 0.1s; }
+.reveal:nth-child(3) { transition-delay: 0.2s; }
+```
+
+### Typography Pairing with CSS Variables
+
+```css
+:root {
+  --font-display: 'Clash Display', sans-serif;
+  --font-body: 'Satoshi', sans-serif;
+  --title-size: clamp(2rem, 5vw, 4.5rem);
+  --body-size: clamp(0.875rem, 1.2vw, 1.125rem);
+}
+h1, h2, h3 { font-family: var(--font-display); }
+body { font-family: var(--font-body); font-size: var(--body-size); }
+```
+
+### Color System with Theme Variables
+
+```css
+:root {
+  --bg-primary: #0a0f1c;
+  --text-primary: #f4f4f5;
+  --accent: #00ffcc;
+  --accent-glow: rgba(0, 255, 204, 0.25);
+  --surface: #111827;
+}
+.card {
+  background: var(--surface);
+  border: 1px solid rgba(255, 255, 255, 0.06);
+  box-shadow: 0 0 40px var(--accent-glow);
+}
+```
+
+## Production Readiness Checklist
+
+Before delivering any frontend implementation, verify:
+
+1. All interactive elements are keyboard-accessible and have visible focus states
+2. Color contrast meets WCAG AA (4.5:1 body text, 3:1 large text)
+3. Animations respect `prefers-reduced-motion: reduce`
+4. Layout does not break between 320px and 1920px viewport widths
+5. No hardcoded pixel font sizes — use `clamp()` or relative units
+6. CSS variables are defined in `:root` for easy theme modification
+7. Images have `alt` attributes; decorative images use `alt=""`
+8. No render-blocking resources; fonts use `font-display: swap`
+9. HTML passes W3C validation with no errors