From a827452881413925b0e92846e2e8a6115a004cb5 Mon Sep 17 00:00:00 2001 From: Alfred Date: Wed, 10 Jun 2026 14:54:18 +0800 Subject: [PATCH] feat(skill): optimize SKILL.md description for better auto-triggering (#324) Rewrites the skill description with platform aliases (zh+en) and action triggers so agents reliably auto-invoke the skill. Maintainer follow-up on the branch: removed nonexistent skill_view tool reference, dropped finance category (no references/finance.md), updated the EN-locale test assertion to the new description. YAML validated, 85 tests pass. Fixes #316. --- agent_reach/skill/SKILL.md | 16 +++++++++------- agent_reach/skill/SKILL_en.md | 17 +++++++++-------- tests/test_skill_command.py | 2 +- 3 files changed, 19 insertions(+), 16 deletions(-) diff --git a/agent_reach/skill/SKILL.md b/agent_reach/skill/SKILL.md index 270182f..ceb4141 100644 --- a/agent_reach/skill/SKILL.md +++ b/agent_reach/skill/SKILL.md @@ -1,15 +1,17 @@ --- name: agent-reach description: > - Give your AI agent eyes to see the entire internet. - 17 platforms via CLI, MCP, curl, and Python scripts. - Zero config for 8 channels. + MUST USE when user asks to search, browse, read, or interact with content from any of these platforms: + 小红书/xiaohongshu/xhs, 抖音/douyin, Twitter/推特/X, 微博/weibo, B站/bilibili, + V2EX, Reddit, LinkedIn/领英, YouTube, GitHub code search, 微信公众号/WeChat articles, + 小宇宙播客, 雪球/股票行情, RSS feeds, or any web URL. + + Also MUST USE for: web搜索/搜/查/找/look up/research, 招聘/求职/jobs, 分享的链接/URL. + Routes to CLI tools: xhs-cli, twitter-cli, rdt-cli, gh, yt-dlp, curl+Jina, mcporter. + 17 platforms. Zero config for 8 channels. 【路由方式】SKILL.md 包含路由表和常用命令，复杂场景需按需阅读对应分类的 references/*.md。 - 分类：search / social (小红书/抖音/微博/推特/B站/V2EX/Reddit) / career(LinkedIn) / dev(github) / web(网页/文章/公众号/RSS) / video(YouTube/B站/播客). - - Use when user asks to search, read, or interact on any supported platform, - shares a URL, or asks to search the web. + 分类：search / social (小红书/抖音/微博/推特/B站/V2EX/Reddit) / career(LinkedIn) / dev(github) / web(网页/文章/公众号/RSS) / video(YouTube/B站/播客)。 triggers: - search: 搜/查/找/search/搜索/查一下/帮我搜 - social: diff --git a/agent_reach/skill/SKILL_en.md b/agent_reach/skill/SKILL_en.md index 32a0051..0601607 100644 --- a/agent_reach/skill/SKILL_en.md +++ b/agent_reach/skill/SKILL_en.md @@ -1,18 +1,19 @@ --- name: agent-reach description: > - Give your AI agent eyes to see the entire internet. - Search and read 17 platforms: Twitter/X, Reddit, YouTube, GitHub, Bilibili, - XiaoHongShu, Douyin, Weibo, WeChat Articles, Xiaoyuzhou Podcast, LinkedIn, - V2EX, Xueqiu, RSS, Exa web search, and any web page. - Zero config for 8 channels. Use when the user asks to search, read, or interact - on any supported platform, shares a URL, or asks to search the web. + MUST USE when user asks to search, browse, read, or interact with content from any supported platform: + Twitter/X, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu, Douyin, Weibo, + WeChat Articles, Xiaoyuzhou Podcast, LinkedIn, V2EX, Xueqiu (stocks), RSS, or any web URL. + + Also MUST USE for: web search, look up, research, find, share a URL/link, jobs/recruiting. + Routes to CLI tools: xhs-cli, twitter-cli, rdt-cli, gh, yt-dlp, curl+Jina, mcporter. + 17 platforms, zero config for 8 channels. + Triggers: "search twitter", "search xiaohongshu", "watch this video", "search the web", "look this up", "research", "youtube transcript", "search reddit", "read this link", "bilibili", "douyin video", "wechat article", "wechat official account", "weibo", "V2EX", - "xiaoyuzhou", "podcast", "xueqiu", "stock quote", - "install agent reach". + "xiaoyuzhou", "podcast", "xueqiu", "stock quote", "雪球", "股票". metadata: openclaw: homepage: https://github.com/Panniantong/Agent-Reach diff --git a/tests/test_skill_command.py b/tests/test_skill_command.py index ff76233..38c1943 100644 --- a/tests/test_skill_command.py +++ b/tests/test_skill_command.py @@ -117,7 +117,7 @@ class TestSkillCommand(unittest.TestCase): with open(target) as f: content = f.read() self.assertTrue(content.strip()) - self.assertIn("Give your AI agent eyes to see the entire internet.", content) + self.assertIn("WeChat Articles, Xiaoyuzhou Podcast", content) self.assertNotIn("搜推特", content) self.assertTrue( os.path.exists(os.path.join(skill_parent, "agent-reach", "references"))