Skip to content

Commit 3e02872

Browse files
agent-ptolemyclaude
andcommitted
docs: Improve skills with mission alignment and Australian context
content-hardening.md: - Add "Why This Matters" preamble linking to SafeAI-Aus values - Add Australian-specific references section (regulators, programs, standards) - Expand "Tone" to include plain language principles and audience check - Fix invocation trigger format visual-markdown-enhancements.md: - Add "Why This Matters" preamble (accessibility, trust, actionability) - Expand Australian English section with full spelling table - Add audience check for plain language - Fix American spellings in skill text (licence, colour, analyse) - Fix invocation trigger format Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 0b312ab commit 3e02872

2 files changed

Lines changed: 129 additions & 38 deletions

File tree

.claude/skills/content-hardening.md

Lines changed: 79 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,24 @@
11
# Content Hardening, Accuracy & Style Alignment
22

3-
<skill-invocation-trigger>
4-
Run this skill when the user asks for:
5-
- "defensibility hardening", "harden content", "defensibility pass"
6-
- "style guide alignment", "economist style", "apply style guide"
7-
- "content review", "content audit", "accuracy check"
8-
- "sourcing audit", "citation check", "fact check"
9-
- Any combination of the above
10-
</skill-invocation-trigger>
3+
Run this skill when the user asks for: "defensibility hardening", "harden content", "defensibility pass", "style guide alignment", "economist style", "apply style guide", "content review", "content audit", "accuracy check", "sourcing audit", "citation check", "fact check", or any combination of the above.
4+
5+
## Why This Matters
6+
7+
SafeAI-Aus's mission is to enable safe, ethical and growth-oriented AI adoption through open standards, practical tools and collaborative knowledge-sharing. Our core values include:
8+
9+
- **Transparency & Accountability** — fostering trust through openness
10+
- **Safety & Responsibility** — protecting people and organisations
11+
- **Alignment with Standards** — promoting compliance with Australian regulations
12+
13+
Content quality directly supports these values. Inaccurate claims, overstated capabilities or outdated references undermine trust and could lead organisations to make poor decisions. Defensible, well-sourced, clearly written content helps Australian businesses adopt AI confidently and safely.
1114

1215
## Overview
1316

1417
This skill performs a comprehensive content quality review:
1518

16-
1. **Defensibility Hardening** - Softens absolute claims to be legally and factually defensible
17-
2. **Sourcing & Accuracy Audit** - Flags claims needing citations, outdated references, predictions
18-
3. **Economist Style Guide Alignment** - Applies consistent editorial style
19+
1. **Defensibility Hardening** Softens absolute claims to be legally and factually defensible
20+
2. **Sourcing & Accuracy Audit** Flags claims needing citations, outdated references, predictions
21+
3. **Economist Style Guide Alignment** Applies consistent editorial style with Australian English and plain language
1922

2023
---
2124

@@ -117,20 +120,29 @@ will be|will become|will happen|will require|by 2030|by 2027|in the future|soon|
117120
#### 3. Outdated Organisational References
118121

119122
**High-risk items to check:**
120-
- Government programs (grants, initiatives) - status changes frequently
121-
- Regulatory bodies - may be renamed, restructured, or abolished
122-
- Legislation - may be amended, replaced, or repealed
123-
- Policies and standards - may be updated or superseded
124-
- Technology products/services - may be discontinued
123+
- Government programs (grants, initiatives) — status changes frequently
124+
- Regulatory bodies — may be renamed, restructured or abolished
125+
- Legislation — may be amended, replaced or repealed
126+
- Policies and standards — may be updated or superseded
127+
- Technology products/services — may be discontinued
128+
129+
**Australian-specific references (high priority):**
130+
- Australian Government department names and programs
131+
- State/territory programs (NSW, VIC, QLD, SA, WA, TAS, ACT, NT)
132+
- Regulators: OAIC, ACCC, ASIC, APRA, TGA, Fair Work Commission
133+
- Standards: Privacy Act 1988, Australian Consumer Law, VAISS, AI6
134+
- Funding bodies: business.gov.au programs, state innovation funds, CSIRO
135+
- Industry bodies: AIIA, Tech Council of Australia
125136

