Agent skill

Wire Shared Package

by flonat in flonat/flonat-research

Add or repair an editable shared Python-package dependency across consuming projects, including clone-local configuration and verification.

MITAuto-check passedAgent Workflows

Install Wire Shared Package

skills CLI
$ npx skills add flonat/flonat-research --skill wire-shared-package -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install flonat/flonat-research wire-shared-package --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/flonat/flonat-research.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/wire-shared-package .claude/skills/wire-shared-package && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
wire-shared-package
GitHub stars
145
Token cost
~1.7k tokens
SKILL.md length
590 words
Files
1
Skills in repo
83
Repo updated
First seen
Licence
MIT

At a glance

Add or repair an editable shared Python-package dependency across consuming projects, including clone-local configuration and verification.

  • Works in 5 steps: Discover → Wire Tier 1 Projects → Document Tier 2 Projects → …
  • Multiple repositories must import the same local package source
  • SKILL.md covers When to Use, Phase 1: Discover, Phase 2: Wire Tier 1 Projects and Phase 3: Document Tier 2…, plus 5 more sections
  • Calls uv

What it does

Wire Shared Package is an agent skill from flonat/flonat-research. Add or repair an editable shared Python-package dependency across consuming projects, including clone-local configuration and verification. Use when multiple repositories must import the same local package source. Not for one project's ordinary environment setup; use $python-env.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows. It works with Python. The repository describes itself as: Shareable Claude Code + Codex infrastructure for PhD researchers — skills, agents, hooks, and rules for academic workflows. The licence is MIT.

When your agent uses it

  • Multiple repositories must import the same local package source

Example prompts

  • “/wire-shared-package”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Glob, Grep, Bash(uv*), Bash(ls*), Bash(mkdir*), AskUserQuestion

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Discover
  2. Wire Tier 1 Projects
  3. Document Tier 2 Projects
  4. Track in Atlas
  5. Update Shared Package Documentation

What it can do on your machine

Read from SKILL.md and the folder at commit da27600. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Glob
    • Grep
    • Bash(uv*)
    • Bash(ls*)
    • Bash(mkdir*)
    • AskUserQuestion

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Wire Shared Package loads about 1.7k tokens when it runs. Until then it costs about 75 tokens; SKILL.md has 590 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~75
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from flonat/flonat-research at commit da27600, republished under its MIT licence (© flonat). 590 words, ~1,711 tokens.

