oderajoseph95

Intercom Article Writer — Development skill for Claude Code

Development community

A Claude Code skill that writes help articles from your code and publishes them to Intercom, with a CI gate so no feature ships without its article.

How to install Intercom Article Writer

This entry records only its repository, not the path inside it, so there is no exact command to give. Open oderajoseph95/intercom-article-writer and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Intercom Article Writer does

A Claude Code skill that writes help articles from your code and publishes them to Intercom, with a CI gate so no feature ships without its article.

Alternatives in Development

  • Releasing — This project ships as a Claude Code plugin 10.9k ★
  • News Writer — Turn fresh news in the site's niche into grounded news-article drafts and queue them in Distribb to autopublis 195 ★
  • Pubmed MCP Server — Search PubMed/Europe PMC, fetch articles and full text (PMC/EPMC/Unpaywall), citations, MeSH terms via MCP 150 ★

README

Intercom Article Writer

A Claude Code skill that writes help-center articles from your code and publishes them to Intercom, plus a CI gate that fails the build when a feature ships without an article.

  • Coverage manifest: one file that says which articles every shipped feature owes.
  • CI gate: fails when a feature has no article, when an article file goes missing, or when a "we'll write it later" has no ticket behind it. Warns when the code an article describes has changed since it was published.
  • Grounded drafts: Claude writes each article from the implementing code and your UI strings file, so button labels, defaults and limits match the product. SEO question titles, one topic per article, a "what this does NOT do" section every time.
  • Publisher: markdown to Intercom HTML with the fixes Intercom needs (spacing between blocks, no double title, paginated collections, create-or-update by id). Dry run by default.
  • Parity ledger: PUBLISHED.md lists every article that is live, and --parity reports drift between the repo and the Help Center.

No dependencies. Node 18+.

Install as a Claude Code skill

For every project on your machine:

git clone https://github.com/oderajoseph95/intercom-article-writer ~/.claude/skills/intercom-article-writer

Or for one repo, so your team gets it too:

git clone https://github.com/oderajoseph95/intercom-article-writer .claude/skills/intercom-article-writer

Then ask Claude Code something like:

  • "Which of our shipped features have no help article?"
  • "Write a help article for the CSV export feature."
  • "Set up the help article coverage gate in CI."
  • "Publish the reviewed articles to Intercom."

Claude picks up the skill from its description. `SKILL.md` holds the full workflow.

Environment

Variable Required Default What it is
INTERCOM_API_TOKEN to talk to Intercom none Access token from your Intercom developer app. Needs articles read a