Skip to content

Conversation

@MounirDhahri
Copy link
Member

Thanks to this #777 it was easier to write a skill to make writing blog posts easier with Claude.

My prompt was the following:

I want you to generate an agent skill on writing articles based on the docs of authoring articles (Only step 1 and 2 ). I want it to refer to the doc that we
  created instead of having a different markdown document. Follow the best practices here
  https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices. When a user prompts to generate an article, ask them which template they want to use
  and show them a drop down from the available templates. Also ask them for their name and see if it's available in _config.yml.  

I tried this locally to generate my next article and it worked pretty well. I think the result wouldn't have been as good if I were to give it no details (tried that a few months ago - but with a worse model)

Screen.Recording.2026-01-08.at.15.38.35.mp4

I think this is as is, is fine, but maybe I could have been stricter with the best practices and added more checkboxes to track progress as suggested on the best practices (thanks @anandaroop for showing them to me)

@MounirDhahri MounirDhahri self-assigned this Jan 8, 2026
Copy link
Member

@anandaroop anandaroop left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Very nice!

Just one bikeshed comment about naming below.

@@ -0,0 +1,56 @@
---
name: writing-articles
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

suggestion (non-blocking): Maybe consider giving this a name like "creating-articles" or "adding-articles" just to be a tad clearer that the skill is not meant to actually write the blog post for you.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

good idea

Base automatically changed from chore/align-docs to source January 9, 2026 09:49
@MounirDhahri MounirDhahri changed the title feat: add write article skill feat: add creating articles skill Jan 9, 2026
@MounirDhahri MounirDhahri merged commit dfc9eae into source Jan 9, 2026
3 checks passed
@MounirDhahri MounirDhahri deleted the feat/add-write-article-skill branch January 9, 2026 09:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants