Agent skill

Insights Deck

by flonat in flonat/flonat-research

Archive an exported Claude Code insights HTML report and turn it into a timestamped Beamer presentation usable from either client.

MITAuto-check passedDocuments & Office

Install Insights Deck

skills CLI
$ npx skills add flonat/flonat-research --skill insights-deck -a claude-code

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

GitHub CLI
$ gh skill install flonat/flonat-research insights-deck --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/flonat/flonat-research.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/insights-deck .claude/skills/insights-deck && 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
insights-deck
GitHub stars
145
Token cost
~1.4k tokens
SKILL.md length
598 words
Files
1
Skills in repo
83
Repo updated
First seen
Licence
MIT

At a glance

Archive an exported Claude Code insights HTML report and turn it into a timestamped Beamer presentation usable from either client.

  • Works in 2 steps: Generate & Archive Insights → Build Beamer Deck
  • The insights export is the source artifact for a presentation
  • SKILL.md covers When to Use, Scope, Phase 1 — Generate & Archive… and Phase 2 — Build Beamer Deck, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Insights Deck is an agent skill from flonat/flonat-research. Archive an exported Claude Code insights HTML report and turn it into a timestamped Beamer presentation usable from either client. Use when the insights export is the source artifact for a presentation. Not for a general research talk; use $talk-deck.

Its SKILL.md is about 1.4k 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 Documents & Office, covering LaTeX. The repository describes itself as: Shareable Claude Code + Codex infrastructure for PhD researchers — skills, agents, hooks, and rules for academic workflows. The licence is MIT.

When your agent uses it

  • The insights export is the source artifact for a presentation
  • Tasks that involve LaTeX

Example prompts

  • “/insights-deck”

Requirements

  • Pre-approved tools (allowed-tools): Bash(latexmk*), Bash(pdflatex*), Bash(xelatex*), Bash(mkdir*), Bash(ls*), Bash(cp*), Read, Write, Edit, Glob, Grep, Task

Workflow steps

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

  1. Generate & Archive Insights
  2. Build Beamer Deck

What it can do on your machine

Read from SKILL.md and the folder at commit da27600. 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(latexmk*)
    • Bash(pdflatex*)
    • Bash(xelatex*)
    • Bash(mkdir*)
    • Bash(ls*)
    • Bash(cp*)
    • Read
    • Write
    • Edit
    • Glob

    …and 2 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 (its code samples are bash and latex).

    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

Insights Deck loads about 1.4k tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 598 words of instructions outside code blocks.

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

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 flonat/flonat-research at commit da27600, republished under its MIT licence (© flonat). 598 words, ~1,419 tokens.

