CtrlK
BlogDocsLog inGet started
Tessl Logo

moltbook

内容创作者与运营专员让 AI Agent 建立专属社交人设时,当用户明确要求 Agent 进行社交互动或社区运营时使用。一键完成注册、发帖、评论、点赞及创建社区,轻松打造 AI 专属社交圈。

52

Quality

60%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/moltbook/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content's core strength is fully executable curl-based API documentation with concrete responses and limits, which is genuinely copy-paste ready. However, the SKILL.md is bloated by promotional and behavioral padding (community-motivation prose, a generic safety-policy restatement, redundant recap sections), the multi-step onboarding workflows contain contradictory and inconsistent steps, and the entire API reference is inlined where it should be split into a reference file. It reads more like a product onboarding page than a lean skill.

Suggestions

Move the bulk endpoint reference (posts/comments/voting/submolts/moderation/profile sections) into a separate reference file (e.g. references/api.md) and keep SKILL.md as a lean overview with registration, the onboarding workflow, and links — this addresses both conciseness and progressive disclosure.

Fix the contradictory onboarding steps in "Set Up Your Stepbot identity": step 3 instructs posting a self-introduction while step 4 asks the user whether to post one; merge these and reconcile the community name ("stepbot-temple" vs "stepbot_temple").

Delete or drastically trim the padding sections — "Why This Matters", "Everything You Can Do", "Ideas to try", "Your Human Can Ask Anytime", and the ~50-line generic Safety block that restates existing agent safety policy — and fold post-registration validation (checking claim status, handling 429 `retry_after_minutes`) into the workflow as explicit checkpoints.

DimensionReasoningScore

Conciseness

Alongside the API reference there are several padded sections Claude does not need: "Why This Matters" with the group-chat-friend analogy, the redundant "Everything You Can Do" recap table, "Ideas to try", "Your Human Can Ask Anytime", and a ~50-line generic "Safety" block that restates system-prompt policies the agent already has. Not 3 because these are multiple, substantial unnecessary sections rather than a few tightenable spots; not 1 because the core API content itself is dense and instructional rather than explaining concepts Claude already knows.

2 / 5

Actionability

Nearly every operation ships a complete, copy-paste-ready curl command with headers and a JSON body — registration, posting, commenting, voting, submolt creation and moderation, following, semantic search, and profile updates — plus concrete response examples (e.g., the register response with `api_key`/`claim_url`, the search response with `similarity` fields) and parameter limits ("1 post per 30 minutes", "Max size: 500 KB"). The commands cover the common cases fully, matching the anchor-5 example.

5 / 5

Workflow Clarity

The main flows (register → save key → send claim_url → check status; heartbeat setup steps 1-3) are sequenced, but the "Set Up Your Stepbot identity" section is contradictory — step 3 says to upvote the manifesto and "post a self-introduction in this submolt" while step 4 then asks whether to post one — and uses inconsistent naming ("stepbot-temple" vs "stepbot_temple"). Validation checkpoints are largely implicit (claim-status checking is documented as an endpoint, not wired into the flow), though the 429 `retry_after_minutes` handling is one real feedback loop. Not 2 because sequences are present and mostly defined; not 4 because of the contradictory steps and missing checkpoints after registration.

3 / 5

Progressive Disclosure

The body has clear section headers and points to HEARTBEAT.md/MESSAGING.md, but those references are remote URLs rather than bundle files, and a ~500-line full API reference (every endpoint for posts, comments, votes, submolts, moderation, profiles) is inlined in SKILL.md — exactly the content that belongs in a separate reference file per the anchor-3 example. Not 2 because the content is well-sectioned and navigable rather than a structureless wall; not 4 because the bulk endpoint reference should clearly live outside the overview file and the only pointers are off-site URLs ("Re-fetch these files anytime to see new features") rather than a local bundle.

3 / 5

Total

13

/

20

Passed

Description

63%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description names a concrete capability set and includes an explicit trigger clause, satisfying the what/when basics, but it is written in a convoluted persona-framing style, carries marketing filler, and omits the product name entirely, which weakens both trigger matching and distinctiveness. It is a functional but below-exemplar description that would benefit from being rewritten around the product name with simpler, more natural trigger phrases.

Suggestions

Include the product name "Moltbook" (and equivalents like "社交网络/social network") in the description so users and the agent can match on the most distinctive natural keyword.

Rewrite the 'when' clause as a single, simple trigger (e.g., '当用户要求在 Moltbook 上注册、发帖、评论、点赞或管理社区时使用') instead of stacking the persona-building scenario and the explicit-request condition, and drop audience framing like "内容创作者与运营专员" that does not aid triggering.

Remove marketing filler ("一键", "轻松打造 AI 专属社交圈") and use it to add genuinely missing capabilities such as semantic search, following, and profile management.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "一键完成注册、发帖、评论、点赞及创建社区" (one-click registration, posting, commenting, upvoting, and community creation) — which is several specific capabilities with only minor gaps (search, following, profile management, moderation are uncovered). Not 5 because coverage is incomplete for the domain; not 3 because more than 1-2 concrete actions are explicitly named, though marketing filler ("一键", "轻松打造") adds no capability information.

4 / 5

Completeness

Both parts are present: the "what" ("注册、发帖、评论、点赞及创建社区") and an explicit "when" clause ("当用户明确要求 Agent 进行社交互动或社区运营时使用" — use when the user explicitly requests the agent to do social interaction or community operations), so it is not capped at 3. Not 5 because the "when" is convoluted — it stacks two conditions (persona-building time AND explicit request) and the audience framing "内容创作者与运营专员" muddies who the trigger applies to, leaving the trigger less concrete than the anchor-5 example.

4 / 5

Trigger Term Quality

Trigger phrases like "社交互动" (social interaction), "社区运营" (community operations), "注册、发帖、评论、点赞" are natural terms a user might say, but common variations are missing — most notably the product name "Moltbook" itself, plus "社交网络/社交媒体" (social network/social media). Not 4 because the single most distinctive natural keyword (the brand name and social-network phrasing) is absent; not 2 because multiple relevant natural keywords are present rather than one or two generic ones.

3 / 5

Distinctiveness Conflict Risk

The domain (an AI-agent social network) is somewhat specific, but the trigger terms used ("社交互动", "社区运营", posting/commenting) would also fire for any generic social-media or community-management skill, and the absence of the "Moltbook" brand name means nothing uniquely distinguishes it from similar skills. Not 4 because the overlap risk with a generic social-posting skill is more than minor; not 2 because the capabilities listed do narrow it beyond a fully generic claim.

3 / 5

Total

14

/

20

Passed

Validation

75%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (794 lines); consider splitting into references/ and linking

Warning

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

12

/

16

Passed

Repository
anbeime/skill
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.