# Standardize Project Conventions

Project teams often lose consistency across branches, documentation, configuration, and reviews. This skill gives Claude, Codex, and Claude Code shared guidance for development conventions.

## Install

```bash
npx skillstore add eis-its/global-conventions
```

## Metadata

- Status: approved
- Slug: eis-its-global-conventions
- Skillstore revision: r1
- Version status: missing
- Tree hash: e0a6f9a9647cda6c782704343732fe71f7f758d17a55644de00d7d6286e42588
- Author: EIS-ITS
- GitHub username: EIS-ITS
- License: MIT
- Repository: https://github.com/EIS-ITS/vss-cli/tree/main/.claude/skills/global-conventions
- Ref: 26421118b848d9f1efc0aa169d8a7a9e7e0a877e
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: filesystem
- Quality score: 78
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/eis-its-global-conventions
- Manifest: https://skillstore.pages.dev/api/skills/eis-its-global-conventions/manifest

## Capabilities

- Guides project file and directory organization.
- Supports commit messages, pull requests, and branch workflow consistency.
- Helps maintain README, contribution, changelog, and release documentation.
- Advises on environment variables, settings files, secrets management, and feature flags.
- Supports dependency file updates and testing requirements before merges.

## Use Cases

- Prepare a New Repository: Set up directory structure, README content, dependency files, and review expectations before the first merge.
- Keep Team Workflow Consistent: Apply shared rules for branches, commit messages, pull requests, tests, and changelog updates.
- Document Configuration Practices: Create guidance for environment variables, feature flags, and settings files without exposing secret values.

## Prompt Templates

### Organize Project Files

```
Review this repository structure and suggest changes that match the global-conventions skill. Focus on directories, README coverage, and dependency files.
```

### Standardize Git Workflow

```
Help me write branch, commit, pull request, testing, and changelog conventions for this project.
```

### Plan Configuration Governance

```
Create a convention plan for environment variables, settings files, feature flags, and secrets handling. Include review checkpoints and documentation owners.
```

### Audit Release Readiness

```
Assess whether this project follows global conventions before release. Review documentation, dependencies, tests, branching rules, and release notes. List gaps by priority.
```

## Limitations

- Provides conventions only; it does not include executable automation or validation scripts.
- Depends on a referenced conventions document outside the skill file.
- Does not define language-specific coding standards beyond project organization topics.
- Does not replace team approval for secret handling or release decisions.

## Best Practices

- Keep conventions near the workflows they govern and review them with code changes.
- Treat secrets as sensitive values; document names and purpose without copying values.
- Update README, changelog, and dependency notes in the same change when behavior shifts.

## Anti Patterns

- Linking to unreviewed parent-directory files instead of packaging required guidance.
- Mixing team workflow policy with private secret values or local-only settings.
- Letting branch, commit, and review rules drift across repositories.

## Security Audit

- Audited at: 2026-07-09T14:22:03.977\+00:00
- Summary: The audit confirms one filesystem-boundary risk: SKILL.md line 29 points to a parent-directory documentation file outside the scanned skill package. The .env reference on line 16 is a safe contextual use case, not an instruction to read or expose secrets. No prompt injection or additional semantic issue was found in the reviewed file.

## Stats

- Views: 188
- Downloads: 11
- Favorites: 0
- Popularity score: 0