agentleFS
ahmetenesdurahmetenesdur/starkfi/skills/config/SKILL.md

config

Skill2 starsChanged 8 months agoMITView on GitHub

View and modify StarkFi CLI configuration — set custom RPC URLs, switch networks, manage gas settings, and check transaction status. Use this skill when the user mentions RPC, rate limits, network settings, gas mode, gas token, configuration, settings, preferences, or wants to check a transaction hash. Also trigger when the user wants to customize their setup, troubleshoot connection issues, fix errors, switch between mainnet and testnet, change how gas is paid, enable free gas, "gas fees too high", "not working", verify whether a transaction succeeded, or check tx status — even if they don't say "config".

24 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use uninstall and resume.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • AnthropicSkill

    uninstall

    Uninstall a community skill that was installed via the hub. Confirms before deleting files, refuses to touch first-party plugin skills, and logs every action. Use when the user wants to fully remove a community skill ("uninstall [skill]", "remove this skill") rather than just disable it.

    Also in 3 projects that use this

  • genomewalkerSkill

    resume

    Resume a thread by loading its ~800-token context capsule

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

5 rules. 0 are common, 0 are distinctive, and 5 are very specific to this project.

  • 0

    Common

    Most of the 19 edited versions we read keep these.

  • 0

    Distinctive

    This author's own choices. Worth a look.

  • 5

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Rate Limits: If any skill fails with "rate limit" or "429" errors, use config set-rpc to set a custom RPC endpoint.

    line 82
  2. Very specific:

    Use tx-status AFTER every send, trade, multi-swap, batch, dca-create, dca-cancel, conf-fund, conf-transfer, conf-withdraw, and …

    line 85
  3. Very specific:

    Use config get-rpc to check the current RPC URL before changing it.

    line 86
  4. Very specific:

    Use config set-gasfree on for developer-sponsored gas.

    line 154
  5. Very specific:

    Use tx-status to verify transactions from any transactional skill.

    line 155

“Common” is measured: kept by at least 6 in 10 of the 19 edited versions of this file we could read. “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

Configuration & Utilities

Manage local configuration for the StarkFi CLI and check transaction status on-chain. Configuration includes RPC endpoints, network selection, and gas payment settings.

Prerequisites

  • None for configuration commands (config list, config set-*, config get-rpc).
  • Active session required for tx-status and for config list to show the effective network source.

Configuration Commands

# List all current settings
npx starkfi@latest config list

# Reset all settings to defaults
npx starkfi@latest config reset

# Set custom RPC URL
npx starkfi@latest config set-rpc <url>

# Get current RPC URL
npx starkfi@latest config get-rpc

# Switch network (takes effect immediately, no re-login needed)
npx starkfi@latest config set-network <network>

# Toggle developer-sponsored gas (Gasfree mode)
npx starkfi@latest config set-gasfree <on|off>

# Set gas payment token (for Gasless mode)
npx starkfi@latest config set-gas-token <token>

Transaction Status

npx starkfi@latest tx-status <hash>

Gas Modes

StarkFi supports two gas abstraction modes:

ModeWho PaysCommandDescription
GasfreeDeveloperconfig set-gasfree onGas fees sponsored by StarkFi via Paymaster
GaslessUser (ERC-20)config set-gas-token STRKUser pays gas in an ERC-20 token (default mode)

Supported gas tokens: ETH, STRK, USDC, USDT, DAI

Gasfree and Gasless are mutually exclusive — enabling one disables the other.

Default: Gasless mode with STRK as gas token. Gas is paid through the Paymaster, so the user does not need native ETH for gas — any supported ERC-20 works.

Parameters

ParameterTypeDescriptionRequired
urlstringFull HTTP(S) RPC endpoint URLYes
networkstringmainnet or sepoliaYes
on/offstringEnable or disable Gasfree modeYes
tokenstringGas token symbol or reset (reverts to STRK)Yes
hashstringTransaction hash (0x...)Yes

Rules

  1. Rate Limits: If any skill fails with "rate limit" or "429" errors, use config set-rpc to set a custom RPC endpoint.
  2. Persistence: Settings are stored locally and persist across sessions.
  3. Network switching: set-network takes effect instantly for all commands — no re-login required. The config setting overrides the session's login network. config list shows the effective network with its source (e.g. sepolia (config override, session: mainnet)).
  4. Use tx-status AFTER every send, trade, multi-swap, batch, dca-create, dca-cancel, conf-fund, conf-transfer, conf-withdraw, and staking/lending transaction to verify success.
  5. Use config get-rpc to check the current RPC URL before changing it.

Examples

User: "I'm getting rate limit errors"

npx starkfi@latest config get-rpc
npx starkfi@latest config set-rpc https://starknet-mainnet.g.alchemy.com/v2/<key>

User: "Show my current configuration"

npx starkfi@latest config list

User: "Switch to testnet"

npx starkfi@latest config set-network sepolia
npx starkfi@latest config list    # Verify: shows "sepolia (config override, session: mainnet)"

User: "Enable free gas mode"

npx starkfi@latest config set-gasfree on

User: "I want to pay gas in USDC"

npx starkfi@latest config set-gasfree off
npx starkfi@latest config set-gas-token USDC

User: "Reset gas token to default"

npx starkfi@latest config set-gas-token reset

User: "Reset all my settings"

npx starkfi@latest config reset

User: "Did my transaction go through? Hash is 0xabc..."

npx starkfi@latest tx-status 0xabc...

Error Handling

ErrorAction
Invalid RPC URLEnsure URL starts with http:// or https://.
Invalid networkUse mainnet or sepolia.
Unsupported gas tokenMust be one of: ETH, STRK, USDC, USDT, DAI.
Transaction not foundVerify the hash is correct and the network matches.
PendingTransaction is still in mempool — wait and retry.

Related Skills

  • This skill is referenced by all other skills for rate limit recovery.
  • Use config set-gasfree on for developer-sponsored gas.
  • Use tx-status to verify transactions from any transactional skill.

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.