Skip to content

feat(ai): add section for Acton dev skills#2168

Merged
novusnota merged 2 commits into
mainfrom
closes-2161/acton-skillz
May 15, 2026
Merged

feat(ai): add section for Acton dev skills#2168
novusnota merged 2 commits into
mainfrom
closes-2161/acton-skillz

Conversation

@novusnota
Copy link
Copy Markdown
Collaborator

@novusnota novusnota commented May 15, 2026

Closes #2161

Summary by CodeRabbit

  • Documentation
    • Added AI skills documentation section describing reusable coding-agent instructions for TON development. Includes guidance on documentation selection, command and project layout navigation, safety verification, automated code generation, and code refactoring capabilities.

Review Change Stack

@novusnota novusnota requested a review from a team as a code owner May 15, 2026 10:38
@mintlify
Copy link
Copy Markdown

mintlify Bot commented May 15, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify-ton-docs 🟢 Ready View Preview May 15, 2026, 10:39 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Copy link
Copy Markdown
Contributor

@github-actions github-actions Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the updates in ecosystem/ai/overview.mdx: please apply the inline suggestion to tighten the wording in the AI skills section.

Comment thread ecosystem/ai/overview.mdx Outdated
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 15, 2026

Warning

Rate limit exceeded

@novusnota has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 59 minutes and 15 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 50169fb2-3f0d-49b0-86f1-1cf3b0eac3a9

📥 Commits

Reviewing files that changed from the base of the PR and between ab8b849 and fa81b58.

📒 Files selected for processing (2)
  • ecosystem/ai/overview.mdx
  • from-ethereum.mdx
📝 Walkthrough

Walkthrough

This PR adds a new "AI skills" subsection to the AI ecosystem overview documentation, linking to Acton development skills and describing them as reusable coding-agent instructions for TON, including coverage of doc selection, command/project layout guidance, safety checks, Tolk code generation, and FunC→Tolk refactoring.

Changes

AI Skills Subsection

Layer / File(s) Summary
AI skills subsection addition
ecosystem/ai/overview.mdx
Introduced "AI skills" subsection with linked reference to Acton development skills and description of reusable coding-agent instructions for TON, including the Agent Skills specification reference.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly related PRs

  • ton-org/docs#2137: Both PRs modify ecosystem/ai/overview.mdx to enhance the AI ecosystem overview content.

Suggested labels

3p

Suggested reviewers

  • TrueCarry
  • thekiba

Poem

🐰 A rabbit hops through TON's vast domain,
Where skills for agents help coders gain,
Acton's wisdom now on display,
Guiding bots through code's grand ballet! 🎯

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The PR title clearly and concisely describes the main change: adding a section for Acton developer skills to the AI documentation.
Linked Issues check ✅ Passed The PR successfully adds a section mentioning Acton's smart contract skills to the AI overview documentation and references the Agent Skills specification as requested in #2161.
Out of Scope Changes check ✅ Passed All changes are directly related to the objective of adding Acton developer skills to the AI overview documentation with no out-of-scope modifications.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch closes-2161/acton-skillz

Warning

Review ran into problems

🔥 Problems

Git: Failed to clone repository. Please run the @coderabbitai full review command to re-trigger a full review. If the issue persists, set path_filters to include or exclude specific files.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

♻️ Duplicate comments (1)
ecosystem/ai/overview.mdx (1)

22-22: ⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Add an explicit AGENTS.md reference to satisfy the PR objective.

Line 22 describes Acton skills but does not reference AGENTS.md, which is a stated requirement from issue #2161/PR objective. Please add a direct mention/link in this subsection.

Suggested update
-[Acton development skills](https://ton-blockchain.github.io/acton/docs/agent-skills/overview) are reusable instructions for coding agents that work with TON smart contracts. They help the agent choose the right docs, commands, project layout, and perform safety checks, write idiomatic [Tolk](/tolk/overview) code, and refactor FunC projects to Tolk. All skills follow the [Agent Skills specification](https://agentskills.io/home).
+[Acton development skills](https://ton-blockchain.github.io/acton/docs/agent-skills/overview) are reusable instructions for coding agents that work with TON smart contracts. They define documentation sources, commands, project layout, safety checks, [Tolk](/tolk/overview) generation, and FunC→Tolk migration steps. See Acton’s `AGENTS.md` for the skill entrypoint/reference. All skills follow the [Agent Skills specification](https://agentskills.io/home).
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@ecosystem/ai/overview.mdx` at line 22, Update the Acton skills paragraph in
ecosystem/ai/overview.mdx to explicitly reference AGENTS.md by adding a direct
mention or link to AGENTS.md alongside the existing Agent Skills specification
link; specifically modify the sentence that begins with "Acton development
skills ..." to append "See AGENTS.md for repository-specific agent guidelines"
(or a similar link to AGENTS.md) so the PR objective from issue `#2161` is
satisfied while keeping the existing links to the Acton docs and Agent Skills
specification.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Duplicate comments:
In `@ecosystem/ai/overview.mdx`:
- Line 22: Update the Acton skills paragraph in ecosystem/ai/overview.mdx to
explicitly reference AGENTS.md by adding a direct mention or link to AGENTS.md
alongside the existing Agent Skills specification link; specifically modify the
sentence that begins with "Acton development skills ..." to append "See
AGENTS.md for repository-specific agent guidelines" (or a similar link to
AGENTS.md) so the PR objective from issue `#2161` is satisfied while keeping the
existing links to the Acton docs and Agent Skills specification.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 64e23b81-fa06-48de-939d-38f72b35ef30

📥 Commits

Reviewing files that changed from the base of the PR and between 529a361 and ab8b849.

📒 Files selected for processing (1)
  • ecosystem/ai/overview.mdx

@novusnota novusnota force-pushed the closes-2161/acton-skillz branch from ab8b849 to 5d279fa Compare May 15, 2026 13:03
@novusnota novusnota merged commit 916e7ef into main May 15, 2026
8 checks passed
@novusnota novusnota deleted the closes-2161/acton-skillz branch May 15, 2026 13:06
Copy link
Copy Markdown

@albertoblue87-netizen albertoblue87-netizen left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Comment thread ecosystem/ai/overview.mdx
Comment on lines +20 to +23
### AI skills

[Acton development skills](https://ton-blockchain.github.io/acton/docs/agent-skills/overview) are reusable instructions for coding agents that work with TON smart contracts. They tell the agent how to read TON documentation, which Acton commands to run, how to structure project files, how to generate [Tolk](/tolk/overview) code, and how to migrate FunC projects to Tolk. All skills follow the [Agent Skills specification](https://agentskills.io/home).

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes

Copy link
Copy Markdown

@albertoblue87-netizen albertoblue87-netizen left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Ecosystem > AI > Overview] Mention Acton's smart contract skills

2 participants