Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -127,6 +127,18 @@ Bring an idea or an existing public Uniswap v4 project. The portable
[Programmable v4 Builder skill](skills/programmable-v4-hook-builder/SKILL.md) helps a compatible coding agent build
and repair the project, bind one exact revision and prepare a small public application pull request.

Install it interactively with one command:

```bash
gh skill install 0xprogrammable/programmable
```

To preselect the Builder while keeping the agent setup interactive:

```bash
gh skill install 0xprogrammable/programmable programmable-v4-hook-builder
```

The complete project stays in the builder-controlled public GitHub repository. `package` validates its local review
package. `prepare-pr` then resolves the clean pushed revision and generates exactly six central files under
[`submissions/`](submissions/), binding the immutable GitHub numeric repository id, full commit, full tree and evidence
Expand Down
17 changes: 16 additions & 1 deletion docs/builder/AGENT_SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,14 +51,29 @@ Ethereum Mainnet-only. Base, Unichain, Sepolia and unknown EVM chains remain rev
or release gates and no launch claim. Exact official deployment references preserve their runtime-unverified trust tier;
they are not silently promoted to Programmable-tested deployments.

## Install the exact revision you reviewed
## Install the Builder

The canonical package is
[`skills/programmable-v4-hook-builder`](../../skills/programmable-v4-hook-builder/SKILL.md). It uses the common Agent
Skills layout and keeps portable frontmatter to `name`, `description` and the SPDX license identifier. The complete
license text remains in `LICENSE.txt`. Host-specific UI metadata is optional and does not control the skill's security
policy.

For an interactive install, use the repository-only command:

```bash
gh skill install 0xprogrammable/programmable
```

To preselect the Builder while keeping the agent setup interactive:

```bash
gh skill install 0xprogrammable/programmable programmable-v4-hook-builder
```

Without a version argument, `gh skill` selects the latest tagged release. For reproducible review work, preview and
install the exact protected revision below.

First preview the protected Builder release tag:

```bash
Expand Down
27 changes: 22 additions & 5 deletions skills/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,14 +23,31 @@ candidate.

Read the [builder guide](../docs/builder/AGENT_SKILL.md) before using it on production code.

## Install the protected Builder release
## Quick install

Install interactively with one command:

```bash
gh skill install 0xprogrammable/programmable
```

To preselect the Builder while keeping the agent setup interactive:

```bash
gh skill install 0xprogrammable/programmable programmable-v4-hook-builder
```

Without a version argument, `gh skill` selects the repository's latest tagged release. Use the protected-release
instructions below only when a review or organization policy requires an exact version pin.

## Install an exact protected Builder release

Inspect the skill before installing it. The release tag below is protected against update and deletion. A full reviewed
commit SHA remains an equivalent pin when an organization requires commit-only policy.

```bash
gh skill preview 0xprogrammable/programmable \
programmable-v4-hook-builder@programmable-v4-builder-v0.1.0
programmable-v4-hook-builder@programmable-v4-builder-v0.1.1
```

Install the same revision for one supported host:
Expand All @@ -41,21 +58,21 @@ gh skill install 0xprogrammable/programmable \
skills/programmable-v4-hook-builder \
--agent codex \
--scope user \
--pin programmable-v4-builder-v0.1.0
--pin programmable-v4-builder-v0.1.1

# Claude Code
gh skill install 0xprogrammable/programmable \
skills/programmable-v4-hook-builder \
--agent claude-code \
--scope user \
--pin programmable-v4-builder-v0.1.0
--pin programmable-v4-builder-v0.1.1

# GitHub Copilot
gh skill install 0xprogrammable/programmable \
skills/programmable-v4-hook-builder \
--agent github-copilot \
--scope user \
--pin programmable-v4-builder-v0.1.0
--pin programmable-v4-builder-v0.1.1
```

The `gh skill` command chooses the host-specific destination. Its skill commands are currently a preview feature, and
Expand Down
Loading