SKILL.md
This is the PANews creator skill for contributors who need to write, edit, manage, and publish articles on the platform. Use it when the task involves authenticated creator workflows such as validating a session, managing drafts or submissions, uploading images, searching tags, applying for a column, or preparing an article for review.
It is best suited for real PANews publishing operations rather than generic writing help alone. The skill should guide the user through the platform workflow clearly and safely, especially when session validation, submission state, or destructive actions are involved.
Session verification is required before any operation. If no session is available, guide the user to get PA-User-Session from browser DevTools -> Application -> Cookies. On a 401 response, stop immediately and tell the user the session has expired and needs to be refreshed.
Common User Phrases
- "Help me publish this article."
- "Upload this cover image and find tags for my draft."
Capabilities
| Scenario | Trigger intent | Reference |
|---|---|---|
| Publish a new article | I want to publish an article / help me submit | [workflow-publish](./references/workflow-publish.md) |
| Manage my articles | Status of my submissions / any rejections | [workflow-manage](./references/workflow-manage.md) |
| Revise and resubmit | Edit a draft / resubmit a rejected article | [workflow-revise](./references/workflow-revise.md) |
| Apply for a column | I don't have a column yet / want to start a column | [workflow-apply-column](./references/workflow-apply-column.md) |
| Upload an image | Upload this cover image / turn this local image into a usable asset URL | Use upload-image |
| Search tags | Find suitable tags / search PANews tags for this topic | Use search-tags |
| Polish an article | Help me improve this article / review it | [workflow-polish](./references/workflow-polish.md) |
Language
--lang accepts standard locale strings (zh, en, zh-TW, en-US, ja-JP, etc.), automatically mapped to the nearest supported language; most read-style commands auto-detect the system locale if omitted. For create-article, --lang indicates the article content language and is required. Pass the language the article is actually written in; this command does not auto-detect the locale.
General principles
- On 401, stop immediately and prompt the user to refresh the session
- Require explicit confirmation before any delete operation
- Do not modify the user's article content or opinions unprompted
Execution guards
- Use more freedom for low-risk tasks such as polishing copy, suggesting improvements, or helping the user prepare content before submission.
- Use strict procedure for high-risk creator actions:
- Before any create, update, delete, submit, or column-application action, validate that a usable PA-User-Session is available. - On any 401 response, stop immediately and ask the user to refresh the session before continuing. - Before deletion, obtain explicit user confirmation for the exact target article. - When updating an article, change only the fields the user asked to modify. - Before moving an article to PENDING, make sure the user intends to submit it for review now. - Treat image upload and tag search as support steps for PANews publishing workflows, not as unrelated generic utilities.
Scripts
scripts/cli.mjs: unified entrypoint for PANews creator commands
node {Skills Directory}/panews-creator/scripts/cli.mjs <command> [options]When unsure about parameters, check with --help first:
node {Skills Directory}/panews-creator/scripts/cli.mjs --help
node {Skills Directory}/panews-creator/scripts/cli.mjs <command> --helpAvailable commands:
validate-session Validate session and list owned columns
list-articles List articles in a column
create-article Create an article in a column
update-article Update a DRAFT or REJECTED article
delete-article Delete a DRAFT or REJECTED article
upload-image Upload a local image and return CDN URL
search-tags Search tags by keyword
apply-column Submit a column application