xpoz-best-practices SKILL.md skillA
xpoz-best-practices from xpozpublic/xpoz-agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add xpozpublic/xpoz-agent-skills/xpoz-best-practices@v2026-06-10Pins v2026-06-10 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- xpozpublic/xpoz-agent-skills
- Path
skills/xpoz-best-practices/SKILL.md- Versions recorded
- 2
- Latest version
- v2026-06-10, committed Jun 16, 2026
- First version recorded
- Jun 10, 2026
- Size
- 12,340 bytes
- Repository stars
- 16
- License
- MIT
Reference guide for using Xpoz effectively. Load this skill whenever working with Xpoz MCP tools, SDKs, or CLI — it ensures correct query syntax, optimal field selection, proper pagination, and best practices for every Xpoz interaction. Covers authentication, query syntax (boolean operators, date filtering), response modes (fast/paging/CSV), field selection, tracking setup, and all platform tool references (Twitter, Instagram, Reddit, TikTok). Use for ANY Xpoz-related work, not just explicit…
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Xpoz Best Practices
## Overview
Xpoz is a social media intelligence platform providing access to **Twitter/X**, **Instagram**, **Reddit**, and **TikTok** data through MCP tools, Python SDK, TypeScript SDK, and CLI — no social media API keys required.
## When to Use
Load this skill for **any Xpoz interaction** — not just when the user explicitly asks about best practices. It provides the context needed to use Xpoz tools correctly:
- Calling any Xpoz MCP tool (query syntax, field selection, response modes)
- Writing code with the Python or TypeScript SDK
- Using the Xpoz CLI
- Setting up authentication or tracking
- Troubleshooting errors or empty results
- Choosing which tool to use for a specific task
## Quick Start
**MCP** — add the Xpoz MCP server to your agent's config. The server URL is `https://mcp.xpoz.ai/mcp`. Most MCP clients handle OAuth automatically on first tool call.
Example for Claude Code (`~/.claude.json`):
```json
{
"mcpServers": {
"xpoz": {
"url": "https://mcp.xpoz.ai/mcp",
"transport": "streamable-http"
}
}
}
```
**Python SDK:**
```bash
pip install xpoz
```
```python
from xpoz import XpozClient
…Read the whole file at its exact version.
How to install
mdr add xpozpublic/xpoz-agent-skills/xpoz-best-practices@sha256:034e197e8c66e848The line at the top of this page pins the label v2026-06-10, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_5jexe63xxyyxbolh)
5 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Jun 10, 2026 and Jun 16, 2026, about one every 6 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v2026-06-10 latest | 2026-06-16 | bd24b52 | 12,340 B | A | view · diff |
| v2026-06-10 | 2026-06-10 | 81fc398 | 12,633 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (12340 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
xpozpublic/xpoz-agent-skills · 16 stars · license MIT · pushed 2026-09-09 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_5jexe63xxyyxbolh GET https://markdownregistry.com/api/v1/resolve?ref=xpozpublic/xpoz-agent-skills/xpoz-best-practices GET https://markdownregistry.com/api/v1/blob/034e197e8c66e8489d3200cade932eeacd11192278e52d56ea064793c583655e
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.