End-to-end workflow: research a topic and then write a LinkedIn post about it.

MITAuto-check passedWriting & Content

Install Research And Write

skills CLI
$ npx skills add iusztinpaul/designing-real-world-ai-agents-workshop --skill research-and-write -a claude-code

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

GitHub CLI
$ gh skill install iusztinpaul/designing-real-world-ai-agents-workshop research-and-write --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/iusztinpaul/designing-real-world-ai-agents-workshop.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/research-and-write .claude/skills/research-and-write && 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
research-and-write
GitHub stars
512
Token cost
~660 tokens
SKILL.md length
247 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

End-to-end workflow: research a topic and then write a LinkedIn post about it.

  • Works in 2 steps: Research → Write
  • The user wants the full pipeline — from a topic idea to a finished LinkedIn post
  • SKILL.md covers Input Preparation, Working Directory, Execution and After Completion
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Research And Write is an agent skill from iusztinpaul/designing-real-world-ai-agents-workshop. End-to-end workflow: research a topic and then write a LinkedIn post about it. Use this skill whenever the user wants the full pipeline — from a topic idea to a finished LinkedIn post. Triggers on: 'research and write a post about', 'create a LinkedIn post about [topic]', 'I want to post about', 'write about [topic] for LinkedIn', or any request that implies both researching a subject and producing a LinkedIn post from it. This is the go-to skill when the user gives you a topic and expects a finished post.

Its SKILL.md is about 660 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 Writing & Content, covering Social media posts. It works with LinkedIn. The repository describes itself as: Hands-on workshop: Build a multi-agent AI system from scratch — Deep Research Agent + Writing Workflow served as MCP servers. Includes code, slides, and video. The licence is MIT.

When your agent uses it

  • The user wants the full pipeline — from a topic idea to a finished LinkedIn post
  • : research and write a post about
  • Create a LinkedIn post about [topic]
  • I want to post about

Example prompts

  • “research and write a post about”
  • “create a LinkedIn post about [topic]”
  • “I want to post about”
  • “/research-and-write”

Workflow steps

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

  1. Research
  2. Write

What it can do on your machine

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

Research And Write loads about 660 tokens when it runs. Until then it costs about 133 tokens; SKILL.md has 247 words of instructions outside code blocks.

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

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 iusztinpaul/designing-real-world-ai-agents-workshop at commit ea4f6e9, republished under its MIT licence (© iusztinpaul). 247 words, ~660 tokens.

