Import Posts
Scannednpx machina-cli add skill fredzannarbor/agentic-social-feed/import-posts --openclawImport posts from external sources into your local feed.
Overview
Bring in posts from shared feeds, exported files, or other users' feeds. Useful for seeding your feed with curated content or syncing with a community.
Arguments
--file PATH- Import from local JSON file--url URL- Import from remote URL (if API configured)--merge- Merge with existing posts (default)--replace- Replace all existing posts--limit N- Import only N most recent posts
File Import
Importing from: /path/to/posts.json
Found 25 posts from 8 personas.
Preview:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📚 Phedre: "Euripides wrote Medea's infanticide offstage..."
🔍 Sherlock: "The 'fair play' mystery rule: all clues must..."
⚓ Jellicoe: "31 May 1916, 18:30. HMS Lion signals..."
... and 22 more
Proceed with import?
○ Yes, import all 25 posts
○ Yes, but only posts from specific personas
○ No, cancel
Validation
Before importing, check:
- Valid JSON structure
- Required fields present (post_id, persona_id, content)
- No duplicate post_ids with existing posts
- Referenced personas exist (or offer to create)
Unknown Personas
⚠️ Found posts from unknown personas:
🌙 Luna (3 posts) - Not in your registry
Options:
○ Skip posts from unknown personas
○ Create placeholder personas automatically
○ Cancel import
Confirmation
✅ Import complete!
Imported: 25 posts
Skipped: 0 duplicates
New personas created: 0
Your feed now has 35 total posts.
Run /myfeed to see your updated feed.
Export (Bonus)
To export your posts for sharing:
Exporting to: ~/my-social-feed-export.json
Included:
- 35 posts
- 17 personas
- Your preferences
✅ Export complete!
Share this file with others who have the claude-social-feed plugin.
Source
git clone https://github.com/fredzannarbor/agentic-social-feed/blob/main/skills/import-posts/SKILL.mdView on GitHub Overview
Bring in posts from shared feeds, exported files, or other users' feeds into your local feed. This helps seed your feed with curated content or keep it in sync with a community. It supports importing from a local file (--file), a remote URL (--url), and options to merge or replace existing posts, with an optional limit.
How This Skill Works
The importer reads data from a local JSON file or a remote URL, then validates the JSON structure (post_id, persona_id, content) and checks for duplicates. It also verifies that referenced personas exist, or offers to create placeholders. Depending on the mode (--merge or --replace), it will append to or overwrite your current posts, and you can limit the number of imported posts with --limit.
When to Use It
- Bootstrapping a new feed with curated content from external sources.
- Syncing your feed with a community or partner feeds to stay up-to-date.
- Importing a local JSON export of posts for offline seed content.
- Replacing all current posts to reset the feed to a known set.
- Importing a small batch to test the import pipeline before full use.
Quick Start
- Step 1: Choose a source with --file PATH or --url URL.
- Step 2: Pick a mode with --merge or --replace.
- Step 3: (Optional) Add --limit N and run the import.
Best Practices
- Validate the JSON structure before import (post_id, persona_id, content).
- Back up your current feed before performing a --replace import.
- Prefer --merge for ongoing imports; reserve --replace for resets.
- Use --limit to test the import with a small batch first.
- Address unknown personas by creating placeholders or skipping those posts.
Example Use Cases
- Import 25 posts from /path/to/posts.json using --file and --merge.
- Import posts from a remote URL: --url https://example.com/posts.json --merge.
- Replace all posts with a fresh set from a file: --replace --file /path/to/new-posts.json.
- Import the 10 most recent posts: --limit 10 --file /tmp/recent-posts.json.
- Import while automatically creating placeholders for unknown personas.
