skill adapter

Data Community

Skill notes

Overview

Analyzes existing plugins in the repository to extract their capabilities, then synthesizes and applies those learned patterns to the current task. Functions as a universal skill chameleon that discovers relevant plugins, extracts their approaches and methodologies, and adapts them to novel requests.

Prerequisites

Read access to the plugins/ directory tree (community, packages, examples categories) grep and find available on PATH for plugin discovery Familiarity with the plugin structure: commands/*.md, agents/*.md, skills/*/SKILL.md, and scripts/

Instructions

Analyze the user's task to identify the core capability needed, the domain (security, devops, testing, documentation, etc.), and key requirements or constraints (see ${CLAUDE_SKILL_DIR}/references/how-it-works.md). Search existing plugins for relevant capabilities using file globbing across plugins/community/, plugins/packages/, and plugins/examples/ directories. Match on plugin.json descriptions and keyword fields.

Output

A structured adaptation report containing: List of plugins analyzed and capabilities extracted from each The synthesized approach combining relevant patterns The direct application of that approach to the user's task Any caveats or limitations of the adapted skill

Error Handling

Error · Cause · Solution No matching plugins found · Search terms too narrow or domain not represented · Broaden search keywords; check alternative categories; fall back to general-purpose approach Plugin directory inaccessible · Missing read permissions or incorrect path · Verify plugins/ directory exists and permissions allow traversal Incompatible patterns · Extracted approaches conflict with current environment · Prioritize the most relevant plugin's approach; discard conflicting elements

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Data
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
88 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@jeremylongshore · no license declared
Token usage
Lean
Setup complexity
Guided setup
External API key
Not required
Operating systems
Docker
Runtime requirements
Docker
Detected file/system behavior
  • Read-only
  • Write / modify
Network behavior
Local-only
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Author source file SKILL.md
# Skill Adapter

## Overview

Analyzes existing plugins in the repository to extract their capabilities, then synthesizes and applies those learned patterns to the current task. Functions as a universal skill chameleon that discovers relevant plugins, extracts their approaches and methodologies, and adapts them to novel requests.

## Prerequisites

- Read access to the `plugins/` directory tree (community, packages, examples categories)
- `grep` and `find` available on PATH for plugin discovery
- Familiarity with the plugin structure: `commands/*.md`, `agents/*.md`, `skills/*/SKILL.md`, and `scripts/`

## Instructions

1. Analyze the user's task to identify the core capability needed, the domain (security, devops, testing, documentation, etc.), and key requirements or constraints (see `${CLAUDE_SKILL_DIR}/references/how-it-works.md`).
2. Search existing plugins for relevant capabilities using file globbing across `plugins/community/`, `plugins/packages/`, and `plugins/examples/` directories. Match on `plugin.json` descriptions and keyword fields.
3. For each relevant plugin discovered, extract capabilities from its components:
   - **Commands** (`commands/*.md`): read content, extract approach and input/output patterns.
   - **Agents** (`agents/*.md`): understand roles, decision-making patterns, expertise areas.
   - **Skills** (`skills/*/SKILL.md`): read instructions, extract core capability and tool usage.
   - **Scripts** (`scripts/*.sh`, `*.py`): analyze logic, identify reusable patterns and error handling.
4. Synthesize extracted patterns by merging complementary approaches, simplifying where possible, and ensuring compatibility with the current environment.
5. Apply the adapted skill to the user's task, following the learned methodology while adjusting syntax, tools, and output format to match the current context.
6. Report which plugins were consulted, what patterns were extracted, and how they were adapted for the current task.

## Output

A structured adaptation report containing:

- List of plugins analyzed and capabilities extracted from each
- The synthesized approach combining relevant patterns
- The direct application of that approach to the user's task
- Any caveats or limitations of the adapted skill

## Error Handling

| Error | Cause | Solution |
|---|---|---|
| No matching plugins found | Search terms too narrow or domain not represented | Broaden search keywords; check alternative categories; fall back to general-purpose approach |
| Plugin directory inaccessible | Missing read permissions or incorrect path | Verify `plugins/` directory exists and permissions allow traversal |
| Incompatible patterns | Extracted approaches conflict with current environment | Prioritize the most relevant plugin's approach; discard conflicting elements |
| Empty skill/command files | Plugin has stub content without real instructions | Skip that plugin and note it as incomplete; rely on other sources |

## Examples

**Learning code analysis from security plugins:**
Task: "Analyze this codebase for issues."
Process: Discover `owasp-top-10-scanner`, `code-quality-enforcer`, and `security-audit-agent`. Extract OWASP vulnerability checks, complexity/duplication metrics, and dependency scanning patterns. Synthesize a multi-layer analysis covering security, quality, and dependencies. Apply to the target codebase (see `${CLAUDE_SKILL_DIR}/references/example-workflows.md`).

**Adopting documentation skills:**
Task: "Generate API documentation."
Process: Find `api-documenter`, `openapi-generator`, `readme-builder`. Extract code parsing, OpenAPI spec generation, and hierarchical documentation structuring. Combine into an end-to-end pipeline: parse endpoints, generate spec, create interactive docs, build README.

**Learning automation from DevOps plugins:**
Task: "Automate deployment process."
Process: Search DevOps category for deployment, CI/CD, and Docker plugins. Extract build-test-deploy-verify workflows, parallel job patterns, and service orchestration. Adapt to the user's specific tech stack and infrastructure.

## Resources

- `${CLAUDE_SKILL_DIR}/references/how-it-works.md` -- detailed five-phase adaptation process
- `${CLAUDE_SKILL_DIR}/references/example-workflows.md` -- end-to-end workflow examples
- `${CLAUDE_SKILL_DIR}/references/errors.md` -- error handling patterns

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.