Agent Skills are markdown-based instruction packs that teach AI agents how to perform specific tasks.
The Typefully Agent Skill allows your AI agent to interact with Typefully through the Typefully API, so it can create drafts, update posts, manage scheduling, and help automate your content workflow.
What is skills.sh?
skills.sh is an open ecosystem created by Vercel for discovering and installing Agent Skills across different AI agents and developer tools.
Compatible agents and tools
The Typefully Agent Skill works with:
And other agents that support the skills CLI
What you can do with the Typefully Agent Skill
Once installed, your AI agent can help you:
Create drafts in Typefully (including threads and multi-platform drafts)
Update existing drafts
Upload media and attach it to posts
Add or edit tags
Schedule drafts (including "next free slot" scheduling)
View your queue and manage queue schedule
Cross-post to specific platforms or all connected platforms at once
Reply to and quote existing posts
Leave comments on drafts and manage comment threads
View X post analytics and follower growth
Add internal scratchpad notes to drafts
Requirements
A Typefully account
A Typefully API key
Node.js 18+ on your machine (required by the installer)
Keep your API key private. Treat it like a password.
Install the Typefully Agent Skill
Open a terminal. Launch your preferred terminal application.
Run:
npx skills add typefully/agent-skillsFollow the setup prompts
The installer will guide you through setup options, including:
Installing globally or per project
Choosing which AI agents or tools can access the skill
Configuring authentication
Configure your Typefully API Key
During setup, you'll be prompted to provide your Typefully API key.
Create an API key
Open Typefully
Go to Settings → API
Create a new API key
Copy the key
Add the API key
Paste the API key when prompted during installation.
If you installed the skill but need to reconfigure your API key later, you can run the setup command directly:
./scripts/typefully.js setup
Or set it as an environment variable:
export TYPEFULLY_API_KEY=your_key_here
If you encounter an "API key not found" error:
Run the setup command above to reconfigure
Confirm you're using the correct environment
Verify the API key was copied correctly
Example Prompts
Once installed, you can ask your AI agent things like:
"Draft a post about AI productivity in Typefully."
"Turn this into an X thread and a LinkedIn post, then save both as drafts."
"Schedule this post for tomorrow at 9 AM."
"Add the 'Announcement' tag and schedule it to my next free slot."
"Upload this image and attach it to my draft."
"Show my X post analytics for last week."
"What's in my queue for next week?"
Keeping the skill updated
As Typefully adds new features, you may need to update the installed skill.
If you installed via the skills CLI, the most common update command is:
npx skills update
If that doesn't work in your environment, re-installing is also fine:
npx skills add typefully/agent-skills
Troubleshooting
The skill is installed, but my agent can't use it
Try the following:
Re-run the install command
Confirm the skill was enabled for the correct agent or tool
Restart your AI agent or editor
Some clients only refresh installed skills after restarting.
The agent can't find my Typefully API key
Run the setup command:
./scripts/typefully.js setupVerify you installed the skill in the same environment you're currently using
Check whether you installed the skill globally or per project
I'm using Notion AI instead of a coding agent
If you want to use Typefully from Notion AI, you'll usually want to connect Typefully via the Typefully MCP Server instead.
FAQ
Do I need the GitHub repository to install the skill?
No. The recommended install path is the command:
npx skills add typefully/agent-skills
What platforms are supported?
Typefully supports publishing across multiple platforms, including:
X (Twitter)
LinkedIn
Threads
Bluesky
Mastodon