Skip to content
Closed
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
69 changes: 69 additions & 0 deletions .agents/skills/voltagent/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
```markdown
# voltagent Development Patterns

> Auto-generated skill from repository analysis

## Overview
This skill teaches the key development patterns and conventions used in the `voltagent` TypeScript codebase. It covers file naming, import/export styles, commit message conventions, and testing patterns. By following these guidelines, contributors can write consistent, maintainable code and collaborate effectively.

## Coding Conventions

### File Naming
- Use **PascalCase** for file names.
- Example: `MyComponent.ts`, `UserService.ts`

### Import Style
- Use **relative imports** for modules within the project.
- Example:
```typescript
import { UserService } from './UserService';
```

### Export Style
- Use **named exports** rather than default exports.
- Example:
```typescript
// UserService.ts
export function UserService() { ... }
```
```typescript
import { UserService } from './UserService';
```

### Commit Messages
- Use **conventional commit** format.
- Prefix new features with `feat`.
- Example:
```
feat: add user authentication
```

## Workflows

_No explicit workflows detected in this repository._

## Testing Patterns

- Test files follow the `*.test.*` pattern.
- Example: `UserService.test.ts`
- Testing framework is **unknown** (not detected).
- Place tests alongside the code or in a dedicated test directory.
- Example test file structure:
```typescript
// UserService.test.ts
import { UserService } from './UserService';

describe('UserService', () => {
it('should return user data', () => {
// test implementation
});
});
```

## Commands
| Command | Purpose |
|---------|---------|
| /conventions | Show coding conventions and examples |
| /test-patterns | Show how to write and name tests |
| /commit-guide | Show commit message guidelines |
```
Comment on lines +1 to +69
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Remove the outer code fence and fix markdownlint violations.

This file currently renders as a single code block instead of a skill document, and it also violates MD058/MD040.

Suggested patch
-```markdown
 # voltagent Development Patterns
@@
 - Prefix new features with `feat`.
   - Example:
-    ```
+    ```text
     feat: add user authentication
     ```
@@
 ## Commands
+
 | Command | Purpose |
 |---------|---------|
 | /conventions | Show coding conventions and examples |
 | /test-patterns | Show how to write and name tests |
 | /commit-guide | Show commit message guidelines |
-```
🧰 Tools
🪛 markdownlint-cli2 (0.22.1)

[warning] 64-64: Tables should be surrounded by blank lines

(MD058, blanks-around-tables)


[warning] 68-68: Tables should be surrounded by blank lines

(MD058, blanks-around-tables)


[warning] 69-69: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.agents/skills/voltagent/SKILL.md around lines 1 - 69, Remove the outer
triple-backtick fence wrapping the entire SKILL.md so the document is real
markdown (locate the top-level "voltagent Development Patterns" heading and the
surrounding opening/closing ``` fences) and fix markdownlint issues by changing
the commit example fence to a language-tagged block (replace the ``` around
"feat: add user authentication" with ```text) and ensure there's a blank line
before the "## Commands" table (add one empty line above the table) so
MD040/MD058 violations are resolved.

6 changes: 6 additions & 0 deletions .agents/skills/voltagent/agents/openai.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
interface:
display_name: "Voltagent"
short_description: "Repo-specific patterns and workflows for voltagent"
default_prompt: "Use the voltagent repo skill to follow existing architecture, testing, and workflow conventions."
policy:
allow_implicit_invocation: true
220 changes: 220 additions & 0 deletions .claude/ecc-tools.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,220 @@
{
"version": "1.3",
"schemaVersion": "1.0",
"generatedBy": "ecc-tools",
"generatedAt": "2026-05-16T09:57:43.876Z",
"repo": "https://github.com/Abdullakala/voltagent",
"referenceSetReadiness": {
"score": 0,
"present": 0,
"total": 6,
"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": "harness-compatibility",
"label": "Harness compatibility",
"status": "missing",
"evidence": [],
"recommendation": "Add cross-harness, adapter-compliance, or harness-audit evidence for Claude, Codex, OpenCode, 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": "core",
"recommended": "core",
"effective": "core",
"requestedAlias": "core",
"recommendedAlias": "core",
"effectiveAlias": "core"
},
"requestedProfile": "core",
"profile": "core",
"recommendedProfile": "core",
"effectiveProfile": "core",
"tier": "free",
"requestedComponents": [
"repo-baseline"
],
"selectedComponents": [
"repo-baseline"
],
"requestedAddComponents": [],
"requestedRemoveComponents": [],
"blockedRemovalComponents": [],
"tierFilteredComponents": [],
"requestedRootPackages": [
"runtime-core"
],
"selectedRootPackages": [
"runtime-core"
],
"requestedPackages": [
"runtime-core"
],
"requestedAddPackages": [],
"requestedRemovePackages": [],
"selectedPackages": [
"runtime-core"
],
"packages": [
"runtime-core"
],
"blockedRemovalPackages": [],
"tierFilteredRootPackages": [],
"tierFilteredPackages": [],
"conflictingPackages": [],
"dependencyGraph": {
"runtime-core": []
},
"resolutionOrder": [
"runtime-core"
],
"requestedModules": [
"runtime-core"
],
"selectedModules": [
"runtime-core"
],
"modules": [
"runtime-core"
],
"managedFiles": [
".claude/skills/voltagent/SKILL.md",
".agents/skills/voltagent/SKILL.md",
".agents/skills/voltagent/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/voltagent-instincts.yaml"
],
"packageFiles": {
"runtime-core": [
".claude/skills/voltagent/SKILL.md",
".agents/skills/voltagent/SKILL.md",
".agents/skills/voltagent/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/voltagent-instincts.yaml"
]
},
"moduleFiles": {
"runtime-core": [
".claude/skills/voltagent/SKILL.md",
".agents/skills/voltagent/SKILL.md",
".agents/skills/voltagent/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/voltagent-instincts.yaml"
]
},
"files": [
{
"moduleId": "runtime-core",
"path": ".claude/skills/voltagent/SKILL.md",
"description": "Repository-specific Claude Code skill generated from git history."
},
{
"moduleId": "runtime-core",
"path": ".agents/skills/voltagent/SKILL.md",
"description": "Codex-facing copy of the generated repository skill."
},
{
"moduleId": "runtime-core",
"path": ".agents/skills/voltagent/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/voltagent-instincts.yaml",
"description": "Continuous-learning instincts derived from repository patterns."
}
],
"workflows": [],
"adapters": {
"claudeCode": {
"skillPath": ".claude/skills/voltagent/SKILL.md",
"identityPath": ".claude/identity.json",
"commandPaths": []
},
"codex": {
"configPath": ".codex/config.toml",
"agentsGuidePath": ".codex/AGENTS.md",
"skillPath": ".agents/skills/voltagent/SKILL.md"
}
}
}
Loading