skill-test

Simple test skill to verify skills system is working. Use this skill when asked to test skills, verify skill discovery, or run a skill test.

⭐39stars🔀12forks📁View on GitHub🕐Updated Oct 27, 2025

When & Why to Use This Skill

The Skill Test utility is a fundamental diagnostic tool designed for developers to validate the integrity and functionality of the Claude Agent SDK skills system. It ensures that the agent can successfully discover, invoke, and parse responses from project-level skills, providing a reliable baseline for troubleshooting and environment setup.

Use Cases

  • Initial Environment Setup: Run this skill immediately after installing the Claude Agent SDK to confirm the system is correctly configured and operational.
  • Skill Discovery Verification: Use it to verify that the agent is correctly identifying and loading skill files from the .claude/skills/ directory.
  • Integration Troubleshooting: Invoke the test skill when custom skills fail to determine if the issue is with the specific skill logic or the underlying SDK infrastructure.
  • Response Parsing Validation: Confirm that the communication bridge between the agent and local tools is properly handling JSON outputs and timestamps.
nameskill-test
description"Simple test skill to verify skills system is working. Use this skill when asked to test skills, verify skill discovery, or run a skill test."
version1.0.0

Skill Test

A simple test skill to verify that the Claude Agent SDK skills system is functioning correctly.

Purpose

This skill exists purely for testing. When invoked, it returns a simple JSON response to confirm:

  1. Skills are being discovered from .claude/skills/ directory
  2. The SDK can invoke project-level skills
  3. JSON responses are properly parsed

When to Use

Use this skill when:

  • Asked to "test skills"
  • Asked to "verify skills work"
  • Asked to "run a skill test"
  • Testing the skills system

What This Skill Does

Simply returns a JSON response with:

  • A success flag
  • A timestamp
  • A greeting message
  • The skill version

Output Format

Return ONLY valid JSON. No markdown code fences, no explanation.

{
  "success": true,
  "message": "Skill system is working!",
  "timestamp": "<current ISO timestamp>",
  "version": "1.0.0",
  "test_data": {
    "skill_name": "skill-test",
    "invocation_count": 1
  }
}

Example Response

{
  "success": true,
  "message": "Skill system is working!",
  "timestamp": "2025-10-24T12:34:56.789Z",
  "version": "1.0.0",
  "test_data": {
    "skill_name": "skill-test",
    "invocation_count": 1
  }
}

That's it! This skill should be trivial to invoke and verify.