126137
**Search for:**
127138
- Program names with dates
128139
- "announced", "launched", "established" + year
129-
- References to specific funding amounts
140+
- References to specific funding amounts (especially in AUD)
130141
- Government department names
142+
- State/territory government references
131143

132144
**Fix options:**
133-
- Verify current status via web search
145+
- Verify current status via web search (prefer .gov.au sources)
134146
- Add "last verified: [date]" or "as of [date]"
135147
- Add warning note about status changes
136148
- Update or remove if obsolete
@@ -170,6 +182,46 @@ For each issue, document:
170182

171183
## Pass 3: Economist Style Guide Alignment
172184

185+
### Australian English Spelling
186+
187+
Use Australian English spelling throughout:
188+
189+
| US Spelling | Australian Spelling |
190+
|-------------|---------------------|
191+
| organize, organization | organise, organisation |
192+
| recognize, recognized | recognise, recognised |
193+
| analyze, analyzed | analyse, analysed |
194+
| customize | customise |
195+
| minimize, maximize | minimise, maximise |
196+
| optimize | optimise |
197+
| prioritize | prioritise |
198+
| utilize | utilise (but prefer "use") |
199+
| center | centre |
200+
| meter (measurement) | metre |
201+
| fiber | fibre |
202+
| labor | labour |
203+
| favor, favorable | favour, favourable |
204+
| behavior | behaviour |
205+
| color | colour |
206+
| honor | honour |
207+
| neighbor | neighbourhood |
208+
| program (computer) | program (keep as-is for software) |
209+
| program (scheme/plan) | programme |
210+
| license (noun) | licence |
211+
| license (verb) | license |
212+
| practice (noun) | practice |
213+
| practice (verb) | practise |
214+
| defense | defence |
215+
| offense | offence |
216+
| catalog | catalogue |
217+
| dialog | dialogue |
218+
| traveler | traveller |
219+
| modeling | modelling |
220+
| canceled | cancelled |
221+
| focused | focussed (or focused - both acceptable) |
222+
223+
**Note:** Some technical terms retain US spelling when they are proper nouns or industry-standard terms (e.g., "NIST AI Risk Management Framework", "Google Cloud").
224+
173225
### Oxford Comma
174226

175227
**Remove Oxford commas** (serial commas before "and"/"or" in lists):
@@ -227,12 +279,20 @@ For each issue, document:
227279
- Avoid exclamation marks in body text
228280
- Use en-dashes (–) for ranges, em-dashes (—) sparingly for parenthetical statements
229281

230-
### Tone
282+
### Tone & Plain Language
283+
284+
SafeAI-Aus content should be accessible to businesses of all sizes, including those without dedicated legal or technical teams.
231285

286+
**Plain language principles:**
232287
- Prefer active voice over passive
233288
- Be direct and concise
234289
- Avoid jargon where plain English works
235290
- Write with confidence but not arrogance
291+
- Explain technical terms on first use, or link to the glossary
292+
- Use short sentences and paragraphs
293+
- Prefer concrete examples over abstract descriptions
294+
295+
**Audience check:** Would a small business owner without AI expertise understand this? If not, simplify or add context.
236296

237297
---
238298

.claude/skills/visual-markdown-enhancements.md

Lines changed: 50 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,22 @@
11
# Visual Markdown Enhancements Skill
22

3-
Apply consistent visual enhancements to SafeAI-Aus markdown pages using Zensical/Material-compatible markdown syntax.
3+
Run this skill when the user asks for: "visual enhancements", "markdown formatting", "enhance page", "format markdown", "add admonitions", "visual structure", "standardise formatting", or similar requests about improving the visual presentation of markdown pages.
4+
5+
## Why This Matters
6+
7+
SafeAI-Aus's mission is to enable safe, ethical and growth-oriented AI adoption through practical tools and collaborative knowledge-sharing. Our content should be:
8+
9+
- **Accessible** — Clear visual structure helps businesses of all sizes navigate complex governance topics
10+
- **Trustworthy** — Consistent, professional formatting builds confidence in our resources
11+
- **Actionable** — Well-organised content with clear steps helps organisations implement AI safely
12+
13+
Visual enhancements aren't just cosmetic — they make the difference between content that gets used and content that gets ignored.
414

515
## When to Use This Skill
616

