CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

add-emacs

Add Emacs as a channel. Opens an interactive chat buffer and org-mode integration so you can talk to NanoClaw from within Emacs (Doom, Spacemacs, or vanilla). Local HTTP bridge — no bot token or external service needed.

Quality

78%

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 ./.claude/skills/add-emacs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%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.

This is a strong, fully executable operational guide with an exemplary validation-first workflow (build and test gates before proceeding, plus thorough troubleshooting recovery paths). Its main weaknesses are a monolithic single-file structure with no progressive disclosure into reference files and some trimmable promotional/formatting content.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence (no explanation of what Emacs or org-mode are) and nearly every line is a command, config block, or diagnostic. It is not a 5 because of the promotional "What you can do with this" section, the inlined markdown-to-org conversion table, and the sheer 285-line length with minor trims available.

4 / 5

Actionability

Everything is copy-paste executable: "nc:copy from-branch:channels", "nc:append to:src/channels/index.ts", build/test commands, curl verification calls, per-distribution elisp blocks, and grep-based diagnostics. Concrete commands cover the common cases (three Emacs distributions, macOS and Linux restarts, with/without auth token).

5 / 5

Workflow Clarity

A clear Install → Enable → Wire → Configure → Restart → Verify sequence with explicit validation checkpoints ("Both must be clean before proceeding") and a described feedback loop (the registration test that goes red if the import drifts). The troubleshooting section adds recovery paths for each failure mode, matching the top anchor.

5 / 5

Progressive Disclosure

Sections are clearly headed and easy to navigate, but the skill is a monolithic 285-line SKILL.md with no reference files at all; troubleshooting, channel info, and the agent-formatting table are inlined content that belongs in separate files. The only external reference, [REMOVE.md](REMOVE.md), is not present in the bundle. Not a 2 because the structure is good rather than minimal, and not a 4 because substantial content that should be split out is inline.

3 / 5

Total

17

/

20

Passed

Description

65%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 clearly states what the skill does and is well differentiated, but it lacks any "Use when..." trigger guidance and slips into second-person voice ("so you can talk to NanoClaw"), costing it specificity points under the rubric. It is solid but sits below the strong examples on completeness and trigger phrasing.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user wants to add or configure an Emacs channel, chat with the assistant from Emacs, or send org-mode buffers/subtrees to it."

Rewrite in third person to avoid the second-person penalty: "Opens an interactive chat buffer and org-mode integration for talking to NanoClaw from within Emacs" instead of "so you can talk to NanoClaw".

Broaden natural trigger terms with common synonyms users would say — elisp, .el, Emacs Lisp, or "my editor" — to lift trigger-term coverage from good to comprehensive.

DimensionReasoningScore

Specificity

"Add Emacs as a channel. Opens an interactive chat buffer and org-mode integration" names several concrete actions with only minor coverage gaps (anchor 4), but "so you can talk to NanoClaw from within Emacs" is second-person voice, which the guidelines penalize by 1 point. Reduced to 3; not a 2 because the domain and multiple specific capabilities are explicitly named.

3 / 5

Completeness

The "what" is clear (interactive chat buffer and org-mode integration over a local HTTP bridge), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not a 4 because the "when" is entirely missing rather than merely implicit-but-recoverable.

3 / 5

Trigger Term Quality

Good natural keyword coverage: "Emacs", "chat buffer", "org-mode", "talk to NanoClaw from within Emacs", plus distribution synonyms "Doom, Spacemacs, or vanilla". Not a 5 because common variations like elisp, .el, M-x, or generic editor terms are absent.

4 / 5

Distinctiveness Conflict Risk

"Emacs", "org-mode", and the named distributions (Doom, Spacemacs, vanilla) are highly distinct triggers with a clear niche; minimal risk of firing for a non-Emacs channel skill.

5 / 5

Total

15

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

nanocoai/nanoclaw

Path

.claude/skills/add-emacs/SKILL.md

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.