Download SKILL.mdSave it as .claude/skills/wire-shared-package/SKILL.md (or your agent's skills folder).
name
wire-shared-package
description
Add or repair an editable shared Python-package dependency across consuming projects, including clone-local configuration and verification. Use when multiple repositories must import the same local package source. Not for one project's ordinary environment setup; use $python-env.
allowed-tools
Read, Write, Edit, Glob, Grep, Bash(uv*), Bash(ls*), Bash(mkdir*), AskUserQuestion
argument-hint
<package-path> [--downstream project1,project2,...] [--tier 1|2]

Wire Shared Package

Wire a shared Python package as an editable local dependency across multiple research projects. Handles pyproject.toml creation, CLAUDE.md documentation, and Atlas infrastructure tracking.

When to Use

  • A shared package exists and needs to be wired into downstream projects
  • "Add collusion-sim as a dependency to these projects"
  • "Wire up the shared package"
  • "Set up cross-project dependency"
  • After creating a shared package with computational-experiments scaffold mode

Phase 1: Discover

  1. Identify the shared package:

    • Read its pyproject.toml to get name, version, and what it provides
    • Read its CLAUDE.md or README.md for module inventory
    • Confirm it installs cleanly: uv pip install -e ".[dev]"
  2. Identify downstream projects:

    • If not specified, ask which projects should depend on this package
    • For each project, classify the dependency tier:
TierMeaningAction
1 — DirectUses the package's core modules in active codeFull wiring: pyproject.toml + CLAUDE.md + Atlas
2 — PartialWill use specific modules when code work beginsCLAUDE.md note + Atlas only (no pyproject.toml yet)
3 — Pattern onlyBorrows design patterns, no code dependencyAtlas note only
  1. Check prerequisites for each downstream project:
    • Does it have a pyproject.toml? (Tier 1 projects need one)
    • Does it have a CLAUDE.md? (all tiers need one)
    • Does it have an Atlas topic file? (locate via project_path in frontmatter)

Phase 2: Wire Tier 1 Projects

For each Tier 1 downstream project:

2a. Create or update pyproject.toml

If no pyproject.toml exists, create one:

toml
[project]
name = "{project-kebab-name}"
version = "0.1.0"
description = "{one-line from CLAUDE.md}"
requires-python = ">=3.11"
dependencies = [
    "{shared-package-name}",
]

[project.optional-dependencies]
dev = [
    "pytest>=8.0",
    "ruff>=0.3",
]

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[tool.hatch.build.targets.wheel]
packages = ["src/{project_underscored_name}"]

[tool.ruff]
line-length = 99
target-version = "py311"

[tool.uv.sources]
{shared-package-name} = { path = "{relative-path-to-package}", editable = true }

If pyproject.toml already exists, add the dependency to [project] dependencies and add the [tool.uv.sources] entry.

Key: The [tool.uv.sources] section tells uv to resolve the package from a local path instead of PyPI. The relative path must be correct from the downstream project to the shared package (typically ../package-name).

2b. Update CLAUDE.md

Add a "Shared Package Dependency" section under ## Setup:

markdown
### Shared Package Dependency
- **`{package-name}`** installed as editable dependency from `{relative-path}/`
- Provides: {list key modules this project uses}
- Install: `uv pip install -e ".[dev]"` (resolves {package-name} via `[tool.uv.sources]`)
- Project-specific code goes in `src/{project_name}/` — shared simulation code stays in {package-name}
2c. Verify install
bash
cd "{project-path}" && uv pip install -e ".[dev]"

Then verify imports:

bash
uv run python -c "from {package_module} import {key_class}; print('OK')"

Phase 3: Document Tier 2 Projects

For each Tier 2 downstream project, add to CLAUDE.md under ## Setup:

markdown
### Shared Package Dependency (Tier 2)
- **`{package-name}`** at `{relative-path}/` — provides {what this project will use}
- When code work begins, add `{package-name}` as editable dependency via `[tool.uv.sources]` in `pyproject.toml`
- This project will extend the framework with {project-specific extensions}

No pyproject.toml changes — the dependency is documented but not yet wired.

Phase 4: Track in Atlas

For each downstream project that has an Atlas topic file, add a ## Shared Infrastructure section between the Description and Key References sections:

markdown
## Shared Infrastructure

- **`{package-name}`** (Tier {N} — {direct reuse|partial reuse|pattern only}): {what components are used}
- Location: `{theme}/{package-dir}/`
{if Tier 1:}
- Install: editable dependency via `pyproject.toml` `[tool.uv.sources]`

Placement: After ## Description (or ## Portfolio Bridge if present), before ## Key References.

Finding the right topic file: Search Atlas by project_path frontmatter field:

bash
grep -rl "project_path.*{project-folder}" ~/vault/atlas/
Show full SKILL.md (215 more words)Show less

Phase 5: Update Shared Package Documentation

If the shared package has a CLAUDE.md or README.md, update its downstream project table to reflect all wired projects:

markdown
## Downstream Projects

| Project | Tier | Uses |
|---------|------|------|
| {Project Name} | {1/2/3} | {components used} |

Anti-Patterns

  • Never wire a dependency that doesn't install cleanly. Verify uv pip install -e . on the shared package first.
  • Never create pyproject.toml for Tier 2 projects. They don't have active code yet — premature wiring creates broken installs.
  • Never use absolute paths in [tool.uv.sources]. Always use relative paths from the downstream project.
  • Never skip the Atlas update. The whole point is cross-project tracking.
  • Never put the shared package's code in a downstream project. Shared code stays in the shared package; project-specific code goes in the project's own src/.

Verification

After completing all phases:

  1. All Tier 1 projects install without errors
  2. Key imports from the shared package work in each Tier 1 project
  3. Every downstream project's CLAUDE.md mentions the dependency
  4. Every downstream project's Atlas topic has a ## Shared Infrastructure section
  5. The shared package's documentation lists all downstream projects

Quick check: grep -rl "{package-name}" ~/vault/atlas/ should return all expected topic files.

Defaults

SettingDefaultOverride
Build backendhatchlingSpecify in args
Python version>=3.11Match shared package
Source layoutsrc/Match shared package
Relative path../package-nameAuto-detect from directory structure
Atlas section placementAfter Description, before Key References—

© flonat, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/wire-shared-package of flonat/flonat-research.

Open the folder on GitHubat commit da27600

Compare with similar skills

Wire Shared Package next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Wire Shared Package compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Wire Shared Package this skillflonat/flonat-research145—~1.7kAutomated safety check: PassMIT
MCP Server Builderanthropics/skills180k62 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k5 repos~1.2kAutomated safety check: PassMIT
Fastmcp Client CLIPrefectHQ/fastmcp28k1 repos~823Automated safety check: PassApache-2.0
Mem0 CLI Memory Commandsmem0ai/mem067k—~1.4kAutomated safety check: NotesApache-2.0
MemPalace Setup and OperationMemPalace/mempalace59k—~2.2kAutomated safety check: PassMIT

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 62 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • Fastmcp Client CLI

    PrefectHQ/fastmcp

    Query and invoke tools on MCP servers using fastmcp list and fastmcp call.

    28k GitHub starsUsed in 1 repo~823 tokens
    Agent WorkflowsAuto-check passed
  • Adds, searches, lists, updates and deletes memories on the Mem0 platform from the terminal with the mem0 command, including a JSON mode built for agents.

    67k GitHub stars~1.4k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes
  • Installs and configures MemPalace as a private local palace, a shared-brain hub or a client of an existing hub, including MCP registration and version-correct initialization.

    59k GitHub stars~2.2k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Google Antigravity SDK

    google-antigravity/antigravity-sdk-python

    Design, implement, and debug autonomous AI agents and multi-agent systems using the Google Antigravity (AGY) SDK.

    3.6k GitHub stars~2.1k tokensUpdated 10 days ago
    Agent WorkflowsAuto-check: notes

More from flonat/flonat-research

All 83 skills in this repo
  • Latex Posters

    flonat/flonat-research

    Create a large-format academic poster in LaTeX using beamerposter, tikzposter, or baposter.

    145 GitHub stars~1.5k tokensUpdated 8 days ago
    Auto-check: notes
  • Skill Creator

    flonat/flonat-research

    Create, revise, and evaluate reusable AI workflow skills, including trigger-quality tests.

    145 GitHub stars~4.4k tokensUpdated 8 days ago
    Auto-check passed
  • DOCX

    flonat/flonat-research

    Create, read, edit, or convert Microsoft Word documents while preserving professional document structure.

    145 GitHub stars~1.2k tokensUpdated 8 days ago
    Auto-check passed
  • PDF

    flonat/flonat-research

    Read, create, combine, split, rotate, OCR, watermark, secure, or extract content from PDF files.

    145 GitHub stars~488 tokensUpdated 8 days ago
    Auto-check passed
  • Init Project Orchestration

    flonat/flonat-research

    Create or migrate project-level agents, repeatable project workflows, and planning state from one client-neutral contract, then render repository-scoped adapters for both Claude Code and Codex.

    145 GitHub stars~1.6k tokensUpdated 8 days ago
    Auto-check passed
  • Pre Commit Audit

    flonat/flonat-research

    Deliver a fast pre-commit safety scan: file size, anonymity (author / affiliation strings in tex/bib), hardcoded secrets, and invisible-Unicode carriers.

    145 GitHub stars~2.8k tokensUpdated 8 days ago
    Auto-check: notes

Works with

Categories

Questions about Wire Shared Package

What does Wire Shared Package do?

Add or repair an editable shared Python-package dependency across consuming projects, including clone-local configuration and verification. Wire Shared Package is an agent skill from flonat/flonat-research. Add or repair an editable shared Python-package dependency across consuming projects, including clone-local configuration and verification.

When should I use Wire Shared Package?

Wire Shared Package fits situations like: multiple repositories must import the same local package source.

How do I install Wire Shared Package in Claude Code?

Run `npx skills add flonat/flonat-research --skill wire-shared-package -a claude-code`. Or copy the skill folder (skills/wire-shared-package in flonat/flonat-research) into .claude/skills/wire-shared-package in your project. Claude Code loads it when a task matches its description.

How do I install Wire Shared Package in Codex?

Run `npx skills add flonat/flonat-research --skill wire-shared-package -a codex`. Or copy the skill folder (skills/wire-shared-package in flonat/flonat-research) into .agents/skills/wire-shared-package in your project. Codex loads it when a task matches its description.

Can I use Wire Shared Package in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add flonat/flonat-research --skill wire-shared-package -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wire-shared-package, .gemini/skills/wire-shared-package, .github/skills/wire-shared-package and .opencode/skills/wire-shared-package in your project.

What does Wire Shared Package need to run?

Going by SKILL.md and its folder, Wire Shared Package needs the command-line tools its instructions call (uv). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Read, Write, Edit, Glob, Grep, Bash(uv*), Bash(ls*), Bash(mkdir*), AskUserQuestion.

Does Wire Shared Package access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Wire Shared Package safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Wire Shared Package use?

Wire Shared Package is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Wire Shared Package use?

About 1.7k tokens (SKILL.md is roughly 6.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Wire Shared Package?

Skills that share tags, products or a category with Wire Shared Package: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), Fastmcp Client CLI (PrefectHQ/fastmcp, 28k stars) and Mem0 CLI Memory Commands (mem0ai/mem0, 67k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wire Shared Package?

flonat (a GitHub user) maintains it in flonat/flonat-research, which has 145 GitHub stars. The repository holds 83 skills in this directory. The repository was last updated on September 29, 2026.

Source: flonat/flonat-research on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.