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.