ai and voice
Why your Claude writing skill doesn't sound like you
·
13 min read
·
By Prateek Singh, founder of VoiceMoat
The short answer
Almost every free writing skill is subtractive. It removes phrasing that reads as machine-written, measured against a general standard, not against you. The best known has over 45,000 stars and a dozen translated forks.
Removing AI tells does not produce your voice. It produces competent anonymous prose. Those are different problems and only one of them is being solved.
Skills that genuinely learn a voice from your own writing do exist, and they sit at 264, 40, 18 and 9 stars. Two orders of magnitude behind the humanizers.
The largest free marketing collection, at nearly 49,000 stars, has no voice-deriving skill at all. Its copywriting skills consume a voice you supply and never build one.
A skill cannot post anything. Not because of a missing permission, but because there is no credential, no session and no authentication anywhere in the format. That absence is the design, not an oversight.
Star counts mislead badly here. The two most-starred skill collections on GitHub contain zero skills between them. They are lists of links.
If you have installed a writing skill and found the output still does not sound like you, the skill is probably working exactly as designed. It just was not designed to do what you wanted.
Subtraction is not the same as voice
There is a whole genre of free Claude skills for writing, and it is dominated by one shape of tool. You give it text, it finds the phrases that read as machine-written, and it takes them out. The canonical one has over 45,000 stars and has been translated into at least seven languages.
These are genuinely useful and we ship one ourselves. But look at what the operation is. It compares your draft against a general standard of what AI writing sounds like, and removes the overlap. Nothing in that process has any information about how you write.
Two different jobs that both get called voice
Subtractive | Additive | |
|---|---|---|
What it does | Removes phrasing that reads as machine-written | Reproduces the way one specific person writes |
What it compares against | A general standard of AI tells | That person's actual published writing |
What you get | Prose that reads as human and anonymous | Prose that reads as yours |
How common | Dozens, one with over 45,000 stars | A handful, the largest at 264 stars |
‼️ The most popular LinkedIn humanizer skill is explicit about this, to its credit. It says it removes tells and only optionally builds a voice profile behind a flag, and it states plainly that it does not attempt to make text pass any AI detector. That is honest engineering. It is also not what most people installing it believe they are getting.
So the honest version of the gap is not that voice skills do not exist. It is that the ones that exist mostly subtract, and the ones that learn your voice have a tiny fraction of the users. If you searched for a writing skill and installed the top result, you almost certainly installed a subtractive one.
Where the additive ones fall short too, ours included
The skills that do try to model a voice split again, and this is the part nobody writes about.
Some ask you to paste in samples and derive a style profile from them. Those are doing the right thing in principle, and they are the small ones: the four we found sit at 264, 40, 18 and 9 stars. Others, and this includes every one of the skills we publish, are hand-authored. A person sat down and wrote instructions describing good writing, and those instructions are the same for every reader.
‼️ That is worth saying plainly about our own work. A hand-authored style skill is a style guide in a folder. Ours are careful, they are specific about structure and rhythm and what to avoid, and they will improve most people's drafts. What they cannot do is know how you write, because nothing in the file has ever seen anything you wrote.
The largest free marketing collection makes the same trade openly. It has nearly 49,000 stars and fifty skills, including copywriting, copy editing and social. Its skills read a brand voice file from your project and use whatever is in it. You supply the voice. The skill never builds one. That is a reasonable design and it puts the hard part back on you.
Which is the real answer to the title. A file cannot learn your voice, because a file does not have your posts. Getting from a style guide to something that sounds like a specific person needs evidence, and evidence means what you have actually published and which of it worked. That is the difference between a skill and a product, and it is why we ship both rather than pretending the files are enough.
A skill cannot post anything, and the reason is not a permission
No Claude skill can publish to LinkedIn or Twitter. On the API surface the sandbox has no network access at all. But even in Claude Code, where a skill has the same network access as any program on your machine, there is no credential, no session and no authentication mechanism anywhere in the skill format. The missing network is a per-surface detail. The missing identity is the design.
This is the most common confusion in the topic and it is worth getting exactly right, because the sloppy version is wrong in both directions.
On the Claude API, skills run in a sandbox with, in Anthropic's words, no network access and no runtime package installation.
On claude.ai, network access varies with a setting. The default permits package registries only, and a reader would have to deliberately open egress to a specific domain.
In Claude Code, a skill has full network access, the same as any other program on your computer. A script bundled in the folder could in principle reach anything you could.
And it still cannot post, because there is no place in the format to put a credential, no auth negotiation, and Anthropic explicitly tells authors not to hardcode secrets and to use a connector for external services instead.
The distinction that resolves it: a connector is the wire, and a skill is the instruction sheet taped next to it. Unplug the wire and the instruction sheet is still a perfectly good instruction sheet. It just does not carry current. If you want Claude to actually publish, you need a connector, which we covered in can Claude post to LinkedIn.
Anthropic's own recommendation for anyone building in this space is to do both, in that order: a remote connector with proper authentication first, then a plugin of skills that helps people use it well. It notes that most partners ship both.
The one mechanical fact that explains everything else
When a skill matches what you asked for, Claude opens the file and reads it, using a shell command. That is the whole mechanism. Only the name and description are loaded up front, at roughly a hundred tokens each, and the body arrives only when triggered.
Every confusing thing about skills follows from that one sentence.
Why code execution must be switched on even for a skill that is pure prose. Without a filesystem and a shell, there is nothing to read the file with. The setting is not there so your skill can run Python. It is there so Claude can open your markdown.
Why skills do not sync between surfaces. They are files in a location, and the locations are different.
Why a skill has no permissions of its own. It borrows whatever access Claude already has. That is also why Anthropic treats a malicious skill as a serious risk rather than a nuisance.
Why you can install a lot of them cheaply. Until one is triggered it costs you a name and a description.
Where the file actually goes
Since this is the question people arrive with, here it is in one table. Read the date on this: paths change, and several guides still publish ones that have moved.
Verified against vendor documentation on 9 September 2026
Surface | Where the skill goes |
|---|---|
Claude Code, just you | A skills folder inside your home .claude directory, one folder per skill, each with a SKILL.md at its root |
Claude Code, one project | The same shape inside the project's .claude directory |
Claude Code, from a plugin | A skills folder inside the plugin, invoked with the plugin name and skill name together |
claude.ai and Claude Desktop | Not on disk at all. A ZIP upload under Customize, then Skills. The skill folder must be at the root of the ZIP, not nested inside another folder |
Cowork | The same account-level skills as claude.ai |
Codex and Cursor | Their own agents and skills directories, and Cursor also reads the Claude and Codex locations for compatibility |
Two traps in that upload flow are worth knowing before you hit them. Extra frontmatter fields are a hard error rather than an ignored value, so a skill written with Claude Code specific fields in its header will fail to upload rather than degrade gracefully. And the words claude and anthropic are rejected in a skill's name by Anthropic's validator, though the open specification permits them.
There is also a live contradiction in Anthropic's own documentation that you should test rather than trust. The claude.ai help page gives the description field a maximum of 200 characters. The platform documentation gives the same field 1,024. Both were live on 9 September 2026. If you are writing a skill for upload, the safe move is to stay under 200 until you have proved otherwise with a real upload.
Star counts are actively misleading here
If you are picking skills by popularity, one thing will waste your afternoon. The two most-starred skill collections on GitHub contain no skills. One advertises more than a thousand agent skills and has over 33,000 stars; the other has over 15,000. Both are lists of links to other repositories. Clone either expecting files to drop into your skills folder and you get a README.
The directories are not much better as a signal. One claims to index over two million skills, which is a count of folders a crawler matched rather than things worth installing. Another lists tens of thousands of skills alongside thousands of connectors on the same ranked surface, which is precisely how a reader ends up installing a server when they meant to install a file.
There is no app store for this. Anthropic's own directory is partner-shaped with no published submission route for skills, and the routes that are open to anyone are a plain repository or a plugin marketplace, which by Anthropic's own documentation has no approval or review process at all.
Which means you should read one before you install it
A skill is instructions that Claude will follow. Installing one from a stranger is closer to running a stranger's shell script than to reading a stranger's blog post, and Anthropic says so directly, advising people to treat it like installing software and to use skills only from sources they trust.
The one large study we could find scanned 3,984 skills from two community registries in February 2026. Its findings, stated the way its own body states them rather than the way its headline does: about 37 percent carried at least one security issue of any severity, 13 percent carried at least one rated critical, and 76 were confirmed malicious after human review. Those are three different numbers measuring three different things, and most write-ups of that study collapse them into one.
The proportionate reading is that this is a software supply chain now, and it has the problems supply chains have. A writing skill is a low-risk category, because prose instructions cannot do much on their own. A skill that bundles scripts, fetches from a URL, or asks for a credential is a different proposition.
What to do with all this
Work out whether you want subtraction or voice. If your drafts read like a press release, a humanizer helps immediately. If they read fine but not like you, no humanizer will fix that.
Open the SKILL.md before installing. It is markdown. You can read the whole thing in two minutes and you will learn more than any comparison table tells you.
Ignore stars. Check whether the repository actually contains SKILL.md files, and check the last commit date rather than the push date.
Keep your header to name and description if you want the skill to work anywhere. Anything more is a Claude Code skill, not a portable one.
If you want Claude to publish rather than draft, you need a connector, and that is a different set of trade-offs entirely.
Where we stand
We publish twenty-two free skills, split across a LinkedIn set and a Twitter set. They declare only a name and a description, which is the portable minimum, so they load on any surface that reads the format rather than only in Claude Code. Several are about voice and one is a humanizer.
They are also hand-authored, which is the limitation this whole article is about. They encode what we think good writing looks like on each platform. They do not know your voice, because a file cannot. What closes that gap is evidence: your actual posts, and which of them worked. That lives in the product and in the MCP connector rather than in a markdown file, and we would rather explain the difference than blur it.
If you only ever use the free files and never touch the product, that is a completely reasonable outcome and the files are genuinely ours to give. Just know what they are.
For the connector side of this, see which LinkedIn MCP servers stop working after 60 days. For what LinkedIn will tell you about how your posts performed, which is the evidence half of the voice problem, see does LinkedIn have an analytics API.
Frequently asked questions
Can a Claude skill post to LinkedIn or Twitter?
No. On the Claude API, skills run in a sandbox with no network access. Even in Claude Code, where a skill has full network access, there is no credential, no session and no authentication mechanism in the skill format at all. Publishing requires an MCP connector, which is a different thing entirely.
Why doesn't my Claude writing skill sound like me?
Most likely because it was never trying to. Almost every free writing skill is subtractive: it removes phrasing that reads as machine-written, measured against a general standard rather than against your writing. That produces prose that reads as human and anonymous, which is a different outcome from sounding like you.
Where do Claude skill files go?
In Claude Code, a folder per skill inside a skills directory, either in your home .claude directory for personal use or the project's .claude directory. On claude.ai and Claude Desktop there is no filesystem path: you upload a ZIP under Customize then Skills, with the skill folder at the root of the ZIP rather than nested.
What is the difference between a Claude skill and an MCP server?
A skill is a folder of instructions that teaches Claude how to do something well. An MCP server is a running service that lets Claude reach an external system. A skill needs no server and holds no credentials. A connector needs both. Anthropic's own guidance to builders is to ship a connector first and then skills that help people use it.
Why does uploading a skill need code execution enabled?
Because of how a skill reaches Claude. When a skill matches your request, Claude opens the file and reads it using a shell command. Without a filesystem and a shell there is no way to open it. The setting is not there so your skill can run code, it is there so Claude can read your markdown.
Are Claude skills safe to install?
A skill is instructions Claude will follow, so treat it like installing software rather than reading an article. One February 2026 study of 3,984 skills from two community registries found roughly 37 percent with a security issue of any severity, 13 percent with a critical one, and 76 confirmed malicious after review. Prose-only writing skills are the low-risk end; skills bundling scripts or fetching URLs are not.
How long can a skill description be?
Anthropic's own documentation disagrees with itself. The claude.ai help page says 200 characters maximum, the platform documentation says 1,024, and both were live in September 2026. If you intend to upload to claude.ai, stay under 200 until a real upload proves otherwise.
AI disclosure
Written and fact-checked by Prateek Singh. VoiceMoat is the publisher's own product and publishes the skills this article discusses, including one of the subtractive kind it describes as limited. Every star count and commit date was read from the GitHub API on 9 September 2026 rather than from a rendered page or a blog, because two repositories in this space report a recent push date against a much older last commit. Skill mechanics, install paths, network constraints and security guidance come from Anthropic's own documentation, read in September 2026, and two internal contradictions in that documentation are reported here rather than resolved. The security study figures are quoted as its body states them, which differs from how its own headline states them.
Keep reading

