# binance-us-briefing-engine

Adopt this skill: https://proskills.md/skills/other/cmeiliu-binance-us-skills

Page: https://proskills.md/skills/other/cmeiliu-binance-us-skills
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 5751
upstream: https://github.com/cmeiliu/binance-us-skills/blob/HEAD/SKILL.md

````text
---
name: binance-us-briefing-engine
description: Personalized Binance.US market, portfolio, and watchlist briefings using account balances, recent trading history, watchlists, market data, recent news headlines, market context, and catalyst watch tied to the user's relevant assets. Use when the user asks for a market summary, personalized crypto brief, portfolio update, capital readiness check, watchlist recap, opportunity alert, or weekly reset for Binance.US.
metadata:
  version: 0.3.0
  author: Binance.US
  openclaw:
    skillKey: binance-us-briefing-engine
    requires:
      bins:
        - python3
    homepage: https://skills.sh
license: MIT
---

# Binance.US Briefing Engine

Generate account-aware Binance.US briefings. This skill is only valuable when it ties the market back to the user's own account.

This repository is a Binance.US skill family:

- root `SKILL.md`: flagship market-brief skill
- nested `SKILL.md` files: installable companion skills for research, funding, trading, and account status

If you want to discover the full family from the repo, use:

```bash
npx skills add cmeiliu/binance-us-skills --list --full-depth
```

If you want to install a nested companion skill, use `--full-depth --skill <name>`.

## When Not To Use

- explicit funding workflows
- spot-trade execution reviews
- account-status troubleshooting
- deep single-asset diligence after the user already picked a coin

The bundled script should prefer:

- price-anchored output over percent-only output
- 24h plus 7-day framing over single-window commentary
- market context before portfolio-specific conclusions
- upcoming catalysts, not just backward-looking news
- ranked, de-duplicated news tied to held or watched assets
- a concrete next step over generic portfolio CTA text
- a conversational advisor tone over compliance-report wording
- explicit watchlist gaps and idle-cash framing when those would prompt action

## Use This Skill For

- "Give me a personalized market summary"
- "What matters for my Binance.US account today?"
- "Summarize my watchlist"
- "Give me a portfolio brief"
- "Do I have idle cash or concentration risk?"
- "What changed since my recent trades?"
- "Give me a capital readiness check"
- "Give me a weekly reset"

## Core Rule

Prefer account-aware output over generic market commentary.

When credentials are available, use:

- current balances
- recent trading history
- watchlist or configured priority assets
- deposit history when useful
- recent headlines for owned, watched, or recently traded assets

If credentials are unavailable, the script can still produce a limited market-only brief, but it should say so clearly.

## How To Run

Run the bundled script:

```bash
python3 scripts/binance_us_brief.py --mode daily_brief --format both
```

Common variants:

```bash
python3 scripts/binance_us_brief.py --mode portfolio_brief --format text
python3 scripts/binance_us_brief.py --mode watchlist_brief --watchlist BTC,ETH,SOL
python3 scripts/binance_us_brief.py --mode opportunity_alert --alert-threshold-pct 5
python3 scripts/binance_us_brief.py --mode capital_readiness --format text
python3 scripts/binance_us_brief.py --mode asset_research --asset BTC --format text
python3 scripts/binance_us_brief.py init-config
```

## Install Behavior

- For local development, prefer the default install behavior without `--copy` so OpenClaw uses a symlink and picks up local repo changes immediately.
- For GitHub or copied installs, use `npx skills update` to pull the latest published version.
- The rendered brief includes a version/update nudge for copied installs so stale snapshots are easier to spot.

## Credentials

The script will look for Binance.US credentials in this order:

1. Environment variables:
   - `BINANCE_US_API_KEY`
   - `BINANCE_US_SECRET_KEY`
2. `~/.openclaw/secrets.env`
3. `~/.env`
4. `.env` in the current workspace

The script reads only specific keys and does not print raw secrets.

## Optional Config

The script supports a small JSON config at:

`~/.openclaw/binance-us-briefing-engine.json`

Create it with:

```bash
python3 scripts/binance_us_brief.py init-config
```

Useful fields:

- `watchlist`
- `quote_assets`
- `quiet_hours`
- `recent_days`
- `portfolio_currency`
- `alert_threshold_pct`

## Recommended Workflow

1. Run `daily_brief` for a broad summary tied to balances and recent trades.
2. Run `portfolio_brief` when the user wants account impact, concentration, or idle cash context.
3. Run `watchlist_brief` when the user asks about tracked assets.
4. Use recent news headlines to explain why those assets matter today.
5. Run `capital_readiness` to connect market setup to account readiness without sounding like a product push.
6. Run `opportunity_alert` for trigger-style checks on owned, watched, or recently traded assets.
7. Run `weekly_reset` for a slower, portfolio-aware recap.
8. Run `asset_research` when a brief surfaces a setup that needs deeper, structured follow-up.
9. Hand off to `binance-us-fund-account`, `binance-us-spot-trade`, or `binance-us-account-status` when the user is past the briefing stage and needs an operational workflow.

## Output Contract

The script returns:

- JSON only
- text only
- or both

The JSON output is the source of truth. The text output is the delivery-ready rendering.

## Guardrails

- Treat the brief as informational, not financial advice.
- Never claim certainty or guaranteed returns.
- Do not place trades automatically.
- If the user requests an action after reading the brief, handle that as a separate explicit step.
- This skill is read-only. It does not place orders, move funds, or change account settings.
- Allowed outbound domains are limited to:
  - `api.binance.us`
  - `news.google.com`
