building-themes SKILL.md skillA

building-themes from macareuxdigital/concretecms-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add macareuxdigital/concretecms-skills/building-themes@git:20260913.db96265

Pins git:20260913.db96265 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
macareuxdigital/concretecms-skills
Path
skills/building-themes/SKILL.md
Versions recorded
1
Latest version
git:20260913.db96265, committed Sep 13, 2026
Size
7,334 bytes
Repository stars
10
License
MIT

This skill provides guidance and standard workflows for developing custom themes for Concrete CMS, including directory structure, page templates, asset management, and v9+ features like containers. Use this when creating or modifying Concrete CMS themes.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Building Themes

## Overview

This skill enables the development of professional, feature-rich themes for Concrete CMS. It covers the essential components like `page_theme.php`, page templates, asset registration, and advanced features such as grid support and containers. 

For the most up-to-date best practices and implementation examples, refer to the `concrete/themes/atomik` directory in the core. It serves as the primary reference for modern theme development in Concrete CMS.

## Workflow

### 1. Setup Theme Directory
Themes should be placed within a package for better portability. Otherwise, they can be stored in the `application` directory.
- Path: `packages/your_package_handle/themes/your_theme_handle/`
- Path: `application/themes/your_theme_handle/`

### 2. Create Core Files
Every theme requires at least:
- `page_theme.php`: The main configuration class for the theme.
- `default.php`: The default page template.
- `view.php`: Required for single pages. Should include the `system_errors` element and `$innerContent`.
- `elements/header.php` & `elements/footer.php`: Shared header and footer.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add macareuxdigital/concretecms-skills/building-themes@sha256:c92229e538bf73f0

The line at the top of this page pins the label git:20260913.db96265, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_7jsgatcmfy5dpxet.svg)](https://markdownregistry.com/a/art_7jsgatcmfy5dpxet)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Sep 13, 2026.

versioncommittedcommitsizeaudit
git:20260913.db96265 latest2026-09-13 db96265 7,334 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7334 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

macareuxdigital/concretecms-skills · 10 stars · license MIT · pushed 2026-09-13 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_7jsgatcmfy5dpxet
GET https://markdownregistry.com/api/v1/resolve?ref=macareuxdigital/concretecms-skills/building-themes
GET https://markdownregistry.com/api/v1/blob/c92229e538bf73f08b977b913b5e99d9481463c7c0c01aaf070697533dd9d23b

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from macareuxdigital/concretecms-skills

building-block-templates SKILL.md skill
macareuxdigital/concretecms-skills · skills/building-block-templates/SKILL.md · Create custom templates for Concrete CMS block types. Use this skill when you need to change the markup of an existing…
git:20260913.db96265 · audit A · 10 stars
building-blocktypes SKILL.md skill
macareuxdigital/concretecms-skills · skills/building-blocktypes/SKILL.md · Create and manage Concrete CMS block types. Use this skill when the user asks to create or modify custom block types.
git:20260913.db96265 · audit A · 10 stars
building-packages SKILL.md skill
macareuxdigital/concretecms-skills · skills/building-packages/SKILL.md · Create and manage Concrete CMS packages. Use this skill when the user asks to create a custom package or manage…
git:20260913.db96265 · audit A · 10 stars
building-singlepages SKILL.md skill
macareuxdigital/concretecms-skills · skills/building-singlepages/SKILL.md · This skill provides instructions and best practices for creating and managing single pages in Concrete CMS packages…
git:20260913.db96265 · audit A · 10 stars
concrete-cms-security SKILL.md skill
macareuxdigital/concretecms-skills · skills/concrete-cms-security/SKILL.md · Apply this skill whenever you are writing, reviewing, or modifying PHP code for Concrete CMS (concrete5) — custom…
git:20260913.db96265 · audit A · 10 stars
concrete-dashboard-crud SKILL.md skill
macareuxdigital/concretecms-skills · skills/concrete-dashboard-crud/SKILL.md · This skill provides instructions and best practices for implementing a CRUD (Create, Read, Update, Delete) interface…
git:20260913.db96265 · audit B · 10 stars
customizing-express-form SKILL.md skill
macareuxdigital/concretecms-skills · skills/customizing-express-form/SKILL.md · Customize the appearance of Express forms in Concrete CMS
git:20260913.db96265 · audit A · 10 stars
working-with-database SKILL.md skill
macareuxdigital/concretecms-skills · skills/working-with-database/SKILL.md · Connect to databases, execute queries, and manipulate data in Concrete CMS projects. Use this skill when the user asks…
git:20260913.db96265 · audit A · 10 stars

Every file in macareuxdigital/concretecms-skills

Browse by kind, by grade A, or by owner.