← Back to Skills Marketplace
781
Downloads
0
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install typefully-social-media
Description
Create, schedule, and manage social media posts via Typefully. ALWAYS use this skill when asked to draft, schedule, post, or check tweets, posts, threads, or social media content for Twitter/X, LinkedIn, Threads, Bluesky, or Mastodon.
Usage Guidance
This skill appears to be a legitimate Typefully CLI wrapper, but there are two red flags you should consider before installing or running it:
1) Metadata mismatch: The registry entry does not declare the TYPEFULLY_API_KEY even though the SKILL.md and included script require it. Ask the publisher (or the skill source) to update the metadata to declare TYPEFULLY_API_KEY as a required credential so automated checks and users can see this up front.
2) Endpoint override: The script honors TYPEFULLY_API_BASE (for tests/self-hosting) but this is not documented in setup. If an attacker can set that environment variable, they could redirect API calls (and capture the API key). Before using, verify the skill's source (prefer an official Typefully-published package or GitHub org), inspect the included scripts yourself, and only set TYPEFULLY_API_KEY in a safe environment. If you must test this skill, run it in an isolated environment (container or dedicated test account) and avoid using your primary Typefully account until you are satisfied with the code and metadata.
If you need to proceed: confirm the skill's publisher identity, update metadata to include TYPEFULLY_API_KEY, and ensure TYPEFULLY_API_BASE is not set (or is set only to a trusted value). If you cannot confirm the source, treat it with caution.
Capability Analysis
Type: OpenClaw Skill
Name: typefully-social-media
Version: 0.1.0
The skill bundle is classified as **benign**.
The `SKILL.md` file is exceptionally well-crafted to prevent prompt injection and misuse by the AI agent. It explicitly forbids the agent from searching for API keys in sensitive locations (e.g., macOS Keychain, `.env` files, system folders), constructing complex shell commands to find credentials, or writing notes to local files instead of the designated `--scratchpad` API option. It also includes strong automation guidelines to prevent spamming or unauthorized actions.
The `scripts/typefully.js` script, which is the core logic, uses only built-in Node.js modules and interacts solely with the Typefully API (`api.typefully.com`). It handles API keys and configuration in a secure manner, prioritizing environment variables and offering to integrate local configuration files with `.gitignore` to prevent accidental exposure. Input arguments are parsed and validated, and there are no apparent shell injection vulnerabilities. The `sanitizeFilename` function is a good security practice. A minor functional bug was identified in `cmdMediaUpload` where the `Content-Type` header is explicitly *not* set during S3 uploads, which could lead to incorrect media handling or upload failures, but this is a functional flaw, not indicative of malicious intent or a security vulnerability. There is no evidence of data exfiltration, persistence mechanisms, or other malicious activities.
Capability Assessment
Purpose & Capability
Name/description match the included code and SKILL.md: this is a Typefully CLI/skill for drafting, scheduling, and publishing social posts. However, the registry metadata lists no required environment variables or primary credential, while both SKILL.md and scripts/typefully.js require a TYPEFULLY_API_KEY (or config files). The metadata omission is an inconsistency that could mislead users or automated reviewers.
Instruction Scope
The SKILL.md stays on-topic and explicitly forbids searching the system for credentials. The runtime instructions and the CLI implementation only read: (1) TYPEFULLY_API_KEY env var, (2) ./ .typefully/config.json in the working directory, and (3) ~/.config/typefully/config.json — all reasonable for a CLI that stores API keys. The skill will call the Typefully API endpoint (default) to perform actions. There is no instruction to read unrelated system files or exfiltrate data, but the doc and code do reference other project files (e.g., CLAUDE.md / AGENTS.md) for “project context” which is reasonable but grants the agent discretion to look at repo-local files.
Install Mechanism
There is no install spec (instruction-only installation), and the included script is a zero-dependency Node.js CLI that runs locally. This is a low-risk install model compared with downloading arbitrary archives. The skill will be executed via the provided script (allowed-tools).
Credentials
The skill requires an API key (TYPEFULLY_API_KEY) to function, but the registry metadata does not declare this required environment variable or a primary credential — a mismatch that reduces transparency. Additionally, the script supports overriding the API base via TYPEFULLY_API_BASE (useful for testing/self-hosting) but this override is not documented in the SKILL.md's 'Setup' section; an attacker or misconfiguration could point that to an arbitrary endpoint to intercept the API key. Overall, the environment access requested is reasonable for the stated purpose, but the lack of metadata declaration and the undocumented endpoint override create a proportionality concern.
Persistence & Privilege
The skill does not request permanent presence (always is false) and does not modify other skills or system-wide settings. It reads and writes only its own expected config paths (project-local and user-global Typefully config) which is typical for a CLI tool.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install typefully-social-media - After installation, invoke the skill by name or use
/typefully-social-media - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of the Typefully social media skill for drafting, scheduling, and publishing posts via Typefully's API and CLI.
- Enables drafting, scheduling, and managing posts for X/Twitter, LinkedIn, Threads, Bluesky, and Mastodon from one tool.
- Provides clear setup, configuration, and troubleshooting guidance (including API key priority and error handling).
- Describes workflow for handling multiple social media accounts (“social sets”) and setting defaults.
- Documents common posting actions, multi-platform publishing, and tag usage for content organization.
- Emphasizes best practices for error handling and user prompts.
Metadata
Frequently Asked Questions
What is Typefully?
Create, schedule, and manage social media posts via Typefully. ALWAYS use this skill when asked to draft, schedule, post, or check tweets, posts, threads, or social media content for Twitter/X, LinkedIn, Threads, Bluesky, or Mastodon. It is an AI Agent Skill for Claude Code / OpenClaw, with 781 downloads so far.
How do I install Typefully?
Run "/install typefully-social-media" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Typefully free?
Yes, Typefully is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Typefully support?
Typefully is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Typefully?
It is built and maintained by frankdilo (@frankdilo); the current version is v0.1.0.
More Skills