Agent skill

Brief Generation

by grandamenium in grandamenium/cortextos

Generate source-backed markdown briefs and run summaries for selected research signals.

MITAuto-check passed

Install Brief Generation

skills CLI
$ npx skills add grandamenium/cortextos --skill brief-generation -a claude-code

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

GitHub CLI
$ gh skill install grandamenium/cortextos brief-generation --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/grandamenium/cortextos.git skills-src && mkdir -p .claude/skills && cp -r skills-src/community/agents/research-agent/.claude/skills/brief-generation .claude/skills/brief-generation && 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
brief-generation
GitHub stars
101
Token cost
~880 tokens
SKILL.md length
163 words
Files
1
Skills in repo
55
Repo updated
First seen
Licence
MIT

At a glance

Generate source-backed markdown briefs and run summaries for selected research signals.

  • SKILL.md covers When to Use, Input, Output and Brief Format, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Brief Generation is an agent skill from grandamenium/cortextos. Generate source-backed markdown briefs and run summaries for selected research signals.

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

The licence is MIT.

Example prompts

  • “/brief-generation”

What it can do on your machine

Read from SKILL.md and the folder at commit 6f93838. 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 markdown).

    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

Brief Generation loads about 880 tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 163 words of instructions outside code blocks.

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

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 grandamenium/cortextos at commit 6f93838, republished under its MIT licence (© grandamenium). 163 words, ~880 tokens.

