Skip to content

Slim SKILL.md files by removing duplicated auth content#49

Merged
devxoul merged 1 commit intomainfrom
refactor/slim-skill-docs
Mar 8, 2026
Merged

Slim SKILL.md files by removing duplicated auth content#49
devxoul merged 1 commit intomainfrom
refactor/slim-skill-docs

Conversation

@devxoul
Copy link
Owner

@devxoul devxoul commented Mar 8, 2026

Summary

Remove detailed auth setup steps, credential storage JSON, and verbose troubleshooting from each SKILL.md — this content already exists in references/authentication.md. Replace removed sections with brief one-liner pointers to the reference files. Keep all essential content that agents need on every invocation (Quick Start, Memory, Commands, Output Format, "command not found" troubleshooting).

Changes

Bot skills (larger reductions)

  • agent-discordbot: Remove bot token setup walkthrough, server invite flow, Message Content Intent instructions, multi-bot management examples, credential JSON format, and detailed troubleshooting for permissions/token issues. Replace with single-line references.
  • agent-slackbot: Remove bot token creation steps, required scopes table, CI/CD env var instructions, credential JSON format. Replace with references.

User-token skills (smaller reductions)

  • agent-discord, agent-slack, agent-teams: Remove credential JSON format blocks, auth extraction troubleshooting sections, and security notes. Replace with compact one-liners pointing to the reference doc.

What stays

All five SKILL.md files retain Quick Start, Memory, Commands, Output Format, error code lists, and the "command not found" troubleshooting (platform-specific bunx trap).

Impact

Skill Before After Saved
agent-discordbot 508 391 -117 (23%)
agent-slackbot 392 332 -60 (15%)
agent-slack 433 405 -28 (6%)
agent-teams 407 379 -28 (7%)
agent-discord 459 432 -27 (6%)
Total 2199 1939 -260 (12%)

Bot skills had bigger reductions since they had verbose manual setup steps. User-token skills were already leaner because auto-extraction requires less setup documentation. No reference files were modified — they already contained complete coverage.


Summary by cubic

Slimmed all SKILL.md files by removing duplicated auth setup, credential JSON, and verbose troubleshooting, replacing them with one-line links to references/authentication.md. Kept Quick Start, Memory, Commands, Output Format, and command-not-found troubleshooting intact.

  • Refactors
    • Bot skills (agent-discordbot, agent-slackbot): removed token setup, permissions/intent steps, multi-bot/CI notes; added brief links to the reference.
    • User-token skills (agent-discord, agent-slack, agent-teams): removed credential JSON blocks and auth troubleshooting; added brief links to the reference.
    • Configuration notes now show only file paths with 0600 perms and point to the reference for format/security. Total reduction: -260 lines (~12%) across 5 files.

Written for commit 4b1095b. Summary will update on new commits.

Remove detailed auth setup steps, credential storage JSON format, and
verbose troubleshooting from each SKILL.md since this content already
exists in references/authentication.md. Replace with brief pointers.

Keeps essential content (Quick Start, Memory, Commands, Output Format)
that agents need on every invocation. Saves 260 lines (~12%) total.
@vercel
Copy link

vercel bot commented Mar 8, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated (UTC)
agent-messenger Ignored Ignored Mar 8, 2026 8:13am

Request Review

Copy link

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 5 files

@devxoul devxoul merged commit b747df2 into main Mar 8, 2026
5 checks passed
@devxoul devxoul deleted the refactor/slim-skill-docs branch March 8, 2026 08:18
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