agentleFS
tradingstrategy-aitradingstrategy-ai/web3-ethereum-defi/.claude/skills/monthly-vault-report/SKILL.md

monthly-vault-report

Skill834 starsChanged 3 days agoMITView on GitHub

Generate or update the monthly "The best-performing stablecoin vaults" blog post as an unpublished Ghost draft, following the report's writing rules

  • Reads credentials

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 4 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Read these before changing anything or running the report:

    line 15
  2. Distinctive:

    When the editor gives a new rule, change the generator, then add the rule to the *Writing rules* and, if it affects the workflow, to this …

    line 26
  3. Very specific:

    When the investability check must run again, which takes minutes, run it with GHOST_DRAFT=false first, then check the draft and upload with …

    line 68
  4. Distinctive:

    After the run, read the draft back through the Admin API and check the headings, image and table counts, the empty feature image, and that …

    line 77
  5. Distinctive:

    Commit it with the report's pull request and post it as a PR comment:

    line 92

≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Monthly vault report

This skill produces the monthly The best-performing stablecoin vaults post: an unpublished Ghost draft that the editor finishes and publishes. Use it whenever you generate the report, change its post templates, or update its draft.

1. Read the rules first

Read these before changing anything or running the report:

  • the Writing rules in eth_defi/vault_report/README-blog-post-outline.md: the section order, headings, introductions, statistics wording, section notes, charts and publishing rules the editor has already decided. Follow them without being asked, and ask before breaking one;
  • eth_defi/vault_report/README-best-vaults-news.md: the Ghost draft and PR comment workflows;
  • eth_defi/vault_report/README-vault-report.md: environment variables, the investability check and the editor workflow.

When the editor gives a new rule, change the generator, then add the rule to the Writing rules and, if it affects the workflow, to this skill.

2. Run the report

The run needs GHOST_ADMIN_API_KEY (an Admin API key, not the read-only Content API key) in the secrets file sourced by .local-test.env. Never print it. It also needs the private production R2 configuration from README-vault-report.md: the script refreshes both input files before generation, reuses downloads younger than one day, and aborts on a failed refresh. Use both TOP_VAULTS_JSON and VAULT_PRICES_PARQUET together only for an explicit local-data run, which bypasses this freshness check.

source .local-test.env && \
    OUTPUT_DIR=/tmp/vault-report \
    VAULT_CHECK_AGENT=claude \
    poetry run python scripts/erc-4626/generate-monthly-vault-report.py
  • The investability check runs the Claude CLI on Sonnet with medium effort to limit the token spend. To iterate on the text or charts, reuse its decisions with VAULT_CHECK_AGENT=reuse VAULT_CHECK_DECISIONS=<previous bundle> while the downloads are younger than one day and flag.py is unchanged.
  • The agent may add blacklist or review_needed entries to eth_defi/vault/flag.py. Never commit them without the user's review.
  • For template work without Ghost, set GHOST_DRAFT=false and open preview.html in the bundle.

3. Update the draft in place

The script refuses to replace an existing draft unless GHOST_OVERWRITE_DRAFT=true, and then only when the draft is as the pipeline last wrote it. It keeps a record of each write in {CACHE_DIR}/ghost-drafts/{slug}.json and compares the draft's updated_at, text fingerprint, title, excerpt and feature image with it. Opening a draft in the Ghost editor re-saves it, which the comparison allows. If the script refuses because the draft was edited, stop and ask the user. Use GHOST_OVERWRITE_DRAFT=force, which skips the comparison, only when there is no record yet and you have compared the draft yourself, or the user asks for it. Never publish.

When the investability check must run again, which takes minutes, run it with GHOST_DRAFT=false first, then check the draft and upload with VAULT_CHECK_AGENT=reuse, so the draft cannot change unseen during the run.

To change the month of a waiting draft, set GHOST_DRAFT_SLUG to the old slug and GHOST_OVERWRITE_DRAFT=true. The script updates and renames that same post, with the existing edit protection, then saves a record for the new slug. Unset the old slug override after the rename.

After the run, read the draft back through the Admin API and check the headings, image and table counts, the empty feature image, and that no excluded vault appears in the post. The Ghost site is private, so the draft can be viewed only in the Ghost editor.

The template includes the dataset subscription link after the statistics, the podcast audience description and the shorter tokenised-fund definition in the writing rules. Community news has two empty h3 subsections, News item 1 and News item 2, for the editor to rename and fill, or remove if unused, before publishing. Leave their bodies empty; do not copy the previous month's news or add editor callouts.

4. Excluded vaults

The run writes eth_defi/vault_report/excluded-vaults/{date}-excluded-vaults.md. Commit it with the report's pull request and post it as a PR comment:

gh pr comment <pr> --body-file eth_defi/vault_report/excluded-vaults/<date>-excluded-vaults.md

5. Report back

Give the user the Ghost editor link the script prints, the excluded and undecided vault counts, any flag.py changes awaiting review, and anything you could not verify.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.