I can pretty much relate to this blog article, because I worked with and created skills recently, as well.
Skills are docs, and docs need tech writers by @theletterf.bsky.social

Skills are docs, and docs need tech writers
Not a month goes by without someone claiming they’ve killed tech writing. A few weeks ago, it was CodeWiki and its docs theatre. Now it’s the turn of Claude Skills and their ecosystem of Markdown instructions served as if they were executable code or macros. Docs, though, are tougher than they’d expect, because they’re the strongest signals in a sea of noise, and because they’re pretty much everywhere. Including, well, skills.