Agent skill

Spec From Rippled

by XRPLF in XRPLF/XRPL-Standards

Update an XLS specification to match changes made in rippled.

MITAuto-check passed

Install Spec From Rippled

skills CLI
$ npx skills add XRPLF/XRPL-Standards --skill spec-from-rippled -a claude-code

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

GitHub CLI
$ gh skill install XRPLF/XRPL-Standards spec-from-rippled --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/XRPLF/XRPL-Standards.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/spec-from-rippled .claude/skills/spec-from-rippled && 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
spec-from-rippled
GitHub stars
288
Token cost
~764 tokens
SKILL.md length
359 words
Files
2 (incl. references)
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Update an XLS specification to match changes made in rippled.

  • Works in 7 steps: Get the diff → Identify the target spec → Map changed files to spec sections → …
  • Asked to sync a spec with a rippled PR
  • SKILL.md covers 1. Get the diff, 2. Identify the target spec, 3. Map changed files to spec… and 4. Read the spec, then propose…, plus 3 more sections
  • Calls git, gh and python

What it does

Spec From Rippled is an agent skill from XRPLF/XRPL-Standards. Update an XLS specification to match changes made in rippled. Use when asked to sync a spec with a rippled PR or commit, update an XLS from the implementation, reconcile a spec against rippled code, or check whether a spec still matches what was built.

