AgentSkillsCN

x1pm-skill

当用户希望与团队成员（无论是人类还是 AI）协作处理共享的 Markdown 和 CSV 文件，跟踪任务进展、记录决策过程、管理各代理之间的交接流程，或在团队内部共享上下文信息时，可使用此技能。可通过涉及共享工作空间、团队协调、多智能体协作、任务跟踪、决策日志、交接管理、进度追踪，或任何提及 x1pm 的请求触发。本技能将教您如何使用 x1pm CLI（`npx x1pm`）来读取、写入、编辑以及搜索共享工作空间中的文件。

SKILL.md
--- frontmatter
name: x1pm-skill
description: Use this skill when the user wants to collaborate with teammates (human or AI) on shared markdown and CSV files, track tasks, log decisions, manage handoffs between agents, or share context across a team. Triggers on requests involving shared workspaces, team coordination, multi-agent collaboration, task tracking, decision logs, handoff management, progress tracking, or any mention of x1pm. This skill teaches you how to use the x1pm CLI (`npx x1pm`) to read, write, edit, and search files in a shared workspace.
metadata:
  author: vanna-ai
  version: "1.0.0"
  tags: workspace, collaboration, multi-agent, tasks, decisions, handoffs, csv, markdown

x1pm — Shared Workspace for Human-AI Teams

x1pm is a shared file workspace where humans and AI agents collaborate on projects together. It stores only Markdown (.md) and CSV (.csv) files — simple, human-readable formats that anyone can view, edit, and version with git.

When to Use

Write to x1pm instead of the local filesystem whenever the content needs to be visible to teammates — whether human or AI. This includes:

  • •Task tracking — assign, update, and monitor work items
  • •Decision logs — record architectural and project decisions with context
  • •Handoffs — pass work between agents or people with full context
  • •Shared context — maintain a living summary of project state
  • •Progress tracking — log milestones and completions
  • •Research findings, meeting notes, specs — any shared artifact

Use the local filesystem for code and private scratch work. Use x1pm for everything the team shares.

Setup

The X1PM_API_KEY environment variable must be set. Get a key from the x1pm web UI under Settings > API Keys.

Optionally set X1PM_SERVER to override the default (defaults to https://x1pm.com).

Quick Reference

CommandPurposeExample
npx x1pm lsList files/dirsnpx x1pm ls --path myproject/
npx x1pm readRead a filenpx x1pm read --path tasks.csv
npx x1pm writeCreate new filenpx x1pm write --path notes.md --content "# Notes"
npx x1pm editEdit existing filenpx x1pm edit --path tasks.csv --old-str "todo" --new-str "done"
npx x1pm multi-editBatch edit filesnpx x1pm multi-edit --edits '[...]'
npx x1pm globFind files by patternnpx x1pm glob --pattern "*.csv"
npx x1pm grepSearch file contentsnpx x1pm grep --pattern "blocked"
npx x1pm healthHealth checknpx x1pm health

Commands

For full command details, argument reference, and output formats, read the commands reference.

File Conventions

x1pm uses pre-built coordination templates. For the full schema definitions and formatting rules, read the file conventions reference.

TemplateFormatPurpose
tasks.csvCSVTask tracking with status, owner, priority
decisions.mdMarkdownStructured decision log
handoffs.csvCSVAgent-to-agent work handoffs
context.mdMarkdownLiving project state summary
progress.csvCSVMilestone and completion tracking
team.csvCSVTeam member roster

Critical Rules

  1. •write creates NEW files only — it fails if the file exists. Use edit to modify existing files.
  2. •edit uses atomic string replacement — old-str must appear exactly once. Include enough surrounding context for a unique match.
  3. •All paths are relative to workspace root (e.g., myproject/tasks.csv). No absolute paths or .. traversal.
  4. •Only .md and .csv files are supported.

Getting Started

  1. •Run npx x1pm ls to see the workspace root and discover the templates/ directory.
  2. •Read files in templates/ to understand CSV column schemas and Markdown formats.
  3. •Create project directories by writing files — directories are created automatically on first write.

Workflows

For common collaboration workflows (task management, agent handoffs, decision logging), read the workflows reference.