← All agents

The Ghostwriter

Claude drafts your next social post and schedules it straight into Typefully, without you ever opening the app.

Comment GHOST Needs: Typefully key ~5 min install MIT · 57★ Tested 2026-09-05

What it does

The Ghostwriter plugs Claude straight into Typefully, so you give it the idea and it drafts, queues, and schedules the post without you ever switching to the Typefully app. It covers X, LinkedIn, Threads, Bluesky, Mastodon, and Substack Notes, all from the same Typefully account.

The video claim was that this agent writes your next post and schedules it before you have even opened the app. We confirmed that is true. It plugs into Claude as a skill, the CLI it runs on is a single Node script with zero runtime dependencies, and we ran the project's full automated test suite, all 130 tests across 10 files passed.

The one honest caveat: you need your own Typefully account and API key to actually post or schedule anything. Without a key, the CLI does not fail silently or crash, it gives a clean, specific error telling you exactly what to do next, which is a good sign for how the rest of it is built.

Who it is for

This is for anyone already running their social posting through Typefully, a solo creator, a marketer, or a small team, who wants Claude to draft and queue the post directly instead of writing it in Claude, copying it, opening Typefully, and pasting it in by hand. It removes that copy-paste step entirely.

Before you start

Install

Step 1: Get the code

Downloads the project onto your machine.

git clone https://github.com/typefully/agent-skills.git

Step 2: Install the dependencies

Installs the packages the project needs to run its test suite.

cd agent-skills && npm install

Step 3: Run the test suite

Runs the project's full set of automated checks, so you can see it actually works before trusting it with your account.

npm test

Step 4: Create a free account at Typefully

Typefully is where the posts actually get drafted, queued, and published. Grab your API key from the API settings page once you're signed in.

Step 5: Connect your Typefully key

Saves your API key locally so Claude can use it on your behalf. Note: the project's own README tells you to run ./scripts/typefully.js setup, that path is wrong for how the repo is actually laid out, use the path below instead.

node skills/typefully/scripts/typefully.js setup

Run it

We ran the test suite, then ran the CLI itself with no key configured yet, to check it fails cleanly instead of crashing.

$ npm test
 Test Files  10 passed (10)
      Tests  130 passed (130)

$ node skills/typefully/scripts/typefully.js social-sets:list
{
  "error": "API key not found. Run 'typefully.js setup' to configure your API key. Get your key at https://typefully.com/?settings=api",
  "action": "Run: typefully.js setup"
}

That second block is exactly what you will see before you have connected your own key, and exactly what goes away once you run setup.

Troubleshooting

"API key not found, run setup" appears every time you use a command. You have not connected your Typefully key yet. Run node skills/typefully/scripts/typefully.js setup, or set it as an environment variable named TYPEFULLY_API_KEY.

Following the README's own install line fails with a "no such file" error. The README says to run ./scripts/typefully.js, but in this repo layout the real path is skills/typefully/scripts/typefully.js. Use the real path.

"social_set_id is required" when listing or creating drafts. You have more than one social account connected in Typefully and none set as default. Run social-sets:list to see your options, then set a default during setup, or pass --social-set-id on the command directly.

"Node.js is required" or the script won't run at all. Your Node.js version is too old. Install Node 20 or newer and try again.

Credit

Built by typefully (https://github.com/typefully/agent-skills), MIT license, 57 stars at test time. One correction to the repo's own docs: the README's setup instructions point to ./scripts/typefully.js, but the actual script in this repo lives at skills/typefully/scripts/typefully.js, use that path.

If you're already posting through Typefully by hand, this is the step you get to stop doing yourself.
Next step

Want to build your own?

This is one agent. The 7-Day AI Native Challenge is how you learn to build the next ten yourself, live, with Dany.

Join the Challenge →
Or skip straight to done for you

Too busy to build it yourself? Focentra AI will build, install and train your team on it. Priced on the call.

Talk to Focentra AI

Download the PDF version

This guide includes affiliate links for tools mentioned in the setup steps. If you sign up through them, I may earn a commission at no extra cost to you.