V2ex

What it does

When your agent uses it

• The user mentions V2EX
• Wants to browse tech forum topics
• Read V2EX discussions
• Search V2EX posts

Example prompts

• “/v2ex”

Requirements

• Python 3
• Docker

Workflow steps

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

1. 1Read /references/provider-config.yaml
2. 2Append the provider block to ~/.sig/config.yaml under providers
3. 3Ask the user: "Do you need a proxy to access this site?" — if yes, add networkProxy: under the provider in config.yaml
4. 4Run sig login v2ex (with --network-proxy if proxy was specified)
5. 5Verify: run sig status v2ex again — must show valid: true before proceeding

What it can do on your machine

Read from SKILL.md and the folder at commit 9ba8b35. 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 16 files in scripts/ (Python, from the files we listed), 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 no API keys, tokens, secrets or passwords.

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

Context cost

V2ex loads about 2.6k tokens when it runs, and up to ~2.8k if it reads all its reference files. Until then it costs about 158 tokens; SKILL.md has 746 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~158

When it runs · the whole SKILL.md, loaded when a task matches

~2.6k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~2.8k

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

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 sigcli/sigcli at commit 9ba8b35, republished under its MIT licence (© sigcli). 746 words, ~2,626 tokens.

name

v2ex

description

Interact with V2EX (v2ex.com) — browse hot and latest topics, read topic details and replies, search posts, create topics, reply to discussions, thank posts, favorite topics/nodes, follow members, daily check-in. Use this skill whenever the user mentions V2EX, v2ex.com, wants to browse tech forum topics, read V2EX discussions, search V2EX posts, check V2EX notifications, create or reply to V2EX topics, or look up V2EX users/nodes. Also trigger when the user pastes a V2EX URL (e.g. v2ex.com/t/12345), mentions a V2EX node name, or asks about Chinese tech community discussions. Keywords: V2EX, v2ex, 论坛, 技术社区, 节点, 主题, 回复.

sig status v2ex 2>&1

grep -A15 "^\s*v2ex:" ~/.sig/config.yaml | grep networkProxy | awk '{print $2}'

sig run v2ex -- bash -c 'python3 <SKILL_DIR>/scripts/v2ex_hot.py --cookie "$SIG_V2EX_COOKIE"'

sig run v2ex -- bash -c 'python3 <SKILL_DIR>/scripts/v2ex_reply.py --cookie "$SIG_V2EX_COOKIE" --topic-id 12345 --content "Nice post!"'

--cookie COOKIE       V2EX session cookie (optional)

--cookie COOKIE       V2EX session cookie (optional)

--cookie COOKIE       V2EX session cookie (optional)
--id ID               Topic ID (required)
--page N              Reply page number (default: 1)

--cookie COOKIE       V2EX session cookie (optional)
--name NAME           Node name (e.g., "python", "apple")
--page N              Page number for topic listing (default: 1)
--list-all            List all available nodes (flag)

--cookie COOKIE       V2EX session cookie (optional)
--username NAME       Member username (required)
--include-topics      Also fetch member's recent topics (flag)

--query TEXT          Search query (required)
--size N             Max results (default: 20)
--sort FIELD         Sort by: "sumup" (relevance, default) or "created"
--node NAME          Filter by node name (optional)
--username NAME      Filter by author (optional)

--cookie COOKIE       V2EX session cookie (required)
--page N              Page number (default: 1)

--cookie COOKIE       V2EX session cookie (required)

--cookie COOKIE       V2EX session cookie (required)
--node NAME           Target node name (required, e.g., "python")
--title TEXT          Topic title (required)
--content TEXT        Topic body content (required)
--syntax SYNTAX       Content syntax: "default" or "markdown" (default: "default")

--cookie COOKIE       V2EX session cookie (required)
--topic-id ID         Topic ID to reply to (required)
--content TEXT        Reply content (required)

--cookie COOKIE       V2EX session cookie (required)
--type TYPE           "topic" or "reply" (required)
--id ID               Topic ID or Reply ID (required)

--cookie COOKIE       V2EX session cookie (required)
--type TYPE           "topic" or "node" (required)
--id ID               Topic ID or Node ID (required)
--undo                Unfavorite instead (flag)

--cookie COOKIE       V2EX session cookie (required)
--action ACTION       "follow", "unfollow", "block", or "unblock" (required)
--id ID               Member numeric ID (required)

--cookie COOKIE       V2EX session cookie (required)

--cookie COOKIE       V2EX session cookie (required)
--topic-id ID         Topic ID to append to (required)
--content TEXT        Supplement content (required)

© sigcli, MIT. 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 32 other files (scripts, references) in skills/v2ex of sigcli/sigcli.

• SKILL.md
• references/provider-config.yaml
• scripts/v2ex_append.py
• scripts/v2ex_client.py
• scripts/v2ex_create.py
• scripts/v2ex_daily.py
• scripts/v2ex_favorite.py
• scripts/v2ex_follow.py
• scripts/v2ex_hot.py
• scripts/v2ex_latest.py
• scripts/v2ex_member.py
• scripts/v2ex_node.py
• scripts/v2ex_notifications.py
• scripts/v2ex_profile.py
• scripts/v2ex_reply.py
• scripts/v2ex_search.py
• scripts/v2ex_thank.py
• scripts/v2ex_topic.py
• tests
• … and 14 more

Open the folder on GitHubat commit 9ba8b35