Agent skill

Senpi Account Status

by Senpi-ai in Senpi-ai/senpi-skills

Reports a user's Senpi points, rank, loyalty tier, fees and referral earnings from one real-time script, and explains the AI-credit usage meter without ever reading its balance.

Apache-2.0Auto-check passedBusiness, Finance & HR

Install Senpi Account Status

skills CLI
$ npx skills add Senpi-ai/senpi-skills --skill senpi-account-status -a claude-code

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

GitHub CLI
$ gh skill install Senpi-ai/senpi-skills senpi-account-status --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/Senpi-ai/senpi-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/senpi-account-status .claude/skills/senpi-account-status && 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
senpi-account-status
GitHub stars
134
Token cost
~3k tokens
SKILL.md length
1,660 words
Files
7 (incl. scripts, references)
Skills in repo
5
Repo updated
First seen
Licence
Apache-2.0

At a glance

Reports a user's Senpi points, rank, loyalty tier, fees and referral earnings from one real-time script, and explains the AI-credit usage meter without ever reading its balance.

  • Works in 3 steps: Points & rank — total, base/perp split,… → Loyalty — current tier + fee/discount,… → Referral — pending balance_usdc (and…
  • Checking a user's current Senpi points, rank or loyalty tier
  • SKILL.md covers Golden rules, How to run the engine, Output contract and Mandatory closing (verbatim), plus 5 more sections
  • Runs Python scripts from its folder; calls python3; needs SENPI_AUTH_TOKEN

What it does

A single script gathers points, loyalty and referral standing together in one call rather than separate tools, and its JSON is always re-run rather than quoted from earlier, since points and fees move. The response groups points into a total, a base and perp split and a multiplier with rank; loyalty into the tier, the fee in basis points, the discount, the next tier and points needed, plus any demotion; and referral into the pending balance from referred trades. The script fails open, so partial data still returns valid JSON, with warnings narrated honestly rather than hidden.

Credits work differently: no tool returns the actual AI-credit balance, since the meter shown in the app's header is itself the balance, so the skill only explains the rules around it rather than reading a number. The published plan catalog and the milestone ladder for earning free credits can be quoted directly from the skill's own reference material, but any figure about what this particular user has left, was charged, or where their bar sits has to come from their own page, never invented. Answers lead with whatever the user asked about, add the relevant next milestone, and close with a call to action, except that a credits question closes by pointing at the meter instead.

When your agent uses it

  • Checking a user's current Senpi points, rank or loyalty tier
  • Explaining why a loyalty tier changed or what the next tier requires
  • Checking referral earnings from referred trades
  • Explaining what the AI-credit meter in the header means

Example prompts

  • “How many points do I have and what's my rank?”
  • “Why did my loyalty tier drop, and how do I get it back?”
  • “What is this credits bubble in the header and why is it going down?”

Requirements

  • A USER-scoped Senpi token
  • Python, to run the bundled status script

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Points & rank — total, base/perp split, multiplier, rank (+ change).
  2. Loyalty — current tier + fee/discount, and points_to_next → next_tier (the actionable
  3. Referral — pending balance_usdc (and that it's claimable if > 0).

What it can do on your machine

Read from SKILL.md and the folder at commit 4f0a537. 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

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • SENPI_AUTH_TOKEN

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

Context cost

Senpi Account Status loads about 3k tokens when it runs, and up to ~3.4k if it reads all its reference files. Until then it costs about 246 tokens; SKILL.md has 1,660 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from Senpi-ai/senpi-skills at commit 4f0a537, republished under its Apache-2.0 licence (© Senpi-ai). 1,660 words, ~2,997 tokens.

Download SKILL.mdSave it as .claude/skills/senpi-account-status/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
senpi-account-status
description
Show the user's standing across Senpi programs — points and rank, loyalty tier and fees, referral earnings — and explain the AI-credits usage meter. Use for "how many points do I have?", "what's my rank/tier?", "what are my fees?", "my referral rewards", and for credits: "what is the bubble/meter in the header?", "why are my credits going down?", "how much did that cost?", "does my strategy use credits?", "can I trade or withdraw my credits?", and for plans: "what plans are there?", "how much does Senpi cost?", "what do I get on Pro/Quant?", "how do I get free credits?", "where are my milestone credits?". Use this instead of calling user_get_senpi_points + get_loyalty_tiers one by one. A hidden engine (scripts/status.py) pulls points/loyalty/referral in one call; the credit BALANCE is explained, never read — no tool returns it — while the plan catalog and the free-credit ladder are published here and may be quoted. Requires a USER-scoped Senpi token.
license
Apache-2.0
metadata.author
Senpi
metadata.version
1.4.0
metadata.platform
senpi
metadata.exchange
hyperliquid

Senpi Account Status — your standing across Senpi

A hidden engine pulls the user's standing in one real-time call; your job is to present it cleanly and point at the next milestone (next loyalty tier, etc.).

Golden rules

  • Run the engine; never hand-pull. python3 scripts/status.py gathers points, loyalty, and referral together. Read its JSON.
  • Real-time, not from memory. Points/rank move — never quote a figure from earlier in the conversation; re-run.
  • Fees come from the data, never from memory. Quote loyalty.fee_bps / fee_discount_pct as returned — the tier table changes; stale numbers mislead. (For the full tier table, that's get_loyalty_tiers; this skill returns the user's own tier.)
  • Lead with what they asked, then the milestone. If they asked about points, lead with points + rank, then "X to the next tier." Don't dump every section if they asked one question — but the engine returns all of it so you can.
  • Credits are explained, never read. No tool returns the AI-credit balance; the meter in the app header is the balance. Rules in "AI credits — the usage meter" below.
  • Plans and free credits are published; the balance is not. Quote the catalog and the milestone ladder in "Plans & free credits" below — and only from there. A figure about this user (what is left, what they were charged, where their bar sits) comes from their page, never from you.
  • Always end with the CTA (below) — for standing answers; a credits answer closes on the meter.

How to run the engine

python3 scripts/status.py

Returns {identity, points, loyalty, referral, meta}:

  • points — total, base (Base copy-trading), perp (Hyperliquid), multiplier, rank, rank_change.
  • loyalty — tier, fee_bps + fee_pct, fee_discount_pct, next_tier, points_to_next (the milestone), plus demoted / previous_tier / maintenance_deadline — if demoted is true, mention the tier they fell from and that maintenance volume wins it back.
  • referral — balance_usdc (pending referral earnings, 25% of builder fee on referred trades).
  • meta.warnings / meta.degraded — narrate honestly.
  • Fails open — partial data still returns valid JSON.

Output contract

Lead with the section they asked about; otherwise a tight standing card:

  1. Points & rank — total, base/perp split, multiplier, rank (+ change).
  2. Loyalty — current tier + fee/discount, and points_to_next → next_tier (the actionable milestone).
  3. Referral — pending balance_usdc (and that it's claimable if > 0).

Formatting: clean, scannable, numbers from the data; emoji sparingly (🎯 next tier).

Mandatory closing (verbatim)

Want me to break down what it takes to reach the next tier?

On yes: use loyalty.points_to_next + get_loyalty_tiers for the tier path.

AI credits — the usage meter

Senpi agents run on AI-usage credits that come with the plan — a trial grant first, then plan credits. The app shows what is left as the meter in the app header (users call it "the bubble" or "my credits"), and their subscription page is the source of truth for the number. What each plan includes is published in "Plans & free credits" below and may be quoted; how much is left depends on your plan and your usage, and only the user's own page shows that.

  • What spends them. Every message the user sends and every tool turn the agent runs. Long threads cost more because the whole conversation is re-sent each turn — a fresh thread is cheaper than a long one. Scheduled monitoring (a cron that re-reads a strategy) is the classic silent drain; senpi-strategy-author/references/shadow-testing.md has the cheap alternatives.
  • A running strategy is not what spends them. Its runtime ticks without a model call, so running it does not move the meter; a decision_mode: llm action in its runtime.yaml is the exception, since that calls a model when it fires. A cron the agent set up to check on a strategy does move it (each firing is a full model call), so name any the agent runs for this user.
  • Not trading money. Credits cannot be traded, withdrawn, deposited into a strategy, or moved anywhere — they are separate from the funding wallet and from every strategy budget. A shrinking meter is usage, never a trading loss; a losing trade never touches the meter.
  • You cannot read the balance. No Senpi tool returns it (user_get_me → id / wallets / createdAt / referralCode; user_get_senpi_points → points / tier / fees) and the engine has no credits section. Point at the meter in the app header, or at their subscription page for the exact figure — the in-app indicator surfaces only when credits run low, so a missing indicator is expected, not a lost balance. Never invent a number, a percentage or a "roughly", and never guess what the meter shows.
  • Chat is not free of credits. Every turn spends them — including the turn that asks what a turn cost. Say so plainly; never "nothing".
SayNever say
"Chat and tool use spend AI credits from your plan; the meter in the app header is the balance — I can't read it from here. Longer threads cost more because the whole conversation is re-sent each turn.""chatting is free" / "that cost nothing"
"What each plan includes is published — here's the table. How much is left depends on your plan and your usage; the meter shows that."Any balance or percentage you did not read from the app, or a plan size you did not read from the table below
"Credits aren't money: they can't be traded, withdrawn or put into a strategy — your funding wallet and strategy budgets are separate.""credits" as a tradable or withdrawable balance
"The meter going down is usage — it moves with messages and tool turns, not with your trades."Blaming a shrinking meter on trading losses
"Your strategy runs on its own without the AI, so running it doesn't use credits. Chat does, and so does any scheduled check-in I run for you.""running the strategy costs nothing" while the agent runs a check-in cron on it; a wallet or strategy balance offered as proof about credits

Routing. "What is the bubble / meter in the header?", "why are my credits going down?", "how much did that cost?", "does my strategy use credits?", "can I trade / withdraw / deposit my credits?" all come here, in any language. "Credits" (Ukrainian "кредити", Spanish "créditos") means these AI credits unless the user says leverage, a loan or funding; when it is unclear, ask which before answering. A credits question is answered from this section alone — no engine run, no number — and closes by pointing at the meter; the next-tier CTA is for standing answers. "What plans are there / how much does it cost / what do I get on Pro / how do I get free credits / where are my milestone credits" are catalog questions: answer them from "Plans & free credits" below, still without a figure about this user.

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

Plans & free credits

Published facts — quote them. Billed per 30-day cycle, rolling from the user's own start date, never a calendar month.

PlanPriceCreditsPoints per $1 volume
Starter$25$251
Pro (default)$50$501.5
Advanced$100$130 (+30%)2
Quant$200$270 (+35%)3
  • Every plan includes every model. Plans differ on credits and points rate only — never on model access, so a cheaper plan never locks anyone out of the better model. Trading fees are separate and start at 0.05% on every plan.
  • $1 of credit = $1 of AI usage. Full credits land at the start of the cycle and expire at the end of it: no rollover, no top-ups, no overage. Out of credits = upgrade (instant) or wait for renewal.
  • Upgrading is instant, any day — the new plan's full credits land immediately, the 30-day cycle restarts, and unused credits are credited against the price, so they pay the difference. Downgrading or cancelling takes effect at the next renewal, never mid-cycle; benefits are kept until then and there are no mid-cycle refunds.
  • Payment is web only (Stripe, senpi.ai/settings/subscription). The app shows plan, credits and renewal date but links out to the web page to change anything.
  • Free trial: activates when the user deploys their agent, is one-time, and expires 14 days after activation. Never quote a trial figure — the starting amount has changed more than once; their subscription page is the only source of truth. On expiry or exhaustion the agent stops until they subscribe: active strategies pause, open positions are NOT auto-closed, funds untouched.

Free credits — the milestone ladder. $315 of AI credit across 12 milestones, on the "Unlock Free AI Credits" card:

MilestoneFree credits
Deploy your agent$10
Launch your first strategy$10
Subscribe to a plan$15
Trade $2K / $25K / $50K volume$10 each
Trade $100K / $250K volume$20 / $30
Trade $500K / $1M / $2M / $4M volume$50 each
  • Deploying the agent is the only one credited on day one. Everything else is earned.
  • Not retroactive — a milestone credits the next time it is achieved, counting from when milestones launched; activity before that does not fill the bar.
  • Milestone credits expire at the next renewal — a different clock from the 14-day trial expiry, so credit that vanished at a renewal boundary is working as designed.
  • Volume progress is not live — the card refreshes on a timer and shows a countdown, so a trade that has not moved the bar yet is normal, not a missed milestone.
  • The bonus is always AI credit — it never lands in Balances as USDC.

The card is the source of truth. If the user's own page or card disagrees with any figure here, their page is right and this table is stale — never argue a user out of what is on their screen, and never tell them what their bar ought to read.

⚠ Token scope

Every tool here is USER-scoped (the user's own account): needs a USER-scoped SENPI_AUTH_TOKEN. App-scoped → no user resolves and meta.degraded; say so rather than reporting zeros.

Skill Attribution

Guide/analysis skill — it reads the user's standing; it does not mutate anything (claiming referral rewards is a separate explicit action via user_claim_referral_rewards, which this skill never calls).

Install — both scripts are required

The engine is two files in scripts/: status.py (the engine) and mcp_client.py (its vendored MCP helper, imported at runtime). Install the whole scripts/ directory — copying status.py alone fails with No module named 'mcp_client'. Stdlib only, no other runtime dependencies.

© Senpi-ai, Apache-2.0. 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 6 other files (scripts, references) in senpi-account-status of Senpi-ai/senpi-skills.

  • SKILL.md
  • references/presentation-notes.md
  • scripts/mcp_client.py
  • scripts/status.py
  • tests/fixtures/status_fixture.json
  • tests/test_skill_surface.py
  • tests/test_status.py

Open the folder on GitHubat commit 4f0a537

Compare with similar skills

Senpi Account Status 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.

Senpi Account Status compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Senpi Account Status this skillSenpi-ai/senpi-skills134—~3kAutomated safety check: PassApache-2.0
Minara Crypto Trading and WalletMinara-AI/minara-skills362—~5.7kAutomated safety check: PassNone
Hyperliquid CLI Tradingchrisling-dev/hyperliquid-cli100—~1.8kAutomated safety check: PassMIT
Aomi Transactsickn33/agentic-awesome-skills47k1 repos~2.3kAutomated safety check: PassMIT
Aomi Transactjeremylongshore/tons-of-skills-marketplace2.8k—~2.3kAutomated safety check: PassMIT
Crypto Pricesundial-org/awesome-openclaw-skills663—~489Automated safety check: PassNone

Similar skills

  • Minara Crypto Trading and Wallet

    Minara-AI/minara-skills

    Drives the Minara CLI for crypto swaps, perps, limit orders, wallet transfers, deposits and withdrawals, plus AI market analysis.

    362 GitHub stars~5.7k tokensUpdated 24 days ago
    Business, Finance & HRAuto-check passed
  • Hyperliquid CLI Trading

    chrisling-dev/hyperliquid-cli

    Trades crypto perpetuals and HIP-3 stocks and commodities on Hyperliquid from the terminal with the hl CLI, including live position tracking and multiple accounts.

    100 GitHub stars~1.8k tokensUpdated 8 mo ago
    Business, Finance & HRAuto-check passed
  • Aomi Transact

    sickn33/agentic-awesome-skills

    Build natural-language crypto/DeFi agents and EVM MCP plugins (Claude Code, Cursor, Codex, Gemini).

    47k GitHub starsUsed in 1 repo~2.3k tokens
    Business, Finance & HRAuto-check passed
  • Aomi Transact

    jeremylongshore/tons-of-skills-marketplace

    Build natural-language crypto agents, web3 assistants, and trading bots that read and write EVM chain state.

    2.8k GitHub stars~2.3k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Crypto Price

    sundial-org/awesome-openclaw-skills

    Get cryptocurrency token price and generate candlestick charts via CoinGecko API or Hyperliquid API.

    663 GitHub stars~489 tokensUpdated 7 mo ago
    Business, Finance & HRAuto-check passed
  • Okx Defi Invest

    nirholas/three.ws

    OKX-aggregated DeFi discovery and execution — for users who want OKX to find and route to the best protocol WITHOUT naming a specific DApp.

    229 GitHub stars~4.4k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed

More from Senpi-ai/senpi-skills

  • Senpi Market Pulse

    Senpi-ai/senpi-skills

    Produces a structured cross-asset read of the day across crypto, equities, indices, commodities and macro, using a bundled engine for data and ending with a signals brief.

    134 GitHub stars~4.9k tokensUpdated yesterday
    Auto-check passed
  • Reads where proven profitable Hyperliquid wallets are positioned versus smaller traders, surfacing the divergence worth paying attention to.

    134 GitHub stars~4k tokensUpdated yesterday
    Auto-check passed
  • Senpi Trading Runtime Contract

    Senpi-ai/senpi-skills

    Documents how a Senpi strategy's scan function talks to the runtime that schedules it, sizes orders, and manages stop-loss exits on Hyperliquid.

    134 GitHub stars~2.6k tokensUpdated yesterday
    Auto-check passed
  • Senpi Why

    Senpi-ai/senpi-skills

    Answer "what makes Senpi different?" / "why Senpi?" / "Senpi vs other trading apps, bots or AI chatbots?" — the positioning answer, led by value, not a feature dump.

    134 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Senpi Account Status

What does Senpi Account Status do?

Reports a user's Senpi points, rank, loyalty tier, fees and referral earnings from one real-time script, and explains the AI-credit usage meter without ever reading its balance. A single script gathers points, loyalty and referral standing together in one call rather than separate tools, and its JSON is always re-run rather than quoted from earlier, since points and fees move. The response groups points into a total, a base and perp split and a multiplier with rank; loyalty into the tier, the fee in basis points, the discount, the next tier and points needed, plus any demotion; and referral into the pending balance from referred trades.

When should I use Senpi Account Status?

Senpi Account Status fits situations like: checking a user's current Senpi points, rank or loyalty tier; explaining why a loyalty tier changed or what the next tier requires; checking referral earnings from referred trades; explaining what the AI-credit meter in the header means.

How do I install Senpi Account Status in Claude Code?

Run `npx skills add Senpi-ai/senpi-skills --skill senpi-account-status -a claude-code`. Or copy the skill folder (senpi-account-status in Senpi-ai/senpi-skills) into .claude/skills/senpi-account-status in your project. Claude Code loads it when a task matches its description.

How do I install Senpi Account Status in Codex?

Run `npx skills add Senpi-ai/senpi-skills --skill senpi-account-status -a codex`. Or copy the skill folder (senpi-account-status in Senpi-ai/senpi-skills) into .agents/skills/senpi-account-status in your project. Codex loads it when a task matches its description.

Can I use Senpi Account Status 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 Senpi-ai/senpi-skills --skill senpi-account-status -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/senpi-account-status, .gemini/skills/senpi-account-status, .github/skills/senpi-account-status and .opencode/skills/senpi-account-status in your project.

What does Senpi Account Status need to run?

Going by SKILL.md and its folder, Senpi Account Status needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named SENPI_AUTH_TOKEN. Our summary lists: A USER-scoped Senpi token; Python, to run the bundled status script.

Does Senpi Account Status access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Senpi Account Status 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Senpi Account Status use?

Senpi Account Status is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Senpi Account Status use?

About 3k tokens (SKILL.md is roughly 12k 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 396 tokens, read only when the agent opens those files.

What are the alternatives to Senpi Account Status?

Skills that share tags, products or a category with Senpi Account Status: Minara Crypto Trading and Wallet (Minara-AI/minara-skills, 362 stars), Hyperliquid CLI Trading (chrisling-dev/hyperliquid-cli, 100 stars), Aomi Transact (sickn33/agentic-awesome-skills, 47k stars) and Aomi Transact (jeremylongshore/tons-of-skills-marketplace, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Senpi Account Status?

Senpi-ai (a GitHub organization) maintains it in Senpi-ai/senpi-skills, which has 134 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 10, 2026.

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