desk-monitoring
Skill530 starsChanged 5 days agoMITView on GitHub
How the desk watches markets and the account between trades using Grok Bot routines and WebSocket or polling watches - the desk brief, book checks, funding and price watches, alert conditions and what a watch may and may not do. Use when the user asks for briefings, alerts, "watch X" or scheduled checks.
2 other projects use a version of this, 1 of them edited.
Adopted by
Most recently taken up by
- swcstudiospace/PumpGroktheir own version, first seen Nov 5, 2026
- Mendurim/strikegrok-trading-deskedited, first seen Sep 10, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 1
- Mendurim/strikegrok-trading-desk★ 022% same
Wrote their own version · 1
- swcstudiospace/PumpGrok★ 66same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository17 other files it gives its agents.
- AGENTS.mdAGENTS.md
- desk-execution-protocolSkill
- desk-incident-responseSkill
- desk-operating-modelSkill
- desk-post-trade-reviewSkill
- desk-risk-limitsSkill
- desk-strategy-labSkill
- desk-trade-lifecycleSkill
- hypergrok-bootstrapSkill
- hyperliquid-accountSkill
- hyperliquid-advancedSkill
- hyperliquid-api-referenceSkill
- hyperliquid-market-dataSkill
- hyperliquid-ordersSkill
- hyperliquid-positionsSkill
- hyperliquid-setupSkill
- hyperliquid-websocketSkill
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 5 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 80
Every watch script logs to /workspace/trading-desk/watch/<name>.log with UTC timestamps.
- Distinctive: line 82
Do not run more than a few watches at once.
- Distinctive: line 83
When the desk goes flat and the user is done for the day, stop the watches that only make sense with positions.
- Distinctive: line 87
Never let a watch place, modify or cancel an order, or change leverage.
- Distinctive: line 88
Never alert with unsourced numbers.
- Very specific: line 89
Never report a stale or failed read as a condition that did not fire.
- Distinctive: line 90
Never poll faster than the desk needs.
≈ “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.
Files
Monitoring, briefs and watches
Monitoring is read-only. A watch may fetch, compute, save and alert. It may never send to the exchange. If a watch condition implies action ("stop got hit, re-enter"), the alert opens a proposal; the lifecycle does the rest.
Grok Bot routines
Each Bot can own routines (schedules or event triggers). Ask the owning Bot to create one with: schedule and time zone, input source, expected result, approval boundary. Keep routines few and specific; the app keeps only recent run records, so a routine that produces something durable should also write to /workspace/trading-desk.
Recommended starting set (the user picks; none is on by default):
| Routine | Owner | Schedule | Output |
| Desk brief | Desk Lead | once a day at the user's chosen time | briefs/YYYY-MM-DD-desk.md and a short post |
| Book check | Risk Manager | every 4-8 hours while positions are open | alert only if something changed or a limit is near |
| Funding snapshot | Market Analyst | daily, or before the user's usual trading time | table of funding, OI, volume for the allowed markets |
| Catalyst calendar refresh | Research Analyst | weekly | research/calendar.md |
| Weekly review | Trade Reviewer | weekly | review posted by DM |
The desk brief
Assembled by the Desk Lead from specialists' inputs, or generated by the Desk Lead directly if it is the only Bot awake:
CONCLUSION: The ETH long remains open with a resting stop; HG-20260816-01 is live.
DESK BRIEF | 2026-08-17 07:00 UTC | mainnet | account 0xabc...def
markets (Market Analyst, allMids + metaAndAssetCtxs 06:58 UTC):
BTC 97,120 (+0.8% 24h) | funding 0.0010%/h | OI $4.1B
ETH 3,004 (+0.2%) | funding 0.0012%/h | OI $1.2B
SOL 151.2 (-1.1%) | funding -0.0004%/h | OI $610M
book (Risk Manager, clearinghouseState 06:59 UTC): 1 position, ETH long 0.4827 @ 3,000, uPnL +$1.9, margin ratio 4.6%, stop resting 2,900; open risk 0.5%; day PnL 0.0%
research (Research Analyst): ETH client release scheduled 2026-08-19 [link]; nothing breaking on held markets
open items: HG-20260816-01 live; pending tickets: noneLead the brief with a plain conclusion about the current book and any required attention, then present these facts with sources. Keep interpretation on one clearly labelled line. Name existing positions and live or pending tickets; do not describe a book with an open position or ticket as having no open items. No trade suggestions.
When to post
A requested update or scheduled report always receives an answer, even when the state is unchanged. For other background checks, save the source, network, UTC check time, accepted and observed data age, result and relevant position or proposal ids under /workspace/trading-desk. Stay quiet only when the check succeeded with fresh, complete data and found no actionable change.
Post changed conditions, failures, stale reads, missing data and gaps with their consequence and next owner or required action. Successful request completion alone is not an all-clear; apply the freshness and completeness checks below before suppressing a message. A quiet run still leaves timestamped evidence and a heartbeat for inspection.
Watches
A watch is a condition plus an alert. Two ways to run one on the desk computer:
- Polling with
/infocalls on a short loop from a script under/workspace/trading-desk/watch/(respect rate limits:/inforequests carry weight; a poll every 5-15 seconds per market is plenty for a desk). - WebSocket subscriptions (
allMids,l2Book,trades,candle,userFills,orderUpdates,userEvents) perhyperliquid-websocket. Better for fills and order updates. Keep the process supervised (a routine can restart it) and log to a file.
Common watch conditions:
| Watch | Data | Alert to |
| Price crosses a level | allMids or candle | user, Desk Lead |
| Funding flips sign or exceeds a threshold | metaAndAssetCtxs funding / predictedFundings | user, Desk Lead |
| Order filled or cancelled | orderUpdates, userFills | Execution Trader, Trade Reviewer |
| Margin ratio above X or liquidation distance below Y | clearinghouseState | user, Risk Manager, Desk Lead |
| Position without a resting stop | clearinghouseState + frontendOpenOrders | Risk Manager, Desk Lead (incident) |
| Daily loss stop approached (80%) or hit | clearinghouseState vs start-of-day equity | user, Risk Manager |
| Exchange unreachable for more than N minutes | any /info call failing | Desk Lead |
An alert message carries: what fired, the value and the threshold, the source and UTC time, and the proposal id if related. Alerts do not include instructions to trade.
Silence is not an all-clear. A watch has three outcomes, never two: the condition fired, the condition did not fire, or the watch could not tell. A failed request, an empty response, a socket that reconnected and skipped messages, a candle that never closed, or data older than the watch's own interval is unavailable, and it must alert as such. A watch that quietly reports "not crossed" on a dead feed is the most dangerous thing on the desk, because it looks exactly like a calm market.
Give every watch a staleness bound (a small multiple of its interval) and check the age of each result against it. On unavailable: say which read failed, how old the last good value was, and how long the gap has run. Escalate a gap that outlives the bound, rather than waiting for the feed to come back.
Hygiene
- Every watch script logs to
/workspace/trading-desk/watch/<name>.logwith UTC timestamps. - A watch that fails silently is worse than none: routines that own a watch check its heartbeat.
- Do not run more than a few watches at once; each is a process on the shared computer.
- When the desk goes flat and the user is done for the day, stop the watches that only make sense with positions.
Never
- Never let a watch place, modify or cancel an order, or change leverage. Even a "protective" one. It alerts; the desk acts through a ticket.
- Never alert with unsourced numbers.
- Never report a stale or failed read as a condition that did not fire. That is an
unavailablealert, not silence. - Never poll faster than the desk needs; a rate-limited desk is a blind desk.
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
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.

