Agent skill

Avalon 8 10p

by nexus-research-lab in nexus-research-lab/nexus

Eight-to-ten-player Avalon rules for a permanent Agent host, with the user choosing to join the randomized player pool or spectate.

Apache-2.0Auto-check passed

Install Avalon 8 10p

skills CLI
$ npx skills add nexus-research-lab/nexus --skill avalon-8-10p -a claude-code

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

GitHub CLI
$ gh skill install nexus-research-lab/nexus avalon-8-10p --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/nexus-research-lab/nexus.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/avalon-8-10p .claude/skills/avalon-8-10p && 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
avalon-8-10p
GitHub stars
151
Token cost
~2.6k tokens
SKILL.md length
1,498 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
Apache-2.0

At a glance

Eight-to-ten-player Avalon rules for a permanent Agent host, with the user choosing to join the randomized player pool or spectate.

  • Works in 3 steps: Preliminary Proposal And Discussion → Team Vote → Quest Cards
  • SKILL.md covers Game Setup, Wake Plumbing, Role Knowledge and Board And Win Conditions, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Avalon 8 10p is an agent skill from nexus-research-lab/nexus. Eight-to-ten-player Avalon rules for a permanent Agent host, with the user choosing to join the randomized player pool or spectate.

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Multi-agent collaboration platform for persistent, proactive AI agents across rooms, workspaces, skills, and external services. The licence is Apache-2.0.

Example prompts

  • “/avalon-8-10p”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Preliminary Proposal And Discussion
  2. Team Vote
  3. Quest Cards

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    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

Avalon 8 10p loads about 2.6k tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 1,498 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~36
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from nexus-research-lab/nexus at commit 67f54e7, republished under its Apache-2.0 licence (© nexus-research-lab). 1,498 words, ~2,621 tokens.

