Skip to main content

metergraph-skills

Installs the Metergraph agent skill into a project, so Codex, Claude Code or Cursor can load it. This is the Python equivalent of metergraph skill in the npm CLI (metergraph-cli).

This package does not sign in, connect a workspace, configure MCP or make any network request. For those, use the npm CLI: npx metergraph-cli@next. The Python SDK for instrumenting an application is a different package, metergraph.

Install the skill

pip install metergraph-skills
metergraph-skills install --client claude

Run it in the project directory, or pass --project DIR.

Option Values
--client codex, claude, cursor
--runtime local (default), cloud
--project Project directory. Default: the current directory.
--json Print one JSON line on stdout.

The skill is written to the client's project skill directory:

Client Path
Codex .agents/skills/metergraph/SKILL.md
Claude Code .claude/skills/metergraph/SKILL.md
Cursor .cursor/skills/metergraph/SKILL.md

An ownership receipt is written to .metergraph/skill-installations.json. It holds no secrets. No other file is touched. Restart the client afterwards; the skill is not discovered until the client loads it.

Use metergraph-skills update to replace an older revision installed by Metergraph. A skill file that Metergraph did not install, or that was edited after it was installed, is never replaced.

Same files as the npm CLI

metergraph-skills and metergraph skill write the same paths and the same receipt. A skill installed by one is recognised and updated by the other. The bundled SKILL.md is byte-identical to the one in the npm package and to https://www.metergraph.dev/SKILL.md for the same revision, and its SHA-256 is checked before anything is written.

To copy the file yourself, metergraph-skills path prints the directory that holds the bundled SKILL.md and manifest.json.

More Metergraph skills

The setup skill comes from metergraph/skills, the source for every Metergraph agent skill, at a pinned commit. That repository also has the model-swap skills: choose a workload, choose traces and models, define the eval, run the analysis, read the report and rerun. This package installs only the setup skill. For the others, use npx skills add metergraph/skills, npx --yes metergraph-cli@next skills install --client claude --runtime local, or the metergraph/skills plugin marketplace in Claude Code and Claude Desktop.

Exit codes

Code Outcome
0 ok
1 internal_error: the bundled skill failed its integrity check
2 invalid_input
6 unsupported: the client or runtime cannot load project skill files
8 conflict: an existing file was not replaced
9 filesystem_error

License

Apache-2.0. Source: https://github.com/metergraph/cli.

Metadata

Release files for metergraph-skills 0.1.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for metergraph-skills 0.1.4
File Size Uploaded
metergraph_skills-0.1.4.tar.gz 24.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for metergraph-skills 0.1.4
File Interpreter ABI Platform
metergraph_skills-0.1.4-py3-none-any.whl Python 3 none any Details

Total release size: 48.1 kB

Release files / metergraph_skills-0.1.4.tar.gz

Download URL metergraph_skills-0.1.4.tar.gz
Size 24.6 kB
Tags Source
SHA-256 checksum
How to use checksums
a8e746aff0808d422e12dea0c06af114003a4b68cad4b885ef1066e0454233e5
BLAKE2b-256 checksum
How to use checksums
97e54ebddc24be308d481e8c79a245e8bd453cc3a8e381f93a3f783da307819b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.

Transparency log

Release files / metergraph_skills-0.1.4-py3-none-any.whl

Download URL metergraph_skills-0.1.4-py3-none-any.whl
Size 23.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a14b88f86cf0e5df690f5f4342f8d63771341c706b7ef7706c069aacc7cb7fc4
BLAKE2b-256 checksum
How to use checksums
6a8e1b12cc1b93e58c45bd602154fdd3d0c74d6071cf679f34d241f1a85753c5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.4 This release

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page