Agent skill

Candidate Brief

by yc-software in yc-software/recruiting

Generate a quick one-paragraph brief on a candidate by pulling from all available sources.

No licenceAuto-check: notesBusiness, Finance & HR

Install Candidate Brief

skills CLI
$ npx skills add yc-software/recruiting --skill candidate-brief -a claude-code

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

GitHub CLI
$ gh skill install yc-software/recruiting candidate-brief --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/yc-software/recruiting.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/candidate-brief .claude/skills/candidate-brief && 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
candidate-brief
GitHub stars
116
Token cost
~1.1k tokens
SKILL.md length
344 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
None found

At a glance

Generate a quick one-paragraph brief on a candidate by pulling from all available sources.

  • Works in 6 steps: Ashby profile → Ashby application → Ashby notes → …
  • The user asks who is this person
  • SKILL.md covers Unified Resolver, Input, Procedure and Output Format, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Candidate Brief is an agent skill from yc-software/recruiting. Generate a quick one-paragraph brief on a candidate by pulling from all available sources. Replaces opening LinkedIn, Ashby, and email tabs. Use when the user asks "who is this person", "tell me about X", "brief me on X", or is triaging candidates and needs context fast.

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

It sits in Business, Finance & HR. It works with LinkedIn.

When your agent uses it

  • The user asks who is this person
  • Tell me about X
  • Is triaging candidates and needs context fast

Example prompts

  • “who is this person”
  • “tell me about X”
  • “brief me on X”
  • “/candidate-brief”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Read, mcp__ashby__candidate_search, mcp__ashby__candidate_info, mcp__ashby__application_info, mcp__ashby__candidate_list_notes, mcp__google-workspace__gmail_query_emails, mcp__google-workspace__gmail_get_email, mcp__waas__candidate_show, mcp__waas__candidate_status_show, mcp__waas__candidate_notes_list

Workflow steps

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

  1. Ashby profile
  2. Ashby application
  3. Ashby notes
  4. Email thread context
  5. WAAS notes (if short_id available)
  6. LinkedIn URL

What it can do on your machine

Read from SKILL.md and the folder at commit d2d6543. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • mcp__ashby__candidate_search
    • mcp__ashby__candidate_info
    • mcp__ashby__application_info
    • mcp__ashby__candidate_list_notes
    • mcp__google-workspace__gmail_query_emails
    • mcp__google-workspace__gmail_get_email
    • mcp__waas__candidate_show
    • mcp__waas__candidate_status_show

    …and 1 more on the same allowed-tools line.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    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

Candidate Brief loads about 1.1k tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 344 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, mcp__ashby__candidate_search, mcp__ashby__candidate_info, mcp__ashby__application_info, 

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 344 words (~1,055 tokens).

“Generate a quick contextual brief on a candidate so the hiring manager can recall and calibrate without opening 5 tabs.”

— opening of SKILL.md by yc-software
name
candidate-brief
allowed-tools
Bash, Read, mcp__ashby__candidate_search, mcp__ashby__candidate_info, mcp__ashby__application_info, mcp__ashby__candidate_list_notes, mcp__google-workspace__gmail_query_emails, mcp__google-workspace__gmail_get_email, mcp__waas__candidate_show, mcp__waas__candidate_status_show, mcp__waas__candidate_notes_list

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/candidate-brief of yc-software/recruiting.

Open the folder on GitHubat commit d2d6543

Compare with similar skills

Candidate Brief 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.

Candidate Brief compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Candidate Brief this skillyc-software/recruiting116—~1.1kAutomated safety check: NotesNone
Job Hunt Skillyanliudesign/offer-toolkit-skill520—~942Automated safety check: PassMIT
Network Scanproficientlyjobs/proficiently-claude-skills4111 repos~2.6kAutomated safety check: PassNone
Apify Buying Signal Detectionapify/awesome-skills264—~5.1kAutomated safety check: NotesApache-2.0
Outreachandrew-shwetzer/career-ops-plugin-do-not-fork-currently-updating-v2-501—~939Automated safety check: PassMIT
Setupproficientlyjobs/proficiently-claude-skills411—~1.4kAutomated safety check: PassNone