Download SKILL.mdSave it as .claude/skills/avalon-8-10p/SKILL.md (or your agent's skills folder).
name
avalon-8-10p
description
Eight-to-ten-player Avalon rules for a permanent Agent host, with the user choosing to join the randomized player pool or spectate.
title
8–10-Player Avalon
scope
room
tags
room, game, avalon

8–10-Player Avalon

This skill layers a complete base game of Avalon on top of the Room communication kernel. The Room system prompt already defines public @<member> wakes and the built-in nexus Room tools; this skill defines only the game contract. The host Agent is always the moderator and never a player.

Game Setup

Resolve participation and player count before assigning roles:

  1. Exclude the host Agent from roles, leadership, teams, votes, and win-condition counts.
  2. Ask the user exactly once whether to join as a player or spectate, using AskUserQuestion, unless the opening request already states that choice explicitly. Use the exact choices 参加本局 and 仅旁观.
  3. If the opening request explicitly names 8, 9, or 10 players, use that count. Reject any unsupported count instead of silently changing it.
  4. Otherwise choose the largest supported count in the order 10, 9, 8 that the Room can fill. A participating user occupies one player seat; a spectating user occupies none.
  5. Randomly select the required non-host Agent players. Extra Agents and a spectating user remain spectators and receive no role card or game wake.
  6. If the requested count cannot be filled, stop before dealing roles and state the exact number of missing players. If no count was requested and fewer than eight seats can be filled, report how many players are missing for an eight-player game.
  7. Use 用户玩家 as the participating user's stable public name. A participating user enters the same randomized role pool as every Agent player and can receive any role, become leader, join a quest, and vote.

Use exactly this role table:

PlayersGoodEvil
8Merlin, Percival, 3 Loyal ServantsMorgana, Assassin, Minion
9Merlin, Percival, 4 Loyal ServantsMordred, Morgana, Assassin
10Merlin, Percival, 4 Loyal ServantsMordred, Morgana, Oberon, Assassin

Shuffle roles across all active players, then independently randomize the circular seating order and first leader. Announce only the player count, active roster, seating order, and first leader. Keep the participation answer, role mapping, and inactive candidate list private.

Lake Lady, Lancelot, and Excalibur are optional variants and are not enabled. Do not add them or substitute a different role distribution unless the user explicitly requests a variant before setup.

Wake Plumbing

The game has three execution channels:

  • Public feed: a normal public reply containing a non-code @<member> wakes that Agent. An Agent handoff has exactly one naked @; a handoff to the user has none.
  • Agent private channel: use nexus.send_message with destination=current_room and visibility=private for Agent role cards, hidden votes, quest cards, assassination choices, and host state.
  • User private channel: only the host uses AskUserQuestion for participation, the user's role card, and every hidden user choice. Player Agents never use it to contact the user.

用户玩家 is not an Agent recipient or wake target. Never place it in send_message.recipients, wake_targets, or a naked public @. A user continues a public turn by posting a normal Room message and uses a real @<next Agent> only when an Agent must run next.

A user message counts as a proposal, speech, or other game action only while host state is waiting for that exact user turn. Spectator comments and out-of-turn messages never change game state.

For every ordered public chain, expose only the current handoff as a naked @. Write future names without @ or inside code spans. Public actions must contain only the player's public persona; never leak role truth or private reasoning.

Collect hidden Agent choices one at a time with an explicit private handback:

json
{
  "tool": "nexus.send_message",
  "arguments": {
    "destination": "current_room",
    "visibility": "private",
    "recipients": ["<player>"],
    "wake_policy": "immediate",
    "reply_route": {
      "mode": "private",
      "recipients": ["<host>"],
      "wake_policy": "immediate"
    },
    "content": "<legal choices and exact reply format>"
  }
}

The Agent player answers with only the requested plain-text final reply. It must not call a Room tool or send the answer twice. Queue the next hidden actor and output <nexus_room_no_reply/> until the collection is complete.

If the final hidden actor is an Agent, set reply_route.next_reply_route.mode = "public" on that Agent's original directed message. If the final hidden actor is the user and an Agent acts immediately before it, set that preceding Agent message's next_reply_route to public; the resumed host turn asks the user and publishes the result naturally. If the collection contains only the user, ask from the current public host turn.

Store minimal authoritative game state in a record-only private message to the host with wake_policy="none" and reply_route.mode="none": player count, seating order, roles, current leader, quest number, proposal attempt, approved team, quest results, and rejection count.

Role Knowledge

Deliver each Agent role as a record-only private message. Deliver a participating user's role through AskUserQuestion with one acknowledgement choice. Include only the knowledge that role is entitled to receive:

  • Merlin sees every Evil player except Mordred. Merlin therefore sees Oberon when Oberon is present.
  • Percival sees Merlin and Morgana as two unordered candidates and is not told which is which.
  • Evil players other than Oberon know one another. They do not see Oberon as Evil.
  • Oberon learns no Evil teammates, and no teammate learns Oberon's identity.
  • Loyal Servants and the Minion receive no additional identities.

Never publish role knowledge before the game ends.

Board And Win Conditions

All supported player counts use quest teams 3, 4, 4, 5, 5 for quests 1 through 5.

  • Quests 1, 2, 3, and 5 fail with at least one 失败 card.
  • Quest 4 requires at least two 失败 cards to fail; zero or one failure means the quest succeeds.
  • Three failed quests immediately give Evil the win.
  • Three successful quests start the assassination phase; Good has not won yet.
  • Four consecutive rejected proposals make the fifth leader's finalized team execute the current quest without another team vote. Reset the proposal attempt and rejection count after every quest.

Do not replace the forced fifth proposal with an automatic Evil victory.

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

Quest Round

Repeat these phases until one side reaches a terminal condition.

1. Preliminary Proposal And Discussion
  1. The host publicly states the quest number, required team size, proposal attempt, and current leader.
  2. The leader publicly proposes exactly that many distinct active players. The leader may include itself.
  3. Run exactly one uninterrupted public speech lap. Start with the player immediately to the leader's right; the leader chooses before the lap whether to speak first or last. Follow the fixed circular seating order and allow no interjections.
  4. Agent-to-Agent speeches end with exactly one @<next Agent>. Agent-to-user handoffs contain no naked @; user-to-Agent handoffs use one real @<next Agent>.
  5. After the final speech, return to the leader. The leader publicly finalizes a legal team and may change any preliminary member.

The host rejects malformed proposals and asks the same leader to correct them; it never fills, removes, or substitutes a player silently.

2. Team Vote

On proposal attempts 1 through 4, every active player votes 同意 or 反对; abstention is illegal. Collect all votes privately so no player sees an earlier choice, then reveal every named vote together in one public result.

A strict majority approves. A tie or a majority of 反对 rejects. On rejection, increment the proposal attempt, rotate leadership to the next active player in seating order, and repeat the same quest. On attempt 5, complete proposal and discussion normally, then skip the team vote and send the finalized team directly on the quest.

Use AskUserQuestion for a participating user's hidden team vote. Use private directed messages for Agent votes. Do not summarize partial vote totals while collecting.

3. Quest Cards

Collect one hidden card from every approved team member:

  • Good players must submit 成功.
  • Evil players may submit either 成功 or 失败.
  • Non-team players submit nothing.

Use AskUserQuestion for a participating user's card and a private directed message for an Agent's card. Validate each choice against the player's role, shuffle their order before publishing only the aggregate number of 成功 and 失败 cards, and never identify who submitted a card.

Apply the quest's failure threshold, record the result, reset the rejection track, and rotate leadership to the next active player. Check the win condition before starting another proposal.

Assassination

After the third successful quest, privately ask the Assassin alone to name one other active player. An Agent Assassin replies through a private directed message; a user Assassin chooses through AskUserQuestion.

  • If Assassin identifies Merlin, Evil wins.
  • Otherwise Good wins.

Publish the target, outcome, and complete role reveal together. Stop all game wakes after the final result.

Public Handoffs And Privacy

  • Public: roster, seating, leader, proposals, speeches, simultaneous named team-vote reveal, quest-card totals, quest results, score, assassination result, final roles.
  • Private: participation answer, role map, role knowledge, team votes before reveal, quest cards, assassination choice before resolution, host state.
  • A public transition to an Agent ends with exactly one naked @<current actor>. A transition to 用户玩家 has no naked @ and waits for a normal user message.
  • Never publish execution status such as who the host is waiting for. Never expose a partial hidden collection.
  • No player is eliminated during Avalon. Every active player remains eligible to lead, speak, join teams, and vote until the game ends.

Alternative rejection tracks, early assassination, Lake Lady, Lancelot, and Excalibur remain disabled unless explicitly selected before roles are dealt. Never improvise a variant mid-game.

© nexus-research-lab, 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

Just SKILL.md in skills/avalon-8-10p of nexus-research-lab/nexus.

Open the folder on GitHubat commit 67f54e7

Compare with similar skills

Avalon 8 10p 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.

Avalon 8 10p compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Avalon 8 10p this skillnexus-research-lab/nexus151—~2.6kAutomated safety check: PassApache-2.0
Player Exampleremotion-dev/remotion63k—~258Automated safety check: PassCustom licence
Escaping Containers To Hostmukul975/Anthropic-Cybersecurity-Skills34k—~3.4kAutomated safety check: PassApache-2.0
Cross Host Federationruvnet/ruflo74k—~1.1kAutomated safety check: PassMIT
Host Patternnukeop/nuclear19k—~1.3kAutomated safety check: PassAGPL-3.0
Testing For Host Header Injectionmukul975/Anthropic-Cybersecurity-Skills34k—~2.2kAutomated safety check: WarnApache-2.0

Similar skills

  • Player Example

    remotion-dev/remotion

    Official

    Start the @remotion/player example app and open it in the Codex browser.

    63k GitHub stars~258 tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Escaping Containers To Host

    mukul975/Anthropic-Cybersecurity-Skills

    Exploits privileged pods, host mounts, runC CVEs, and exposed Docker sockets to break out of a container and reach the underlying host during an authorized container-security assessment.

    34k GitHub stars~3.4k tokensUpdated 1 mo ago
    SecurityAuto-check passed
  • Join and operate a signed cross-host agentbbs federation, and coordinate work claims across nodes.

    74k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Host Pattern

    nukeop/nuclear

    A skill your agent uses when adding a new domain to Nuclear's plugin system, or implementing a host.

    19k GitHub stars~1.3k tokensUpdated 5 days ago
    Auto-check passed
  • Testing For Host Header Injection

    mukul975/Anthropic-Cybersecurity-Skills

    Test web applications for HTTP Host header injection vulnerabilities to identify password reset poisoning, web cache poisoning, SSRF, and virtual host routing manipulation risks.

    34k GitHub stars~2.2k tokensUpdated 1 mo ago
    SecurityAuto-check: warnings
  • Add Hosted Key

    simstudioai/sim

    Add hosted API key support to a tool so Sim provides the key (metered and billed to the workspace) when a user has not brought their own.

    30k GitHub stars~3.6k tokensUpdated today
    Backend & APIsAuto-check passed

More from nexus-research-lab/nexus

All 17 skills in this repo
  • Imagegen

    nexus-research-lab/nexus

    Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, UI mockups, product shots, or transparent-background…

    151 GitHub stars~600 tokensUpdated yesterday
    Auto-check passed
  • Caixun Work Hours

    nexus-research-lab/nexus

    彩讯(RichPMS)工时填报助手:把当前会话、代码记录或用户口述整理成日报,按 8 小时分配,经用户确认后写入工时系统。用户提到“填日报、报工、补报、本周工时、日报被驳回”时使用。

    151 GitHub stars~1k tokensUpdated yesterday
    Auto-check passed
  • Wechat Article Search

    nexus-research-lab/nexus

    搜索微信公众号文章,并整理标题、摘要、发布时间、来源公众号和链接。用户提到微信公众号、 公众号文章、微信文章、搜一批公众号资料、按关键词找公众号内容、查某公众号相关报道, 或需要为中文研究收集微信公众平台文章时使用;即使用户只说“搜微信里的文章”也应触发。

    151 GitHub stars~858 tokensUpdated yesterday
    Auto-check: notes
  • XLSX

    nexus-research-lab/nexus

    只要电子表格文件(.xlsx、.xlsm、旧版 .xls、.csv、.tsv)是任务的主要输入或输出,或者需要 被打开、读取、创建、修改,就使用本 Skill。也适用于公式、格式、图表、数据清洗和表格格式转换。

    151 GitHub stars~501 tokensUpdated yesterday
    Auto-check passed
  • Automation

    nexus-research-lab/nexus

    通过宿主提供的 nexus.command 结构化工具查询、规划、确认并管理 scheduled task。用户要求提醒、延迟执行、周期检查、定时报表、补跑、结果重投递、持续关注、修改或删除任务、处理任务权限阻塞时使用;同时适用于定时任务后台 run 检查自身状态。

    151 GitHub stars~541 tokensUpdated yesterday
    Auto-check passed
  • Execution Orchestrator

    nexus-research-lab/nexus

    选择执行结构、委派子智能体、管理 Nexus 工作图与可复用模板;遵守本轮权限,简单任务直接完成. An agent skill from nexus-research-lab/nexus.

    151 GitHub stars~821 tokensUpdated yesterday
    Auto-check passed

Questions about Avalon 8 10p

What does Avalon 8 10p do?

Eight-to-ten-player Avalon rules for a permanent Agent host, with the user choosing to join the randomized player pool or spectate. Avalon 8 10p is an agent skill from nexus-research-lab/nexus. Eight-to-ten-player Avalon rules for a permanent Agent host, with the user choosing to join the randomized player pool or spectate.

How do I install Avalon 8 10p in Claude Code?

Run `npx skills add nexus-research-lab/nexus --skill avalon-8-10p -a claude-code`. Or copy the skill folder (skills/avalon-8-10p in nexus-research-lab/nexus) into .claude/skills/avalon-8-10p in your project. Claude Code loads it when a task matches its description.

How do I install Avalon 8 10p in Codex?

Run `npx skills add nexus-research-lab/nexus --skill avalon-8-10p -a codex`. Or copy the skill folder (skills/avalon-8-10p in nexus-research-lab/nexus) into .agents/skills/avalon-8-10p in your project. Codex loads it when a task matches its description.

Can I use Avalon 8 10p 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 nexus-research-lab/nexus --skill avalon-8-10p -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/avalon-8-10p, .gemini/skills/avalon-8-10p, .github/skills/avalon-8-10p and .opencode/skills/avalon-8-10p in your project.

What does Avalon 8 10p need to run?

SKILL.md names no scripts, command-line tools or credentials: Avalon 8 10p is instructions for the agent only.

Does Avalon 8 10p 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 Avalon 8 10p 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. Review the folder before installing.

What licence does Avalon 8 10p use?

Avalon 8 10p is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Avalon 8 10p use?

About 2.6k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Avalon 8 10p?

Skills that share tags, products or a category with Avalon 8 10p: Player Example (remotion-dev/remotion, 63k stars), Escaping Containers To Host (mukul975/Anthropic-Cybersecurity-Skills, 34k stars), Cross Host Federation (ruvnet/ruflo, 74k stars) and Host Pattern (nukeop/nuclear, 19k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Avalon 8 10p?

nexus-research-lab (a GitHub organization) maintains it in nexus-research-lab/nexus, which has 151 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 10, 2026.

Source: nexus-research-lab/nexus on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.