agent2rss_skill

Overview

This skill is an Agent2RSS client that helps you create and manage RSS channels and push content to RSS feeds. It automates channel creation, stores channel tokens and URLs in a local config, and supports both JSON and file-upload content delivery. Built-in idempotency prevents duplicate posts and returns feed URLs for easy subscription.

How this skill works

Before any action it checks for a local config.json and runs an initialization flow if missing, creating a channel on the configured Agent2RSS server and saving the returned ID and token. Content can be pushed either as JSON (for simple content) or -- recommended -- as a Markdown file upload to avoid JSON escaping issues. All API calls use Bearer token authentication and server URLs are read from config.json so postsUrl and rssUrl are consistently derived from the configured server.

When to use it

• You need to publish AI-generated articles or reports to an RSS feed for distribution.
• You want to create, list, update, or delete RSS channels with an automated client.
• You require idempotent publishing to avoid duplicate posts when retrying requests.
• You prefer uploading Markdown files to avoid JSON escaping problems.
• You want automated config initialization and persistent channel tokens/URLs.

Best practices

• Always use file upload (Markdown) for complex content to avoid escaping issues.
• Provide a meaningful idempotencyKey (e.g., article URL or timestamp) for safe retries.
• Keep config.json backed up and never expose channel tokens publicly.
• Use the configured serverUrl from config.json; avoid localhost unless explicitly set.
• Validate token and channel ID when you get 401 or 404 responses.

Example use cases

• Create a new channel for a project and get its RSS URL to share with readers.
• Upload a Markdown article with an idempotencyKey so retries won’t create duplicates.
• List local channels and switch the default channel used for future posts.
• Update a channel name or description and synchronize the change locally.
• Permanently remove a test channel and its posts after confirming deletion.