Skip to content
Skills Library
Programming · Building & coding

code-styleguides

/code-styleguides

Language-specific code style guidelines. Use when writing TypeScript, Python, Go, JavaScript, or HTML/CSS code to ensure consistent, idiomatic, and maintainable code following best practices.

Licence
Apache-2.0
Last repository change
31.10.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 31.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Language-specific code style guidelines. Use when writing TypeScript, Python, Go, JavaScript, or HTML/CSS code to ensure consistent, idiomatic, and maintainable code following best practices.

Original author description

Language-specific code style guidelines. Use when writing TypeScript, Python, Go, JavaScript, or HTML/CSS code to ensure consistent, idiomatic, and maintainable code following best practices.

How it works

  1. How It Works
  2. Reading order
  3. Supported Languages
  4. When to Activate
  5. Universal Principles
  6. Guide-consistency rule
  7. Setup
  8. Integration
Original SKILL.md headings · 73 lines, 447 words
SKILL.md preview
---
name: code-styleguides
description: Language-specific code style guidelines. Use when writing TypeScript, Python, Go, JavaScript, or HTML/CSS code to ensure consistent, idiomatic, and maintainable code following best practices.
---

# Code Styleguides

Language-specific coding standards and best practices, plus the project's
cross-cutting standards. Load this skill before writing, reviewing or
refactoring code so findings cite the project's own rules.

## How It Works

Reads project-level styleguides from `conductor/code_styleguides/` (copied
during `/conductor-okf:setup` based on tech stack, then hardened per project).

## Reading order

1. `conductor/code_styleguides/engineering-principles.md` — the pillars every
   guide inherits (reusability, clean code, algorithmic excellence, validation
   & testing, portability). Read first, always.
2. Cross-cutting contracts when present:
   - `federation.md` — region manifest, per-layer source protocol, coverage
     declarations, readability-as-portability, soft size ceiling.
   - `layer-lanes.md` — the data-layer lane contract (lattice placement,
     nature, observed/forecast streams, provenance, availability).
   - `sql.md` — schema, migration and query standard.
3. The language guide for the file being touched (table below).

A reviewer cites the section (`federation.md §1`, `python.md "Readability and
region portability"`) so the author can locate the rule.

## Supported Languages

| Language | Extensions | Styleguide File |
|----------|------------|-----------------|
| TypeScript | `.ts`, `.tsx`, `.mts`, `.cts` | `conductor/code_styleguides/typescript.md` |
| Python | `.py`, `.pyi` | `conductor/code_styleguides/python.md` |
| SQL | `.sql`, Alembic `versions/*.py` | `conductor/code_styleguides/sql.md` |
| Go | `.go` | `conductor/code_styleguides/go.md` |
| JavaScript | `.js`, `.jsx`, `.mjs`, `.cjs` | `conductor/code_styleguides/javascript.md` |
| HTML/CSS | `.html`, `.css`, `.scss`, `.sass` | `conductor/code_styleguides/html-css.md` |

## When to Activate

Writing new code, reviewing code, refactoring, or setting up new files/modules.

## Universal Principles

| Aspect | Guideline |
|--------|-----------|
| **Naming** | Full words, intent-revealing; field-standard terms count as words; no cryptic abbreviations |
| **Structure** | Single responsibility; nesting ≤3; soft ceiling ~600-line modules / ~60-line functions (guidance, not lint) |
| **Documentation** | One-line "what" in code; the algorithm named at its implementation; the "why" in the directory's `AGENTS.md` with a pointer |
| **Errors** | Handle explicitly; fail closed and loud; never swallow; never substitute a plausible default for a missing governed input |
| **Boundaries** | Validate every external value once at ingress and give it a named type |
| **Portability** | No footprint literal (coordinate, state code, region name) outside the region manifest; sources bind behind a per-layer protocol and declare coverage |
| **Testing** | Behaviour and its failure/partial paths; one full sweep at the end of a multi-fix pass |

## Guide-consistency rule

A change that makes any rule in a guide false fixes the rule in the same
change and names the ruling or measurement that supersedes it. A checklist
item that has outlived its decision fails review for the wrong reason.

## Setup

If styleguides missing:
1. Run `/conductor-okf:setup` to initialize
2. Or copy from `templates/code-styleguides/` to `conductor/code_styleguides/`

Check: `ls conductor/code_styleguides/`

## Integration

Works with: **conductor-context** (project overrides), **tdd-workflow** (language test patterns)

Versions

The database has no other skills named code-styleguides.

Database snapshot: 13.11.2026 · package version 7b02b9c199c2 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100typescript-best-practices
    Write idiomatic TypeScript patterns for clean, maintainable code. Use when writing or refactoring TypeScript classes, functions, modules, or async logic.
  • 100html-css-guide
    HTML and CSS guardrails, patterns, and best practices for AI-assisted development. Use when working with HTML/CSS files (.html, .css, .scss, .less), or when the user mentions HTML/CSS. Provides semantic HTML guidelines, accessibility standards, modern CSS patterns, and…
  • 96html-css-js
    HTML/CSS/JavaScript开发专家助手。当用户需要进行网页开发、响应式布局、CSS动画、原生JS交互或Web前端基础开发时调用。
  • 90code-style-css
    Use when editing CSS, SCSS, or style blocks in .svelte files. Covers CSS-specific code style rules. Auto-invoke when writing or modifying styles.
  • 90golang-language
    Core idioms, style guides, and best practices for writing idiomatic Go code. Use when writing Go code following official style guides and idiomatic patterns.
  • 100verify-language
    Language-specific verification for Python, TypeScript/JavaScript, and Go. Checks type safety, language idioms, and best practices. Use when asked to "verify language", "check types", or for language-specific checks.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.