A repository of Claude Code skills for building Discourse themes and block components: https://github.com/discourse/discourse-theme-skills :toolbox: What’s included Theme Authoring Skill — covers a comprehensive scope of building a Discourse theme: scaffolding with the discourse_theme CLI, SCSS ar…

Having some actual fun with this :winking_face_with_tongue: … As other AI design tools it’s really performant for quickly prototyping ideas that would have been too costly to sketch out manually. Asked for a very brutalist style editorial homepage, with highly unconventional content featured from t…

[image] manuel: And more fun when it’s all moving :carp_streamer: Theme Creator [image] flushy

Finally!!! Will try it asap to update my experimental theme components :smiley: [Elmo Surrounded by Intense Fire]

This is great work and very creative. If we fork and build off this theme are there considerations for the parent not staying updated with Discourse over time? Trying to think how this should be approached. Thanks for the resources!

Thanks @BrianC ! On the parent staying updated: the skills track Discourse’s theme and Blocks APIs, so as long as we actively use them, they will be kept in sync as the APIs evolve. The example theme is more of a snapshot to demonstrate patterns. If you fork it, you own your fork. But you can refer …

I’m just starting to mess around with this (without agentic coding). I get the impression that it wouldn’t take too much to convert this into a Theme Component which controls just the Homepage of a site - for example, one already using the Horizon Theme. Would that be stupid? Also, I’ve noticed a …

Thanks for giving it a try @nathank ! It’s still considered experimental and we will make changes to the API, so I wouldn’t build a homepage-builder-type theme component on top of it for now. The demo blocks are just basic examples. We also have some API changes coming up that will improve how we ca…

Finally I took the step and started to play a little with this. Thank you very much for sharing it. I wonder how possible could be to generate a custom block that displays the user’s avatar and name (which I’ve already achieved) along with their topic and posts count, likes, cheer points, and somet…

If you want to add a block, I think you’d need to submit a PR to core.

I have been reading up on the blocks API, ask.discourse has been quite helpful. I would like to try imitate (plagiarise) the meta category banner with the icons, amongst some other ideas. Most of the materials I have read seem to lean towards self-hosted sites and not hosted sites. Are there any …

Skills for authoring themes and blocks

Development

manuel (Manuel Kostka) October 13, 2026, 9:26pm 26

@nathank I updated the events block and generally updated styles and settings of the theme. Block panels now use one shared skeleton with loading and error states.

Topic		Replies	Views
Designer's Guide to getting started with themes in Discourse Developer Guides tutorial , theme-guides	9	12776	April 8, 2024
Rebuilding the Meta Branded theme: New icons, a custom homepage, and a first look at the Blocks API Site feedback meta-redesign-2026	27	1558	August 14, 2026
Creating a 'Blocks' API for injecting content Projects	0	83	August 27, 2026
Using Discourse MCP to quickly build a theme Extras ai , mcp	13	625	September 14, 2026
Canvas Theme Template Theme	20	6340	February 25, 2026

Skills for authoring themes and blocks

Related topics