Packages
fnord
0.9.39
0.9.40
0.9.39
0.9.38
0.9.37
0.9.36
0.9.35
0.9.34
0.9.33
0.9.32
0.9.31
0.9.30
0.9.29
0.9.28
0.9.27
0.9.26
0.9.25
0.9.24
0.9.23
0.9.22
0.9.21
0.9.20
0.9.19
0.9.18
0.9.17
0.9.16
0.9.15
0.9.14
0.9.13
0.9.12
0.9.11
0.9.10
0.9.9
0.9.8
0.9.7
0.9.6
0.9.5
0.9.4
0.9.3
0.9.2
0.9.1
0.9.0
0.8.99
0.8.98
0.8.97
0.8.96
0.8.95
0.8.94
0.8.93
0.8.92
0.8.91
0.8.90
0.8.89
0.8.88
0.8.87
0.8.86
0.8.85
0.8.84
0.8.83
0.8.82
0.8.81
0.8.80
0.8.79
0.8.78
0.8.77
0.8.76
0.8.75
0.8.74
0.8.73
0.8.72
0.8.71
0.8.70
0.8.69
0.8.68
0.8.67
0.8.66
0.8.65
0.8.64
0.8.63
0.8.62
0.8.61
0.8.60
0.8.59
0.8.58
0.8.57
0.8.56
0.8.55
0.8.54
0.8.53
0.8.52
0.8.51
0.8.50
0.8.49
0.8.48
0.8.47
0.8.46
0.8.45
0.8.44
0.8.43
0.8.42
0.8.41
0.8.40
0.8.39
0.8.38
0.8.37
0.8.36
0.8.35
0.8.34
0.8.33
0.8.32
0.8.31
0.8.30
0.8.29
0.8.27
0.8.26
0.8.25
0.8.24
0.8.23
0.8.22
0.8.21
0.8.20
0.8.19
0.8.18
0.8.17
0.8.16
0.8.15
0.8.14
0.8.13
0.8.12
0.8.11
0.8.1
0.8.0
0.7.24
0.7.23
0.7.22
0.7.21
0.7.20
0.7.19
0.7.18
0.7.17
0.7.16
0.7.15
0.7.14
0.7.13
0.7.12
0.7.11
0.7.10
0.7.9
0.7.8
0.7.7
0.7.6
0.7.5
0.7.3
0.7.2
0.7.1
0.7.0
0.6.9
0.6.8
0.6.7
0.6.6
0.6.5
0.6.4
0.6.3
0.6.1
0.6.0
0.5.9
0.5.8
0.5.7
0.5.6
0.5.5
0.5.4
0.5.3
0.5.2
0.5.1
0.5.0
0.4.44
0.4.43
0.4.42
0.4.41
0.4.40
0.4.39
0.4.38
0.4.37
0.4.36
0.4.35
0.4.34
0.4.33
0.4.32
0.4.30
0.4.29
0.4.28
0.4.27
0.4.26
0.4.25
0.4.24
0.4.23
0.4.22
0.4.21
0.4.20
0.4.19
0.4.18
0.4.17
0.4.16
0.4.15
0.4.14
0.4.13
0.4.12
0.4.11
0.4.10
0.4.9
0.4.8
0.4.7
0.4.6
0.4.5
0.4.4
0.4.3
0.4.2
0.4.1
0.4.0
0.3.0
0.2.0
0.1.0
AI code archaeology
Current section
Files
Jump to
Current section
Files
lib/skills.ex
defmodule Skills do
@moduledoc """
Skills are TOML-defined agent presets that can be executed by the coordinator.
This context module is the integration point that:
- discovers skill definitions on disk,
- applies precedence (user overrides project definitions by name),
- applies enablement (via `Settings.Skills`), and
- returns skill metadata suitable for dynamic tool specs and `fnord skills list`.
Disk locations:
- User skills: `~/fnord/skills/*.toml`
- Project skills: `~/.fnord/projects/<project>/skills/*.toml`
Enablement:
- Global settings key: `skills`
- Project settings key: `projects.<project>.skills`
Effective enablement is the union of the global and project lists.
"""
@type definition :: %{
skill: Skills.Skill.t(),
source: Skills.Loader.skill_source(),
path: String.t()
}
@type resolved_skill :: %{
name: String.t(),
effective: definition,
definitions: [definition]
}
@type list_error :: Skills.Loader.load_error() | {:no_project_selected}
@doc """
List all resolved skills available for the current project context.
Returned entries include all definition locations and the effective
definition after applying precedence rules.
This function does not filter to enabled skills.
"""
@spec list_all() :: {:ok, [resolved_skill]} | {:error, list_error}
def list_all() do
with {:ok, user} <- Skills.Loader.load_dir(user_skills_dir(), :user),
{:ok, project} <- load_project_skills() do
{:ok, resolve_definitions(user, project)}
end
end
@doc """
List resolved skills that are enabled in the current project context.
Enablement is controlled by `Settings.Skills`.
"""
@spec list_enabled() :: {:ok, [resolved_skill]} | {:error, list_error}
def list_enabled() do
with {:ok, all} <- list_all() do
enabled = Settings.Skills.effective_enabled()
all
|> Enum.filter(fn %{name: name} -> MapSet.member?(enabled, name) end)
|> then(&{:ok, &1})
end
end
@doc """
Get a resolved skill by name.
Returns `{:ok, resolved_skill}` if found, `{:error, :not_found}` otherwise.
"""
@spec get(String.t()) :: {:ok, resolved_skill} | {:error, :not_found | list_error}
def get(name) when is_binary(name) do
with {:ok, all} <- list_all() do
all
|> Enum.find(fn %{name: n} -> n == name end)
|> case do
nil -> {:error, :not_found}
found -> {:ok, found}
end
end
end
@doc """
Get an enabled skill by name.
Returns `{:ok, resolved_skill}` if the skill is enabled in the current project context, `{:error, :not_found | list_error}` otherwise.
"""
@spec get_enabled(String.t()) :: {:ok, resolved_skill} | {:error, :not_found | list_error}
def get_enabled(name) when is_binary(name) do
with {:ok, enabled} <- list_enabled() do
enabled
|> Enum.find(fn %{name: n} -> n == name end)
|> case do
nil -> {:error, :not_found}
found -> {:ok, found}
end
end
end
@doc """
Returns the user skills directory path.
This uses `Settings.get_user_home()` at runtime so tests can override HOME.
"""
@spec user_skills_dir() :: String.t()
def user_skills_dir() do
Path.join([Settings.get_user_home(), "fnord", "skills"])
end
@doc """
Returns the project skills directory for the currently selected project.
"""
@spec project_skills_dir() :: {:ok, String.t()} | {:error, :no_project_selected}
def project_skills_dir() do
case Settings.get_selected_project() do
{:ok, project} ->
{:ok, Path.join([Settings.fnord_home(), "projects", project, "skills"])}
_ ->
{:error, :no_project_selected}
end
end
defp load_project_skills() do
case project_skills_dir() do
{:ok, dir} -> Skills.Loader.load_dir(dir, :project)
{:error, :no_project_selected} -> {:ok, []}
end
end
defp resolve_definitions(user_loaded, project_loaded) do
all = user_loaded ++ project_loaded
all
|> Enum.group_by(& &1.skill.name)
|> Enum.map(fn {name, defs} ->
%{name: name, effective: choose_effective(defs), definitions: defs}
end)
|> Enum.sort_by(& &1.name)
end
defp choose_effective(defs) do
# User definitions override project definitions.
case Enum.find(defs, &(&1.source == :user)) do
nil -> Enum.at(defs, 0)
user_def -> user_def
end
end
end