Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
87 changes: 87 additions & 0 deletions .agents/skills/repopilot/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,87 @@
```markdown
# repopilot Development Patterns

> Auto-generated skill from repository analysis

## Overview
This skill teaches you the core development patterns and conventions used in the `repopilot` Python codebase. You'll learn about file organization, code style, commit patterns, and how to write and run tests. The repository uses Python with no detected framework, and follows clear naming and import/export conventions to ensure maintainability and readability.

## Coding Conventions

### File Naming
- Use **snake_case** for all file names.
- Example: `data_processor.py`, `user_utils.py`

### Import Style
- Use **relative imports** within the package.
- Example:
```python
from .utils import helper_function
```

### Export Style
- Use **named exports** (explicitly define what is exported).
- Example:
```python
__all__ = ['main_function', 'HelperClass']
```

### Commit Patterns
- **Type:** Mixed (features, fixes, etc.)
- **Prefix:** Use `feat` for new features.
- Example commit message: `feat: add support for batch processing`
- **Length:** Keep commit messages concise (average ~53 characters).

## Workflows

### Add a New Feature
**Trigger:** When you need to implement a new feature.
**Command:** `/add-feature`

1. Create a new Python file using snake_case if needed.
2. Implement the feature using relative imports for internal modules.
3. Add named exports to the file.
4. Write or update tests in a corresponding `*.test.*` file.
5. Commit your changes with a message starting with `feat:`.
- Example: `feat: implement data normalization utility`

### Run Tests
**Trigger:** When you want to verify your code changes.
**Command:** `/run-tests`

1. Identify all test files matching the pattern `*.test.*`.
2. Run the tests using your preferred Python test runner (e.g., `pytest`, `unittest`).
3. Review the results and fix any failing tests.

### Refactor Code
**Trigger:** When improving code structure or readability.
**Command:** `/refactor`

1. Rename files or functions to follow snake_case if necessary.
2. Update imports to use relative paths.
3. Ensure all exports are named.
4. Update or add tests as needed.
5. Commit changes with a clear message (e.g., `refactor: improve import structure`).

## Testing Patterns

- **Framework:** Not explicitly specified; use standard Python testing tools.
- **File Pattern:** Test files are named using `*.test.*` (e.g., `module.test.py`).
- **Example Test File:**
```python
# my_module.test.py
import unittest
from .my_module import my_function

