x-api-data-access

Convert vague X API data requests into concrete retrieval plans with endpoints and auth scopes.

18|4|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/parmartejass/AGENTS.MD --skill x-api-data-access
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-api-data-access
Source: https://github.com/parmartejass/AGENTS.MD/tree/main/docs/agents/skills/x-api-data-access
Command: npx skills add https://github.com/parmartejass/AGENTS.MD --skill x-api-data-access

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Convert vague X API data requests into concrete retrieval plans, selecting endpoints, auth scopes, and field requirements before implementation.

Core Features & Use Cases

  • Classify requests into endpoint families and required authentication.
  • Map needs to capabilities like posts, timelines, bookmarks, likes, follows, lists, spaces, and direct messages with appropriate parameters (fields, expansions, pagination).
  • Validate against rate limits, retention windows, and plan constraints using official docs as references.
  • Example: given a user request for a private timeline and bookmarks, produce a scoped plan with the necessary PKCE flow and scopes.

Quick Start

Describe your X data requirement and the skill will map it to endpoints, auth scopes, and field selections.

Frequently Asked Questions about x-api-data-access

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

FAQPage Schema
How do I map X API data requests to specific endpoints and authentication scopes?

To map X API data requests, you must classify the request into endpoint families and determine the required authentication scopes. This process converts vague data needs into concrete retrieval plans by selecting appropriate endpoints, auth scopes, and field requirements before implementation.

What is needed to access private timelines and bookmarks via the X API?

Accessing private timelines and bookmarks via the X API requires a scoped plan utilizing the PKCE flow and specific authentication scopes. You must validate these requirements against official auth-and-scopes references to ensure proper access to private data patterns.

Can I retrieve direct messages and spaces using the same X API data access planning?

Yes, you can retrieve direct messages and spaces using X API data access planning. The planning process maps these needs to capabilities with appropriate parameters, including fields, expansions, and pagination, while validating against rate limits and retention windows.

How do I handle X API pagination and field expansions for posts and timelines?

Handling X API pagination and field expansions involves mapping your needs to capabilities like posts and timelines with appropriate parameters. The planning process selects the necessary fields and expansions, and applies pagination constraints to ensure complete data retrieval within rate limits.

What are the limitations and gotchas when planning X API data retrieval tasks?

Limitations when planning X API data retrieval tasks include rate limits, retention windows, and plan constraints. You must validate endpoints, scopes, and retention windows against official limitations-and-gotchas references before generating a retrieval plan to avoid hitting access walls.