Graph Sync Agent Kit

Graph Sync Agent Kit

Installable agent skills and maintainer eval prompts for WordLift graph-sync projects.

This repository contains reusable agent workflows that were extracted from graph-sync project specs and day-to-day implementation practice. The same skills/ directory can be packaged for Claude Code, packaged for Codex, or installed directly as Codex skills.

Skill Inventory

• graph-sync-curator — day-to-day semantic curation; orchestrates the other skills end-to-end.
• graph-sync-project — technical project edits: mappings, templates, postprocessors, CLI, and validation.
• graph-sync-repo-lifecycle — repository setup, commit, and publish.
• graph-sync-yarrrml-review — focused YARRRML/RML mapping review.
• graph-sync-postprocessor-authoring — postprocessor authoring and debugging.
• graph-sync-github-workflow-review — GitHub Actions workflow review.

Each skill's SKILL.md is the authoritative reference for its capabilities.

Repository Layout

.codex-plugin/
  plugin.json

.claude-plugin/
  plugin.json

scripts/
  sync_versions.py
  validate_agent_kit.py

skills/
  graph-sync-curator/
  graph-sync-project/
  graph-sync-repo-lifecycle/
  graph-sync-yarrrml-review/
  graph-sync-postprocessor-authoring/
  graph-sync-github-workflow-review/

evals/
  prompts/

pyproject.toml

The skills/ folders are the installable runtime units. The evals/prompts/ files are maintainer fixtures for forward-testing skills and should not be installed as skills.

Installation

Use the repository from:

[email protected]:wordlift/graph-sync-agent-kit.git

Claude Code Plugin

Install through the WordLift agent marketplace:

claude plugin marketplace add wordlift/agent-marketplace
claude plugin install graph-sync-agent-kit@wordlift

Update an installed plugin after a new marketplace release:

claude plugin update graph-sync-agent-kit@wordlift

For local development, clone the repository and load it directly:

git clone [email protected]:wordlift/graph-sync-agent-kit.git
claude --plugin-dir ./graph-sync-agent-kit

When installed as a Claude Code plugin, invoke skills with the plugin namespace:

/graph-sync-agent-kit:graph-sync-curator start the graph-sync workflow for www.example.org

Codex Plugin

Install through the WordLift agent marketplace:

codex plugin marketplace add wordlift/agent-marketplace --ref main
codex plugin add graph-sync-agent-kit@wordlift

Update an installed plugin after a new marketplace release:

codex plugin marketplace upgrade wordlift
codex plugin add graph-sync-agent-kit@wordlift

The marketplace points Codex at this repository as the Git-backed plugin source. Start a new Codex thread after installing or updating the plugin so the skills are loaded.

Codex Skill Install

Ask Codex to install every skill in this repository:

Use $skill-installer to install all skills under skills/ from wordlift/graph-sync-agent-kit.

Install all skills in this kit. They are designed to work together: graph-sync-curator orchestrates the workflow, while the other skills provide project, lifecycle, mapping, postprocessor, and GitHub workflow support.

Restart Codex after installing skills.

Manual Codex Install

Clone the repository and copy all skill folders into Codex's skills directory:

git clone [email protected]:wordlift/graph-sync-agent-kit.git
cd graph-sync-agent-kit
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R skills/graph-sync-* "${CODEX_HOME:-$HOME/.codex}/skills/"

Restart Codex after copying skills.

Usage

The prompts below are intentionally concrete. Replace example.org, repository URLs, profiles, and cluster names with the project you are working on. Claude Code plugin skills use /graph-sync-agent-kit:<skill>. Codex skills use $<skill>.