class TestMyFunction(unittest.TestCase):
def test_basic(self):
self.assertEqual(my_function(2), 4)
```

## Commands
| Command | Purpose |
|----------------|-------------------------------------------|
| /add-feature | Start workflow to add a new feature |
| /run-tests | Run all tests in the repository |
| /refactor | Start workflow to refactor code |
```
6 changes: 6 additions & 0 deletions .agents/skills/repopilot/agents/openai.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
interface:
display_name: "Repopilot"
short_description: "Repo-specific patterns and workflows for repopilot"
default_prompt: "Use the repopilot repo skill to follow existing architecture, testing, and workflow conventions."
policy:
allow_implicit_invocation: true
272 changes: 272 additions & 0 deletions .claude/ecc-tools.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,272 @@
{
"version": "1.3",
"schemaVersion": "1.0",
"generatedBy": "ecc-tools",
"generatedAt": "2026-07-01T06:31:17.949Z",
"repo": "https://github.com/sreerevanth/repopilot",
"referenceSetReadiness": {
"score": 0,
"present": 0,
"total": 7,
"items": [
{
"id": "deep-analyzer-corpus",
"label": "Deep analyzer corpus",
"status": "missing",
"evidence": [],
"recommendation": "Add analyzer fixture, golden, benchmark, or reference-set files that can catch analyzer regressions."
},
{
"id": "rag-evaluator",
"label": "RAG/evaluator comparison",
"status": "missing",
"evidence": [],
"recommendation": "Add retrieval or evaluator reference-set comparison fixtures with expected ranking behavior."
},
{
"id": "pr-salvage",
"label": "PR salvage/review corpus",
"status": "missing",
"evidence": [],
"recommendation": "Add stale-PR, review-thread, reopen-flow, or salvage reference cases for queue cleanup automation."
},
{
"id": "discussion-triage",
"label": "Discussion triage corpus",
"status": "missing",
"evidence": [],
"recommendation": "Add public discussion triage fixtures, golden cases, or reference sets for informational, answered, and no-response classifications."
},
{
"id": "harness-compatibility",
"label": "Harness compatibility",
"status": "missing",
"evidence": [],
"recommendation": "Add cross-harness, adapter-compliance, or harness-audit evidence for Claude, Codex, OpenCode, Zed, dmux, and agent surfaces."
},
{
"id": "security-evidence",
"label": "Security evidence",
"status": "missing",
"evidence": [],
"recommendation": "Attach security evidence such as SBOMs, SARIF, audit reports, or AgentShield evidence packs."
},
{
"id": "ci-failure-mode",
"label": "CI failure-mode evidence",
"status": "missing",
"evidence": [],
"recommendation": "Add captured CI failure logs, dry-run fixtures, or troubleshooting docs for common workflow failure modes."
}
]
},
"profiles": {
"requested": "full",
"recommended": "full",
"effective": "developer",
"requestedAlias": "full",
"recommendedAlias": "full",
"effectiveAlias": "developer"
},
"requestedProfile": "full",
"profile": "developer",
"recommendedProfile": "full",
"effectiveProfile": "developer",
"tier": "free",
"requestedComponents": [
"repo-baseline",
"workflow-automation",
"security-audits",
"research-tooling",
"team-rollout",
"governance-controls"
],
"selectedComponents": [
"repo-baseline",
"workflow-automation"
],
"requestedAddComponents": [],
"requestedRemoveComponents": [],
"blockedRemovalComponents": [],
"tierFilteredComponents": [
"security-audits",
"research-tooling",
"team-rollout",
"governance-controls"
],
"requestedRootPackages": [
"runtime-core",
"workflow-pack",
"agentshield-pack",
"research-pack",
"team-config-sync",
"enterprise-controls"
],
"selectedRootPackages": [
"runtime-core",
"workflow-pack"
],
"requestedPackages": [
"runtime-core",
"workflow-pack",
"agentshield-pack",
"research-pack",
"team-config-sync",
"enterprise-controls"
],
"requestedAddPackages": [],
"requestedRemovePackages": [],
"selectedPackages": [
"runtime-core",
"workflow-pack"
],
"packages": [
"runtime-core",
"workflow-pack"
],
"blockedRemovalPackages": [],
"tierFilteredRootPackages": [
"agentshield-pack",
"research-pack",
"team-config-sync",
"enterprise-controls"
],
"tierFilteredPackages": [
"agentshield-pack",
"research-pack",
"team-config-sync",
"enterprise-controls"
],
"conflictingPackages": [],
"dependencyGraph": {
"runtime-core": [],
"workflow-pack": [
"runtime-core"
]
},
"resolutionOrder": [
"runtime-core",
"workflow-pack"
],
"requestedModules": [
"runtime-core",
"workflow-pack",
"agentshield-pack",
"research-pack",
"team-config-sync",
"enterprise-controls"
],
"selectedModules": [
"runtime-core",
"workflow-pack"
],
"modules": [
"runtime-core",
"workflow-pack"
],
"managedFiles": [
".claude/skills/repopilot/SKILL.md",
".agents/skills/repopilot/SKILL.md",
".agents/skills/repopilot/agents/openai.yaml",
".claude/identity.json",
".codex/config.toml",
".codex/AGENTS.md",
".codex/agents/explorer.toml",
".codex/agents/reviewer.toml",
".codex/agents/docs-researcher.toml",
".claude/homunculus/instincts/inherited/repopilot-instincts.yaml"
],
"packageFiles": {
"runtime-core": [
".claude/skills/repopilot/SKILL.md",
".agents/skills/repopilot/SKILL.md",
".agents/skills/repopilot/agents/openai.yaml",
".claude/identity.json",
".codex/config.toml",
".codex/AGENTS.md",
".codex/agents/explorer.toml",
".codex/agents/reviewer.toml",
".codex/agents/docs-researcher.toml",
".claude/homunculus/instincts/inherited/repopilot-instincts.yaml"
]
},
"moduleFiles": {
"runtime-core": [
".claude/skills/repopilot/SKILL.md",
".agents/skills/repopilot/SKILL.md",
".agents/skills/repopilot/agents/openai.yaml",
".claude/identity.json",
".codex/config.toml",
".codex/AGENTS.md",
".codex/agents/explorer.toml",
".codex/agents/reviewer.toml",
".codex/agents/docs-researcher.toml",
".claude/homunculus/instincts/inherited/repopilot-instincts.yaml"
]
},
"files": [
{
"moduleId": "runtime-core",
"path": ".claude/skills/repopilot/SKILL.md",
"description": "Repository-specific Claude Code skill generated from git history."
},
{
"moduleId": "runtime-core",
"path": ".agents/skills/repopilot/SKILL.md",
"description": "Codex-facing copy of the generated repository skill."
},
{
"moduleId": "runtime-core",
"path": ".agents/skills/repopilot/agents/openai.yaml",
"description": "Codex skill metadata so the repo skill appears cleanly in the skill interface."
},
{
"moduleId": "runtime-core",
"path": ".claude/identity.json",
"description": "Suggested identity.json baseline derived from repository conventions."
},
{
"moduleId": "runtime-core",
"path": ".codex/config.toml",
"description": "Repo-local Codex MCP and multi-agent baseline aligned with ECC defaults."
},
{
"moduleId": "runtime-core",
"path": ".codex/AGENTS.md",
"description": "Codex usage guide that points at the generated repo skill and workflow bundle."
},
{
"moduleId": "runtime-core",
"path": ".codex/agents/explorer.toml",
"description": "Read-only explorer role config for Codex multi-agent work."
},
{
"moduleId": "runtime-core",
"path": ".codex/agents/reviewer.toml",
"description": "Read-only reviewer role config focused on correctness and security."
},
{
"moduleId": "runtime-core",
"path": ".codex/agents/docs-researcher.toml",
"description": "Read-only docs researcher role config for API verification."
},
{
"moduleId": "runtime-core",
"path": ".claude/homunculus/instincts/inherited/repopilot-instincts.yaml",
"description": "Continuous-learning instincts derived from repository patterns."
}
],
"workflows": [],
"adapters": {
"claudeCode": {
"skillPath": ".claude/skills/repopilot/SKILL.md",
"identityPath": ".claude/identity.json",
"commandPaths": []
},
"codex": {
"configPath": ".codex/config.toml",
"agentsGuidePath": ".codex/AGENTS.md",
"skillPath": ".agents/skills/repopilot/SKILL.md"
}
}
}
Loading