Similar skills

  • Job Hunt Skill

    yanliudesign/offer-toolkit-skill

    批量发现、整理和持续维护求职岗位清单。根据用户的简历、目标方向或种子 JD,搜索 LinkedIn 与公开网页,去重并建立尽量完整的候选池,用证据区分已核验事实和方向性推断,最后生成可搜索、可筛选的单文件 HTML job-hunt-skill 报告。用户说‘帮我批量找岗位’、‘整理职位清单’、‘使用 job-hunt-skill’、‘根据简历搜工作’、‘把这些 LinkedIn…

    520 GitHub stars~942 tokensUpdated 9 days ago
    Business, Finance & HRAuto-check passed
  • Network Scan

    proficientlyjobs/proficiently-claude-skills

    Scan your LinkedIn contacts' companies for matching job openings

    411 GitHub starsUsed in 1 repo~2.6k tokens
    Business, Finance & HRAuto-check passed
  • Apify Buying Signal Detection

    apify/awesome-skills

    Official

    Set up a recurring buying-signal detection pipeline that finds companies showing buying intent across three signal types — job postings (hiring for the persona), fundraising events (recent raises)…

    264 GitHub stars~5.1k tokensUpdated 15 days ago
    Business, Finance & HRAuto-check: notes
  • Outreach

    andrew-shwetzer/career-ops-plugin-do-not-fork-currently-updating-v2-

    Draft personalized outreach messages for LinkedIn connections, hiring managers, or recruiters.

    501 GitHub stars~939 tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Setup

    proficientlyjobs/proficiently-claude-skills

    One-time onboarding - upload resume, set preferences, and do a work history interview

    411 GitHub stars~1.4k tokensUpdated 7 mo ago
    Business, Finance & HRAuto-check passed
  • Company Hiring Intelligence

    tinyfish-io/tinyfish-cookbook

    Reverse-engineer what a company is building by scraping their job postings, careers page, LinkedIn Jobs, and engineering blog using TinyFish web agents.

    2.2k GitHub stars~3.6k tokensUpdated 7 days ago
    Business, Finance & HRAuto-check passed

More from yc-software/recruiting

All 12 skills in this repo
  • Candidate Status

    yc-software/recruiting

    Look up the full status of a recruiting candidate by name. An agent skill from yc-software/recruiting.

    116 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check: notes
  • Inbox Archive

    yc-software/recruiting

    Suggest inbox emails that are "complete" and safe to archive.

    116 GitHub stars~1.2k tokensUpdated 1 mo ago
    Auto-check: notes
  • Outreach

    yc-software/recruiting

    Draft personalized cold outreach to a candidate the hiring manager hasn't contacted yet.

    116 GitHub stars~3k tokensUpdated 1 mo ago
    Auto-check: notes
  • Pipeline

    yc-software/recruiting

    Show the full recruiting pipeline with priority actions at the top.

    116 GitHub stars~2k tokensUpdated 1 mo ago
    Auto-check: notes
  • Reject

    yc-software/recruiting

    Draft a personalized rejection email for a candidate, with tone calibrated to how far they got in the process.

    116 GitHub stars~2.8k tokensUpdated 1 mo ago
    Auto-check: notes
  • Review Applicants

    yc-software/recruiting

    Review all new inbound applicants across Ashby, WAAS, and inbox.

    116 GitHub stars~3.4k tokensUpdated 1 mo ago
    Auto-check: notes

Works with

Questions about Candidate Brief

What does Candidate Brief do?

Generate a quick one-paragraph brief on a candidate by pulling from all available sources. Candidate Brief is an agent skill from yc-software/recruiting. Generate a quick one-paragraph brief on a candidate by pulling from all available sources.

When should I use Candidate Brief?

Candidate Brief fits situations like: the user asks who is this person; tell me about X; is triaging candidates and needs context fast.

How do I install Candidate Brief in Claude Code?

Run `npx skills add yc-software/recruiting --skill candidate-brief -a claude-code`. Or copy the skill folder (.claude/skills/candidate-brief in yc-software/recruiting) into .claude/skills/candidate-brief in your project. Claude Code loads it when a task matches its description.

How do I install Candidate Brief in Codex?

Run `npx skills add yc-software/recruiting --skill candidate-brief -a codex`. Or copy the skill folder (.claude/skills/candidate-brief in yc-software/recruiting) into .agents/skills/candidate-brief in your project. Codex loads it when a task matches its description.

Can I use Candidate Brief 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 yc-software/recruiting --skill candidate-brief -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/candidate-brief, .gemini/skills/candidate-brief, .github/skills/candidate-brief and .opencode/skills/candidate-brief in your project.

What does Candidate Brief need to run?

SKILL.md names no scripts, command-line tools or credentials: Candidate Brief is instructions for the agent only. Its frontmatter pre-approves these tools: Bash, Read, mcp__ashby__candidate_search, mcp__ashby__candidate_info, mcp__ashby__application_info, mcp__ashby__candidate_list_notes, mcp__google-workspace__gmail_query_emails, mcp__google-workspace__gmail_get_email, mcp__waas__candidate_show, mcp__waas__candidate_status_show, mcp__waas__candidate_notes_list.

Does Candidate Brief 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 Candidate Brief safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Candidate Brief use?

No licence was found for Candidate Brief or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Candidate Brief use?

About 1.1k tokens (SKILL.md is roughly 4.2k 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 Candidate Brief?

Skills that share tags, products or a category with Candidate Brief: Job Hunt Skill (yanliudesign/offer-toolkit-skill, 520 stars), Network Scan (proficientlyjobs/proficiently-claude-skills, 411 stars), Apify Buying Signal Detection (apify/awesome-skills, 264 stars) and Outreach (andrew-shwetzer/career-ops-plugin-do-not-fork-currently-updating-v2-, 501 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Candidate Brief?

yc-software (a GitHub organization) maintains it in yc-software/recruiting, which has 116 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on August 23, 2026.

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