extracting-ai-context

Extracts version-matched AI skills and AGENTS.md guidance from workflow-kotlin library JARs.

1.1k|112|Updated Jun 2, 2020
One-click install
npx skills add https://github.com/square/workflow-kotlin --skill extracting-ai-context
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: extracting-ai-context
Source: https://github.com/square/workflow-kotlin/tree/main/.agents/skills/extracting-ai-context
Command: npx skills add https://github.com/square/workflow-kotlin --skill extracting-ai-context

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When using the workflow-kotlin library, AI coding agents need version-matched skills and project guidance to give accurate assistance. Manually copying skills and AGENTS.md content after every dependency upgrade is error-prone and quickly goes stale.

Core Features & Use Cases

  • Gradle-based extraction: Runs the extractAiContext task to pull skills and AGENTS.md guidance directly from workflow-kotlin JARs on the classpath.
  • Multi-agent support: Writes skills to agent-specific directories (.agents/skills/, .claude/skills/, .goose/skills/, etc.) via the --tools flag.
  • Safe AGENTS.md merging: Injects workflow-kotlin guidance between delimited markers so existing project content is preserved and cleanly replaced on updates.
  • Use Case: After bumping the workflow-kotlin dependency version, re-run the extraction task so your AI agent's skills and guidance match the new library version.

Quick Start

Ask the agent to run the Gradle extractAiContext task to extract the workflow-kotlin skills and AGENTS.md guidance into this project.

Frequently Asked Questions about extracting-ai-context

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract AI skills from workflow-kotlin JARs?

Apply the com.squareup.workflow1.ai-context Gradle plugin, then run ./gradlew extractAiContext. This extracts skills to .agents/skills/ and merges workflow-kotlin guidance into AGENTS.md.

How do I update workflow-kotlin AI skills after a version bump?

Re-run ./gradlew extractAiContext after updating the dependency version. Skills in .agents/skills/ are overwritten with new versions, and injection markers in AGENTS.md ensure old content is cleanly replaced.

Does the extraction task support Claude Code and other AI agents?

Yes, use the --tools flag such as --tools=amp,claude-code,goose. Claude Code writes to .claude/skills/, Goose to .goose/skills/, and the default amp option covers Cursor, Codex, Copilot, and Gemini CLI via .agents/skills/.

Why is no AI context extracted by the Gradle task?

Verify the com.squareup.workflow1.ai-context plugin is applied and workflow-kotlin dependencies like workflow-core are on the classpath. Run ./gradlew extractAiContext --info for verbose diagnostic output.

Can I preview AI context extraction without writing files?

Yes, run ./gradlew extractAiContext --preview to see what would be extracted without modifying any files. This is recommended when adopting the plugin in an existing repository.