{"id":49157006,"url":"https://github.com/typefully/agent-skills","last_synced_at":"2026-05-08T17:01:10.206Z","repository":{"id":334918540,"uuid":"1142570972","full_name":"typefully/agent-skills","owner":"typefully","description":"AI agent skills for drafting and scheduling social media posts via Typefully","archived":false,"fork":false,"pushed_at":"2026-05-01T11:51:06.000Z","size":117,"stargazers_count":48,"open_issues_count":7,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-01T13:27:06.450Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/typefully.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-26T15:28:42.000Z","updated_at":"2026-05-01T11:51:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/typefully/agent-skills","commit_stats":null,"previous_names":["typefully/agent-skills"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/typefully/agent-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/typefully%2Fagent-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/typefully%2Fagent-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/typefully%2Fagent-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/typefully%2Fagent-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/typefully","download_url":"https://codeload.github.com/typefully/agent-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/typefully%2Fagent-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32789370,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"ssl_error","status_checked_at":"2026-05-08T08:22:45.650Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-22T10:00:23.578Z","updated_at":"2026-05-08T17:01:10.145Z","avatar_url":"https://github.com/typefully.png","language":"JavaScript","funding_links":[],"categories":["Productivity \u0026 Workflow"],"sub_categories":[],"readme":"# Typefully Skills\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Version](https://img.shields.io/badge/version-1.0.0-green.svg)]()\n[![Typefully API](https://img.shields.io/badge/Typefully-API-3B9AF8)](https://typefully.com/docs/api)\n\nAI agent skills for drafting, scheduling, and managing social media posts across X, LinkedIn, Threads, Bluesky, and Mastodon. Give your AI agent the ability to manage your social media scheduling directly from your IDE or terminal.\n\nBuilt on the [Typefully API](https://typefully.com/docs/api). [Typefully](https://typefully.com) is a writing and scheduling app used by 200k+ top creators and teams to grow on X, LinkedIn, Threads, and Bluesky.\n\n## What Are Skills?\n\nSkills are markdown files that give AI agents specialized knowledge and workflows for specific tasks. Add this to your project and your AI agent will be able to create, schedule, and publish social media content.\n\n## Setup\n\n### 1. Install the skill\n\n**CLI** (works with Claude Code, Cursor, Windsurf, and many other agents):\n\n```bash\nnpx skills add typefully/agent-skills\n```\n\n\u003cdetails\u003e\n\u003csummary\u003eOther installation methods\u003c/summary\u003e\n\n**Claude Code Plugin:**\n\n```\n/plugin marketplace add typefully/agent-skills\n```\n\nThen:\n\n```\n/plugin install typefully@typefully-skills\n```\n\n**Cursor:**\n\n1. Open Settings (Cmd+Shift+J)\n2. Go to \"Rules \u0026 Command\" → \"Project Rules\"\n3. Click \"Add Rule\" → \"Remote Rule (GitHub)\"\n4. Enter: `https://github.com/typefully/agent-skills.git`\n\n**Manual:**\n\nClone this repository and copy `skills/typefully/` to your project's `.cursor/skills/` or `.claude/skills/` directory.\n\n\u003c/details\u003e\n\n### 2. Copy your API Key\n\nYou'll need a Typefully API key for the setup command. Copy an existing key or create a new one at https://typefully.com/?settings=api\n\n### 3. Run the setup command\n\nThis configures your API key and default social set:\n\n```bash\n./scripts/typefully.js setup\n```\n\n\u003e [!TIP]\n\u003e The path depends on how you installed the skill, but you can ask your agent \"Help me set up the Typefully skill\" to get the correct path.\n\u003e\n\u003e You can also set the API key as an environment variable instead: `export TYPEFULLY_API_KEY=your_key_here`\n\n### 4. Start using it\n\nAsk your AI agent things like:\n\n- \"Draft a tweet about [topic]\"\n- \"Create a LinkedIn post announcing [news]\"\n- \"Schedule my draft for tomorrow morning\"\n- \"Show my scheduled posts\"\n- \"Create a thread about [topic]\"\n- \"Post this to X and LinkedIn\"\n\n## Local Development\n\nTo test this skill locally, install it from the repo root:\n\n```bash\nnpx skills add .\n```\n\nThen test it in your agent to verify the latest local changes behave as expected.\n\n## Supported Platforms\n\n- X (formerly Twitter)\n- LinkedIn\n- Threads\n- Bluesky\n- Mastodon\n\n## Troubleshooting\n\n### \"TYPEFULLY_API_KEY environment variable is not set\"\n\nRun the setup command:\n\n```bash\n./scripts/typefully.js setup\n```\n\nOr set the environment variable manually:\n\n```bash\nexport TYPEFULLY_API_KEY=your_key_here\n```\n\nTo persist the environment variable across sessions, add it to your shell profile (`~/.bashrc`, `~/.zshrc`, etc.).\n\n### \"Node.js is required\"\n\nThe CLI is a zero-dependency Node.js script and requires Node.js 18+ (for built-in `fetch`).\nInstall a recent Node.js version, then retry your command.\n\n### API errors (401, 403)\n\n- Verify your API key is correct\n- Check that your key has the required permissions at https://typefully.com/?settings=api\n\n### Drafts not appearing\n\n- Make sure you're using the correct `social_set_id` (run `./scripts/typefully.js social-sets:list` to list them)\n- Check the draft status with `./scripts/typefully.js drafts:list \u003csocial_set_id\u003e`\n\n## Alternative: MCP Server\n\nFor deeper integration with Claude Code, you can also use the Typefully MCP Server which provides native tool access:\n\nhttps://support.typefully.com/en/articles/13128440-typefully-mcp-server\n\n## Links\n\n- [Typefully](https://typefully.com)\n- [API Documentation](https://typefully.com/docs/api)\n- [Skills Leaderboard](https://skills.sh)\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftypefully%2Fagent-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftypefully%2Fagent-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftypefully%2Fagent-skills/lists"}