Skills
Consider this idea: A company has 100 tech-writer-specific skills that are highly adopted and used across the organization. This collection of skills, focusing on internal authoring skills, has skills for doing virtually anything related to tech writing that you can imagine — fixing a bug, applying a style edit, checking release notes for accuracy, fixing comments in proto styles, and more. The skills don’t do the job entirely themselves but rather act as power tools for the writers, accelerating and amplifying their work.
Not everyone uses all 100 of the tech writer skills. Instead, each tech writer adds the skills most relevant to their tasks in a skills.json file. Some have even created virtual agents that have these skills.
Is this 100 TW skills idea worthwhile? The merits of the 100 skills idea is questionable; there are many problems associated with it. And yet, I think the idea could be interesting. We would essentially be externalizing the skills of an entire profession in a way that could be used cross-organizationally, by any role. This is unsettling as it may lead to our irrelevance. But there’s also a high possibility of amplification: by externalizing our skills, we build upon each others’ strengths. Is it possible to construct skills in such a way that other writers, particularly those who didn’t make the skills, find them useful?
In this series, I’ll build out these ideas into a course on skills.
About Tom Johnson
I'm an API technical writer based in the Seattle area. On this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, AI, information architecture, content strategy, writing processes, plain language, tech comm careers, and more. Check out my API documentation course if you're looking for more info about documenting APIs. Or see my posts on AI and AI course section for more on the latest in AI and tech comm.
If you're a technical writer and want to keep on top of the latest trends in the tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me. Finally, note that the opinions I express on my blog are my own points of view, not that of my employer.