Skip to main content

Agent Skills

Skills that make a coding agent write code with Aspid.FastTools instead of the raw Unity API.

Quick start​

Install Aspid.FastTools in your Unity project. The skills installer needs Node.js 22.20 or newer.

note

Releases up to and including 1.0.0-rc.8 do not ship the skills. With one of them, see Versions and updates first.

Ask your agent:

Install the skills from VPDPersonal/Aspid.FastTools in the current project,
not globally. Run npx skills add VPDPersonal/Aspid.FastTools#skills.

Or run in the project root:

npx skills add VPDPersonal/Aspid.FastTools#skills

In the installer, choose the Project scope: a global install applies to every Unity project, whatever its package version.

Profile Simulate and the neighbor search
Without skillsWith skills
private static readonly
ProfilerMarker _simulate =
new("Flock.Simulate");
private static readonly
ProfilerMarker _neighbors =
new("Flock.FindNeighbors");

public void Simulate()
{
using var _ = _simulate.Auto();
using (_neighbors.Auto())
FindNeighbors();
Integrate();
}
public void Simulate()
{
using var _ = this.Marker();
using (this.Marker()
.WithName("Neighbors"))
FindNeighbors();
Integrate();
}

Versions and updates​

The skills come from release branches, never from main. Each channel of the package has its own: skills-preview gets every preview release, as upm-preview does, and skills every stable one, as upm does. Install from the channel of your package. npx skills update moves the skills to the newest release of that channel, and it updates every skill in the project, not only these.

Update the package at the same time: skills newer than your package can describe API that it does not have, so the agent writes code that does not compile. To keep the skills at your package version, install them from its tag, which npx skills update does not move:

npx skills add VPDPersonal/Aspid.FastTools#skills/<version>

The tag is on the channel of your package: skills/<version> for a stable release, skills-preview/<version> for a preview one.

Releases up to and including 1.0.0-rc.8 do not ship the skills. With one of them, upgrade the package to a release that does.

The skills used to ship as the aspid-fasttools Claude Code plugin. If you have it, remove it with /plugin uninstall aspid-fasttools@aspid-claude-plugins: it teaches the agent API that no longer exists.

Skills​

Skills activate automatically for matching requests.

aspid-profiler-marker​

Profile a method or a section with this.Marker(). Guide: ProfilerMarkers.

AgentFlockSimulation.cs
>Profile Simulate and the neighbor search
Skill aspid-profiler-marker
Update FlockSimulation.cs +2
public void Simulate(){    using var _ = this.Marker();    using (this.Marker().WithName("Neighbors"))    FindNeighbors();    Integrate();}

aspid-visual-element-fluent​

Build and style UI Toolkit elements in C#. Guide: VisualElement Extensions.

AgentAbilityConfigEditor.cs
>Build the inspector header with a title
Skill aspid-visual-element-fluent
Update AbilityConfigEditor.cs +5
public override VisualElement CreateInspectorGUI(){    return new VisualElement()        .SetPaddingX(12)        .SetPaddingY(10)        .AddChild(new Label("Ability Config")            .SetFontSize(14));}

aspid-serializable-type​

Store a System.Type, pick types in the Inspector and fail a CI job on missing types. Guides: Serializable Types, TypeSelector, SerializeReference Selector, ComponentTypeSelector, Build and CI checks.

AgentWeaponMount.cs
>Add a weapon class picker to the Inspector, no abstract ones
Skill aspid-serializable-type
Update WeaponMount.cs +3
public sealed class WeaponMount : MonoBehaviour{    [TypeSelector(Allow = TypeAllow.None)]    [SerializeField]    private SerializableType<Weapon> _primaryWeapon;}

aspid-enum-values​

Map enum members to values. Guide: EnumValues.

AgentDamageReceiver.cs
>Add a damage multiplier per DamageType to the Inspector
Skill aspid-enum-values
Update DamageReceiver.cs +5
public sealed class DamageReceiver : MonoBehaviour{    [SerializeField]    private EnumValues<DamageType, float> _multipliers;
    public float GetMultiplier(DamageType type) =>        _multipliers.GetValue(type);}