🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Help.Center Article Management
πŸ¦€ ClawHub

Help.Center Article Management

by @shyjal

When the user wants to create, update, read, or manage help center articles via the Help.Center API. Use when the user says "write a help article", "update t...

Versionv1.0.0
Downloads835
#writing#legal#productivity
TERMINAL
clawhub install helpcenter

πŸ“– About This Skill

name: helpcenter description: > When the user wants to create, update, read, or manage help center articles via the Help.Center API. Use when the user says "write a help article", "update the docs", "publish an article", "add to the help center", "create a knowledge base article", "edit the getting started guide", or mentions Help.Center, help articles, or knowledge base content management. Also use when the user wants to search existing articles, manage drafts, change categories, or publish/unpublish content. metadata: version: 1.0.0 author: Microdot Company

Help.Center Article Management

Manage help center articles through the Help.Center API. Supports creating new articles, reading and updating existing ones, publishing/unpublishing, and organizing by category.

Prerequisites

Before making any API calls, you need two pieces of information from the user:

1. API Key - Created in Help.Center dashboard under Settings > General > API - The key must have appropriate scopes: - content.read - Required for searching/reading articles - content.write - Required for creating/updating articles and categories - content.publish - Required for publishing/unpublishing articles - content.delete - Required for deleting articles or categories 2. Center ID - Found on the same page

If the user hasn't provided these, ask for them before proceeding. Store them as environment variables for the session:

export HC_API_KEY="the_api_key"
export HC_CENTER_ID="the_center_id"

Base URL

https://api.help.center

Authentication

All requests require the API key in the Authorization header:

Authorization: Bearer $HC_API_KEY

Workflow

When the user wants to UPDATE an existing article

1. Search for the article first to find its ID and current content: 

   curl -s -X GET \
     -H "Authorization: Bearer $HC_API_KEY" \
     -H "Content-Type: application/json" \
     "https://api.help.center/v0/centers/$HC_CENTER_ID/articles?search=SEARCH_TERM&expand[]=content"

2. Read the full article using the article ID from search results: 

   curl -s -X GET \
     -H "Authorization: Bearer $HC_API_KEY" \
     -H "Content-Type: application/json" \
     "https://api.help.center/v0/centers/$HC_CENTER_ID/articles/ARTICLE_ID?expand[]=content"

3. Update only the specific part the user wants changed. Merge the user's changes into the existing HTML content, preserving everything else. Update via the draft endpoint: 

   curl -s -X PATCH \
     -H "Authorization: Bearer $HC_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "title": "Updated Title",
       "html": "
Updated full HTML content with changes merged in
"
     }' \
     "https://api.help.center/v0/centers/$HC_CENTER_ID/articles/ARTICLE_ID/draft"

4. Publish the updated article (ask the user first if they want to publish or keep as draft): 

   curl -s -X POST \
     -H "Authorization: Bearer $HC_API_KEY" \
     "https://api.help.center/v0/centers/$HC_CENTER_ID/articles/ARTICLE_ID/publish"

When the user wants to CREATE a new article

1. List categories so the article can be assigned properly: 

   curl -s -X GET \
     -H "Authorization: Bearer $HC_API_KEY" \
     -H "Content-Type: application/json" \
     "https://api.help.center/v0/centers/$HC_CENTER_ID/articles/categories"

2. Write the article content as clean, well-structured HTML. Follow these content guidelines: - Use semantic HTML:

for main title,

for sections,

for subsections - Use

tags for paragraphs - Use

βš™οΈ Configuration