shuoshuo-notes

shuoshuo-notes is a skill for Claude Code, Codex from rcy1314/echo-noise. It costs 63 tokens per session (3,572 once invoked), scanned A, original, MIT.

A Chinese-language tool for managing posts or notes on the “说说笔记” service through its web API, with an optional MCP connection. MCP is a way for software tools to expose actions to an AI assistant.

In plain words
What is it for?
Use it to publish, search, browse, view, update, delete, or pin posts; manage login tokens; check service status and configuration; and inspect calendars or RSS feeds.
Why use it?
It hides the difference between the available connection methods and can use the API when MCP is not clearly enabled or does not work.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/rcy1314/echo-noise/skill
Any agent
npx skills add rcy1314/echo-noise --skill skill
Clone the repo
git clone --depth 1 https://github.com/rcy1314/echo-noise

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for shuoshuo-notes

README.md
[![agentmods](https://agentmods.dev/badge/skills/rcy1314/echo-noise/skill.svg)](https://agentmods.dev/skills/rcy1314/echo-noise/skill)
Your own site
<a href="https://agentmods.dev/skills/rcy1314/echo-noise/skill"><img src="https://agentmods.dev/badge/skills/rcy1314/echo-noise/skill.svg" alt="Measured on agentmods" height="20"></a>
Per session 63 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,572 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00063 $0.03572
Opus 5 $0.00032 $0.01786
Sonnet 5 $0.00013 $0.00714
Haiku 4.5 $0.00006 $0.00357

Measured 5d ago against content hash 41062a758ff0, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

shuoshuo-notes scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl "$MCP_BASE_URL/mcp/tools"
skill/SKILL.md · 579 lines

How it starts

The opening of the file, as written. The whole thing — 579 lines — stays where its author put it; the contents beside it link to each section on GitHub.

说说笔记 Skill

本 skill 仅保留一份,统一封装“说说笔记”的两种调用模式:

  • API 模式:默认模式,项目默认部署通常不启用 MCP 时使用
  • MCP 模式:只有在环境明确已启用 MCP 时才使用

核心要求:

  • 不默认假设 MCP 已开启
  • 优先保证功能可用,再选择更合适的调用通道
  • 对用户隐藏底层差异,统一输出整理后的中文结果

何时调用

当用户有以下需求时,应调用本 skill:

  • 发布一条说说或笔记
  • 搜索、筛选、分页浏览内容
  • 查看某条内容详情
  • 更新、删除、置顶内容
  • 登录后台、获取或重建 token
  • 查询状态、前端配置、发布日历、RSS
  • 排查 API 或 MCP 是否可用

配置驱动(推荐)

为避免每次改文档,建议优先使用同目录 config.json 作为运行参数来源。

优先级建议如下:

  1. 用户本轮对话明确指定(最高优先)
  2. skill/config.json 中的配置
  3. 文档默认值(最低优先)

推荐 AI 行为:

  • 开始执行前先读取 skill/config.json
  • baseUrl 作为 API 基础地址
  • mcpBaseUrl 作为 MCP HTTP/SSE 验证地址
  • defaultMode=api 时默认走 API
  • autoFallbackToApi=true 且 MCP 不可用时自动回退 API

首次安装自动引导(无需用户先说固定指令)

当满足以下任一条件时,AI 应进入“配置引导模式”并先提问,不直接执行写操作:

  • baseUrl 为空
  • baseUrl 仍是占位值(如 your-domain.com
  • onboarding.completed=falseonboarding.enabled=true

引导模式建议提问顺序:

  1. 你的站点域名是什么(如 https://example.com)?
  2. 本次默认走 API 还是 MCP
  3. 是否启用“MCP 失败自动回退 API”?

引导完成后,AI 应在后续对话中默认沿用本轮确认的配置,并在必要时提醒你同步更新 skill/config.json

默认工作模式

默认决策顺序必须如下:

  1. 先判断是否已明确可用 MCP
  2. 若未明确启用 MCP,则直接走 API 模式
  3. 若已明确启用 MCP,再根据任务选择 MCP 模式
  4. MCP 失败时,若等价 API 可用,应回退到 API

以下情况视为“已明确启用 MCP”:

  • 用户明确说明已配置 MCP 客户端
  • 环境已提供可调用的 MCP server 配置
  • 已知服务运行在 final-mcp、独立 mcp 容器,或已暴露 /mcp/* 端点
  • 已验证 GET /mcp/toolsGET /mcp/sse 可访问

以下情况一律按“未启用 MCP”处理:

  • 普通默认部署
  • docker-compose.yml 使用主应用 target: final
  • 只有后端服务可访问,但未确认 1315 或 MCP 子进程

双模式能力总览

API 模式

API 模式为默认首选,直接调用后端 HTTP 接口。

  • 状态GET /apiGET /api/status
  • 配置GET /api/frontend/configGET /api/settings
  • 分页GET /api/messages/pagePOST /api/messages/page
  • 详情GET /api/messages/:id
  • 搜索GET /api/messages/search
  • 标签内容GET /api/messages/tags/:tag
  • 标签列表GET /api/messages/tags
  • 日历GET /api/messages/calendar
  • RSSGET /rss
  • 登录POST /api/login
  • 发布POST /api/messagesPOST /api/token/messages
  • 更新PUT /api/messages/:idPUT /api/token/messages/:id
  • 删除DELETE /api/messages/:idDELETE /api/token/messages/:id
  • 置顶PUT /api/messages/:id/pinPUT /api/token/messages/:id/pin
  • 读取 tokenGET /api/user/token
  • 重建 tokenPOST /api/user/token/regenerate
  • 更新设置PUT /api/settingsPUT /api/token/settings

Read the full file on GitHub · 579 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 579 lines · 63 tokens per session scan A 41062a758ff0

Subscribe to this mod's changes

shuoshuo-notes is a skill published in the GitHub repository rcy1314/echo-noise (57 stars, last pushed 1mo ago), licensed MIT. It adds 63 tokens to every session and 3,572 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

debugging-output-and-previewing-html-using-ray

Use when user says "send to Ray," "show in Ray," "debug in Ray," "log to Ray," "display in Ray," or wants to visualize data, debug output, or show diagrams in the Ray desktop application.

coollabsio/coolify · 58 tokens

changelog-entry

Add a new entry to CHANGELOG.yml under the current unreleased version (or create the version block if needed), then regenerate documentation. Use when the user says things like "add a changelog entry", "log this fix in the changelog", or "/changelog-entry".

telepresenceio/telepresence · 60 tokens

project-snmp-profiles-authoring

Use when editing Netdata SNMP profile YAMLs, topology SNMP profiles, ddsnmp profile parsing, or profile-format documentation. Requires checking source MIB field accessibility, especially MAX-ACCESS not-accessible INDEX objects, before adding or changing profile symbols.

netdata/netdata · 60 tokens

sora-taira-testnet

Work against the SORA Taira testnet through its deployed Torii MCP endpoint for live account, asset, alias, contract, governance, Musubi package-registry, and transaction workflows. Use when Codex needs to inspect or mutate the Taira testnet, verify or add https://taira.sora.org/v1/mcp, prefer the curated iroha. tool…

hyperledger-iroha/iroha · 113 tokens

web-artifacts-builder

Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.

Prismer-AI/PrismerCloud · 64 tokens

gateway

Start and manage the Kurtosis gateway for Kubernetes. The gateway forwards local ports to the Kurtosis engine and services running in a k8s cluster. Required when using Kurtosis with Kubernetes. Use when kurtosis engine status shows nothing on k8s or services aren't reachable.

kurtosis-tech/kurtosis · 57 tokens