gitwtfhub

wtf is real-agent-workflows?

qianquandong/real-agent-workflows — explained in plain English

Analysis updated 2026-05-18

1Audience · generalComplexity · 2/5LicenseSetup · easy

TL;DR

A collection of real, running AI automation playbooks, shared one workflow at a time as plain markdown SKILL.md files that work with any AI agent tool, not just one product.

Mindmap

mindmap
  root((repo))
    What it does
      Shares real workflows
      Plain markdown playbooks
      Tool agnostic instructions
    Tech stack
      Markdown
      Obsidian
      Any AI agent
    Use cases
      News briefings
      Morning cockpit
      Email triage
    Audience
      Content creators
      Obsidian users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Turn a day of AI news into a categorized briefing inside your Obsidian vault automatically

REASON 2

Get one morning briefing that combines several news sources with your triaged email inbox

REASON 3

Harvest and filter saved social media posts into searchable knowledge cards

REASON 4

Copy a single SKILL.md playbook into your own AI agent and adapt it instead of starting from scratch

What's in the stack?

MarkdownObsidian

How it stacks up

qianquandong/real-agent-workflows0xkinno/neuralvault0xlocker/d17-contracts
Stars111
LanguageTypeScriptSolidity
Setup difficultyeasyhardhard
Complexity2/54/55/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Most workflow docs are in Chinese, and several depend on extra tools like browser control, yt-dlp, or an email connector.

You can use, modify, and distribute this software freely, including for commercial purposes, as long as you keep the copyright notice.

Wtf does this do

Real Agent Workflows is a collection of AI automation setups that the author actually runs on their own computer, shared one at a time rather than presented as a single polished product. Each folder in the repository is a complete workflow: what triggers it, the steps it takes, and what it produces, written up as a plain markdown playbook called SKILL.md. The author is explicit that this is a guide, not a plugin, and that it is not tied to any particular AI tool, capability names like web search or browser control in the instructions are meant to be mapped to whatever equivalent tool your own AI assistant provides. The repository draws a distinction between a skill, a single capability used on demand, and a workflow, the full chain of trigger, steps, and output that runs itself on a schedule or event. Six workflows are marked ready today, covering things like turning the last day of AI related news into a categorized briefing inside an Obsidian notes vault, pulling several news sources plus an email inbox into one page you can approve with checkboxes each morning, harvesting and filtering saved social media posts into knowledge cards, filing any pasted link as a summarized note, drafting a short video script from a topic in your notes, and triaging a day's email into an action required or for your information list. Many more workflows, covering things like website building, search engine optimization, and video editing, are listed as still in progress. To use a workflow, you copy its SKILL.md file into your own AI agent's skills folder, run it once by hand to check the result, then put it on a recurring schedule if it is useful. The author suggests trying just one workflow closest to your actual work for a couple of weeks before deciding whether to keep it. Most of the individual workflow documentation is currently written in Chinese, though the top level repository itself is bilingual. The project is released under the MIT license.

Yoink these prompts

Prompt 1
Copy the obsidian-morning-cockpit SKILL.md into my agent and set it up for my own news sources
Prompt 2
Adapt the email-triage workflow's SKILL.md to label my inbox as Action Required, FYI, or spam
Prompt 3
Explain how the obsidian-favorites-harvest workflow filters out pure entertainment before making knowledge cards
Prompt 4
Help me schedule the obsidian-ai-news-input workflow to run daily using my own agent's scheduler

Frequently asked questions

wtf is real-agent-workflows?

A collection of real, running AI automation playbooks, shared one workflow at a time as plain markdown SKILL.md files that work with any AI agent tool, not just one product.

What license does real-agent-workflows use?

You can use, modify, and distribute this software freely, including for commercial purposes, as long as you keep the copyright notice.

How hard is real-agent-workflows to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is real-agent-workflows for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.