flowstate-app-agents Package Skill

Package: @epicdm/flowstate-app-agents Repository: epic-flowstate-apps Path: packages/flowstate-app-agents Version: 1.0.0

Use this published Dojo skill as the package-level entrypoint. For detailed workflows, use the package-local skills listed below.

Primary Package Workflow

Agents Variables And Metrics

Status: Active Purpose: Guide changes to variable-context management and execution metric extraction. Scope: packages/flowstate-app-agents/src/hooks/useWorkflowVariables.ts, src/components/variables, and src/utils/executionMetrics.ts Trigger: Work touches .env parsing, codebase variables, execution metrics, tokens, costs, durations, or model lists. Input: Desired variable or metric behavior. Output: Utility and UI changes that preserve existing parsing and extraction fallbacks.

Workflow

1. For variable contexts, start with useWorkflowVariables.ts. It stores variables by codebaseId and context, and supports createOrUpdateVariables, deleteContext, and env import.
2. For env text, use parseEnvFile, isValidVariableKey, and formatToEnvFile from src/components/variables/utils/parseEnvFile.ts.
3. Preserve merge behavior when importing variables unless the caller explicitly chooses replacement.
4. For execution metrics, use extractExecutionMetrics from src/utils/executionMetrics.ts; it supports variables and step-history payload shapes.
5. Use formatTokens, formatTokensCompact, formatCost, formatDuration, and getUniqueModels instead of reimplementing display formatting.

Example

When adding a metric tile for model usage, call extractExecutionMetrics(execution) and derive the models with getUniqueModels(metrics.steps) so both variable-based and step-history executions render.

Verification

• Add focused unit tests for new parser or formatter behavior.
• yarn workspace @epicdm/flowstate-app-agents typecheck

Created: 2026-06-30

Package Skill Inventory

FlowState Agents Skill Inventory

Reviewed: 2026-06-30

Skills

Review Notes

The skill split follows the package behavior: one app-level orchestration skill, one collection-hook workflow skill, and one focused reference skill for variable and execution-metric utilities. No skills were created from feature-matrix labels alone.

Review Gate

FlowState Agents Skills Review

Reviewed: 2026-06-30 Status: Pass with package-local scope

Checks

• Skills cite source paths from the app package.
• Skills describe reusable agent workflows, not a generated feature list.
• Skills avoid writing or relying on .flowstate/dojo.
• Skills include package-local verification commands.

Residual Risk

The package script named test currently echoes No tests yet, while src/hooks/__tests__/useTeamMemberAgents.test.ts exists. Prefer targeted test runner discovery before relying on yarn workspace @epicdm/flowstate-app-agents test for coverage.

Start with this skill to understand the package purpose, then use the package-local focused skills for specific workflows. Keep this Dojo version aligned with packages/flowstate-app-agents/package.json. Do not treat generated feature lists as lessons; use workflow evidence from CODE-REVIEW.md, SKILL-INVENTORY.md, and REVIEW.md.