````

## File: README.md
upstream: https://github.com/cmeiliu/binance-us-skills/blob/HEAD/README.md

````text
# Binance.US Skills

`binance-us-skills` is a Binance.US skill family for OpenClaw, Codex, and Claude Code.

It is built around one simple goal: help agents move users from market awareness to account action on Binance.US in a way that feels useful, explicit, and trustworthy.

The repo currently includes five skills:

- `binance-us-briefing-engine`: personalized daily brief, watchlist recap, opportunity alert, portfolio brief, capital-readiness check, and weekly reset
- `binance-us-asset-research`: deeper single-asset research for Binance.US-listed assets
- `binance-us-fund-account`: step-by-step account funding and deposit workflow
- `binance-us-spot-trade`: deliberate spot-trade review workflow
- `binance-us-account-status`: balances, deposits, readiness, and blockers

Together, these skills cover the full loop:

- understand the market
- understand your account
- research a setup
- get capital ready
- review the next Binance.US action

## Features

- 5 installable Binance.US skills in one repo
- daily market and portfolio briefing
- deeper Binance.US-safe asset research
- account funding and deposit workflow guidance
- spot-trade review workflow guidance
- account-status and readiness checks
- price-anchored summaries with 24h and 7-day context
- market context and catalyst-watch sections
- portfolio-aware news ranking and de-duplicated asset headline search
- Markdown-friendly text output for chat delivery
- first-run hook, watchlist-gap prompts, and sharper action-oriented CTAs

## Install

### OpenClaw

Important: this repo contains a skill family, not just one root skill. If you want to discover or install the companion `binance-us-asset-research` skill, use `--full-depth`.

Local development:

Prefer the default install behavior without `--copy` so your installed skill stays linked to the repo checkout and updates when you pull new commits.

```bash
npx skills add . -g --agent openclaw --yes --full-depth
```

From GitHub or for snapshot installs:

```bash
npx skills add cmeiliu/binance-us-skills -g --agent openclaw --yes --copy --full-depth
```

From GitHub, if you want full skill-family discovery:

```bash
npx skills add cmeiliu/binance-us-skills --list --full-depth
```

From GitHub, if you want to install a specific nested skill:

```bash
npx skills add cmeiliu/binance-us-skills -g --agent openclaw --yes --full-depth --skill binance-us-asset-research
```

To refresh a copied or GitHub-installed skill later:

```bash
npx skills update
```

### Codex

Codex can use this repo directly. The Codex-facing workflow is documented in `AGENTS.md`, and the shared engine is:

```bash
python3 scripts/binance_us_brief.py --mode daily_brief --format text
```

For deeper single-asset work:

```bash
python3 scripts/binance_us_brief.py --mode asset_research --asset BTC --format text
```

### Claude Code

Claude Code can use the project-local skill wrapper at `.claude/skills/binance-us-briefing-engine/SKILL.md`.

It invokes the same bundled Python engine, so behavior stays aligned across agents.

## Usage

In OpenClaw:

```text
Use $binance-us-briefing-engine to generate a personalized Binance.US brief from my balances, recent trades, and watchlist.
```

From the command line:

```bash
python3 scripts/binance_us_brief.py --mode daily_brief --format text
python3 scripts/binance_us_brief.py --mode portfolio_brief --format both
python3 scripts/binance_us_brief.py --mode watchlist_brief --watchlist BTC,ETH,SOL
python3 scripts/binance_us_brief.py --mode capital_readiness --format text
python3 scripts/binance_us_brief.py --mode asset_research --asset BTC --format text
```

This script is the shared execution layer for OpenClaw, Codex, and Claude Code.

If you install from GitHub or with `--copy`, the rendered brief also includes a version/update reminder so users get nudged toward `npx skills update`.

## Credentials

Each user must provide their own Binance.US credentials. Nothing is hard-coded into the skill.

Supported variables:

- `BINANCE_US_API_KEY`
- `BINANCE_US_SECRET_KEY`

Recommended location:

- `~/.openclaw/secrets.env`

Example:

```bash
BINANCE_US_API_KEY=your_key_here
BINANCE_US_SECRET_KEY=your_secret_here
```

Only these exact variable names are supported.

## Safety

This skill is read-only.

It does not:

- place orders
- convert assets
- move funds
- modify account settings

Allowed outbound network domains:

- `api.binance.us`
- `news.google.com`

The skill reads only user-provided Binance.US credentials and does not embed shared credentials in code.

## Config

Optional config file:

`~/.openclaw/binance-us-briefing-engine.json`

Create a starter config with:

```bash
python3 scripts/binance_us_brief.py init-config
```

## Skills

- `binance-us-briefing-engine`: daily brief, watchlist, opportunity, portfolio, weekly, and capital-readiness flows
- `binance-us-asset-research`: deeper single-asset research for Binance.US-listed assets
- `binance-us-fund-account`: step-by-step account funding and deposit workflow
- `binance-us-spot-trade`: deliberate spot-trade review workflow
- `binance-us-account-status`: balances, deposits, readiness, and blockers

Skill entrypoints in this repo:

- `binance-us-asset-research/SKILL.md`
- `binance-us-fund-account/SKILL.md`
- `binance-us-spot-trade/SKILL.md`
- `binance-us-account-status/SKILL.md`

For repos with a root skill, nested skills may require `--full-depth` during discovery or installation.

## License

MIT
````
