virgiliojr94/x-to-skill

x-to-skill

Turn a public X/Twitter account’s posts into a citable agent skill — recurring ideas, real contradictions, and a source URL behind every claim.

English · Português (Brasil)

For people, it is a searchable collection. For AI agents, it is a local, provenance-preserving corpus with a cheap sample and monthly chunks — without putting an entire timeline into context.

Output

-corpus/
├── manifest.json       # requested/actual window, counts, and file list
├── raw.jsonl           # complete source records; quote-tweet context
├── corpus.md           # compact chronological collection
├── sample.md           # up to 3 high-signal posts per month
└── chunks/YYYY-MM.md   # monthly slices for selective reading

The resulting skill is structured by themes, not dates. An idea becomes a framework only when it recurs in at least three posts; smaller themes become observations or are dropped.

Requirement

opencli is required. It reuses the existing authenticated Chrome session to read only the named account’s public posts.

npm install -g @jackwener/opencli
opencli twitter whoami -f json

Do not substitute a scraper or another API/client: the safety guards depend on opencli’s output format.

Install in an agent or LLM

For any agent/LLM that can install skills from a GitHub repository, paste this into its chat:

Install https://github.com/virgiliojr94/x-to-skill

The agent must follow its own skill-installation convention, then read SKILL.md before use. A future npx installer may simplify this; the GitHub URL is the install source today.

Use it

After installation, ask your agent to use x-to-skill for the public X profile URL you want to analyze. Each agent discovers and invokes installed skills through its own configuration and command convention; this project does not prescribe a slash command, prompt syntax, or filesystem path.

The agent follows SKILL.md: it collects the named public profile, asks the intake questions, and records the actual returned date window in manifest.json. The default requested window is the previous 365 days; X may return less history than requested.

Intake

Before collecting, choose or accept defaults:

Profile is a lens for theme hypotheses; it never restricts collected posts. A technical account can yield philosophical principles and the reverse is true.

Safety and scope

• Reads only public posts from the named account.