Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
30 commits
Select commit Hold shift + click to select a range
9c2c054
Add 8 new skills: foundation, standards, and development series
claude Jan 27, 2026
41aa55f
Package 8 skills as distributable .skill files for upload
claude Jan 27, 2026
d500c06
feat: add skills_claude ECC bundle (.claude/ecc-tools.json)
ecc-tools[bot] Mar 24, 2026
02d475d
feat: add skills_claude ECC bundle (.claude/skills/skills_claude/SKIL…
ecc-tools[bot] Mar 24, 2026
15f0afb
feat: add skills_claude ECC bundle (.agents/skills/skills_claude/SKIL…
ecc-tools[bot] Mar 24, 2026
9b77c5c
feat: add skills_claude ECC bundle (.agents/skills/skills_claude/agen…
ecc-tools[bot] Mar 24, 2026
947cde4
feat: add skills_claude ECC bundle (.claude/identity.json)
ecc-tools[bot] Mar 24, 2026
febebc9
feat: add skills_claude ECC bundle (.codex/config.toml)
ecc-tools[bot] Mar 24, 2026
f21c140
feat: add skills_claude ECC bundle (.codex/AGENTS.md)
ecc-tools[bot] Mar 24, 2026
ad7c562
feat: add skills_claude ECC bundle (.codex/agents/explorer.toml)
ecc-tools[bot] Mar 24, 2026
7a320d9
feat: add skills_claude ECC bundle (.codex/agents/reviewer.toml)
ecc-tools[bot] Mar 24, 2026
82bed6b
feat: add skills_claude ECC bundle (.codex/agents/docs-researcher.toml)
ecc-tools[bot] Mar 24, 2026
7057a28
feat: add skills_claude ECC bundle (.claude/homunculus/instincts/inhe…
ecc-tools[bot] Mar 24, 2026
08a2b9a
feat: add skills_claude ECC bundle (.claude/commands/feature-developm…
ecc-tools[bot] Mar 24, 2026
642cdc8
feat: add skills_claude ECC bundle (.claude/commands/add-new-skill.md)
ecc-tools[bot] Mar 24, 2026
251a1b8
feat: add skills_claude ECC bundle (.claude/commands/update-or-export…
ecc-tools[bot] Mar 24, 2026
36e1e69
Merge pull request #2 from Eaprime1/ecc-tools/skills_claude-177439354…
Eaprime1 Mar 24, 2026
0c45701
Merge branch 'anthropics:main' into claude/skills-brainstorm-Nd4vz
Eaprime1 Mar 24, 2026
98dcfbc
feat: add skills_claude ECC bundle (.claude/ecc-tools.json)
ecc-tools[bot] Mar 24, 2026
014ca80
feat: add skills_claude ECC bundle (.claude/skills/skills_claude/SKIL…
ecc-tools[bot] Mar 24, 2026
05e8579
feat: add skills_claude ECC bundle (.agents/skills/skills_claude/SKIL…
ecc-tools[bot] Mar 24, 2026
4054129
feat: add skills_claude ECC bundle (.agents/skills/skills_claude/agen…
ecc-tools[bot] Mar 24, 2026
d128924
feat: add skills_claude ECC bundle (.claude/identity.json)
ecc-tools[bot] Mar 24, 2026
7bab2c8
feat: add skills_claude ECC bundle (.codex/agents/explorer.toml)
ecc-tools[bot] Mar 24, 2026
5512f85
feat: add skills_claude ECC bundle (.codex/agents/reviewer.toml)
ecc-tools[bot] Mar 24, 2026
56bdd01
feat: add skills_claude ECC bundle (.codex/agents/docs-researcher.toml)
ecc-tools[bot] Mar 24, 2026
3fc4041
feat: add skills_claude ECC bundle (.claude/commands/feature-developm…
ecc-tools[bot] Mar 24, 2026
8c36527
feat: add skills_claude ECC bundle (.claude/commands/refactoring.md)
ecc-tools[bot] Mar 24, 2026
c8c4c2c
feat: add skills_claude ECC bundle (.claude/commands/add-or-update-sk…
ecc-tools[bot] Mar 24, 2026
f42253a
Merge pull request #4 from Eaprime1/ecc-tools/skills_claude-177439390…
Eaprime1 Mar 24, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
338 changes: 338 additions & 0 deletions .agents/skills/skills_claude/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,338 @@
---
name: skills-claude-conventions
description: Development conventions and patterns for skills_claude. Python project with mixed commits.
---

# Skills Claude Conventions

> Generated from [Eaprime1/skills_claude](https://github.com/Eaprime1/skills_claude) on 2026-03-24

## Overview

This skill teaches Claude the development patterns and conventions used in skills_claude.

## Tech Stack

- **Primary Language**: Python
- **Architecture**: hybrid module organization
- **Test Location**: separate

## When to Use This Skill

Activate this skill when:
- Making changes to this repository
- Adding new features following established patterns
- Writing tests that match project conventions
- Creating commits with proper message format

## Commit Conventions

Follow these commit message conventions based on 42 analyzed commits.

### Commit Style: Mixed Style

### Prefixes Used

- `feat`
- `chore`

### Message Guidelines

- Average message length: ~56 characters
- Keep first line concise and descriptive
- Use imperative mood ("Add feature" not "Added feature")


*Commit message example*

```text
feat: add skills_claude ECC bundle (.claude/commands/update-or-export-example-skills.md)
```

*Commit message example*

```text
chore: update claude-api skill [auto-sync] (#729)
```

*Commit message example*

```text
Merge branch 'anthropics:main' into claude/skills-brainstorm-Nd4vz
```

*Commit message example*

```text
Merge pull request #2 from Eaprime1/ecc-tools/skills_claude-1774393541560
```

*Commit message example*

```text
feat: add skills_claude ECC bundle (.claude/commands/add-new-skill.md)
```

*Commit message example*

```text
feat: add skills_claude ECC bundle (.claude/commands/feature-development.md)
```

*Commit message example*

```text
feat: add skills_claude ECC bundle (.codex/agents/docs-researcher.toml)
```

*Commit message example*

```text
feat: add skills_claude ECC bundle (.codex/agents/reviewer.toml)
```

## Architecture

### Project Structure: Single Package

This project uses **hybrid** module organization.

### Guidelines

- This project uses a hybrid organization
- Follow existing patterns when adding new code

## Code Style

### Language: Python

### Naming Conventions

| Element | Convention |
|---------|------------|
| Files | kebab-case |
| Functions | camelCase |
| Classes | PascalCase |
| Constants | SCREAMING_SNAKE_CASE |

### Import Style: Relative Imports

### Export Style: Named Exports


*Preferred import style*

```typescript
// Use relative imports
import { Button } from '../components/Button'
import { useAuth } from './hooks/useAuth'
```

*Preferred export style*

```typescript
// Use named exports
export function calculateTotal() { ... }
export const TAX_RATE = 0.1
export interface Order { ... }
```

## Common Workflows

These workflows were detected from analyzing commit patterns.

### Feature Development

Standard feature implementation workflow

**Frequency**: ~19 times per month

**Steps**:
1. Add feature implementation
2. Add tests for feature
3. Update documentation

**Files typically involved**:
- `**/*.test.*`
- `**/api/**`

**Example commit sequence**:
```
Add 3rd Party notices (#4)
Add initial Agent Skills Spec (#2)
Small tweak to blog link (#7)
```

### Refactoring

Code refactoring and cleanup workflow

**Frequency**: ~2 times per month

**Steps**:
1. Ensure tests pass before refactor
2. Refactor code structure
3. Verify tests still pass

**Files typically involved**:
- `src/**/*`

**Example commit sequence**:
```
Reorganize the example skills (#1)
Adding more details to README (#3)
Add 3rd Party notices (#4)
```

### Add Or Update Skill

Adds a new skill or updates an existing skill, including its SKILL.md and related scripts/assets.

**Frequency**: ~2 times per month

**Steps**:
1. Create or update SKILL.md in skills/<skill-name>/
2. Add or update supporting scripts, templates, or assets in the skill's folder
3. If applicable, update marketplace or index files (e.g., .claude-plugin/marketplace.json)
4. Optionally, add language-specific guides or reference files

**Files typically involved**:
- `skills/*/SKILL.md`
- `skills/*/scripts/*.py`
- `skills/*/templates/*`
- `skills/*/reference/*`
- `.claude-plugin/marketplace.json`

**Example commit sequence**:
```
Create or update SKILL.md in skills/<skill-name>/
Add or update supporting scripts, templates, or assets in the skill's folder
If applicable, update marketplace or index files (e.g., .claude-plugin/marketplace.json)
Optionally, add language-specific guides or reference files
```

### Export Or Bundle Skills

Exports multiple skills as distributable bundles or updates the exported set of skills.

**Frequency**: ~1 times per month

**Steps**:
1. Aggregate or update SKILL.md and related files for all relevant skills
2. Generate distributable bundles (e.g., .skill files in dist/)
3. Update index/marketplace files if needed

**Files typically involved**:
- `dist/*.skill`
- `skills/*/SKILL.md`
- `.claude-plugin/marketplace.json`

**Example commit sequence**:
```
Aggregate or update SKILL.md and related files for all relevant skills
Generate distributable bundles (e.g., .skill files in dist/)
Update index/marketplace files if needed
```

### Office Skill Shared Module Update

Updates or reorganizes shared Office document processing modules (docx, pptx, xlsx) and their schemas/scripts.

**Frequency**: ~1 times per month

**Steps**:
1. Update or reorganize scripts in skills/{docx,pptx,xlsx}/scripts/office/
2. Update or add schemas in skills/{docx,pptx,xlsx}/scripts/office/schemas/
3. Update pack/unpack/validate scripts for each Office skill
4. Optionally, update SKILL.md or documentation for each skill

**Files typically involved**:
- `skills/docx/scripts/office/**/*`
- `skills/pptx/scripts/office/**/*`
- `skills/xlsx/scripts/office/**/*`
- `skills/docx/scripts/office/schemas/**/*`
- `skills/pptx/scripts/office/schemas/**/*`
- `skills/xlsx/scripts/office/schemas/**/*`
- `skills/docx/scripts/office/pack.py`
- `skills/pptx/scripts/office/pack.py`
- `skills/xlsx/scripts/office/pack.py`
- `skills/docx/SKILL.md`
- `skills/pptx/SKILL.md`
- `skills/xlsx/SKILL.md`

**Example commit sequence**:
```
Update or reorganize scripts in skills/{docx,pptx,xlsx}/scripts/office/
Update or add schemas in skills/{docx,pptx,xlsx}/scripts/office/schemas/
Update pack/unpack/validate scripts for each Office skill
Optionally, update SKILL.md or documentation for each skill
```

### Skill Creator Tooling Update

Updates scripts, references, or documentation in the skill-creator tool, including validation, packaging, and optimization scripts.

**Frequency**: ~1 times per month

**Steps**:
1. Update or add scripts in skills/skill-creator/scripts/
2. Update references or documentation in skills/skill-creator/references/
3. Update SKILL.md for skill-creator if needed

**Files typically involved**:
- `skills/skill-creator/scripts/*.py`
- `skills/skill-creator/references/*.md`
- `skills/skill-creator/SKILL.md`

**Example commit sequence**:
```
Update or add scripts in skills/skill-creator/scripts/
Update references or documentation in skills/skill-creator/references/
Update SKILL.md for skill-creator if needed
```

### Add Or Update Claude Api Skill

Adds or updates the claude-api documentation skill, including language-specific guides and shared references.

**Frequency**: ~1 times per month

**Steps**:
1. Add or update skills/claude-api/SKILL.md
2. Add or update language guides in skills/claude-api/{python,typescript,java,go,ruby,csharp,php,curl}/
3. Update shared documentation in skills/claude-api/shared/
4. Update marketplace or index if needed

**Files typically involved**:
- `skills/claude-api/SKILL.md`
- `skills/claude-api/*/claude-api.md`
- `skills/claude-api/*/README.md`
- `skills/claude-api/*/*.md`
- `skills/claude-api/shared/*.md`
- `.claude-plugin/marketplace.json`

**Example commit sequence**:
```
Add or update skills/claude-api/SKILL.md
Add or update language guides in skills/claude-api/{python,typescript,java,go,ruby,csharp,php,curl}/
Update shared documentation in skills/claude-api/shared/
Update marketplace or index if needed
```


## Best Practices

Based on analysis of the codebase, follow these practices:

### Do

- Use kebab-case for file names
- Prefer named exports

### Don't

- Don't deviate from established patterns without discussion

---

*This skill was auto-generated by [ECC Tools](https://ecc.tools). Review and customize as needed for your team.*
6 changes: 6 additions & 0 deletions .agents/skills/skills_claude/agents/openai.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
interface:
display_name: "Skills Claude"
short_description: "Repo-specific patterns and workflows for skills_claude"
default_prompt: "Use the skills_claude repo skill to follow existing architecture, testing, and workflow conventions."
policy:
allow_implicit_invocation: true
41 changes: 41 additions & 0 deletions .claude/commands/add-new-skill.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
---
name: add-new-skill
description: Workflow command scaffold for add-new-skill in skills_claude.
allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"]
---

# /add-new-skill

Use this workflow when working on **add-new-skill** in `skills_claude`.

## Goal

Adds a new skill to the repository, including its SKILL.md and any supporting files.

## Common Files

- `skills/*/SKILL.md`
- `skills/*/LICENSE.txt`
- `skills/*/scripts/*`
- `skills/*/templates/*`
- `skills/*/examples/*`
- `skills/*/reference/*`

## Suggested Sequence

1. Understand the current state and failure mode before editing.
2. Make the smallest coherent change that satisfies the workflow goal.
3. Run the most relevant verification for touched files.
4. Summarize what changed and what still needs review.

## Typical Commit Signals

- Create a new folder under skills/ (or previously examples/, document-skills/, office-examples/).
- Add SKILL.md to the new skill folder.
- Optionally add LICENSE.txt, scripts/, templates/, examples/, or reference/ subfolders and files as needed.
- Update skills/README.md or .claude-plugin/marketplace.json if necessary.

## Notes

- Treat this as a scaffold, not a hard-coded script.
- Update the command if the workflow evolves materially.
Loading