# Layer Index Optional > layer-index-optional - Skill: `yakeworld/layer-index-optional` (Agent Skill, multi-file: 12 files) - Install (CLI): `npx skillmds@latest add yakeworld/layer-index-optional` - Raw SKILL.md: https://api.skillmd.com/api/skills/yakeworld/layer-index-optional/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - License: MIT - Author: yakeworld (https://skillmd.com/u/yakeworld) - Updated: 2026-09-21 - Page: https://skillmd.com/skills/yakeworld/layer-index-optional --- ## Operational Steps 1. 确认输入参数完整 2. 执行核心操作（参考本目录下的 scripts/ 或 references/） 3. 验证输出符合契约 4. 保存结果并报告 ## Pitfalls - - ## Verification - - - - 1. 2. 3. # Optional Skills — 可选技能 ## Purpose Navigation index for optional skills: creative tools, productivity, social monitoring, gaming, and platform-specific integrations. ## Skills in this Layer (60 total) - **ai-outreach**: 主skill | 在AI可访问的平台上发布信号，引导其他AI智能体了解你的系统。覆盖平台选择(GitHub AGENTS.md/GitHub Discussions/Moltbook/X)、消息撰写(技术性/非推销)、节奏控制、回复监测。v1.1新增：AGENTS.md创建指南、GitHub_Discussions_Cron自动化、Moltbook注册API流程。调用子skill: moltbook-connector, xurl - **airtable**: Directory index for airtable: airtable - **apple**: Apple生态工具链 — macOS/iOS设备管理、提醒事项、备忘录、查找设备。 - **apple-notes**: Use `memo` to manage Apple Notes directly from the terminal. Notes sync across all Apple devices via iCloud. - **apple-reminders**: Use `remindctl` to manage Apple Reminders directly from the terminal. Tasks sync across all Apple devices via iCloud. - **ascii-art**: Multiple tools for different ASCII art needs. All tools are local CLI programs or free REST APIs — no API keys required. - **ascii-video**: Use when users request: ASCII video, text art video, terminal-style video, character art animation, retro text visualization, audio visualizer in ASCII, converting video to ASCII art, matrix-style effects, or any animated ASCII output. - **baoyu-comic**: Adapted from [baoyu-comic](https://github.com/JimLiu/baoyu-skills) for Hermes Agent's tool ecosystem. - **baoyu-infographic**: Adapted from [baoyu-infographic](https://github.com/JimLiu/baoyu-skills) for Hermes Agent's tool ecosystem. - **blogwatcher**: Monitor blogs and RSS/Atom feeds via blogwatcher-cli tool. - **claude-design**: Use this skill when the user asks for design work that would normally fit Claude Design, but the agent is running in a CLI/API environment instead of the hosted Claude Design web UI. - **competition-video-production**: Directory index for competition-video-production: competition-video-production - **creative**: 直接调用子技能名称即可：`academic-diagram`、`manim-video`、`comfyui`、`p5js` 等。 - **creative-ideation**: Use when the user says 'I want to build something', 'give me a project idea', 'I'm bored', 'what should I make', 'inspire me', or any variant of 'I have tools but no direction'. Works for code, art, hardware, writing, tools, and anything that can be made. - **design-md**: DESIGN.md is Google's open spec (Apache-2.0, `google-labs-code/design.md`) for - **email**: 电子邮件管理 — Himalaya CLI邮件收发、搜索。 - **ffmpeg-video-audio-sync**: Debug and fix FFmpeg video-audio synchronization issues including duration - **figure-generation**: 科研图表创建：Figure契约方法论——结论Claim→证据层级→面板映射→出口契约→审核。 支持Nature语义色板（蓝主-绿正-红基+中性色），16种排版模式。兼容所有SCI/会议图表场景。 - **findmy**: Track Apple devices and AirTags via the FindMy.app on macOS. Since Apple doesn't - **gaming**: 游戏服务器 — Minecraft模组服务器、宝可梦模拟器。 - **gif-search**: Search and download GIFs directly via the Tenor API using curl. No extra tools needed. - **google-workspace**: Directory index for google-workspace: google-workspace - **heartmula**: HeartMuLa is a family of open-source music foundation models (Apache-2.0) that generates music conditioned on lyrics and tags, with multilingual support. Generates full songs from lyrics + tags. Comparable to Suno for open-source. Includes: - **himalaya**: Himalaya is a CLI email client that lets you manage emails from the terminal using IMAP, SMTP, Notmuch, or Sendmail backends. - **humanizer**: Identify and remove signs of AI-generated text to make writing sound natural and human. Based on Wikipedia's "Signs of AI writing" guide (maintained by WikiProject AI Cleanup), derived from observations of thousands of AI-generated text instances. - **imessage**: Use `imsg` to read and send iMessage/SMS via macOS Messages.app. - **jupyter-live-kernel**: Iterative Python via live Jupyter kernel (hamelnb). - **linear**: Directory index for linear: linear - **llm-wiki**: Directory index for llm-wiki: llm-wiki - **macos-computer-use**: You have a `computer_use` tool that drives the Mac in the **background**. - **manim-video**: Directory index for manim-video: manim-video - **maps**: Geocode, POIs, routes, timezones via OpenStreetMap/OSRM. - **markitdown-convert**: Convert PDF/Office files to Markdown using Microsoft MarkItDown - **media**: 媒体内容 — GIF搜索、音乐生成、音谱分析、Spotify控制。 - **minecraft-modpack-server**: Before starting setup, ask the user for: - **moltbook-connector**: 子skill | 将Synthos认知原子接入Moltbook AI社交网络。注册→心跳→发帖/回复。父skill: ai-outreach。注意：注册需人类claim(发推验证)，优先使用GitHub version: 1.0.0 Discussions(零注册)代替。 - **notebooklm-cli**: 子skill | NotebookLM CLI全功能指南 — Q&A知识提取、内容生成(报告/视频/音频/信息图/幻灯片)、文献检索。响应paper-pipeline的P1阶段调用。 - **notion**: Notion API via curl: pages, databases, blocks, search. - **obsidian**: Read, search, create, and edit notes in the Obsidian vault. - **openhue**: Control Philips Hue lights and scenes via a Hue Bridge from the terminal. - **p5js**: Use when users request: p5.js sketches, creative coding, generative art, interactive visualizations, canvas animations, browser-based visual art, data viz, shader effects, or any p5.js project. - **pil-image-generation**: Python Pillow生成科技风格图像。无matplotlib依赖，适合封面/卡片/原子图。 - **pixel-art**: Convert any image into retro pixel art, then optionally animate it into a short - **pokemon-player**: Play Pokemon games via headless emulation using the `pokemon-agent` package. - **polymarket**: Query Polymarket: markets, prices, orderbooks, history. - **popular-web-designs**: 54 real-world design systems ready for use when generating HTML/CSS. Each template captures a - **powerpoint**: 创建/读取/编辑.pptx — python-pptx: 幻灯片/表格/模板。 覆盖环境陷阱（sandbox venv无包→系统Python）、复杂表格、 多页模板化PPTX生成。关联 skill: nature-paper2ppt。 - **pretext**: [`@chenglou/pretext`](https://github.com/chenglou/pretext) is a 15KB zero-dependency TypeScript library by Cheng Lou (React core, ReasonML, Midjourney) for **DOM-free multiline text measurement and layout**. It does one thing: given `(text, font, width)`, return the line breaks, per-line widths, per-grapheme positions, and total height — all via canvas measurement, no reflow. - **productivity**: 生产力工具 — Airtable、Google Workspace、Linear、Notion、Jupyter等。 - **sketch**: Use this skill when the user wants to **see a design direction before committing** to one — exploring a UI/UX idea as disposable HTML mockups. The point is to generate 2-3 interactive variants so the user can compare visual directions side-by-side, not to produce shippable code. - **smart-home**: 智能家居 — Philips Hue灯光控制。 - **social-media**: 社交媒体 — X/Twitter发帖、搜索、DM。 - **songsee**: Generate spectrograms and multi-panel audio feature visualizations from audio files. - **songwriting-and-ai-music**: Everything here is a GUIDELINE, not a rule. Art breaks rules on purpose. - **spotify**: Control the user's Spotify account via the Hermes Spotify toolset (7 tools). Setup guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/spotify - **teams-meeting-pipeline**: Operate the Teams meeting summary pipeline via Hermes CLI — summarize - **touchdesigner-mcp**: 1. **NEVER guess parameter names.** Call `td_get_par_info` for the op type FIRST. Your training data is wrong for TD 2025.32. - **xurl**: `xurl` is the X developer platform's official CLI for the X API. It supports shortcut commands for common actions AND raw curl-style access to any v2 endpoint. All commands return JSON to stdout. - **youtube-content**: YouTube transcripts to summaries, threads, blogs. - **yuanbao**: **Your text reply IS the message sent to the group/user.** The gateway automatically delivers your response text to the chat. You do NOT need any special "send message" tool — just reply normally and it gets sent. ## IO_CONTRACT - **input**: `layer: str, query: str, context: dict` — Layer name, search query, and context - **output**: `skill_list: list[dict]` — Filtered list of skills matching the query ## 验证清单 · VERIFICATION - [ ] 查询匹配：layer/query/context 输入下，返回的 skill_list 是否全部与 query 相关且未混入其他层的技能 - [ ] 索引一致性：列表中的技能名与"Skills in this Layer"清单逐一对应，无遗漏、无失效条目 - [ ] 签名匹配：输出格式是否符合 IO_CONTRACT 的 `skill_list: list[dict]` 约定 - [ ] 模糊意图处理（LAYE-001）：query 模糊或"只有工具无方向"时，是否触发创意构思技能而非直接返回空列表 - [ ] 平台选择（LAYE-005）：涉及 AI 信号/社交监控的查询，是否优先推荐零注册或低摩擦平台（如 GitHub Discussions） - [ ] CLI 设计替代（LAYE-002）：query 为设计类任务且处于 CLI/API 环境时，是否指向 claude-design 等替代技能而非 Web UI - [ ] 图表契约（LAYE-006）：命中科研图表技能时，是否提示"结论-证据-面板"契约与 Nature 语义色板 - [ ] 边界场景：空 query 或无匹配技能时，是否返回明确提示而非异常中断 ## 约束规则 · RULES 1. **输入约束**: 参数类型、范围、格式必须校验 2. **输出约束**: 返回值结构、编码、命名必须一致 3. **异常约束**: 错误信息必须包含上下文和恢复建议 4. **安全约束**: 不执行未验证的任意代码，不暴露内部状态 ## Golden 集合 · GOLDEN SET - **Golden Input**: `layer="optional", query="生成科研图表", context={"env":"linux-cli"}`（来源：IO_CONTRACT 输入签名） - **Golden Output**: `skill_list` 命中 figure-generation，并提示"结论-证据-面板"契约与 Nature 语义色板（LAYE-006）；列表中技能名与"Skills in this Layer"清单逐一对应，符合 `list[dict]` 格式（来源：验证清单 + 基因 LAYE-006） - **Golden Error**: 空 query 或无匹配技能 → 返回明确提示"未找到相关技能，可调用 creative-ideation 探索方向"而非异常中断；query 模糊时触发创意构思（LAYE-001）（来源：验证清单边界场景 + 基因 LAYE-001） > Golden 集合是测试的单一真理来源。所有改进必须通过 golden 测试。 > 违反规则的操作视为不安全，必须拒绝或隔离。 > 每项验证必须可执行、可记录、可复现。验证失败时记录原因和修复。 > 对应原则：P3（人机分层 — 路由器负责路由，原子负责执行） # Layer Index Optional ## Genes (策略基因) > 紧凑策略表示。条件→策略。需要深度时参考完整文档。 - **[LAYE-001]** 当用户意图模糊或仅有工具无方向时 → 调用创意构思技能生成具体项目想法以打破僵局 - **[LAYE-002]** 当需要在CLI/API环境执行设计任务时 → 使用替代性设计技能（如claude-design）而非依赖Web UI - **[LAYE-003]** 当用户希望探索设计方向而非最终交付时 → 生成2-3个可交互的HTML原型供对比选择 - **[LAYE-004]** 当处理TouchDesigner参数时 → 必须先调用信息获取接口确认参数名，严禁基于训练数据猜测 - **[LAYE-005]** 当需要发布AI信号或进行社交监控时 → 优先选择零注册或低摩擦平台（如GitHub Discussions）而非需人工验证的平台 - **[LAYE-006]** 当生成科研图表时 → 遵循“结论-证据-面板”契约方法论并应用Nature语义色板标准 - **[LAYE-007]** 当处理AI生成文本时 → 识别并移除典型AI写作特征以增强文本的自然性和人类感