CtrlK
BlogDocsLog inGet started
Tessl Logo

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). Uses a local HTTP bridge — no bot token or external service needed.

62

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/add-emacs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

83%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 body is highly actionable with executable commands and concrete per-distribution examples, sequenced through clear phases with validation gates. Minor conciseness and validation-gap improvements would lift it further.

DimensionReasoningScore

Conciseness

Largely command-first with no padding about Emacs/org-mode/HTTP concepts; a few minor over-explanations ('works out of the box with defaults', 'no package manager setup needed') keep it just below a 5.

4 / 5

Actionability

Fully executable and copy-paste ready across every phase — git merge, build/test gates, per-distribution elisp blocks, curl with expected output, lsof/kill, sqlite3 queries — covering the common cases including auth tokens.

5 / 5

Workflow Clarity

Clear four-phase sequence with an idempotency pre-flight and an explicit build/test validation gate before proceeding; minor gaps are the ungated manual conflict resolution and the lack of a re-verify after the Phase 3 restart.

4 / 5

Progressive Disclosure

Well-sectioned into logical phases with no nested or 2+-level doc references; with no bundle files present, content is appropriately inline for this single-purpose channel skill, though a few long troubleshooting blocks could be lightly consolidated.

4 / 5

Total

17

/

20

Passed

Description

61%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 is specific and distinctive, clearly naming the Emacs channel capability and its mechanism. Its main weakness is the absence of an explicit 'Use when...' trigger clause, leaving the invocation condition only weakly implied.

Suggestions

Add a 'Use when...' clause naming the natural trigger (e.g. 'Use when the user wants to chat with NanoClaw or send org-mode content from inside Emacs').

Include a couple of common user phrasings or synonyms (e.g. 'AI assistant in Emacs', 'ask Andy from Emacs') to strengthen trigger-term coverage toward 5.

DimensionReasoningScore

Specificity

Lists several concrete actions ('Opens an interactive chat buffer and org-mode integration', 'Uses a local HTTP bridge') with a specific mechanism; stops short of the comprehensive enumeration of a 5.

4 / 5

Completeness

A clear 'what' is present but there is no 'Use when...' clause, so the 'when' is only weakly implied — the missing-trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Good natural-term coverage ('Emacs', 'chat buffer', 'org-mode', 'Doom, Spacemacs, or vanilla', 'talk to NanoClaw') with distribution synonyms, but a few common user phrasings (e.g. 'ask my AI from Emacs') are missing.

4 / 5

Distinctiveness Conflict Risk

Clearly niche ('Emacs as a channel', named distributions, 'local HTTP bridge') with minimal overlap risk, though it lacks explicit trigger phrases that would push it to 5.

4 / 5

Total

15

/

20

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
jbaruch/nanoclaw-telegram
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.