Its SKILL.md is about 760 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/rippled-map.md`).

The repository describes itself as: XLS: XRP(L) community defined Suggestions, Proposals, RFCs / Standards / Drafts & discussions, to be added to the core protocol, used for platform & apps devemopment, etc. The licence is MIT.

When your agent uses it

  • Asked to sync a spec with a rippled PR
  • Update an XLS from the implementation
  • Reconcile a spec against rippled code
  • Check whether a spec still matches what was built

Example prompts

  • “/spec-from-rippled”

Requirements

  • Python 3

Workflow steps

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

  1. Get the diff
  2. Identify the target spec
  3. Map changed files to spec sections
  4. Read the spec, then propose edits
  5. Update the preamble
  6. Verify
  7. Report what did not map

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • gh
    • python

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

  • Network

    No URLs in SKILL.md. Its commands use git and gh, 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

Spec From Rippled loads about 764 tokens when it runs, and up to ~2.5k if it reads all its reference files. Until then it costs about 68 tokens; SKILL.md has 359 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~68
When it runs · the whole SKILL.md, loaded when a task matches
~764
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.5k

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 XRPLF/XRPL-Standards at commit ad935be, republished under its MIT licence (© XRPLF). 359 words, ~764 tokens.

Download SKILL.mdSave it as .claude/skills/spec-from-rippled/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
spec-from-rippled
description
Update an XLS specification to match changes made in rippled. Use when asked to sync a spec with a rippled PR or commit, update an XLS from the implementation, reconcile a spec against rippled code, or check whether a spec still matches what was built.

Update a spec from rippled changes

Reconcile an XLS-NNNN-slug/README.md in this repo against a change in rippled, and propose the minimal spec edits that make the two agree.

The implementation is the evidence. Every proposed edit cites a rippled path:line. Never describe behavior that is not in the code you read.

1. Get the diff

From a PR or commit URL (no checkout needed):

bash
gh pr diff XRPLF/rippled <number>
gh pr view XRPLF/rippled <number> --json title,body,files
# or, for a commit:
gh api repos/XRPLF/rippled/commits/<sha> --jq '.files[].filename'

From a local checkout (e.g. ~/Documents/rippled-all/develop):

bash
git -C <rippled> diff develop...<branch> --stat
git -C <rippled> diff develop...<branch>

Ask which one to use if the request is ambiguous. For a large diff, work from --stat first and read individual files as needed.

2. Identify the target spec

In order of preference: the XLS number in the PR title or body; the amendment name added to include/xrpl/protocol/detail/features.macro, matched against this repo; or ask. Do not guess between two candidate specs.

3. Map changed files to spec sections

Read references/rippled-map.md.

rippled's tree moves — transactors and invariants were recently relocated under src/libxrpl/tx/. Treat every path in that table as a hint and confirm it before relying on it:

bash
git -C <rippled> ls-files '*transactors*' | head
git -C <rippled> grep -n "TxName" -- include src | head -30

4. Read the spec, then propose edits

For each mapped change:

  1. Read the current spec text for that section.
  2. Decide whether the spec is wrong, incomplete, or already correct. Say so for each — "already correct" is a useful result.
  3. Propose the smallest edit that fixes it, quoting the rippled path:line that justifies it.

Do not restructure sections the diff does not touch. Do not infer a failure condition, a default value, or an invariant that you did not read in the code.

Show full SKILL.md (107 more words)Show less

5. Update the preamble

  • Bump updated: to today's date.
  • Add or refresh implementation: if this PR is the reference implementation.
  • Do not change status: — an Amendment or System XLS reaching Final is a separate decision, and needs the rippled PR merged first.

6. Verify

Run the xls-template-conformity skill on the edited spec, or at minimum:

bash
python scripts/validate_xls_template.py XLS-NNNN-slug/README.md

7. Report what did not map

List every changed rippled file you could not tie to a spec section, with a one-line reason. Some are genuinely spec-invisible (refactors, build files, logging); others mean the spec is missing a section. That call belongs to the author, so surface it rather than deciding it.

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

Files

SKILL.md and 1 other file (references) in .agents/skills/spec-from-rippled of XRPLF/XRPL-Standards.

  • SKILL.md
  • references/rippled-map.md

Open the folder on GitHubat commit ad935be

Compare with similar skills

Spec From Rippled 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.

Spec From Rippled compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Spec From Rippled this skillXRPLF/XRPL-Standards288—~764Automated safety check: PassMIT
Peer ReviewK-Dense-AI/claude-scientific-writer2.4k2 repos~3.1kAutomated safety check: NotesMIT
Academic HumanizerAIScientists-Dev/academic-humanizer1.9k1 repos~4.2kAutomated safety check: PassMIT
Doc Coauthoringaws-samples/sample-strands-agent-with-agentcore19541 repos~3.2kAutomated safety check: PassMIT
Audit Onboarding Proposalhoangnb24/repository-harness1.2k—~4kAutomated safety check: PassMIT
Longbridge Researchhelsome/folio2703 repos~2.1kAutomated safety check: PassMIT

Similar skills

  • Peer Review

    K-Dense-AI/claude-scientific-writer

    Prepare evidence-bounded, constructive peer-review drafts and structured manuscript assessments.

    2.4k GitHub starsUsed in 2 repos~3.1k tokens
    Research & ScienceAuto-check: notes
  • Academic Humanizer

    AIScientists-Dev/academic-humanizer

    Improve the clarity and voice of AI-assisted academic writing (papers, theses, rebuttals) and funding proposals (NSF Project Summary/Description, NIH Specific Aims): preserve scholarly conventions…

    1.9k GitHub starsUsed in 1 repo~4.2k tokens
    Research & ScienceAuto-check passed
  • Doc Coauthoring

    aws-samples/sample-strands-agent-with-agentcore

    Official

    Guide users through a structured workflow for co-authoring documentation.

    195 GitHub starsUsed in 41 repos~3.2k tokens
    Sales & SupportAuto-check passed
  • Audit Onboarding Proposal

    hoangnb24/repository-harness

    Use only when the user explicitly invokes $audit-onboarding-proposal.

    1.2k GitHub stars~4k tokensUpdated 5 days ago
    Sales & SupportAuto-check passed
  • Longbridge Research

    helsome/folio

    Institution ratings, consensus price targets, EPS/revenue forecasts, finance calendar, shareholder data, fund holders, insider trades (SEC Form 4), short interest, industry rankings, peer group…

    270 GitHub starsUsed in 3 repos~2.1k tokens
    Business, Finance & HRAuto-check passed
  • No Negative Echo

    LB623/no-negative-echo

    Prevent 此地无银三百两式 residue: finalize artifacts without echoing rejected session-only alternatives into labels, metadata, commits, PRs, or handoffs.

    897 GitHub stars~965 tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed

More from XRPLF/XRPL-Standards

  • Xls Template Conformity

    XRPLF/XRPL-Standards

    Check that an XLS specification conforms to the XRPL-Standards templates.

    288 GitHub stars~859 tokensUpdated yesterday
    Auto-check passed
  • Code Review

    XRPLF/XRPL-Standards

    Review a pull request in XRPL-Standards. An agent skill from XRPLF/XRPL-Standards.

    288 GitHub stars~825 tokensUpdated yesterday
    Auto-check passed

Questions about Spec From Rippled

What does Spec From Rippled do?

Update an XLS specification to match changes made in rippled. Spec From Rippled is an agent skill from XRPLF/XRPL-Standards. Update an XLS specification to match changes made in rippled.

When should I use Spec From Rippled?

Spec From Rippled fits situations like: asked to sync a spec with a rippled PR; update an XLS from the implementation; reconcile a spec against rippled code; check whether a spec still matches what was built.

How do I install Spec From Rippled in Claude Code?

Run `npx skills add XRPLF/XRPL-Standards --skill spec-from-rippled -a claude-code`. Or copy the skill folder (.agents/skills/spec-from-rippled in XRPLF/XRPL-Standards) into .claude/skills/spec-from-rippled in your project. Claude Code loads it when a task matches its description.

How do I install Spec From Rippled in Codex?

Run `npx skills add XRPLF/XRPL-Standards --skill spec-from-rippled -a codex`. Or copy the skill folder (.agents/skills/spec-from-rippled in XRPLF/XRPL-Standards) into .agents/skills/spec-from-rippled in your project. Codex loads it when a task matches its description.

Can I use Spec From Rippled 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 XRPLF/XRPL-Standards --skill spec-from-rippled -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/spec-from-rippled, .gemini/skills/spec-from-rippled, .github/skills/spec-from-rippled and .opencode/skills/spec-from-rippled in your project.

What does Spec From Rippled need to run?

Going by SKILL.md and its folder, Spec From Rippled needs the command-line tools its instructions call (git, gh and python). Our summary lists: Python 3.

Does Spec From Rippled access the network?

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

Is Spec From Rippled 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 Spec From Rippled use?

Spec From Rippled 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 Spec From Rippled use?

About 764 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.8k tokens, read only when the agent opens those files.

What are the alternatives to Spec From Rippled?

Skills that share tags, products or a category with Spec From Rippled: Peer Review (K-Dense-AI/claude-scientific-writer, 2.4k stars), Academic Humanizer (AIScientists-Dev/academic-humanizer, 1.9k stars), Doc Coauthoring (aws-samples/sample-strands-agent-with-agentcore, 195 stars) and Audit Onboarding Proposal (hoangnb24/repository-harness, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Spec From Rippled?

XRPLF (a GitHub organization) maintains it in XRPLF/XRPL-Standards, which has 288 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 8, 2026.

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