Download SKILL.mdSave it as .claude/skills/research-and-write/SKILL.md (or your agent's skills folder).
name
research-and-write
description
End-to-end workflow: research a topic and then write a LinkedIn post about it. Use this skill whenever the user wants the full pipeline — from a topic idea to a finished LinkedIn post. Triggers on: 'research and write a post about', 'create a LinkedIn post about [topic]', 'I want to post about', 'write about [topic] for LinkedIn', or any request that implies both researching a subject and producing a LinkedIn post from it. This is the go-to skill when the user gives you a topic and expects a finished post.

Research and Write

End-to-end workflow: research a topic, then write a LinkedIn post from it. Chains the deep-research and linkedin-writer MCP servers.

Input Preparation

Gather from the user:

  1. Topic — what to research
  2. Guideline — how the post should be written (becomes guideline.md)

If the user only gives a topic, ask for the guideline details (angle, audience, key points, tone) or suggest a default based on the topic.

Working Directory

All output goes into outputs/{slug}/ relative to the project root. Derive the slug from:

  • The dataset seed/guideline filename if the user references one (e.g., my-topic_seed.md → my-topic)
  • Otherwise, slugify the topic (lowercase, hyphens, no special chars, max 60 chars)

Create the directory if it doesn't exist.

Create guideline.md in the working directory:

markdown
# LinkedIn Post Guideline

## Topic
[Core topic]

## Angle
[Perspective]

## Target Audience
[Who reads this]

## Key Points to Cover
[3-5 bullets]

## Tone
[How it should sound]

Execution

Phase 1: Research

Load the research_workflow MCP prompt from the deep-research server and follow the workflow instructions using the available tools:

  • deep_research — for web research queries
  • analyze_youtube_video — for any YouTube URLs the user provides
  • compile_research — to produce the final research.md

Use outputs/{slug}/ as the working_dir for all tool calls. This produces research.md.

Tell the user when research is complete.

Phase 2: Write

Read the WORKFLOW_INSTRUCTIONS from src/writing/routers/prompts.py and follow those steps exactly, using the linkedin-writer MCP tools. The working directory outputs/{slug}/ already has guideline.md and research.md from Phase 1.

The generate_post tool internally runs 4 evaluator-optimizer iterations (review + edit cycles) to refine the post before producing the final version.

After Completion

Present the final outputs/{slug}/post.md and outputs/{slug}/post_image.png to the user. Offer to edit with feedback.

© iusztinpaul, 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 .agents/skills/research-and-write of iusztinpaul/designing-real-world-ai-agents-workshop.

Open the folder on GitHubat commit ea4f6e9

Compare with similar skills

Research And Write 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.

Research And Write compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Research And Write this skilliusztinpaul/designing-real-world-ai-agents-workshop512—~660Automated safety check: PassMIT
Socialcoreyhaines31/marketingskills54k4 repos~4.5kAutomated safety check: PassMIT
Social Contentfreekmurze/dotfiles1k23 repos~2.1kAutomated safety check: PassNone
Linkedin Marketingsergebulaev/linkedin-skills4.4k1 repos~3.2kAutomated safety check: NotesMIT
Linkedin Content Plannersergebulaev/linkedin-skills4.4k1 repos~2.1kAutomated safety check: PassMIT
Typefullyfreekmurze/dotfiles1k1 repos~3.4kAutomated safety check: NotesNone

Similar skills

  • Social

    coreyhaines31/marketingskills

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, or Facebook, or wants to do social listening and engagement triage.

    54k GitHub starsUsed in 4 repos~4.5k tokens
    Writing & ContentAuto-check passed
  • Social Content

    freekmurze/dotfiles

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms.

    1k GitHub starsUsed in 23 repos~2.1k tokens
    Writing & ContentAuto-check passed
  • Linkedin Marketing

    sergebulaev/linkedin-skills

    Plan, draft, audit, and publish LinkedIn posts and comments.

    4.4k GitHub starsUsed in 1 repo~3.2k tokens
    Writing & ContentAuto-check: notes
  • Linkedin Content Planner

    sergebulaev/linkedin-skills

    Generate a 7-day LinkedIn content plan from a theme, audience, and pillars.

    4.4k GitHub starsUsed in 1 repo~2.1k tokens
    Writing & ContentAuto-check passed
  • Typefully

    freekmurze/dotfiles

    Create, schedule, and manage social media posts via Typefully.

    1k GitHub starsUsed in 1 repo~3.4k tokens
    Writing & ContentAuto-check: notes
  • Changelog Social Recap

    FlorianBruniaux/claude-code-ultimate-guide

    Turns CHANGELOG.md entries for a release or a week into LinkedIn, Twitter/X, newsletter and Slack posts in French and English.

    6.1k GitHub stars~1.8k tokensUpdated 2 days ago
    Writing & ContentAuto-check: notes

More from iusztinpaul/designing-real-world-ai-agents-workshop

All 23 skills in this repo
  • Building Streamlit Custom Components V2

    iusztinpaul/designing-real-world-ai-agents-workshop

    Builds bidirectional Streamlit Custom Components v2 (CCv2) using st.components.v2.component.

    512 GitHub stars~2.8k tokensUpdated 4 mo ago
    Auto-check passed
  • Building Streamlit Chat UI

    iusztinpaul/designing-real-world-ai-agents-workshop

    Building chat interfaces in Streamlit. An agent skill from iusztinpaul/designing-real-world-ai-agents-workshop.

    512 GitHub stars~1.4k tokensUpdated 4 mo ago
    Auto-check passed
  • Building Streamlit Dashboards

    iusztinpaul/designing-real-world-ai-agents-workshop

    Building dashboards in Streamlit. An agent skill from iusztinpaul/designing-real-world-ai-agents-workshop.

    512 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Building Streamlit Multipage Apps

    iusztinpaul/designing-real-world-ai-agents-workshop

    Building multi-page Streamlit apps. An agent skill from iusztinpaul/designing-real-world-ai-agents-workshop.

    512 GitHub stars~1.6k tokensUpdated 4 mo ago
    Auto-check passed
  • Choosing Streamlit Selection Widgets

    iusztinpaul/designing-real-world-ai-agents-workshop

    Choosing the right Streamlit selection widget. An agent skill from iusztinpaul/designing-real-world-ai-agents-workshop.

    512 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Connecting Streamlit To Snowflake

    iusztinpaul/designing-real-world-ai-agents-workshop

    Connecting Streamlit apps to Snowflake. An agent skill from iusztinpaul/designing-real-world-ai-agents-workshop.

    512 GitHub stars~1.3k tokensUpdated 4 mo ago
    Auto-check passed

Works with

Questions about Research And Write

What does Research And Write do?

End-to-end workflow: research a topic and then write a LinkedIn post about it. Research And Write is an agent skill from iusztinpaul/designing-real-world-ai-agents-workshop. End-to-end workflow: research a topic and then write a LinkedIn post about it.

When should I use Research And Write?

Research And Write fits situations like: the user wants the full pipeline — from a topic idea to a finished LinkedIn post; : research and write a post about; create a LinkedIn post about [topic]; I want to post about.

How do I install Research And Write in Claude Code?

Run `npx skills add iusztinpaul/designing-real-world-ai-agents-workshop --skill research-and-write -a claude-code`. Or copy the skill folder (.agents/skills/research-and-write in iusztinpaul/designing-real-world-ai-agents-workshop) into .claude/skills/research-and-write in your project. Claude Code loads it when a task matches its description.

How do I install Research And Write in Codex?

Run `npx skills add iusztinpaul/designing-real-world-ai-agents-workshop --skill research-and-write -a codex`. Or copy the skill folder (.agents/skills/research-and-write in iusztinpaul/designing-real-world-ai-agents-workshop) into .agents/skills/research-and-write in your project. Codex loads it when a task matches its description.

Can I use Research And Write 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 iusztinpaul/designing-real-world-ai-agents-workshop --skill research-and-write -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/research-and-write, .gemini/skills/research-and-write, .github/skills/research-and-write and .opencode/skills/research-and-write in your project.

What does Research And Write need to run?

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

Does Research And Write 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 Research And Write 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 Research And Write use?

Research And Write 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 Research And Write use?

About 660 tokens (SKILL.md is roughly 2.6k 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 Research And Write?

Skills that share tags, products or a category with Research And Write: Social (coreyhaines31/marketingskills, 54k stars), Social Content (freekmurze/dotfiles, 1k stars), Linkedin Marketing (sergebulaev/linkedin-skills, 4.4k stars) and Linkedin Content Planner (sergebulaev/linkedin-skills, 4.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Research And Write?

iusztinpaul (a GitHub user) maintains it in iusztinpaul/designing-real-world-ai-agents-workshop, which has 512 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on June 3, 2026.

Source: iusztinpaul/designing-real-world-ai-agents-workshop on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.