boardgame-studio: Skill for Cursor

.cursor/skills/bgs-reference/SKILL.md

bgs-reference is a skill for Cursor from kongsol-83/boardgame-studio. It costs 78 tokens per session (1,454 once invoked), scanned A, original, Apache-2.0.

A research workflow for finding similar board games on BoardGameGeek, a website that catalogs board games, and identifying mechanisms that may fit a new idea.

In plain words
What is it for?
It helps translate a game's core actions into mechanism candidates, find comparable games, study common combinations, and record promising options in a research document.
Why use it?
It shows which solutions have already been tried and where an idea may differ, instead of designing without checking existing games.

Skill for Cursor

Written for Cursor: installed under .cursor/.

This is kongsol-83/boardgame-studio's own configuration. It tells Cursor how to work on boardgame-studio itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything boardgame-studio configures →

Reuse

Borrowing it

Nothing to install: this file belongs to kongsol-83/boardgame-studio. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/kongsol-83/boardgame-studio/main/.cursor/skills/bgs-reference/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/kongsol-83/boardgame-studio

Made for: Cursor.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for bgs-reference

README.md
[![agentmods](https://agentmods.dev/badge/skills/kongsol-83/boardgame-studio/bgs-reference/github.svg)](https://agentmods.dev/skills/kongsol-83/boardgame-studio/bgs-reference)
Your own site
<a href="https://agentmods.dev/skills/kongsol-83/boardgame-studio/bgs-reference"><img src="https://agentmods.dev/badge/skills/kongsol-83/boardgame-studio/bgs-reference/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for bgs-reference

Your own site · 80×15
<a href="https://agentmods.dev/skills/kongsol-83/boardgame-studio/bgs-reference"><img src="https://agentmods.dev/badge/skills/kongsol-83/boardgame-studio/bgs-reference.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 78 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,454 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00078 $0.01454
Opus 5 $0.00039 $0.00727
Sonnet 5 $0.00016 $0.00291
Haiku 4.5 $0.00008 $0.00145

Measured 8d ago against content hash d073195401dc, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

bgs-reference scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.cursor/skills/bgs-reference/SKILL.md · 133 lines

How it starts

The opening of the file, as written. The whole thing — 133 lines — stays where its author put it; the contents beside it link to each section on GitHub.

레퍼런스 조사

concept.md 의 핵심 동사를 실제로 만들어내는 메커니즘을 찾는다. 산출물은 projects/<slug>/research.md 다.

목적은 두 가지다. 이미 검증된 해법을 찾는 것아직 비어 있는 자리를 찾는 것. 둘 다 필요하다. 남들이 다 하는 걸 굳이 새로 만들 이유도 없고, 남들이 안 하는 데는 이유가 있을 수도 있다.

준비

concept.md 가 있어야 한다. 없으면 /bgs-concept 를 먼저 안내한다.

조사는 bgs-researcher 서브에이전트에게 맡긴다. 직접 CLI를 돌리지 않는다. 검색 결과 원본이 이 대화의 컨텍스트를 잡아먹으면 정작 설계 판단에 쓸 자리가 없어진다.

문서는 studio.config.jsonlanguage 로 쓴다. 다만 게임 제목과 BGG 메커니즘 이름은 원문 그대로 둔다. 번역하면 BGG에서 다시 찾을 수 없게 된다.

진행

- [ ] 1. 핵심 동사를 메커니즘 후보로 번역한다
- [ ] 2. 유사작을 찾는다
- [ ] 3. 조합의 관습과 빈자리를 본다
- [ ] 4. 후보를 좁힌다
- [ ] 5. research.md 를 쓴다

1. 동사를 메커니즘으로

핵심 동사를 BGG 메커니즘 어휘로 옮긴다. 이 번역은 기계적이지 않으니 후보를 여러 개 내고 사용자에게 확인받는다.

"상대의 다음 기동을 읽고 먼저 자리를 잡는다"라면 후보는 이런 것들이다.

  • 동시 선택과 공개 → Simultaneous Action Selection
  • 미리 정한 순서대로 실행 → Action / Movement Programming
  • 자리를 선점해 막기 → Area Majority, Worker Placement
  • 상대 패를 추론 → Deduction, Hidden Movement

정확한 BGG 철자를 몰라도 된다. 조회 도구가 부분일치로 찾는다.

2. 유사작

bgs-researcher 에게 concept.md 의 무게와 인원을 필터로 넘겨 조회를 맡긴다.

여러 조합을 나눠서 물어본다. 후보 메커니즘을 한 번에 다 넣으면 전부 만족하는 게임이 몇 개 없어서 결과가 빈약해진다. 2개씩 짝지어 여러 번 보는 편이 낫다.

돌아온 목록에서 직접 확인해볼 게임 3~5개를 고른다. 목록 전체를 문서에 옮기는 건 의미가 없다. 이 아이디어와 가장 가까운 것, 가장 성공한 것, 그리고 비슷한 시도를 했다가 평이 나쁜 것을 섞어서 고른다. 마지막 것이 특히 중요하다. 왜 안 됐는지가 가장 값진 정보다.

3. 관습과 빈자리

bgs-researcher 에게 핵심 메커니즘의 조합 통계를 맡긴다.

  • 자주 붙는 조합 — 관습이다. 따르면 설명이 짧아지고, 깨면 룰북이 길어진다
  • 거의 안 붙는 조합 — 빈 니치 후보다. 다만 비어 있는 데 이유가 있을 수 있다. 서로 상충하는지, 아니면 그냥 아무도 안 해본 것인지 판단이 필요하다

여기서 나온 것을 그대로 받아쓰지 않는다. "이 조합은 156개 게임 중 2개뿐"이라는 사실보다 왜 그런지 짚은 추정이 문서에 남아야 쓸모 있다.

4. 좁히기

메커니즘 후보를 2~3개 조합으로 좁힌다. 후보마다 이렇게 정리해서 사용자에게 고르게 한다.

  • 이 조합이 핵심 동사를 어떻게 만들어내는가
  • 가장 가까운 기존 게임과 무엇이 다른가
  • 예상되는 문제 (다운타임, 분석 마비, 인원 확장성)
  • 이 조합을 고르면 무엇을 포기하는가

대신 고르지 않는다. 선택지를 놓고 사용자가 정한다.

5. 문서

projects/<slug>/research.md 를 쓴다. 초안을 보여주고 승인받은 뒤 파일에 쓴다.

# 레퍼런스 조사

조사일: YYYY-MM-DD
기준: concept.md 핵심 동사 "..."

## 참고할 게임

### <이름> (연도) · 무게 · 평점
- 왜 봤나:
- 가져올 것:
- 안 가져올 것:

## 메커니즘 조합 후보

### 안 1: <조합>
- 핵심 동사를 만드는 방식:
- 가장 가까운 기존 게임과의 차이:
- 예상 문제:
- 포기하는 것:

## 조합 통계에서 본 것
- 관습:
- 빈자리와 그 이유 추정:

## 결정
채택: <안 N>
이유:

Read the full file on GitHub · 133 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 133 lines · 78 tokens per session scan A d073195401dc

Subscribe to this mod's changes

bgs-reference is a skill published in the GitHub repository kongsol-83/boardgame-studio (9 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 78 tokens to every session and 1,454 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.