c6512333aa
- Created 19 AI-discoverable skills in .github/skills/ for GitHub Copilot - Updated 13 VS Code tasks to use skill-runner.sh - Added validation and helper infrastructure scripts - Maintained backward compatibility with deprecation notices - All tests pass with 85%+ coverage, zero security issues Benefits: - Skills are auto-discovered by GitHub Copilot - Consistent execution interface across all tools - Self-documenting with comprehensive SKILL.md files - Progressive disclosure reduces context usage - CI/CD workflows can use standardized skill-runner Closes: (add issue number if applicable) BREAKING CHANGE: None - backward compatible with 1 release cycle deprecation period
199 lines
4.5 KiB
Markdown
199 lines
4.5 KiB
Markdown
---
|
|
# agentskills.io specification v1.0
|
|
name: "test-frontend-unit"
|
|
version: "1.0.0"
|
|
description: "Run frontend unit tests without coverage analysis (fast execution)"
|
|
author: "Charon Project"
|
|
license: "MIT"
|
|
tags:
|
|
- "testing"
|
|
- "unit-tests"
|
|
- "frontend"
|
|
- "vitest"
|
|
- "fast"
|
|
compatibility:
|
|
os:
|
|
- "linux"
|
|
- "darwin"
|
|
shells:
|
|
- "bash"
|
|
requirements:
|
|
- name: "node"
|
|
version: ">=18.0"
|
|
optional: false
|
|
- name: "npm"
|
|
version: ">=9.0"
|
|
optional: false
|
|
environment_variables: []
|
|
parameters:
|
|
- name: "watch"
|
|
type: "boolean"
|
|
description: "Run tests in watch mode"
|
|
default: "false"
|
|
required: false
|
|
- name: "filter"
|
|
type: "string"
|
|
description: "Filter tests by name pattern"
|
|
default: ""
|
|
required: false
|
|
outputs:
|
|
- name: "test_results"
|
|
type: "stdout"
|
|
description: "Vitest output showing pass/fail status"
|
|
metadata:
|
|
category: "test"
|
|
subcategory: "unit"
|
|
execution_time: "short"
|
|
risk_level: "low"
|
|
ci_cd_safe: true
|
|
requires_network: false
|
|
idempotent: true
|
|
---
|
|
|
|
# Test Frontend Unit
|
|
|
|
## Overview
|
|
|
|
Executes the frontend unit test suite using Vitest without coverage analysis. This skill provides fast test execution for quick feedback during development, making it ideal for pre-commit checks and rapid iteration.
|
|
|
|
Unlike test-frontend-coverage, this skill does not generate coverage reports or enforce coverage thresholds, focusing purely on test pass/fail status.
|
|
|
|
## Prerequisites
|
|
|
|
- Node.js 18.0 or higher installed and in PATH
|
|
- npm 9.0 or higher installed and in PATH
|
|
- Frontend dependencies installed (`cd frontend && npm install`)
|
|
|
|
## Usage
|
|
|
|
### Basic Usage
|
|
|
|
Run all frontend unit tests:
|
|
|
|
```bash
|
|
cd /path/to/charon
|
|
.github/skills/scripts/skill-runner.sh test-frontend-unit
|
|
```
|
|
|
|
### Watch Mode
|
|
|
|
Run tests in watch mode for continuous testing:
|
|
|
|
```bash
|
|
.github/skills/scripts/skill-runner.sh test-frontend-unit -- --watch
|
|
```
|
|
|
|
### Filter Tests
|
|
|
|
Run tests matching a specific pattern:
|
|
|
|
```bash
|
|
.github/skills/scripts/skill-runner.sh test-frontend-unit -- --grep "Button"
|
|
```
|
|
|
|
### CI/CD Integration
|
|
|
|
For use in GitHub Actions or other CI/CD pipelines:
|
|
|
|
```yaml
|
|
- name: Run Frontend Unit Tests
|
|
run: .github/skills/scripts/skill-runner.sh test-frontend-unit
|
|
```
|
|
|
|
## Parameters
|
|
|
|
| Parameter | Type | Required | Default | Description |
|
|
|-----------|------|----------|---------|-------------|
|
|
| watch | boolean | No | false | Run tests in watch mode |
|
|
| filter | string | No | "" | Filter tests by name pattern |
|
|
|
|
## Environment Variables
|
|
|
|
No environment variables are required for this skill.
|
|
|
|
## Outputs
|
|
|
|
### Success Exit Code
|
|
- **0**: All tests passed
|
|
|
|
### Error Exit Codes
|
|
- **Non-zero**: One or more tests failed
|
|
|
|
### Console Output
|
|
Example output:
|
|
```
|
|
✓ src/components/Button.test.tsx (3)
|
|
✓ src/utils/helpers.test.ts (5)
|
|
✓ src/hooks/useAuth.test.ts (4)
|
|
|
|
Test Files 3 passed (3)
|
|
Tests 12 passed (12)
|
|
```
|
|
|
|
## Examples
|
|
|
|
### Example 1: Basic Execution
|
|
|
|
```bash
|
|
.github/skills/scripts/skill-runner.sh test-frontend-unit
|
|
```
|
|
|
|
### Example 2: Watch Mode for TDD
|
|
|
|
```bash
|
|
.github/skills/scripts/skill-runner.sh test-frontend-unit -- --watch
|
|
```
|
|
|
|
### Example 3: Test Specific File
|
|
|
|
```bash
|
|
.github/skills/scripts/skill-runner.sh test-frontend-unit -- Button.test.tsx
|
|
```
|
|
|
|
### Example 4: UI Mode (Interactive)
|
|
|
|
```bash
|
|
.github/skills/scripts/skill-runner.sh test-frontend-unit -- --ui
|
|
```
|
|
|
|
### Example 5: Reporter Configuration
|
|
|
|
```bash
|
|
.github/skills/scripts/skill-runner.sh test-frontend-unit -- --reporter=verbose
|
|
```
|
|
|
|
## Error Handling
|
|
|
|
### Common Errors
|
|
|
|
#### Error: Cannot find module
|
|
**Solution**: Run `npm install` to ensure all dependencies are installed
|
|
|
|
#### Error: Test timeout
|
|
**Solution**: Increase timeout in vitest.config.ts or fix hanging async tests
|
|
|
|
#### Error: Unexpected token
|
|
**Solution**: Check for syntax errors in test files
|
|
|
|
## Related Skills
|
|
|
|
- test-frontend-coverage - Run tests with coverage analysis (slower)
|
|
- test-backend-unit - Backend Go unit tests
|
|
- build-check-go - Verify builds without running tests
|
|
|
|
## Notes
|
|
|
|
- **Execution Time**: Fast execution (~3-5 seconds typical)
|
|
- **No Coverage**: Does not generate coverage reports
|
|
- **Vitest Features**: Full access to Vitest CLI options via arguments
|
|
- **Idempotency**: Safe to run multiple times
|
|
- **Caching**: Benefits from Vitest's smart caching
|
|
- **Suitable For**: Pre-commit hooks, quick feedback, TDD workflows
|
|
- **Watch Mode**: Available for interactive development
|
|
|
|
---
|
|
|
|
**Last Updated**: 2025-12-20
|
|
**Maintained by**: Charon Project Team
|
|
**Source**: Inline task command
|