Download SKILL.mdSave it as .claude/skills/brief-generation/SKILL.md (or your agent's skills folder).
name
brief-generation
description
Generate source-backed markdown briefs and run summaries for selected research signals.

Brief Generation

Write a structured markdown brief for each selected signal.


When to Use

After signal-scoring selects the top N items.


Input

  • research/output/YYYY-MM-DD/signals-selected.json
  • config.json (for voice, audience, output folder)

Output

  • research/output/YYYY-MM-DD/briefs/SLUG.md (one file per selected signal)
  • research/output/YYYY-MM-DD/summary.md (run summary across all briefs)

Brief Format

Each brief file follows this structure:

markdown
# [TITLE]

**Date:** YYYY-MM-DD
**Source:** [source_name] -- [url]
**Author/Channel/Repo:** [author]
**Category:** [category] | [funnel_stage] | [output_type]
**Score:** [score]/10

---

## Executive Summary

2-3 sentences. What is this? Why does it matter right now?

---

## Evidence and Proof Points

- Specific facts, numbers, dates, quotes from the source
- Raw metrics: stars, views, engagement, score
- Growth signals if applicable

---

## Technical Details

What is technically happening here? Relevant for builders and technical audiences.
(Skip or condense for non-technical signals.)

---

## Why It Matters

1-3 concrete reasons this is worth paying attention to.
Tied to the configured target audience and niche.

---

## Content Angles

- [Angle 1]: one sentence describing the hook or frame
- [Angle 2]: ...
- [Angle 3]: ...

Include at least 2, up to 5.

---

## Suggested Hooks

> "Quote or opening line that could start a piece of content"
> "Alternative hook"

---

## Recommended Action

One of: create content, investigate further, share internally, monitor, no action needed.
One sentence explaining why.

---

## Confidence and Freshness

- **Confidence:** high / medium / low (based on source quality and completeness of data)
- **Freshness:** [published_at] -- [N days old]
- **Shelf life:** [urgency score interpretation: breaking / 24h / 1 week / evergreen]

Writing Rules

  • Lead with the finding, not the process.
  • Use the voice and audience defined in config (e.g. "technical founders building with AI" vs "content creators").
  • Proof points must come from the source. Do not add claims not supported by the fetched data.
  • Content angles must be specific. "Here's a content angle" is not a content angle. "The security incident shows that centralizing OAuth tokens at a vendor is an architectural liability -- frame as why to own your credential layer" is a content angle.
  • If a brief cannot be written with enough evidence (source returned only a title), mark confidence as low and note what additional research is needed.

Run Summary Format

research/output/YYYY-MM-DD/summary.md:

markdown
# Research Run Summary -- YYYY-MM-DD HH:MM UTC

**Sources checked:** N
**Items collected:** N
**Items after dedup:** N
**Items scored:** N
**Items selected:** N (threshold: X, top_n: Y)
**Source failures:** list any

---

## Selected Signals

| # | Title | Score | Category | Output Type | Brief |
|---|-------|-------|----------|-------------|-------|
| 1 | [title] | 8.2 | [cat] | short_form_video | [briefs/slug.md] |
| 2 | ... | | | | |

---

## Source Performance

| Source | Items | Status |
|--------|-------|--------|
| github_trending | 25 | ok |
| reddit/r/community | 10 | ok |
| youtube_rss/channel | 0 | timeout |

---

## Delivery Status

[pending approval / sent to DESTINATION at HH:MM / disabled]

© grandamenium, MIT. 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 community/agents/research-agent/.claude/skills/brief-generation of grandamenium/cortextos.

Open the folder on GitHubat commit 6f93838

Compare with similar skills

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

Brief Generation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Brief Generation this skillgrandamenium/cortextos101—~880Automated safety check: PassMIT
Briefalirezarezvani/claude-skills28k—~967Automated safety check: PassMIT
Briefdavepoon/buildwithclaude3.6k—~1.3kAutomated safety check: NotesMIT
Select Namethedaviddias/Front-End-Checklist74k—~451Automated safety check: PassMIT
Engine Selectionsickn33/agentic-awesome-skills47k1 repos~1.2kAutomated safety check: PassMIT
Speak Summarygithub/awesome-copilot40k—~1.6kAutomated safety check: PassMIT

Similar skills

  • Brief

    alirezarezvani/claude-skills

    /cs:brief <topic — Generate a one-page strategy brief from an office-hours intake.

    28k GitHub stars~967 tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Brief

    davepoon/buildwithclaude

    Session-start briefing from Origin. An agent skill from davepoon/buildwithclaude.

    3.6k GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check: notes
  • Select Name

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Provide accessible names for select elements.

    74k GitHub stars~451 tokensUpdated 4 days ago
    Frontend & DesignAuto-check passed
  • Engine Selection

    sickn33/agentic-awesome-skills

    Selects game engines and frameworks by platform, genre, and architecture (full canvas shell vs hybrid DOM shell + guest viewport).

    47k GitHub starsUsed in 1 repo~1.2k tokens
    Game DevelopmentAuto-check passed
  • Speak Summary

    github/awesome-copilot

    Official

    Convert text, markdown, or a summary produced by another skill into a listenable MP3 using local CPU-only neural text-to-speech.

    40k GitHub stars~1.6k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • Deal Team Summary

    anthropics/claude-for-legal

    Official

    Aggregate diligence findings into a deal team briefing at the right altitude for the audience — exec summary for leadership, working summary for the team.

    9.6k GitHub starsUsed in 3 repos~1.3k tokens
    Business, Finance & HRAuto-check passed

More from grandamenium/cortextos

All 55 skills in this repo
  • Cortext Self Diagnosis

    grandamenium/cortextos

    Diagnose cortextOS itself when the framework misbehaves — an agent has gone silent or wedged, agents are crash-looping, Telegram or agent-to-agent messages are not arriving, crons did not fire, an…

    101 GitHub stars~3.7k tokensUpdated 18 days ago
    Auto-check passed
  • Activity Channel

    grandamenium/cortextos

    You have completed something significant and want the whole org — all agents and the user — to know about it.

    101 GitHub stars~624 tokensUpdated 18 days ago
    Auto-check passed
  • Agentcard Purchase

    grandamenium/cortextos

    You need to make a purchase on behalf of the user — buy a SaaS subscription, pay for an API, purchase a domain, or any transaction requiring a credit card.

    101 GitHub stars~1.1k tokensUpdated 18 days ago
    Auto-check passed
  • Claude To Codex Migration

    grandamenium/cortextos

    Migrate ANY cortextOS agent from the claude-code runtime to the live codex-app-server runtime.

    101 GitHub stars~12k tokensUpdated 18 days ago
    Auto-check: warnings
  • Bus Reference

    grandamenium/cortextos

    Complete cortextos bus CLI reference - all available commands with examples.

    101 GitHub stars~3.8k tokensUpdated 18 days ago
    Auto-check passed
  • Business News Monitor

    grandamenium/cortextos

    Daily cron-driven scan of news/forums/social in a domain to surface market shifts, new competitors, regulatory changes, and net-new opportunities.

    101 GitHub stars~1.3k tokensUpdated 18 days ago
    Auto-check passed

Questions about Brief Generation

What does Brief Generation do?

Generate source-backed markdown briefs and run summaries for selected research signals. Brief Generation is an agent skill from grandamenium/cortextos. Generate source-backed markdown briefs and run summaries for selected research signals.

How do I install Brief Generation in Claude Code?

Run `npx skills add grandamenium/cortextos --skill brief-generation -a claude-code`. Or copy the skill folder (community/agents/research-agent/.claude/skills/brief-generation in grandamenium/cortextos) into .claude/skills/brief-generation in your project. Claude Code loads it when a task matches its description.

How do I install Brief Generation in Codex?

Run `npx skills add grandamenium/cortextos --skill brief-generation -a codex`. Or copy the skill folder (community/agents/research-agent/.claude/skills/brief-generation in grandamenium/cortextos) into .agents/skills/brief-generation in your project. Codex loads it when a task matches its description.

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

What does Brief Generation need to run?

SKILL.md names no scripts, command-line tools or credentials: Brief Generation is instructions for the agent only.

Does Brief Generation 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 Brief Generation 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 Brief Generation use?

Brief Generation is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Brief Generation use?

About 880 tokens (SKILL.md is roughly 3.5k 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 Brief Generation?

Skills that share tags, products or a category with Brief Generation: Brief (alirezarezvani/claude-skills, 28k stars), Brief (davepoon/buildwithclaude, 3.6k stars), Select Name (thedaviddias/Front-End-Checklist, 74k stars) and Engine Selection (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Brief Generation?

grandamenium (a GitHub user) maintains it in grandamenium/cortextos, which has 101 GitHub stars. The repository holds 55 skills in this directory. The repository was last updated on September 23, 2026.

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