717
- Enhancing existing content pages for better readability
818
- Adding visual structure to template pages
9-
- Standardizing formatting across the site
19+
- Standardising formatting across the site
1020
- Converting plain markdown to visually enhanced pages
1121

1222
## Enhancement Patterns
@@ -121,7 +131,7 @@ Use tabs only for genuinely different perspectives or contexts (e.g., comparing
121131
- Beginner vs advanced (write for all levels)
122132
- Different durations (pick one recommended approach)
123133

124-
### 6. License Footer (Standard Format)
134+
### 6. Licence Footer (Standard Format)
125135

126136
Always use collapsible note admonition:
127137

@@ -144,35 +154,56 @@ For checklists and step-by-step content:
144154

145155
### 8. Risk Level Tables
146156

147-
Use color-coded icons for risk levels:
157+
Use colour-coded icons for risk levels:
148158

149159
```markdown
150160
| Risk Level | Example Use Cases |
151161
|------------|-------------------|
152-
| 🟢 **Low** | Website chatbot, content summarization |
162+
| 🟢 **Low** | Website chatbot, content summarisation |
153163
| 🟡 **Medium** | Staff rostering, marketing automation |
154164
| 🔴 **High** | Automated loan approvals, hiring decisions |
155165
```
156166

157167
## Australian English Requirements
158168

159-
**Always convert American to Australian English:**
169+
SafeAI-Aus content is written for an Australian audience. Always use Australian English spelling.
160170

161-
| American | Australian |
162-
|----------|------------|
163-
| customize | customise |
164-
| organize | organise |
165-
| organization | organisation |
166-
| organizational | organisational |
167-
| optimize | optimise |
168-
| analyze | analyse |
169-
| center | centre |
171+
**Common conversions:**
170172

171-
**Exception:** Leave schema.org vocabulary unchanged (`"@type": "Organization"`)
173+
| US Spelling | Australian Spelling |
174+
|-------------|---------------------|
175+
| organize, organization | organise, organisation |
176+
| customize, customization | customise, customisation |
177+
| recognize, recognized | recognise, recognised |
178+
| analyze, analyzed | analyse, analysed |
179+
| minimize, maximize | minimise, maximise |
180+
| optimize, optimized | optimise, optimised |
181+
| prioritize | prioritise |
182+
| center | centre |
183+
| meter (measurement) | metre |
184+
| color | colour |
185+
| favor, favorable | favour, favourable |
186+
| behavior | behaviour |
187+
| labor | labour |
188+
| defense | defence |
189+
| license (noun) | licence |
190+
| practice (verb) | practise |
191+
| program (scheme/plan) | programme |
192+
| modeling | modelling |
193+
| canceled | cancelled |
194+
| catalog | catalogue |
195+
| dialog | dialogue |
196+
197+
**Exceptions:**
198+
- Leave schema.org vocabulary unchanged (`"@type": "Organization"`)
199+
- Keep US spelling for proper nouns and product names (e.g., "NIST AI Risk Management Framework")
200+
- Keep "program" for software/computer contexts
201+
202+
**Audience check:** Content should be accessible to Australian businesses of all sizes, including those without dedicated legal or technical teams. Explain jargon on first use or link to the glossary.
172203

173204
## Enhancement Workflow
174205

175-
### Step 1: Read and Analyze
206+
### Step 1: Read and Analyse
176207
```bash
177208
# Read the target file
178209
Read the markdown file
@@ -193,7 +224,7 @@ Read the markdown file
193224
4. Add icons to lists
194225
5. Ensure proper blank lines before list items in admonitions
195226
6. Convert to Australian English
196-
7. Add/fix license footer
227+
7. Add/fix licence footer
197228
8. Add Standards Compliance tabs (if applicable)
198229

199230
### Step 3: Verify Formatting
@@ -242,7 +273,7 @@ chmod +x /tmp/check_formatting.sh
242273
- [ ] No tabs in "How to Use" sections
243274
- [ ] Australian English throughout
244275
- [ ] Icons are relevant and not excessive
245-
- [ ] Collapsible `???` used only for license/disclaimer/FAQs
276+
- [ ] Collapsible `???` used only for licence/disclaimer/FAQs
246277

247278
### Step 4: Build and Test
248279
```bash

0 commit comments

Comments
 (0)