1# Contributing to LLM-as-a-Judge Skills
2 
3Thank you for your interest in contributing! This project is part of the [Agent Skills for Context Engineering](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering) ecosystem.
4 
5## How to Contribute
6 
7### Reporting Issues
8 
9- Check existing issues first
10- Provide clear reproduction steps
11- Include test output if applicable
12 
13### Adding New Tools
14 
151. **Create the implementation** in `src/tools/<category>/<tool-name>.ts`
16   - Define input/output Zod schemas
17   - Implement execute function with error handling
18   - Include proper TypeScript types
19 
202. **Export from index** in `src/tools/<category>/index.ts`
21 
223. **Add documentation** in `tools/<category>/<tool-name>.md`
23   - Purpose and when to use
24   - Input/output specifications
25   - Example usage
26 
274. **Write tests** in `tests/`
28   - Unit tests for schema validation
29   - Integration tests with real API calls
30 
31### Code Style
32 
33- Run `npm run lint` before committing
34- Run `npm run format` for consistent formatting
35- Use TypeScript strict mode
36- Add JSDoc comments for public APIs
37 
38### Pull Request Process
39 
401. Fork the repository
412. Create a feature branch: `git checkout -b feature/my-feature`
423. Make your changes
434. Run tests: `npm test`
445. Commit: `git commit -m 'Add my feature'`
456. Push: `git push origin feature/my-feature`
467. Open a Pull Request
47 
48### Testing Guidelines
49 
50- Tests run against real OpenAI API (requires API key)
51- Use `60000ms` timeout for single API calls
52- Use `120000ms` timeout for multiple API calls
53- Tests should be deterministic despite LLM variance
54 
55## Development Setup
56 
57```bash
58# Clone
59git clone https://github.com/muratcankoylan/llm-as-judge-skills.git
60cd llm-as-judge-skills
61 
62# Install
63npm install
64 
65# Configure
66cp env.example .env
67# Add your OPENAI_API_KEY to .env
68 
69# Build
70npm run build
71 
72# Test
73npm test
74```
75 
76## Questions?
77 
78Open an issue or reach out via the main repository.
79