CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

daily-guidance

强制使用:凡是时间尺度在小时及以下的日常行为模拟,必须使用本 Skill 生成、评估、执行和修正每日 Story。

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./packages/agentsociety2/agentsociety2/agent/skills/daily-guidance/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a lean, highly actionable, hook-driven operating manual with an explicit validation feedback loop and a clear deviation-handling ladder — workflow clarity is genuinely strong. Its main structural weakness is progressive disclosure: two reference files ship in the bundle but are never linked from SKILL.md, and their content is partially duplicated inline.

Suggestions

Add a short '## References' section pointing to references/story_schema.yaml (full field/schema rules) and references/examples.md (worked examples), so the bundle files are discoverable instead of orphaned.

Move the duplicated segment/maslow_reason/tpb_reason field specifications out of the body into references/story_schema.yaml, keeping only the minimal field list and one example inline.

Show a concrete `revise --from SEG_ID --json '[...]'` payload example and clarify how commands are invoked via `execute_skill_script` versus direct `python scripts/daily_guidance.py` invocation.

DimensionReasoningScore

Conciseness

The body is dense and table-driven with almost no padding — CLI commands, location_policy values, and Maslow needs are all tabulated. Minor trimmable instances remain: the 偏差处理 section re-lists record/deviate/revise commands already in the CLI table, the one-line TPB theory explainer, and the inlined segment-field requirements that duplicate references/story_schema.yaml. This fits anchor 4 (efficient, minor instances that could be trimmed) rather than anchor 5's 'every token earns its place'.

4 / 5

Actionability

Commands are concrete and copy-paste ready (`plan --date D --json '<obj>'`, `record --date D --activity A --location L`) with a complete, executable plan JSON example and a sample hook output. It stops short of anchor 5 because the `revise --json '<list>'` payload is never shown (only inferable from the plan example) and the stated invocation mechanism `execute_skill_script` is never demonstrated — anchor 4's 'concrete code or commands with minor gaps'.

4 / 5

Workflow Clarity

The per-step loop is a clear two-branch decision procedure driven by hook output (Case A: no valid story → submit plan; Case B: active_segment → act on it), with validation and a feedback loop built in ('校验通过才写文件,否则返回逐字段修复提示' — per-field fix hints on failure, plus a `check` command), a deviation ladder (record_only / local_patch→revise / carryover), and the 生成规则 section acting as a plan-creation checklist. This matches anchor 5 (clear sequence, explicit validation, error-recovery feedback, checklist) rather than anchor 4's 'minor validation gaps'.

5 / 5

Progressive Disclosure

The body itself is well-sectioned and the script reference (scripts/daily_guidance.py, verified to exist with matching CLI) is one level deep, but the bundle's references/examples.md and references/story_schema.yaml are never mentioned anywhere in SKILL.md — orphaned rather than merely 'not clearly signaled' — and the inlined maslow_reason/tpb_reason/segment-field specifications duplicate story_schema.yaml. This lands on anchor 3 ('references present but not clearly signaled; content that should be separate is inline'), not anchor 2 because the body's own structure is good rather than minimal.

3 / 5

Total

16

/

20

Passed

Description

66%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description has an explicit and well-scoped trigger condition and a clear niche, giving it strong completeness-of-'when' and low conflict risk. However, the 'what' is abstract (unexplained 'Story' artifact, generic lifecycle verbs), keyword variations are missing, and the imperative mandate voice costs specificity.

Suggestions

State the concrete output in the description, e.g. what the skill produces and manages (writes state/daily_guidance/YYYY-MM-DD/story.yaml, derives per-step execution state from the simulation clock, injects the active segment via a pre_step hook).

Add natural trigger synonyms/variations (e.g. daily schedule, daily plan, 仿真步, hourly-or-finer simulation steps) so users and the router match it with more phrasings.

Rewrite in third-person declarative voice ('Generates, evaluates, and revises daily Stories...') instead of the imperative '强制使用……必须使用本 Skill' to avoid the directive-voice penalty.

DimensionReasoningScore

Specificity

The description names the domain ("时间尺度在小时及以下的日常行为模拟") and four actions ("生成、评估、执行和修正每日 Story"), which is baseline-4 territory, but the actions are abstract lifecycle verbs on an unexplained artifact, and the imperative "强制使用……必须使用本 Skill" is directive/second-person voice, reduced one point per the rubric guideline. It is above anchor 2 (which only names a domain with minimal actions) but does not reach anchor 4's concrete, comprehensive action list.

3 / 5

Completeness

Both parts are present: 'what' = "生成、评估、执行和修正每日 Story" and an explicit 'when' = "凡是时间尺度在小时及以下的日常行为模拟" with a concrete trigger condition. It sits at anchor 4 rather than 5 because the 'what' side is less concrete — what a Story is and what output the skill produces (story.yaml files, clock-derived execution state) is left implicit.

4 / 5

Trigger Term Quality

Trigger phrases like "日常行为模拟", "每日 Story", and "时间尺度在小时及以下" are natural for this simulation domain, but no synonyms or variations are offered (e.g. daily schedule, daily plan, 仿真步). This matches anchor 3 ('some relevant keywords but missing common variations or synonyms') and falls short of anchor 4's good coverage with only a few missing terms.

3 / 5

Distinctiveness Conflict Risk

The trigger is a narrow, well-defined niche (sub-hour daily behavior simulation producing daily Story files) that no generic skill would accidentally match. This matches anchor 5 (clear niche with distinct triggers, minimal conflict risk); anchor 4's 'minor overlap risk with closely related skills' does not apply since no related skill shares this trigger.

5 / 5

Total

15

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

tsinghua-fib-lab/AgentSociety

Path

packages/agentsociety2/agentsociety2/agent/skills/daily-guidance/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.