Skip to content

docs(skills): fix skill-authoring accuracy in Overview and External Skills - #109

Merged
Aaronontheweb merged 1 commit into
devfrom
docs/skills-overview-accuracy-fixes
Jul 22, 2026
Merged

docs(skills): fix skill-authoring accuracy in Overview and External Skills#109
Aaronontheweb merged 1 commit into
devfrom
docs/skills-overview-accuracy-fixes

Conversation

@Aaronontheweb

Copy link
Copy Markdown
Contributor

Small correctness and clarity fixes surfaced while auditing the skills docs against the netclaw 0.25.0 source. Scoped deliberately small; the broader readability pass and the new local-skill tutorial are separate follow-ups.

  • Factual bug: External Skills claimed external skills skip the prompt-injection scanner. They don't - skill_load scans every skill at load regardless of source (SkillLoadTool.cs); external skills only skip the write-time scan, since you author them in another tool. Corrected (it also contradicted the Overview, which was right).
  • Factual bug: Overview said 'create, edit ... with netclaw skill', but there are no such subcommands. You create a native skill by dropping a SKILL.md or via the agent's skill_manage tool; netclaw skill inspects/removes/validates.
  • Clarity: name the system-skill source - 'a CDN' becomes 'netclaw's own feed', so it reads as first-party rather than an unspecified third party.
  • Clarity: define 'prompt injection' inline on first use.
  • Cleanup: remove a shipped placeholder TODO comment.

Verified: npm run build generates both pages; no new external links. Chips at #104.

…kills

Small correctness + clarity fixes surfaced while auditing the skills docs
against the netclaw 0.25.0 source:

- External Skills wrongly claimed external skills skip the prompt-injection
  scanner. They don't - skill_load scans every skill at load regardless of
  source; external skills only skip the write-time scan (they're authored
  in another tool). Corrected.
- Overview said 'create, edit ... with netclaw skill', but there are no
  such subcommands. You create a native skill by dropping a SKILL.md or via
  the agent's skill_manage tool; netclaw skill inspects/removes/validates.
- Name the system-skill source: 'a CDN' -> 'netclaw's own feed', so it
  reads as first-party rather than an unspecified third party.
- Define 'prompt injection' inline on first use.
- Remove a shipped placeholder TODO comment.

Chips at #104.
@Aaronontheweb
Aaronontheweb enabled auto-merge (squash) July 22, 2026 04:16
@Aaronontheweb
Aaronontheweb merged commit 6773575 into dev Jul 22, 2026
2 checks passed
@Aaronontheweb
Aaronontheweb deleted the docs/skills-overview-accuracy-fixes branch July 22, 2026 04:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant