Skip to content

feat(skill-discourse): add Discourse skill for the DHIS2 Community of Practice - #3

Open
ivargr wants to merge 2 commits into
dhis2:mainfrom
ivargr:feat/skill-discourse
Open

ivargr wants to merge 2 commits into
dhis2:mainfrom
ivargr:feat/skill-discourse

Conversation

@ivargr

@ivargr ivargr commented Sep 22, 2026 •

Copy link
Copy Markdown

Summary

Adds @dhis2/skill-discourse under src/skills/discourse/: a skill for setting up the official @discourse/mcp server against the DHIS2 Community of Practice and using it from an AI coding agent.

It covers:

  • Setup — generating a Discourse user API key, registering the MCP server at user scope with write tools enabled, and the gotchas we hit (missing profile dir, --allow_writes, harmless 404 on /ai/tools).
  • Reading — searching topics and posts, filtering recent activity in a category, reading threads (with post content treated as untrusted data).
  • Drafting and posting — defaults to Discourse drafts the user publishes from the composer; only posts live on explicit request. Includes the new_topic draft/sequence handling and a pre-filled composer link fallback when write tools are unavailable.

The skill was ported from the dhis2-chap/claude-plugins marketplace, where the CHAP team uses it to search the CoP and draft release announcements, and generalised for DHIS2. The Chap & Modeling category (id 84) is kept as the worked example.

Also adds the skill to the README install section and the workspace lockfile. No changeset, per CLAUDE.md (skills are ignored by changesets).

Test plan

  • pnpm lint passes
  • pnpm changeset status --since=origin/main passes
  • npx skills add https://github.com/ivargr/ai-devtools/tree/feat/skill-discourse/src/skills/discourse installs the skill

🤖 Generated with Claude Code

ivargr and others added 2 commits September 22, 2026 09:01
… Practice

Adds @dhis2/skill-discourse: a skill for setting up the official
@discourse/mcp server against community.dhis2.org and using it to search
and read topics and to draft release announcements and replies. Ported
from the dhis2-chap/claude-plugins marketplace and generalised for DHIS2;
the Chap & Modeling category is kept as the worked example.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Too product-specific for a general DHIS2 skill.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
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