What is the .conventions/ directory?

It is a specialized folder created by this skill that houses your project's gold standards, anti-patterns, and naming rules to ensure consistent AI code generation.

Does this skill fix my code style or lint files?

No, it is designed to analyze and document patterns rather than perform active linting or formatting on individual files.

What is a project profile?

It's an auto-generated YAML file that summarizes your tech stack and structure, allowing Claude to understand your project instantly without re-scanning the entire codebase.

Can I update existing conventions?

Yes, the skill detects existing .conventions/ directories and updates them with new patterns or architectural decisions without deleting your existing files.

How does it help AI agents?

It provides short, high-quality examples (Gold Standards) that can be easily injected into agent prompts, helping them mimic your project's specific coding style.

Codebase Conventions & Standards

Name: Codebase Conventions & Standards
Author: izzzzzi

byizzzzzi

0•

Developer Tools

Analyzes your codebase to establish a single source of truth for architectural patterns, naming rules, and coding standards.

This skill automates the creation and maintenance of a .conventions/ directory, acting as a permanent memory of your project's 'gold standards' and 'anti-patterns.' By scanning your specific stack and existing code, it extracts naming conventions, architectural decisions, and verified tool-chain commands into a structured format. This ensures that every AI agent and human contributor follows the exact same project-specific taste, reducing technical debt and eliminating the need for repetitive context-setting during code generation tasks.

Key Features

01Regex-based naming and import convention verification

02Automated codebase research and tech stack detection

03Extraction of short, 20-30 line 'Gold Standard' code snippets

04Creation of Anti-pattern guides with Bad vs. Good comparisons

05Generation of .project-profile.yml for optimized AI cold-starts

060 GitHub stars

Use Cases

01Aligning multiple autonomous agents to follow a unified set of architectural decisions

02Bootstrapping standards for a new project to guide AI-assisted development

03Auditing an existing codebase to document patterns for onboarding new team members

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add izzzzzi/izteam conventions

For use in Claude.ai and ChatGPT