simple-skill

The simple-skill is a foundational utility developed for the Skillet ecosystem, specifically tailored to validate the integration between the Skillet CLI and the Claude Code environment. As an engineering-focused diagnostic tool, it provides developers with a reliable way to ensure that their local or remote skill configuration is correctly parsed, the environment permissions are accurately set, and the execution pipeline is functioning as expected before running more complex, production-level agent workflows.

This skill is primarily intended for software engineers, automation specialists, and developers using Skillet to manage headless Claude agents. It acts as a "Hello World" for the toolchain, allowing users to verify that frontmatter parsing, variable interpolation, and tool-invocation protocols are operational. By triggering this skill, users can confirm that Skillet successfully communicates with the Claude CLI, handles the lifecycle of an agent request, and formats the output through the expected Charm-based terminal interface.

• Validates core Skillet CLI command parsing and execution pipelines.

• Verifies that YAML frontmatter configuration, such as model selection and tool permissions, is applied correctly.

• Confirms that terminal output formatting and stream-json parsing from Claude Code are functioning.

• Serves as a reference implementation for creating new agent skills within the .claude/skills directory structure.

• Supports headless operation for automated CI/CD testing environments.

• The skill should be invoked using the Skillet CLI: skillet simple-skill.

• Expected output upon successful execution is a confirmation message: "Task completed successfully."

• Use the --verbose flag with the Skillet CLI if the skill fails to report completion, as this provides deeper insight into the raw JSON streams and command history logs.

• Ensure that your local environment has the Claude CLI installed and authenticated before attempting to run this test, as Skillet relies on these credentials to perform actions.

• This skill does not require specific external API keys or complex tool access; it is designed to be lightweight and zero-dependency, making it the ideal starting point for troubleshooting connection issues between your terminal and the Claude agent system.