Download SKILL.mdSave it as .claude/skills/insights-deck/SKILL.md (or your agent's skills folder).
name
insights-deck
description
Archive an exported Claude Code insights HTML report and turn it into a timestamped Beamer presentation usable from either client. Use when the insights export is the source artifact for a presentation. Not for a general research talk; use $talk-deck.
allowed-tools
Bash(latexmk*), Bash(pdflatex*), Bash(xelatex*), Bash(mkdir*), Bash(ls*), Bash(cp*), Read, Write, Edit, Glob, Grep, Task
argument-hint
(no arguments)

Insights Deck Skill

Archive a Claude Code insights HTML export and generate a Beamer presentation summarising the findings. All outputs go to log/insights/ with date stamps.

When to Use

  • After exporting the built-in Claude Code insights report
  • When you want a shareable deck summarising how you use Claude Code
  • For periodic self-reflection on AI-assisted workflow

Scope

This skill produces two outputs only: an archived HTML report and a Beamer deck. Do NOT use insights suggestions to create plans, rules, CLAUDE.md edits, or other follow-up actions during this skill's execution. If the user wants to act on suggestions, that happens after the deck is delivered — as a separate conversation.


Phase 1 — Generate & Archive Insights

Step 1: Obtain the exported HTML

The insights export is produced by a built-in Claude Code command and cannot be generated by Codex. If no HTML path was provided, tell the user:

Please export the Claude Code insights report, then provide the generated HTML path. I can build the archive and deck from either client.

If an HTML path was supplied, continue directly. Do not require the active client itself to be Claude Code.

Step 2: Locate the generated HTML

After the export completes, find the most recent insights HTML file:

bash
ls -t /tmp/claude-insights-*.html 2>/dev/null | head -1

If not found in /tmp/, check the user's home directory and common download locations. Ask the user for the path if it can't be located automatically.

Step 3: Archive the HTML

Each insights run gets its own date folder:

bash
mkdir -p log/insights/YYYY-MM-DD
cp <source-html> log/insights/YYYY-MM-DD/insights-YYYY-MM-DD-log.html

Use today's date for the timestamp.


Phase 2 — Build Beamer Deck

Step 1: Read and extract findings

Read the archived HTML file (log/insights/YYYY-MM-DD/insights-YYYY-MM-DD-log.html). Extract:

  1. Usage patterns — most-used tools, session frequency, typical session length
  2. Strengths — what's working well in the workflow
  3. Friction points — repeated failures, slow patterns, underused features
  4. Recommendations — suggested improvements
Step 2: Design the deck structure

Apply rhetoric principles from the beamer-deck skill (condensed — no sub-agent reviews needed for an internal deck):

  • Assertion titles — every frame title states a claim, not a label
  • One idea per slide — split if a slide has two ideas
  • Three-act arc:
    • Act I (Tension): Current usage snapshot — what does the data show?
    • Act II (Development): Patterns, strengths, friction points
    • Act III (Resolution): Recommendations and next steps
  • MB/MC balance — vary dense and light slides deliberately
  • Pyramid principle — lead with conclusions, then support
Show full SKILL.md (221 more words)Show less
Step 3: Generate the .tex file

Write to log/insights/YYYY-MM-DD/insights-YYYY-MM-DD-deck.tex with:

  • \documentclass[aspectratio=169,11pt]{beamer}
  • Original inline theme (no default Beamer themes)
  • Professional colour palette:
    latex
    \definecolor{Midnight}{HTML}{1A1A2E}
    \definecolor{DeepBlue}{HTML}{16213E}
    \definecolor{RoyalBlue}{HTML}{0F3460}
    \definecolor{Coral}{HTML}{E94560}
    \definecolor{SoftGray}{HTML}{BDC3C7}
    \definecolor{CloudWhite}{HTML}{FAFBFC}
  • Suggested structure (adapt based on findings):
    1. Title slide — "Claude Code Usage: [Month Year]"
    2. Opening claim — lead with the most striking finding
    3. Usage overview — session count, tool distribution, time patterns
    4. Top strengths (1–2 slides)
    5. Key friction points (1–2 slides)
    6. Recommendations (1–2 slides)
    7. Closing — single actionable takeaway
Step 4: Compile

Install the fail-closed canonical .latexmkrc in the date folder if it is missing by invoking the latex pre-flight, which resolves its bundled canonical artifact. Never reconstruct a shortened recipe. If a file already exists and differs, classify it before migration.

Then compile:

bash
cd log/insights/YYYY-MM-DD && latexmk -pdf insights-YYYY-MM-DD-deck.tex
Step 5: Fix all warnings

Parse out/*.log for overfull/underfull hbox/vbox warnings. Fix every one. Recompile until clean.

The canonical .latexmkrc copies the requested PDF from out/ back to the date folder only after a successful build.


Output

When complete, the date folder should contain:

log/insights/YYYY-MM-DD/
├── insights-YYYY-MM-DD-log.html     # Archived insights HTML
├── insights-YYYY-MM-DD-deck.tex     # Beamer source
├── insights-YYYY-MM-DD-deck.pdf     # Compiled PDF
├── .latexmkrc                       # Canonical build config
└── out/                             # Build artifacts

Each insights-deck run creates a new date folder, keeping the parent log/insights/ clean.


Cross-References

SkillRelationship
beamer-deckFull rhetoric framework and multi-agent review (this skill uses a condensed version)
latexDefault compiler — use for compilation with auto error resolution
latexManual compilation config details, .latexmkrc setup
session-logComplements insights with session-level detail

© flonat, 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 skills/insights-deck of flonat/flonat-research.

Open the folder on GitHubat commit da27600

Compare with similar skills

Insights Deck 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.

Insights Deck compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Insights Deck this skillflonat/flonat-research145—~1.4kAutomated safety check: PassMIT
Research Writingalfonso0512/research-writing-skill4871 repos~818Automated safety check: PassMIT
Paper WritingMLNLP-World/Paper-Writing-Tips4.7k—~630Automated safety check: PassNone
Evomath TaoEvoScientist/EvoSkills4752 repos~3.8kAutomated safety check: PassApache-2.0
Math Modeling to EI Conference Paperjihe520/MathModelAgent6.2k—~688Automated safety check: PassNone
PaperjurySpark-To-Paper-Skills/paperjury1.2k—~5.3kAutomated safety check: PassMIT

Similar skills

  • Research Writing

    alfonso0512/research-writing-skill

    科研论文写作助手,提供 30 个 Prompt 模板覆盖论文写作全流程. An agent skill from alfonso0512/research-writing-skill.

    487 GitHub starsUsed in 1 repo~818 tokens
    Documents & OfficeAuto-check passed
  • Paper Writing

    MLNLP-World/Paper-Writing-Tips

    学术论文写作检查与优化助手。基于 MLNLP-World 社区整理的论文写作技巧,帮助检查和优化学术论文。Use when: (1) 检查论文 LaTeX 格式和排版, (2) 优化公式符号使用, (3) 改进图表设计, (4) 润色英文学术表达, (5) 检查参考文献格式, (6) 投稿前终稿检查, (7) 用户询问论文写作技巧或规范。

    4.7k GitHub stars~630 tokensUpdated 12 days ago
    Documents & OfficeAuto-check passed
  • Evomath Tao

    EvoScientist/EvoSkills

    A skill your agent uses whenever the user submits a non-trivial mathematical claim that needs a rigorous proof or audit.

    475 GitHub starsUsed in 2 repos~3.8k tokens
    Documents & OfficeAuto-check passed
  • Rewrites a math modeling competition paper into an English EI conference submission, using a bundled IEEE LaTeX template, with evidence tracked back to the original paper.

    6.2k GitHub stars~688 tokensUpdated 5 days ago
    Documents & OfficeAuto-check passed
  • Paperjury

    Spark-To-Paper-Skills/paperjury

    Three modes for CS-conference papers (CVPR/ICCV/ECCV vision, ACL/EMNLP/NAACL NLP, ICLR/NeurIPS/ICML/AAAI ML).

    1.2k GitHub stars~5.3k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Compiledeck

    scunning1975/MixtapeTools

    Create and compile beautiful Beamer presentations following the Rhetoric of Decks philosophy.

    470 GitHub starsUsed in 2 repos~3.1k tokens
    Documents & OfficeAuto-check passed

More from flonat/flonat-research

All 83 skills in this repo
  • Latex Posters

    flonat/flonat-research

    Create a large-format academic poster in LaTeX using beamerposter, tikzposter, or baposter.

    145 GitHub stars~1.5k tokensUpdated 9 days ago
    Auto-check: notes
  • Skill Creator

    flonat/flonat-research

    Create, revise, and evaluate reusable AI workflow skills, including trigger-quality tests.

    145 GitHub stars~4.4k tokensUpdated 9 days ago
    Auto-check passed
  • DOCX

    flonat/flonat-research

    Create, read, edit, or convert Microsoft Word documents while preserving professional document structure.

    145 GitHub stars~1.2k tokensUpdated 9 days ago
    Auto-check passed
  • PDF

    flonat/flonat-research

    Read, create, combine, split, rotate, OCR, watermark, secure, or extract content from PDF files.

    145 GitHub stars~488 tokensUpdated 9 days ago
    Auto-check passed
  • Init Project Orchestration

    flonat/flonat-research

    Create or migrate project-level agents, repeatable project workflows, and planning state from one client-neutral contract, then render repository-scoped adapters for both Claude Code and Codex.

    145 GitHub stars~1.6k tokensUpdated 9 days ago
    Auto-check passed
  • Pre Commit Audit

    flonat/flonat-research

    Deliver a fast pre-commit safety scan: file size, anonymity (author / affiliation strings in tex/bib), hardcoded secrets, and invisible-Unicode carriers.

    145 GitHub stars~2.8k tokensUpdated 9 days ago
    Auto-check: notes

Questions about Insights Deck

What does Insights Deck do?

Archive an exported Claude Code insights HTML report and turn it into a timestamped Beamer presentation usable from either client. Insights Deck is an agent skill from flonat/flonat-research. Archive an exported Claude Code insights HTML report and turn it into a timestamped Beamer presentation usable from either client.

When should I use Insights Deck?

Insights Deck fits situations like: the insights export is the source artifact for a presentation; tasks that involve LaTeX.

How do I install Insights Deck in Claude Code?

Run `npx skills add flonat/flonat-research --skill insights-deck -a claude-code`. Or copy the skill folder (skills/insights-deck in flonat/flonat-research) into .claude/skills/insights-deck in your project. Claude Code loads it when a task matches its description.

How do I install Insights Deck in Codex?

Run `npx skills add flonat/flonat-research --skill insights-deck -a codex`. Or copy the skill folder (skills/insights-deck in flonat/flonat-research) into .agents/skills/insights-deck in your project. Codex loads it when a task matches its description.

Can I use Insights Deck 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 flonat/flonat-research --skill insights-deck -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/insights-deck, .gemini/skills/insights-deck, .github/skills/insights-deck and .opencode/skills/insights-deck in your project.

What does Insights Deck need to run?

SKILL.md names no scripts, command-line tools or credentials: Insights Deck is instructions for the agent only. Its frontmatter pre-approves these tools: Bash(latexmk*), Bash(pdflatex*), Bash(xelatex*), Bash(mkdir*), Bash(ls*), Bash(cp*), Read, Write, Edit, Glob, Grep, Task.

Does Insights Deck 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 Insights Deck 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 Insights Deck use?

Insights Deck 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 Insights Deck use?

About 1.4k tokens (SKILL.md is roughly 5.7k 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 Insights Deck?

Skills that share tags, products or a category with Insights Deck: Research Writing (alfonso0512/research-writing-skill, 487 stars), Paper Writing (MLNLP-World/Paper-Writing-Tips, 4.7k stars), Evomath Tao (EvoScientist/EvoSkills, 475 stars) and Math Modeling to EI Conference Paper (jihe520/MathModelAgent, 6.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Insights Deck?

flonat (a GitHub user) maintains it in flonat/flonat-research, which has 145 GitHub stars. The repository holds 83 skills in this directory. The repository was last updated on September 29, 2026.

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