Agent skill

Project Guidelines Example

by cloudnative-co in cloudnative-co/claude-code-starter-kit

Example project-specific skill template. An agent skill from cloudnative-co/claude-code-starter-kit.

MITAuto-check passedTesting & QA

Install Project Guidelines Example

skills CLI
$ npx skills add cloudnative-co/claude-code-starter-kit --skill project-guidelines-example -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install cloudnative-co/claude-code-starter-kit project-guidelines-example --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/cloudnative-co/claude-code-starter-kit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/project-guidelines-example .claude/skills/project-guidelines-example && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
project-guidelines-example
GitHub stars
151
Token cost
~446 tokens
SKILL.md length
168 words
Files
4 (incl. references)
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Example project-specific skill template. An agent skill from cloudnative-co/claude-code-starter-kit.

  • Works in 8 steps: No emojis in code, comments, or… → Immutability - never mutate objects or… → TDD - write tests before implementation → …
  • Tasks that involve Skill authoring
  • SKILL.md covers When to Use, Reference Documents, Critical Rules and Related Skills
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Project Guidelines Example is an agent skill from cloudnative-co/claude-code-starter-kit. Example project-specific skill template. Use as a starting point when creating guidelines for your own projects.

Its SKILL.md is about 450 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/architecture.md`, `references/code-patterns.md` and `references/testing-deployment.md`).

It sits in Testing & QA, covering Skill authoring. The repository describes itself as: One-command setup of a complete Claude Code development environment with interactive wizard. The licence is MIT.

When your agent uses it

  • Tasks that involve Skill authoring

Example prompts

  • “/project-guidelines-example”

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. No emojis in code, comments, or documentation
  2. Immutability - never mutate objects or arrays
  3. TDD - write tests before implementation
  4. 80% coverage minimum
  5. Many small files - 200-400 lines typical, 800 max
  6. No console.log in production code
  7. Proper error handling with try/catch
  8. Input validation with Pydantic/Zod

What it can do on your machine

Read from SKILL.md and the folder at commit f00e7ce. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • zenith.chat

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Project Guidelines Example loads about 446 tokens when it runs, and up to ~2.5k if it reads all its reference files. Until then it costs about 35 tokens; SKILL.md has 168 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~35
When it runs · the whole SKILL.md, loaded when a task matches
~446
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from cloudnative-co/claude-code-starter-kit at commit f00e7ce, republished under its MIT licence (© cloudnative-co). 168 words, ~446 tokens.

Download SKILL.mdSave it as .claude/skills/project-guidelines-example/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
project-guidelines-example
description
Example project-specific skill template. Use as a starting point when creating guidelines for your own projects.
when_to_use
Use when creating a new project-specific skill or adapting this template into real architecture, workflow, and testing guidance.

Project Guidelines Skill (Example)

This is an example of a project-specific skill. Use this as a template for your own projects.

Based on a real production application: Zenith - AI-powered customer discovery platform.

When to Use

Reference this skill when working on the specific project it's designed for. Project skills contain:

  • Architecture overview
  • File structure
  • Code patterns
  • Testing requirements
  • Deployment workflow

Reference Documents

Critical Rules

  1. No emojis in code, comments, or documentation
  2. Immutability - never mutate objects or arrays
  3. TDD - write tests before implementation
  4. 80% coverage minimum
  5. Many small files - 200-400 lines typical, 800 max
  6. No console.log in production code
  7. Proper error handling with try/catch
  8. Input validation with Pydantic/Zod
  • coding-standards - General coding best practices
  • backend-patterns - API and database patterns
  • frontend-patterns - React and Next.js patterns
  • tdd-workflow - Test-driven development methodology

© cloudnative-co, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/project-guidelines-example of cloudnative-co/claude-code-starter-kit.

  • SKILL.md
  • references/architecture.md
  • references/code-patterns.md
  • references/testing-deployment.md

Open the folder on GitHubat commit f00e7ce

Compare with similar skills

Project Guidelines Example next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Project Guidelines Example compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Project Guidelines Example this skillcloudnative-co/claude-code-starter-kit151—~446Automated safety check: PassMIT
Create a Verification Skillcursor/plugins10k8 repos~1.5kAutomated safety check: PassNone
Aliyun Skill Creatorcinience/alicloud-skills397—~2.8kAutomated safety check: PassApache-2.0
Skill Writingmillionco/expect3.6k—~1.8kAutomated safety check: PassCustom licence
Waza Skill Evaluatormicrosoft/waza1.4k—~2kAutomated safety check: PassMIT
Generate Testshidai25/eval-view137—~658Automated safety check: PassApache-2.0

Similar skills

  • Official

    Generates a project-local skill that launches your app, exercises a feature the way a user would and captures evidence, for web, CLI, API or desktop projects.

    10k GitHub starsUsed in 8 repos~1.5k tokens
    Testing & QAAuto-check passed
  • Aliyun Skill Creator

    cinience/alicloud-skills

    A skill your agent uses when creating, migrating, or optimizing skills for this alicloud-skills repository.

    397 GitHub stars~2.8k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Skill Writing

    millionco/expect

    Write and improve agent skills (SKILL.md files). An agent skill from millionco/expect.

    3.6k GitHub stars~1.8k tokensUpdated 5 mo ago
    DevelopmentAuto-check passed
  • Waza Skill Evaluator

    microsoft/waza

    Official

    Evaluates agent skills with a Go CLI that runs YAML-defined benchmarks, compares runs and scores the quality of SKILL.md frontmatter.

    1.4k GitHub stars~2k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Generate Tests

    hidai25/eval-view

    Generate EvalView test cases — either from a SKILL.md file using LLM-powered generation, or by capturing real agent interactions through a proxy.

    137 GitHub stars~658 tokensUpdated 1 mo ago
    Testing & QAAuto-check passed
  • Waza Interactive

    microsoft/waza

    Official

    Walks you through creating, running and reading waza evals for an agent skill, then proposes concrete fixes when tasks fail or the score is low.

    1.4k GitHub stars~1.3k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

More from cloudnative-co/claude-code-starter-kit

All 8 skills in this repo
  • Eval Harness

    cloudnative-co/claude-code-starter-kit

    Formal evaluation framework for Claude Code sessions implementing eval-driven development (EDD) principles.

    151 GitHub starsUsed in 10 repos~1.3k tokens
    Auto-check passed
  • TDD Workflow

    cloudnative-co/claude-code-starter-kit

    A skill your agent uses when the user explicitly asks for TDD or a tests-first workflow, or when developing a new feature with a test coverage requirement.

    151 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Web Content Extraction

    cloudnative-co/claude-code-starter-kit

    Web取得の標準前処理レイヤー。URL・公式ドキュメント・ブログ・ニュース・OSSページを読むときは、原則として毎回このSkillでDefuddleを使い本文をMarkdown/JSON化してから読む。生HTMLのまま要約・分析・比較・レビューしない。トリガー例: URLを読む/Webページ要約/OSS調査/公式Doc確認/記事解析/競合サイト確認/Web一次情報確認。

    151 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Prompt Patterns

    cloudnative-co/claude-code-starter-kit

    Practical prompt patterns and techniques for effective Claude Code usage.

    151 GitHub stars~887 tokensUpdated today
    Auto-check passed
  • Verification Loop

    cloudnative-co/claude-code-starter-kit

    Comprehensive verification system for Claude Code sessions. An agent skill from cloudnative-co/claude-code-starter-kit.

    151 GitHub stars~733 tokensUpdated today
    Auto-check passed
  • Cloudnative Writing Baseline

    cloudnative-co/claude-code-starter-kit

    日本語の業務文書を作成・修正するときに使用する共通品質基準。事実性、確度、論理、簡潔さ、自然な日本語を守る。提案書、報告、技術説明、議事録、メール、Slack、要約、レビューに適用する。創作、広告コピー、コードや構造化データだけの生成には使用しない。

    151 GitHub stars~1.1k tokensUpdated today
    Auto-check passed

Questions about Project Guidelines Example

What does Project Guidelines Example do?

Example project-specific skill template. An agent skill from cloudnative-co/claude-code-starter-kit. Project Guidelines Example is an agent skill from cloudnative-co/claude-code-starter-kit. Example project-specific skill template.

When should I use Project Guidelines Example?

Project Guidelines Example fits situations like: tasks that involve Skill authoring.

How do I install Project Guidelines Example in Claude Code?

Run `npx skills add cloudnative-co/claude-code-starter-kit --skill project-guidelines-example -a claude-code`. Or copy the skill folder (skills/project-guidelines-example in cloudnative-co/claude-code-starter-kit) into .claude/skills/project-guidelines-example in your project. Claude Code loads it when a task matches its description.

How do I install Project Guidelines Example in Codex?

Run `npx skills add cloudnative-co/claude-code-starter-kit --skill project-guidelines-example -a codex`. Or copy the skill folder (skills/project-guidelines-example in cloudnative-co/claude-code-starter-kit) into .agents/skills/project-guidelines-example in your project. Codex loads it when a task matches its description.

Can I use Project Guidelines Example in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add cloudnative-co/claude-code-starter-kit --skill project-guidelines-example -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/project-guidelines-example, .gemini/skills/project-guidelines-example, .github/skills/project-guidelines-example and .opencode/skills/project-guidelines-example in your project.

What does Project Guidelines Example need to run?

SKILL.md names no scripts, command-line tools or credentials: Project Guidelines Example is instructions for the agent only.

Does Project Guidelines Example access the network?

SKILL.md names 1 domain. As links in the text: zenith.chat. This is read from the text; nothing was executed.

Is Project Guidelines Example safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Project Guidelines Example use?

Project Guidelines Example is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Project Guidelines Example use?

About 446 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.1k tokens, read only when the agent opens those files.

What are the alternatives to Project Guidelines Example?

Skills that share tags, products or a category with Project Guidelines Example: Create a Verification Skill (cursor/plugins, 10k stars), Aliyun Skill Creator (cinience/alicloud-skills, 397 stars), Skill Writing (millionco/expect, 3.6k stars) and Waza Skill Evaluator (microsoft/waza, 1.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Project Guidelines Example?

cloudnative-co (a GitHub organization) maintains it in cloudnative-co/claude-code-starter-kit, which has 151 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 7, 2026.

Source: cloudnative-co/claude-code-starter-kit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.