x-posts-adapter

Ingest filtered X/Twitter posts from Postgres into a niche knowledge base.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/00PZ/oopz-inc --skill x-posts-adapter
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: x-posts-adapter
Source: https://github.com/00PZ/oopz-inc/tree/main/companies/shoshin/skills/x-posts-adapter
Command: npx skills add https://github.com/00PZ/oopz-inc --skill x-posts-adapter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Automates the ingestion of curated X/Twitter posts into a niche knowledge base from the tweet-curator Postgres source, eliminating manual exports and enabling consistent, searchable records.

Core Features & Use Cases

  • Selector-driven ingestion: filters posts using author_username_in, author_id_in, hashtags_any, min_engagement, and lookback_days to surface only relevant content for a niche.
  • Rich knowledge-item output: converts posts into [[knowledge-base]] items with provenance and engagement signals for reliable auditing.
  • Safe, read-only integration: connects to tweet-curator without altering source data, deduplicates by tweet_id, and supports end-to-end KB updates.

Quick Start

Enable knowledge_sources.x-posts in your niche profile and run the assets/scripts/fetch-x-posts.ts script to ingest curated posts into the knowledge base.

Frequently Asked Questions about x-posts-adapter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I ingest curated X posts into a knowledge base from Postgres?▼

You can ingest X posts into a knowledge base by running the fetch-x-posts script, which reads from the tweet-curator Postgres database and writes knowledge items. The process filters posts using author usernames, hashtags, and engagement metrics.

What filters can I apply when importing X posts into my knowledge base?▼

When importing X posts, you can filter by author_username_in, author_id_in, hashtags_any, min_engagement, and lookback_days. These selectors ensure only relevant content is ingested into your targeted niche profile.

Does the X posts adapter alter source data in the Postgres database?▼

No, the adapter performs safe, read-only integration with the Postgres database. It connects to the tweet-curator source without altering data and deduplicates records by tweet_id before writing to your knowledge base.

How does the X posts ingestion process handle provenance and engagement metadata?▼

The ingestion process converts posts into knowledge items while explicitly preserving provenance and engagement signals. This ensures reliable auditing and consistent, searchable records within your niche knowledge base.

Can I use this adapter to deduplicate X posts when updating my knowledge base?▼

Yes, you can use this adapter to deduplicate X posts during knowledge base updates. It automatically deduplicates records by tweet_id, ensuring end-to-end KB updates remain clean and free of redundant entries.