AI and Voice
Every social MCP connector reaches both platforms. That is not the hard part
We were going to write that connecting one assistant to both Twitter and LinkedIn was rare. It is not. More than twenty connectors do it and several are free, so channel coverage is table stakes and every roundup ranking them by it is measuring the wrong thing. Here is what actually differs between them, and the one thing we read enumerated tool lists for six of them to confirm nobody does at all.
11 min read
·

AI and Voice
Hootsuite alternatives in 2026, priced from the vendors' own pages
Hootsuite starts at $99 per user a month, not $19. Here is what the realistic alternatives cost, read off each vendor's own pricing page in both billing positions, plus the clause in Hootsuite's terms that its pricing page does not mention.
10 min read
·

AI and Voice
Taplio alternatives in 2026, priced from the vendors' own pages
Four LinkedIn tools people move to from Taplio, priced from each vendor's own pricing page rather than from each other. Includes the arithmetic on Taplio's Pro tier, which does not add up, and one name still on every recommendation list that has quietly shut down.
11 min read
·

AI and Voice
Later alternatives in 2026, and the caps that actually move you up a tier
Later is one of the cheapest majors on headline price. What moves you up a tier is not the price, it is the 30-posts-per-profile cap and the user count. Here is what the alternatives cost, read off each vendor's own page in both billing positions.
10 min read
·

AI and Voice
How to train AI to write in your voice: the cross-model guide
You can get ChatGPT, Claude, or Gemini to write in your voice, but only for one session and only to about 70 to 80 percent, because chat models forget your style between chats and never learn from your edits. This is the honest cross-model guide: the analyze-then-write prompts that work, the settings that make them stick, the negative-constraint list that kills the AI tells, and the persistent alternative for anyone who posts regularly.
19 min read
·
From the X algorithm series
The X algorithm in May 2026: why voice wins under the new transformer
Read ›